Skip to content

Commit 93d82fc

Browse files
committed
Mention other libs and roadmap in README
1 parent a291074 commit 93d82fc

File tree

1 file changed

+26
-6
lines changed

1 file changed

+26
-6
lines changed

README.md

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -170,16 +170,13 @@ GraphQL-core-next tries to reproduce the code of the reference implementation Gr
170170
in Python as closely as possible and to stay up-to-date with the latest development of
171171
GraphQL.js.
172172

173-
It has been created as an alternative and potential successor to
173+
It has been created as a modern alternative to
174174
[GraphQL-core](https://github.com/graphql-python/graphql-core), a prior work
175175
by Syrus Akbary, based on an older version of GraphQL.js and also targeting
176-
older Python versions. GraphQL-core also serves as as the foundation for
177-
[Graphene](http://graphene-python.org/), a more high-level framework for building
178-
GraphQL APIs in Python. Some parts of GraphQL-core-next have been inspired by
176+
older Python versions. Some parts of GraphQL-core-next have been inspired by
179177
GraphQL-core or directly taken over with only slight modifications, but most of the code
180178
has been re-implemented from scratch, replicating the latest code in GraphQL.js very
181-
closely and adding type hints for Python. Though GraphQL-core has also been updated and
182-
modernized to some extend, it might be replaced by GraphQL-core-next in the future.
179+
closely and adding type hints for Python.
183180

184181
Design goals for the GraphQL-core-next library are:
185182

@@ -201,6 +198,29 @@ Some restrictions (mostly in line with the design goals):
201198
* the benchmarks have not yet been ported to Python
202199

203200

201+
## Integration with other libraries and roadmap
202+
203+
* [Graphene](http://graphene-python.org/) is a more high-level framework for building
204+
GraphQL APIs in Python, and there is already a whole ecosystem of libraries, server
205+
integrations and tools built on top of Graphene. Most of this Graphene ecosystem has
206+
also been created by Syrus Akbary, who meanwhile has handed over the maintenance
207+
and future development to members of the GraphQL-Python community.
208+
209+
The current version 2 of Graphene is using Graphql-core as core library for much of
210+
the heavy lifting. Note that it is not compatible with GraphQL-core-next.
211+
The new version 3 of Graphene however is planned to use GraphQL-core-next instead of
212+
GraphQL-core, and GraphQL-core-next will probably be renamed to Graphql-core 3.
213+
214+
* [Ariadne](https://github.com/mirumee/ariadne) is a Python library for implementing
215+
GraphQL servers using schema-first approach created by Rafał Pitoń.
216+
217+
Ariadne is already using GraphQL-core-next as its GraphQL implementation.
218+
219+
* [Strawberry](https://github.com/strawberry-graphql/strawberry), created by Patrick
220+
Arminio, is a new GraphQL library for Python 3, inspired by dataclasses,
221+
that is also using GraphQL-core-next as underpinning.
222+
223+
204224
## Changelog
205225

206226
Changes are tracked as

0 commit comments

Comments
 (0)