Commit Graph

214 Commits

Author SHA1 Message Date
Sunli
3d7512ec58 Update docs. 2020-10-01 11:23:24 +08:00
Sunli
80d47a9fc7
Merge pull request #291 from async-graphql/rework-errors
Rework errors
2020-10-01 11:18:23 +08:00
Chip Senkbeil
2556c2fd7a
Add flatten union documentation 2020-09-30 21:44:47 -05:00
Koxiaet
ab82460b81 Merge master 2020-09-30 18:24:24 +01:00
Koxiaet
2ddaaaa07f Rework errors
This completely overhauls the error system used in async-graphql.
- `Error` has been renamed to `ServerError` and `FieldError` has been
renamed to just `Error`. This is because `FieldError` is by far the most
common error that users will have to use so it makes sense to use the
most obvious error name. Also, the current name didn't make sense as it
was used for things other than field errors, such as the data callback
for websockets.
- `ServerError` has been made completely opaque. Before it was an enum
of all the possible errors, but now it just contains an error message,
the locations, the path and extensions. It is a shame that we lose
information, it makes more sense as _conceptually_ GraphQL does not
provide that information. It also frees us to change the internals of
async-graphql a lot more.
- The path of errors is no longer an opaque JSON value but a regular
type, `Vec<PathSegment>`. The type duplication of `PathSegment` and
`QueryPathSegment` is unfortunate, I plan to work on this in the future.
- Now that `ServerError` is opaque, `RuleError` has been removed from
the public API, making it simpler.
- Additionally `QueryError` has been completely removed. Instead the
error messages are constructed ad-hoc; I took care to never repeat an
error message.
- Instead of constructing field-not-found errors inside the
implementations of field resolvers they now return `Option`s, where a
`None` value is representative of the field not being found.
- As an unfortunate consequence of the last change, self-referential
types based on the output of a subscription resolver can no longer be
created. This does not mean anything for users, but causes lifetime
issues in the implementation of merged objects. I fixed it with a bit of
a hack, but this'll have to be looked into further.
- `InputValueError` now has a generic parameter - it's kind of weird but
it's necessary for ergonomics. It also improves error messages.
- The `ErrorExtensions` trait has been removed. I didn't think the
`extend` method was necessary since `From` impls exist. But the
ergonomics are still there with a new trait `ExtendError`, which
is implemented for both errors and results.
- `Response` now supports serializing multiple errors. This allows for
nice things like having multiple validation errors not be awkwardly
shoved into a single error.
- When an error occurs in execution, data is sent as `null`. This is
slightly more compliant with the spec but the algorithm described in
<https://spec.graphql.org/June2018/#sec-Errors-and-Non-Nullability> has
yet to be implemented.
2020-09-29 20:06:44 +01:00
Sunli
8c5d8f0324 Rework async-graphql-derive. #288 2020-09-29 16:06:10 +08:00
Sunli
e42f5a4477 Update book. 2020-09-28 14:43:12 +08:00
Sunli
a0905de86f Update docs 2020-09-28 09:31:19 +08:00
Chip Senkbeil
b9359df3f6
Add remote enum documentation
Add book documentation about remote option for enums (#276)
2020-09-27 14:02:10 -05:00
Sunli
ebb7c90461 Remove all GQL prefix. #208 2020-09-20 13:44:20 +08:00
Sunli
322e296a24 Remove the GQL prefix of all macros. #208 2020-09-18 09:10:24 +08:00
Sunli
fab82f15f3 Update book 2020-09-17 08:14:07 +08:00
Sunli
646c6155cd Update book 2020-09-15 11:56:05 +08:00
Sunli
7aa9cb2ed7 Update Book 2020-09-13 12:12:32 +08:00
Sunli
13f7126a13 Udate docs 2020-09-13 11:51:10 +08:00
Sunli
8d3ae2d465 Update book. 2020-09-11 23:38:18 +08:00
Sunli
035e7c27c9 Release 1.18.0 2020-09-09 15:27:45 +08:00
Koxiaet
ba5e80f35e Improve book and fix serde dependency 2020-09-01 06:47:22 +01:00
Sunli
3a0ccd43a0 Update docs 2020-08-28 14:04:59 +08:00
Lee Benson
449e6fc4e8
Merge pull request #1 from leebenson/patch-2
Update SUMMARY.md
2020-08-27 11:04:11 +01:00
Lee Benson
3ab7ddb145
Update SUMMARY.md 2020-08-27 11:02:28 +01:00
Lee Benson
876e221cb7
Update merging_objects.md
Add subscription merging
2020-08-27 11:01:39 +01:00
Sunli
702869a1f2 Add GQLMergedObject to docs/zh_CN 2020-08-11 11:42:19 +08:00
D1plo1d
cb18c60989 Add GQLMergedObject to docs 2020-08-10 23:21:15 -04:00
Sunli
b0bce9ec32 Update book 2020-08-10 13:01:49 +08:00
Alaa Zorkane
3d179038f3
fix(docs): missing comment hashtag 2020-08-10 03:54:22 +01:00
Quentin Perez
5863ad2877
InputValueValidator: impl for MustBeZero 2020-08-03 14:43:15 +02:00
Sunli
c22ff21b96 InputValueValidator::is_valid function now returns the Result type. #221 2020-07-30 09:43:51 +08:00
Sunli
993b2499d7 Update input_value_validators.md 2020-07-30 09:29:07 +08:00
Sunli
3395c00603 Replace Value::Int and Value::Float with Value::Number. 2020-07-29 09:42:52 +08:00
Sunli
3eb3e1441f Fix typo 2020-07-15 15:08:58 +08:00
Sunli
741ec4d90a Update docs #205 2020-07-08 15:05:38 +08:00
Blaine Bublitz
6ed3909a9a Use FieldResult for data(), add data_unchecked() for panic 2020-07-06 17:39:53 -07:00
Sunli
c6803c4b35 Update docs for federation #180 2020-06-19 13:03:17 +08:00
Atsuhiro Takahashi
9f8197e317 Fix sample code in the book. 2020-06-18 21:59:45 +09:00
Atsuhiro Takahashi
3fd22ae3a2
Fix sample code on Quickstart (#177)
Fix sample code on Quickstart #177
2020-06-15 21:07:38 +08:00
Sunli
cda4498979 Remove all datasource-related code and update the documentation. 2020-06-15 14:17:19 +08:00
Sunli
27b622e8bc Add connection::query function 2020-06-02 17:43:13 +08:00
Sunli
7a3c4792f5 Update docs 2020-06-02 08:57:45 +08:00
Sunli
27587dda8f
Merge pull request #134 from nm-infy/nm-infy-patch-2
Correct spelling in context.md
2020-06-01 19:16:26 +08:00
Nilesh Mali
910ffc2726
correct spelling 2020-06-01 16:40:01 +05:30
Nilesh Mali
e2f26f8996
correct statement grammar and spelling 2020-06-01 16:39:06 +05:30
Nilesh Mali
272ba99bb4
correct spelling in context.md 2020-06-01 16:31:04 +05:30
Nilesh Mali
8b591952eb
correct spelling in apollo_federation.md 2020-06-01 15:55:19 +05:30
Sunli
928ecba19c Update introduction.md 2020-06-01 10:49:43 +08:00
Sunli
cf537ad9a1
Merge pull request #128 from phated/notes-from-120
Improve stability message based on #120 feedback
2020-06-01 09:39:20 +08:00
Blaine Bublitz
89c3bdf3c2 Improve stability message based on #120 feedback 2020-05-31 12:00:19 -07:00
sunli
3c97c76c60 update some docs 2020-05-29 00:01:04 +08:00
Иван Плесских
6d56c0157e
Added docs for Interface field method argument (#124)
* Added docs for `Interface` field `method` argument
2020-05-28 23:50:01 +08:00
sunli
1a7ae5a26d Update introduction.md 2020-05-28 08:15:04 +08:00
Sunli
bdfaaf46ef
Merge pull request #120 from phated/stability-warning
Add stability warning to README & book (ref #117)
2020-05-28 08:02:59 +08:00
Sunli
ada2597130
New data source (#105)
* New data source
2020-05-28 08:02:00 +08:00
Blaine Bublitz
5fb79d6b15 Add stability warning to README & book (ref #117) 2020-05-27 15:40:51 -07:00
sunli
c79e9f1b58 Update docs 2020-05-26 23:27:50 +08:00
nicolaiunrein
24de8639b6
Fix typo in book 2020-05-21 18:45:24 +02:00
Samuel Hurel
36c05dc5a7 Fix tests & impl From<Stream> for StreamDataSource 2020-05-21 10:22:36 +02:00
Nicolai Unrein
1fd20d921e add examples and benchmarks to introduction of book 2020-05-20 13:29:07 +02:00
Sunli
89bfaac0eb The scalar name and description attributes are placed on the process macro attributes. #97 2020-05-19 13:27:01 +08:00
sunli
0717d6685b Update error_extensions.md 2020-05-13 12:51:44 +08:00
sunli
0824b6cc23 Update docs 2020-05-13 12:49:43 +08:00
Nicolai Unrein
c533080c8c add some fixes in error_extensions.md and error_handling.md 2020-05-12 11:13:35 +02:00
sunli
a8c7e571e4 Merge branch 'upload-stream' 2020-05-11 21:47:58 +08:00
sunli
83579077d9 Support Upload Stream #15
I think the previous implementation is not elegant enough, the `QueryBuilder::set_files_holder` function looks disgusting, so I refactored it.
By the way, the performance of parsing InputValue has been optimized, and unnecessary clones have been removed.
2020-05-11 21:47:24 +08:00
Nicolai Unrein
fd9a7553ae Add documentation for error_extensions 2020-05-11 14:25:54 +02:00
Sunli
1499b67a78 Update docs 2020-05-11 14:35:12 +08:00
Sunli
a1c8dedd56
Merge pull request #75 from phated/interface-enums
Change interfaces & unions to require enums
2020-05-11 13:44:19 +08:00
Blaine Bublitz
d19ab4c559 Update the books 2020-05-10 21:39:43 -07:00
Sunli
f15fa9dbdf fix typo 2020-05-11 10:39:08 +08:00
sunli
6d7d64866b The error reason can be returned when the input value is parsed incorrectly. #70 2020-05-10 18:27:46 +08:00
Sunli
93dedf1198
Merge pull request #67 from DataCorrupted/master
slightly modified based on Sunli's reply.
2020-05-10 13:53:26 +08:00
Peter Rong
17bd315727 slightly modified based on Sunli's reply.
Signed-off-by: Peter Rong <PeterRong96@gmail.com>
2020-05-09 22:48:41 -07:00
sunli
85156b69a8 Use rustdoc comments as graphql desc. #62 2020-05-10 12:41:05 +08:00
sunli
6874b8138c Update apollo_tracing.md 2020-05-10 09:03:21 +08:00
Sunli
0d3df4ad0f
Merge pull request #64 from DataCorrupted/master
Translate type system almost done with some TODO.
2020-05-10 08:56:50 +08:00
Ethan Fast
cc17c32721 translate section 7 (advanced topics) 2020-05-09 15:37:31 -07:00
Peter Rong
f5ce459e51 resolved typo.
Signed-off-by: Peter Rong <PeterRong96@gmail.com>
2020-05-09 15:01:25 -07:00
Ethan Fast
625a3ddb5a translate section 6 (integrations) 2020-05-09 14:56:45 -07:00
Ethan Fast
774cde91aa translate section 5 (extensions) 2020-05-09 14:39:04 -07:00
Ethan Fast
ab9cefb349 translate section 4 (schema) 2020-05-09 13:56:15 -07:00
Peter Rong
b5c8e80151 Translate type system almost done with some TODO.
Signed-off-by: Peter Rong <PeterRong96@gmail.com>
2020-05-09 10:53:41 -07:00
sunli
04a3b73c72 Update cursor_connections.md 2020-05-07 10:08:44 +08:00
Blaine Bublitz
aedb02fe63 Update book 2020-05-06 17:04:59 -07:00
sunli
98864c6879 Add field guard 2020-05-02 07:57:34 +08:00
ansj
3867f9d638
Update custom_scalars.md (#40)
* Update custom_scalars.md
2020-04-29 16:38:11 +08:00
sunli
aefe448ede Move project to async-graphql 2020-04-28 15:41:31 +08:00
sunli
c4b9b33f5f Update custom_scalars.md 2020-04-28 10:32:26 +08:00
sunli
1bc97de889 fix #33 2020-04-27 12:57:52 +08:00
sunli
28658dd11f Update quickstart.md 2020-04-22 11:20:41 +08:00
sunli
6bc7fa0d4f Update quickstart.md 2020-04-22 11:19:56 +08:00
sunli
e7b7291454 Update introduction.md 2020-04-22 11:18:58 +08:00
sunli
8b210ab0d2 Add some docs 2020-04-22 11:16:41 +08:00
sunli
59098a770b Add some docs 2020-04-22 10:30:21 +08:00
sunli
16438b9d32 Update custom_extensions.md 2020-04-19 21:29:05 +08:00
sunli
2bf3d72b0a Update custom_extensions.md 2020-04-19 21:26:41 +08:00
sunli
776719743c Add some docs 2020-04-19 10:28:52 +08:00
sunli
c233192545 The int64 scalar serializes to a string 2020-04-19 10:17:47 +08:00
sunli
b023d5c939 Update input_value_validators.md 2020-04-18 12:25:05 +08:00
sunli
bcfa066838 Update integrations_to_actix_web.md 2020-04-17 19:38:43 +08:00
sunli
67c0b908a0 Update subscription.md 2020-04-17 19:35:14 +08:00
sunli
1fa3691a3a Update docs 2020-04-17 19:33:28 +08:00
sunli
92e1fc1a5b Update integrations 2020-04-17 18:23:48 +08:00
sunli
f438678fbf Add some docs 2020-04-17 18:22:24 +08:00
sunli
2c664bb7d7 Add some docs
v1.9.2
2020-04-17 11:06:33 +08:00
sunli
20c132406c Add some docs 2020-04-16 17:51:10 +08:00
sunli
51ea8696ac Add some docs 2020-04-16 17:06:46 +08:00
sunli
11000b42d3 Add some docs 2020-04-16 15:09:09 +08:00
sunli
62f4b069d5 Update define_enum 2020-04-16 11:51:23 +08:00
sunli
d7ff639fa3 Add some docs 2020-04-16 11:06:09 +08:00
sunli
a358088d74 Add some docs 2020-04-16 10:22:57 +08:00
sunli
d1fedd75da Update book 2020-04-15 17:19:26 +08:00
sunli
fa39607d0f Update book.yml 2020-04-15 12:32:48 +08:00
sunli
f4d30cfd4f Update book.yml 2020-04-15 12:31:19 +08:00
sunli
cba47982df Update book 2020-04-15 12:26:40 +08:00
sunli
643f1d4906 Add docs 2020-04-15 11:15:30 +08:00