2019-12-26 13:05:17 +01:00
|
|
|
# Changelog
|
2015-09-12 12:54:05 +02:00
|
|
|
All notable changes to this project will be documented in this file.
|
|
|
|
|
|
2019-12-26 13:05:17 +01:00
|
|
|
The format is based on
|
|
|
|
|
[Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
|
|
|
and this project adheres to
|
|
|
|
|
[Haskell Package Versioning Policy](https://pvp.haskell.org/).
|
|
|
|
|
|
2019-12-25 06:45:29 +01:00
|
|
|
## [Unreleased]
|
2020-05-22 10:11:48 +02:00
|
|
|
### Fixed
|
|
|
|
|
- The parser rejects variables when parsing defaultValue (DefaultValue). The
|
|
|
|
|
specification defines default values as `Value` with `const` parameter and
|
|
|
|
|
constant cannot be variables. `AST.Document.ConstValue` was added,
|
|
|
|
|
`AST.Document.ObjectField` was modified.
|
|
|
|
|
|
2020-05-13 16:21:48 +02:00
|
|
|
### Changed
|
|
|
|
|
- `Resolver` is now `Resolver Name FieldResolver` where `FieldResolver` can
|
|
|
|
|
contain a JSON value or another resolver, which is invoked during the
|
|
|
|
|
execution. `FieldResolver` is executed in `ActionT` and the current `Field` is
|
|
|
|
|
passed in the reader and not as an explicit argument.
|
2020-05-21 10:20:59 +02:00
|
|
|
- `Execute.Transform.operation` has the prior responsibility of
|
|
|
|
|
`Execute.Transform.document`, but transforms only the chosen operation and not
|
|
|
|
|
the whole document. `Execute.Transform.document` translates
|
|
|
|
|
`AST.Document.Document` into `Execute.Transform.Document`.
|
2020-05-11 12:30:41 +02:00
|
|
|
|
2020-05-14 09:17:14 +02:00
|
|
|
### Added
|
2020-05-21 10:20:59 +02:00
|
|
|
- `Type.Definition` contains input and the most output types.
|
|
|
|
|
- `Type.Schema` describes a schema. Both public functions that execute queries
|
2020-05-14 09:17:14 +02:00
|
|
|
accept a `Schema` now instead of a `HashMap`. The execution fails if the root
|
|
|
|
|
operation doesn't match the root Query type in the schema.
|
2020-05-21 10:20:59 +02:00
|
|
|
- `Execute.Coerce` defines a typeclass responsible for input, variable value
|
|
|
|
|
coercion. It decouples us a bit from JSON since any format can be used to pass
|
|
|
|
|
query variables. Execution functions accept (`HashMap Name a`) instead of
|
|
|
|
|
`Subs`, where a is an instance of `VariableValue`.
|
|
|
|
|
|
|
|
|
|
### Removed
|
|
|
|
|
- `AST.Core.Document`. Transforming the whole document is probably not
|
|
|
|
|
reasonable since a document can define multiple operations and we're
|
|
|
|
|
interested only in one of them. Therefore `Document` was modified and moved to
|
|
|
|
|
`Execute.Transform`. It contains only slightly modified AST used to pick the
|
|
|
|
|
operation.
|
2020-05-14 09:17:14 +02:00
|
|
|
|
2020-05-11 12:30:41 +02:00
|
|
|
## [0.7.0.0] - 2020-05-11
|
2020-03-31 09:04:34 +02:00
|
|
|
### Fixed
|
|
|
|
|
- Result of null encoding
|
2020-03-29 15:56:07 +02:00
|
|
|
- Block strings encoding
|
|
|
|
|
- Result of tab and newline encoding
|
2020-03-31 09:04:34 +02:00
|
|
|
|
2019-12-26 13:00:47 +01:00
|
|
|
### Added
|
|
|
|
|
- AST for the GraphQL schema.
|
2020-01-26 11:55:15 +01:00
|
|
|
- Type system definition parser.
|
2019-12-31 08:29:03 +01:00
|
|
|
- `Trans.argument`.
|
2020-01-25 16:37:17 +01:00
|
|
|
- Schema extension parser.
|
2020-05-10 18:32:58 +02:00
|
|
|
- Contributing guidelines.
|
2020-05-13 16:21:48 +02:00
|
|
|
- `Schema.resolversToMap` (intended to be used internally).
|
2019-12-26 13:00:47 +01:00
|
|
|
|
2019-12-25 06:45:29 +01:00
|
|
|
### Changed
|
2019-12-28 07:07:58 +01:00
|
|
|
- Rename `AST.Definition` into `AST.Document.ExecutableDefinition`.
|
|
|
|
|
`AST.Document.TypeSystemDefinition` and `AST.Document.TypeSystemExtension`
|
|
|
|
|
can also be definitions.
|
|
|
|
|
- Move all AST data to `AST.Document` and reexport them.
|
|
|
|
|
- Rename `AST.OperationSelectionSet` to `AST.Document.SelectionSet`.
|
2019-12-30 18:26:24 +01:00
|
|
|
- Make `Schema.Subs` a `Data.HashMap.Strict` (was a function
|
|
|
|
|
`key -> Maybe value` before).
|
2020-01-17 12:22:29 +01:00
|
|
|
- Make `AST.Lexer.at` a text (symbol) parser. It was a char before and is
|
|
|
|
|
`symbol "@"` now.
|
2020-02-01 20:46:35 +01:00
|
|
|
- Replace `MonadIO` with a plain `Monad`. Since the tests don't use IO,
|
|
|
|
|
set the inner monad to `Identity`.
|
2020-05-10 18:32:58 +02:00
|
|
|
- `NonEmpty (Resolver m)` is now `HashMap Text (NonEmpty (Resolver m))`. Root
|
|
|
|
|
operation type can be any type, therefore a hashmap is needed. Since types
|
|
|
|
|
cannot be empty, we save the list of resolvers in the type as a non-empty
|
|
|
|
|
list. Currently only "Query" and "Mutation" are supported as types. For more
|
|
|
|
|
schema support is required. The executor checks now if the type in the query
|
|
|
|
|
matches the type of the provided root resolvers.
|
2019-12-26 13:05:17 +01:00
|
|
|
|
|
|
|
|
### Removed
|
|
|
|
|
- `AST.Field`, `AST.InlineFragment` and `AST.FragmentSpread`.
|
2019-12-25 06:45:29 +01:00
|
|
|
These types are only used in `AST.Selection` and `AST.Selection` contains now
|
|
|
|
|
3 corresponding data constructors, `Field`, `InlineFragment` and
|
|
|
|
|
`FragmentSpread`, instead of separate types. It simplifies pattern matching
|
|
|
|
|
and doesn't make the code less typesafe.
|
2019-12-31 08:29:03 +01:00
|
|
|
- `Schema.scalarA`.
|
|
|
|
|
- `Schema.wrappedScalarA`.
|
|
|
|
|
- `Schema.wrappedObjectA`.
|
|
|
|
|
- `Schema.objectA`.
|
2020-01-01 10:58:11 +01:00
|
|
|
- `AST.Argument`. Replaced with `AST.Arguments` which holds all arguments as a
|
|
|
|
|
key/value map.
|
2019-12-25 06:45:29 +01:00
|
|
|
|
2019-12-23 06:35:32 +01:00
|
|
|
## [0.6.1.0] - 2019-12-23
|
2019-11-27 09:18:20 +01:00
|
|
|
### Fixed
|
2019-12-25 06:45:29 +01:00
|
|
|
- Parsing multiple string arguments, such as
|
2019-11-27 09:18:20 +01:00
|
|
|
`login(username: "username", password: "password")` would fail on the comma
|
|
|
|
|
due to strings not having a space consumer.
|
2019-12-01 20:43:19 +01:00
|
|
|
- Fragment spread is evaluated based on the `__typename` resolver. If the
|
|
|
|
|
resolver is missing, it is assumed that the type condition is satisfied (all
|
|
|
|
|
fragments are included).
|
2019-12-19 06:59:27 +01:00
|
|
|
- Escaping characters during encoding.
|
2019-11-27 09:18:20 +01:00
|
|
|
|
2019-12-06 22:52:24 +01:00
|
|
|
### Added
|
|
|
|
|
- Directive support (@skip and @include).
|
2019-12-21 09:16:41 +01:00
|
|
|
- Pretifying multi-line string arguments as block strings.
|
2019-12-06 22:52:24 +01:00
|
|
|
|
2019-11-27 08:26:51 +01:00
|
|
|
## [0.6.0.0] - 2019-11-27
|
2019-11-03 10:42:10 +01:00
|
|
|
### Changed
|
|
|
|
|
- `Language.GraphQL.Encoder` moved to `Language.GraphQL.AST.Encoder`.
|
|
|
|
|
- `Language.GraphQL.Parser` moved to `Language.GraphQL.AST.Parser`.
|
|
|
|
|
- `Language.GraphQL.Lexer` moved to `Language.GraphQL.AST.Lexer`.
|
|
|
|
|
- All `Language.GraphQL.AST.Value` data constructor prefixes were removed. The
|
|
|
|
|
module should be imported qualified.
|
|
|
|
|
- All `Language.GraphQL.AST.Core.Value` data constructor prefixes were removed.
|
|
|
|
|
The module should be imported qualified.
|
2019-11-22 08:00:50 +01:00
|
|
|
- `Language.GraphQL.AST.Core.Object` is now just a HashMap.
|
|
|
|
|
- `Language.GraphQL.AST.Transform` is isn't exposed publically anymore.
|
|
|
|
|
- `Language.GraphQL.Schema.resolve` accepts a selection `Seq` (`Data.Sequence`)
|
|
|
|
|
instead of a list. Selections are stored as sequences internally as well.
|
2019-11-23 09:49:12 +01:00
|
|
|
- Add a reader instance to the resolver's monad stack. The Reader contains
|
|
|
|
|
a Name/Value hashmap, which will contain resolver arguments.
|
2019-11-03 10:42:10 +01:00
|
|
|
|
2019-11-09 23:24:31 +01:00
|
|
|
### Added
|
2019-11-22 08:00:50 +01:00
|
|
|
- Nested fragment support.
|
|
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
- Consume ignored tokens after `$` and `!`. I mistakenly assumed that
|
|
|
|
|
`$variable` is a single token, same as `Type!` is a single token. This is not
|
|
|
|
|
the case, for example `Variable` is defined as `$ Name`, so these are two
|
|
|
|
|
tokens, therefore whitespaces and commas after `$` and `!` should be
|
|
|
|
|
consumed.
|
|
|
|
|
|
|
|
|
|
### Improved
|
|
|
|
|
- `Language.GraphQL.AST.Parser.type_`: Try type parsers in a variable
|
|
|
|
|
definition in a different order to avoid using `but`.
|
2019-11-09 23:24:31 +01:00
|
|
|
|
2019-11-23 09:49:12 +01:00
|
|
|
### Removed
|
|
|
|
|
- `Language.GraphQL.AST.Arguments`. Use `[Language.GraphQL.AST.Argument]`
|
|
|
|
|
instead.
|
|
|
|
|
- `Language.GraphQL.AST.Directives`. Use `[Language.GraphQL.AST.Directives]`
|
|
|
|
|
instead.
|
|
|
|
|
- `Language.GraphQL.AST.VariableDefinitions`. Use
|
|
|
|
|
`[Language.GraphQL.AST.VariableDefinition]` instead.
|
|
|
|
|
- `Language.GraphQL.AST.FragmentName`. Use `Language.GraphQL.AST.Name` instead.
|
|
|
|
|
- `Language.GraphQL.Execute.Schema` - It was a resolver list, not a schema.
|
|
|
|
|
- `Language.GraphQL.Schema`: `enum`, `enumA`, `wrappedEnum` and `wrappedEnumA`.
|
|
|
|
|
Use `scalar`, `scalarA`, `wrappedScalar` and `wrappedScalarA` instead.
|
|
|
|
|
|
|
|
|
|
|
2019-10-22 07:07:54 +02:00
|
|
|
## [0.5.1.0] - 2019-10-22
|
2019-10-01 06:59:30 +02:00
|
|
|
### Deprecated
|
|
|
|
|
- `Language.GraphQL.AST.Arguments`. Use `[Language.GraphQL.AST.Argument]`
|
|
|
|
|
instead.
|
|
|
|
|
- `Language.GraphQL.AST.Directives`. Use `[Language.GraphQL.AST.Directives]`
|
|
|
|
|
instead.
|
|
|
|
|
- `Language.GraphQL.AST.VariableDefinitions`. Use
|
|
|
|
|
`[Language.GraphQL.AST.VariableDefinition]` instead.
|
|
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
- Module documentation.
|
2019-10-11 23:28:55 +02:00
|
|
|
- Inline fragment support.
|
2019-09-13 20:33:39 +02:00
|
|
|
|
2019-10-22 07:07:54 +02:00
|
|
|
### Fixed
|
|
|
|
|
- Top-level fragments.
|
|
|
|
|
- Fragment for execution is chosen based on the type.
|
|
|
|
|
|
2019-09-10 10:06:48 +02:00
|
|
|
## [0.5.0.1] - 2019-09-10
|
2019-08-26 10:14:46 +02:00
|
|
|
### Added
|
|
|
|
|
- Minimal documentation for all public symbols.
|
|
|
|
|
|
2019-08-29 07:40:50 +02:00
|
|
|
### Deprecated
|
2019-08-30 07:26:04 +02:00
|
|
|
- `Language.GraphQL.AST.FragmentName`. Replaced with Language.GraphQL.AST.Name.
|
|
|
|
|
- `Language.GraphQL.Execute.Schema` - It is not a schema (at least not a
|
|
|
|
|
complete one), but a resolver list, and the resolvers should be provided by
|
|
|
|
|
the user separately, because the schema can originate from a GraphQL
|
|
|
|
|
document. `Schema` name should be free to provide a data type for the real
|
|
|
|
|
schema later.
|
2019-09-01 02:53:15 +02:00
|
|
|
- `Language.GraphQL.Schema`: `enum`, `enumA`, `wrappedEnum` and `wrappedEnumA`.
|
|
|
|
|
There are actually only two generic types in GraphQL: Scalars and objects.
|
|
|
|
|
Enum is a scalar value.
|
2019-08-29 07:40:50 +02:00
|
|
|
|
2019-09-06 07:48:01 +02:00
|
|
|
### Fixed
|
|
|
|
|
- Parsing block string values.
|
|
|
|
|
|
2019-08-14 08:49:07 +02:00
|
|
|
## [0.5.0.0] - 2019-08-14
|
2019-07-25 07:37:36 +02:00
|
|
|
### Added
|
|
|
|
|
- `executeWithName` executes an operation with the given name.
|
2019-08-14 08:49:07 +02:00
|
|
|
- Export `Language.GraphQL.Encoder.definition`,
|
|
|
|
|
`Language.GraphQL.Encoder.type'` and `Language.GraphQL.Encoder.directive`.
|
2019-08-13 07:24:05 +02:00
|
|
|
- Export `Language.GraphQL.Encoder.value`. Escapes \ and " in strings now.
|
2019-07-25 07:37:36 +02:00
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
- `Operation` includes now possible operation name which allows to support
|
|
|
|
|
documents with multiple operations.
|
2019-08-02 13:52:51 +02:00
|
|
|
- `Language.GraphQL.Encoder.document` and other encoding functions take a
|
|
|
|
|
`Formatter` as argument to distinguish between minified and pretty printing.
|
2019-08-05 09:00:11 +02:00
|
|
|
- All encoder functions return `Data.Text.Lazy`.
|
2019-07-25 07:37:36 +02:00
|
|
|
|
2019-07-27 07:19:21 +02:00
|
|
|
### Removed
|
|
|
|
|
- Unused `Language.GraphQL.Encoder.spaced`.
|
|
|
|
|
|
2019-07-23 06:04:33 +02:00
|
|
|
## [0.4.0.0] - 2019-07-23
|
|
|
|
|
### Added
|
|
|
|
|
- Support for mutations.
|
|
|
|
|
- Error handling (with monad transformers).
|
|
|
|
|
- Nullable types.
|
|
|
|
|
- Arbitrary nested lists support.
|
|
|
|
|
- Potential BOM header parsing.
|
|
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
- attoparsec is replaced with megaparsec.
|
|
|
|
|
- The library is now under `Language.GraphQL` (instead of `Data.GraphQL`).
|
|
|
|
|
- HUnit and tasty are replaced with Hspec.
|
|
|
|
|
- `Alternative`/`MonadPlus` resolver constraints are replaced with `MonadIO`.
|
|
|
|
|
|
|
|
|
|
### Removed
|
|
|
|
|
- Duplicates from `Language.GraphQL.AST` already available in
|
|
|
|
|
`Language.GraphQL.AST.Core`.
|
|
|
|
|
- All module exports are now explicit, so private and help functions aren't
|
|
|
|
|
exported anymore.
|
|
|
|
|
|
2015-09-22 14:27:10 +02:00
|
|
|
## [0.3] - 2015-09-22
|
|
|
|
|
### Changed
|
|
|
|
|
- Exact match numeric types to spec.
|
|
|
|
|
- Names follow now the spec.
|
|
|
|
|
- AST slightly different for better readability or easier parsing.
|
|
|
|
|
- Replace golden test for test to validate parsing/encoding.
|
|
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
- Parsing errors in all cases where `Alternative` is used.
|
|
|
|
|
- GraphQL encoder.
|
|
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
- Expect braces `inputValueDefinitions` instead of parens when parsing.
|
|
|
|
|
|
2015-09-16 11:16:16 +02:00
|
|
|
## [0.2.1] - 2015-09-16
|
|
|
|
|
### Fixed
|
|
|
|
|
- Include data files for golden tests in Cabal package.
|
|
|
|
|
- Support for ghc-7.8.
|
|
|
|
|
|
2015-09-14 17:25:18 +02:00
|
|
|
## [0.2] - 2015-09-14
|
|
|
|
|
### Added
|
|
|
|
|
- Rudimentary parser for `GraphQL` which successfully parses the sample file
|
|
|
|
|
`kitchen-sink.graphql` from `graphql-js` tests.
|
|
|
|
|
- Golden test for `kitchen-sink.grahql` parsing.
|
|
|
|
|
### Changed
|
|
|
|
|
- Many optional data types in `GraphQl` didn't need to be wrapped in a `Maybe`.
|
|
|
|
|
- Some `newtype`s became type synonyms for easier parsing.
|
|
|
|
|
|
2015-09-16 11:16:16 +02:00
|
|
|
## 0.1 - 2015-09-12
|
2015-09-12 12:54:05 +02:00
|
|
|
### Added
|
|
|
|
|
- Data types for the GraphQL language.
|
2015-09-16 11:16:16 +02:00
|
|
|
|
2019-12-25 06:45:29 +01:00
|
|
|
[Unreleased]: https://github.com/caraus-ecms/graphql/compare/v0.6.1.0...HEAD
|
2020-05-11 12:30:41 +02:00
|
|
|
[0.7.0.0]: https://github.com/caraus-ecms/graphql/compare/v0.6.1.0...v0.7.0.0
|
2019-12-23 06:35:32 +01:00
|
|
|
[0.6.1.0]: https://github.com/caraus-ecms/graphql/compare/v0.6.0.0...v0.6.1.0
|
2019-11-27 08:26:51 +01:00
|
|
|
[0.6.0.0]: https://github.com/caraus-ecms/graphql/compare/v0.5.1.0...v0.6.0.0
|
2019-10-22 07:07:54 +02:00
|
|
|
[0.5.1.0]: https://github.com/caraus-ecms/graphql/compare/v0.5.0.1...v0.5.1.0
|
2019-09-10 10:06:48 +02:00
|
|
|
[0.5.0.1]: https://github.com/caraus-ecms/graphql/compare/v0.5.0.0...v0.5.0.1
|
2019-08-14 08:49:07 +02:00
|
|
|
[0.5.0.0]: https://github.com/caraus-ecms/graphql/compare/v0.4.0.0...v0.5.0.0
|
2019-07-23 06:04:33 +02:00
|
|
|
[0.4.0.0]: https://github.com/caraus-ecms/graphql/compare/v0.3...v0.4.0.0
|
|
|
|
|
[0.3]: https://github.com/caraus-ecms/graphql/compare/v0.2.1...v0.3
|
|
|
|
|
[0.2.1]: https://github.com/caraus-ecms/graphql/compare/v0.2...v0.2.1
|
|
|
|
|
[0.2]: https://github.com/caraus-ecms/graphql/compare/v0.1...v0.2
|
