diff options
| author | CoprDistGit <copr-devel@lists.fedorahosted.org> | 2023-02-25 02:20:27 +0000 |
|---|---|---|
| committer | CoprDistGit <copr-devel@lists.fedorahosted.org> | 2023-02-25 02:20:27 +0000 |
| commit | 231c1f88af5257014c78bca2a992bbb0d2a07bf5 (patch) | |
| tree | 586ee666062aefe1fb3675f242617d7a4841b53c | |
| parent | 42531437e36d4cd6cd4b18dd88af0a845c8450ae (diff) | |
automatic import of python3-graphql-coreopeneuler20.03
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-graphql-core.spec | 822 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 824 insertions, 0 deletions
@@ -0,0 +1 @@ +/graphql-core-3.2.3.tar.gz diff --git a/python-graphql-core.spec b/python-graphql-core.spec new file mode 100644 index 0000000..88d3582 --- /dev/null +++ b/python-graphql-core.spec @@ -0,0 +1,822 @@ +%global _empty_manifest_terminate_build 0 +Name: python-graphql-core +Version: 3.2.3 +Release: 1 +Summary: GraphQL implementation for Python, a port of GraphQL.js, the JavaScript reference implementation for GraphQL. +License: MIT license +URL: https://github.com/graphql-python/graphql-core +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/ee/a6/94df9045ca1bac404c7b394094cd06713f63f49c7a4d54d99b773ae81737/graphql-core-3.2.3.tar.gz +BuildArch: noarch + +Requires: python3-typing-extensions + +%description +# GraphQL-core 3 + +GraphQL-core 3 is a Python 3.6+ port of [GraphQL.js](https://github.com/graphql/graphql-js), +the JavaScript reference implementation for [GraphQL](https://graphql.org/), +a query language for APIs created by Facebook. + +[](https://badge.fury.io/py/graphql-core) +[](https://graphql-core-3.readthedocs.io) + + +[](https://github.com/ambv/black) + +The current version 3.2.3 of GraphQL-core is up-to-date with GraphQL.js version 16.6.0. + +An extensive test suite with over 2300 unit tests and 100% coverage comprises a +replication of the complete test suite of GraphQL.js, making sure this port is +reliable and compatible with GraphQL.js. + +Note that for various reasons, GraphQL-core does not use SemVer like GraphQL.js. Increases in the major version of GraphQL.js are reflected in the minor version of GraphQL-core instead. This means there can be breaking changes in the API when the minor version changes, and only patch releases are fully backward compatible. Therefore, we recommend something like `=~ 3.2.0` as version specifier when including GraphQL-core as a dependency. + + +## Documentation + +A more detailed documentation for GraphQL-core 3 can be found at +[graphql-core-3.readthedocs.io](https://graphql-core-3.readthedocs.io/). + +The documentation for GraphQL.js can be found at [graphql.org/graphql-js/](https://graphql.org/graphql-js/). + +The documentation for GraphQL itself can be found at [graphql.org](https://graphql.org/). + +There will be also [blog articles](https://cito.github.io/tags/graphql/) with more usage +examples. + + +## Getting started + +A general overview of GraphQL is available in the +[README](https://github.com/graphql/graphql-spec/blob/main/README.md) for the +[Specification for GraphQL](https://github.com/graphql/graphql-spec). That overview +describes a simple set of GraphQL examples that exist as [tests](tests) in this +repository. A good way to get started with this repository is to walk through that +README and the corresponding tests in parallel. + + +## Installation + +GraphQL-core 3 can be installed from PyPI using the built-in pip command: + + python -m pip install graphql-core + +You can also use [poetry](https://github.com/python-poetry/poetry) for installation in a +virtual environment: + + poetry install + + +## Usage + +GraphQL-core provides two important capabilities: building a type schema and +serving queries against that type schema. + +First, build a GraphQL type schema which maps to your codebase: + +```python +from graphql import ( + GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=lambda obj, info: 'world') + })) +``` + +This defines a simple schema, with one type and one field, that resolves to a fixed +value. The `resolve` function can return a value, a co-routine object or a list of +these. It takes two positional arguments; the first one provides the root or the +resolved parent field, the second one provides a `GraphQLResolveInfo` object which +contains information about the execution state of the query, including a `context` +attribute holding per-request state such as authentication information or database +session. Any GraphQL arguments are passed to the `resolve` functions as individual +keyword arguments. + +Note that the signature of the resolver functions is a bit different in GraphQL.js, +where the context is passed separately and arguments are passed as a single object. +Also note that GraphQL fields must be passed as a `GraphQLField` object explicitly. +Similarly, GraphQL arguments must be passed as `GraphQLArgument` objects. + +A more complex example is included in the top-level [tests](tests) directory. + +Then, serve the result of a query against that type schema. + +```python +from graphql import graphql_sync + +source = '{ hello }' + +print(graphql_sync(schema, source)) +``` + +This runs a query fetching the one field defined, and then prints the result: + +```python +ExecutionResult(data={'hello': 'world'}, errors=None) +``` + +The `graphql_sync` function will first ensure the query is syntactically and +semantically valid before executing it, reporting errors otherwise. + +```python +from graphql import graphql_sync + +source = '{ BoyHowdy }' + +print(graphql_sync(schema, source)) +``` + +Because we queried a non-existing field, we will get the following result: + +```python +ExecutionResult(data=None, errors=[GraphQLError( + "Cannot query field 'BoyHowdy' on type 'RootQueryType'.", + locations=[SourceLocation(line=1, column=3)])]) +``` + +The `graphql_sync` function assumes that all resolvers return values synchronously. By +using coroutines as resolvers, you can also create results in an asynchronous fashion +with the `graphql` function. + +```python +import asyncio +from graphql import ( + graphql, GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + + +async def resolve_hello(obj, info): + await asyncio.sleep(3) + return 'world' + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=resolve_hello) + })) + + +async def main(): + query = '{ hello }' + print('Fetching the result...') + result = await graphql(schema, query) + print(result) + + +asyncio.run(main()) +``` + + +## Goals and restrictions + +GraphQL-core tries to reproduce the code of the reference implementation GraphQL.js +in Python as closely as possible and to stay up-to-date with the latest development of +GraphQL.js. + +GraphQL-core 3 (formerly known as GraphQL-core-next) has been created as a modern +alternative to [GraphQL-core 2](https://github.com/graphql-python/graphql-core-legacy), +a prior work by Syrus Akbary, based on an older version of GraphQL.js and also +targeting older Python versions. Some parts of GraphQL-core 3 have been inspired by +GraphQL-core 2 or directly taken over with only slight modifications, but most of the +code has been re-implemented from scratch, replicating the latest code in GraphQL.js +very closely and adding type hints for Python. + +Design goals for the GraphQL-core 3 library were: + +* to be a simple, cruft-free, state-of-the-art GraphQL implementation for current + Python versions +* to be very close to the GraphQL.js reference implementation, while still providing + a Pythonic API and code style +* to make extensive use of Python type hints, similar to how GraphQL.js used Flow + (and is now using TypeScript) +* to use [black](https://github.com/ambv/black) to achieve a consistent code style + while saving time and mental energy for more important matters +* to replicate the complete Mocha-based test suite of GraphQL.js + using [pytest](https://docs.pytest.org/) + with [pytest-describe](https://pypi.org/project/pytest-describe/) + +Some restrictions (mostly in line with the design goals): + +* requires Python 3.6 or newer +* does not support some already deprecated methods and options of GraphQL.js +* supports asynchronous operations only via async.io + (does not support the additional executors in GraphQL-core) + + +## Integration with other libraries and roadmap + +* [Graphene](http://graphene-python.org/) is a more high-level framework for building + GraphQL APIs in Python, and there is already a whole ecosystem of libraries, server + integrations and tools built on top of Graphene. Most of this Graphene ecosystem has + also been created by Syrus Akbary, who meanwhile has handed over the maintenance + and future development to members of the GraphQL-Python community. + + The current version 2 of Graphene is using Graphql-core 2 as core library for much of + the heavy lifting. Note that Graphene 2 is not compatible with GraphQL-core 3. + The new version 3 of Graphene will use GraphQL-core 3 instead of GraphQL-core 2. + +* [Ariadne](https://github.com/mirumee/ariadne) is a Python library for implementing + GraphQL servers using schema-first approach created by Mirumee Software. + + Ariadne is already using GraphQL-core 3 as its GraphQL implementation. + +* [Strawberry](https://github.com/strawberry-graphql/strawberry), created by Patrick + Arminio, is a new GraphQL library for Python 3, inspired by dataclasses, + that is also using GraphQL-core 3 as underpinning. + + +## Changelog + +Changes are tracked as +[GitHub releases](https://github.com/graphql-python/graphql-core/releases). + + +## Credits and history + +The GraphQL-core 3 library +* has been created and is maintained by Christoph Zwerschke +* uses ideas and code from GraphQL-core 2, a prior work by Syrus Akbary +* is a Python port of GraphQL.js which has been developed by Lee Byron and others + at Facebook, Inc. and is now maintained + by the [GraphQL foundation](https://gql.foundation/join/) + +Please watch the recording of Lee Byron's short keynote on the +[history of GraphQL](https://www.youtube.com/watch?v=VjHWkBr3tjI) +at the open source leadership summit 2019 to better understand +how and why GraphQL was created at Facebook and then became open sourced +and ported to many different programming languages. + + +## License + +GraphQL-core 3 is +[MIT-licensed](./LICENSE), +just like GraphQL.js. + + + + +%package -n python3-graphql-core +Summary: GraphQL implementation for Python, a port of GraphQL.js, the JavaScript reference implementation for GraphQL. +Provides: python-graphql-core +BuildRequires: python3-devel +BuildRequires: python3-setuptools +%description -n python3-graphql-core +# GraphQL-core 3 + +GraphQL-core 3 is a Python 3.6+ port of [GraphQL.js](https://github.com/graphql/graphql-js), +the JavaScript reference implementation for [GraphQL](https://graphql.org/), +a query language for APIs created by Facebook. + +[](https://badge.fury.io/py/graphql-core) +[](https://graphql-core-3.readthedocs.io) + + +[](https://github.com/ambv/black) + +The current version 3.2.3 of GraphQL-core is up-to-date with GraphQL.js version 16.6.0. + +An extensive test suite with over 2300 unit tests and 100% coverage comprises a +replication of the complete test suite of GraphQL.js, making sure this port is +reliable and compatible with GraphQL.js. + +Note that for various reasons, GraphQL-core does not use SemVer like GraphQL.js. Increases in the major version of GraphQL.js are reflected in the minor version of GraphQL-core instead. This means there can be breaking changes in the API when the minor version changes, and only patch releases are fully backward compatible. Therefore, we recommend something like `=~ 3.2.0` as version specifier when including GraphQL-core as a dependency. + + +## Documentation + +A more detailed documentation for GraphQL-core 3 can be found at +[graphql-core-3.readthedocs.io](https://graphql-core-3.readthedocs.io/). + +The documentation for GraphQL.js can be found at [graphql.org/graphql-js/](https://graphql.org/graphql-js/). + +The documentation for GraphQL itself can be found at [graphql.org](https://graphql.org/). + +There will be also [blog articles](https://cito.github.io/tags/graphql/) with more usage +examples. + + +## Getting started + +A general overview of GraphQL is available in the +[README](https://github.com/graphql/graphql-spec/blob/main/README.md) for the +[Specification for GraphQL](https://github.com/graphql/graphql-spec). That overview +describes a simple set of GraphQL examples that exist as [tests](tests) in this +repository. A good way to get started with this repository is to walk through that +README and the corresponding tests in parallel. + + +## Installation + +GraphQL-core 3 can be installed from PyPI using the built-in pip command: + + python -m pip install graphql-core + +You can also use [poetry](https://github.com/python-poetry/poetry) for installation in a +virtual environment: + + poetry install + + +## Usage + +GraphQL-core provides two important capabilities: building a type schema and +serving queries against that type schema. + +First, build a GraphQL type schema which maps to your codebase: + +```python +from graphql import ( + GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=lambda obj, info: 'world') + })) +``` + +This defines a simple schema, with one type and one field, that resolves to a fixed +value. The `resolve` function can return a value, a co-routine object or a list of +these. It takes two positional arguments; the first one provides the root or the +resolved parent field, the second one provides a `GraphQLResolveInfo` object which +contains information about the execution state of the query, including a `context` +attribute holding per-request state such as authentication information or database +session. Any GraphQL arguments are passed to the `resolve` functions as individual +keyword arguments. + +Note that the signature of the resolver functions is a bit different in GraphQL.js, +where the context is passed separately and arguments are passed as a single object. +Also note that GraphQL fields must be passed as a `GraphQLField` object explicitly. +Similarly, GraphQL arguments must be passed as `GraphQLArgument` objects. + +A more complex example is included in the top-level [tests](tests) directory. + +Then, serve the result of a query against that type schema. + +```python +from graphql import graphql_sync + +source = '{ hello }' + +print(graphql_sync(schema, source)) +``` + +This runs a query fetching the one field defined, and then prints the result: + +```python +ExecutionResult(data={'hello': 'world'}, errors=None) +``` + +The `graphql_sync` function will first ensure the query is syntactically and +semantically valid before executing it, reporting errors otherwise. + +```python +from graphql import graphql_sync + +source = '{ BoyHowdy }' + +print(graphql_sync(schema, source)) +``` + +Because we queried a non-existing field, we will get the following result: + +```python +ExecutionResult(data=None, errors=[GraphQLError( + "Cannot query field 'BoyHowdy' on type 'RootQueryType'.", + locations=[SourceLocation(line=1, column=3)])]) +``` + +The `graphql_sync` function assumes that all resolvers return values synchronously. By +using coroutines as resolvers, you can also create results in an asynchronous fashion +with the `graphql` function. + +```python +import asyncio +from graphql import ( + graphql, GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + + +async def resolve_hello(obj, info): + await asyncio.sleep(3) + return 'world' + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=resolve_hello) + })) + + +async def main(): + query = '{ hello }' + print('Fetching the result...') + result = await graphql(schema, query) + print(result) + + +asyncio.run(main()) +``` + + +## Goals and restrictions + +GraphQL-core tries to reproduce the code of the reference implementation GraphQL.js +in Python as closely as possible and to stay up-to-date with the latest development of +GraphQL.js. + +GraphQL-core 3 (formerly known as GraphQL-core-next) has been created as a modern +alternative to [GraphQL-core 2](https://github.com/graphql-python/graphql-core-legacy), +a prior work by Syrus Akbary, based on an older version of GraphQL.js and also +targeting older Python versions. Some parts of GraphQL-core 3 have been inspired by +GraphQL-core 2 or directly taken over with only slight modifications, but most of the +code has been re-implemented from scratch, replicating the latest code in GraphQL.js +very closely and adding type hints for Python. + +Design goals for the GraphQL-core 3 library were: + +* to be a simple, cruft-free, state-of-the-art GraphQL implementation for current + Python versions +* to be very close to the GraphQL.js reference implementation, while still providing + a Pythonic API and code style +* to make extensive use of Python type hints, similar to how GraphQL.js used Flow + (and is now using TypeScript) +* to use [black](https://github.com/ambv/black) to achieve a consistent code style + while saving time and mental energy for more important matters +* to replicate the complete Mocha-based test suite of GraphQL.js + using [pytest](https://docs.pytest.org/) + with [pytest-describe](https://pypi.org/project/pytest-describe/) + +Some restrictions (mostly in line with the design goals): + +* requires Python 3.6 or newer +* does not support some already deprecated methods and options of GraphQL.js +* supports asynchronous operations only via async.io + (does not support the additional executors in GraphQL-core) + + +## Integration with other libraries and roadmap + +* [Graphene](http://graphene-python.org/) is a more high-level framework for building + GraphQL APIs in Python, and there is already a whole ecosystem of libraries, server + integrations and tools built on top of Graphene. Most of this Graphene ecosystem has + also been created by Syrus Akbary, who meanwhile has handed over the maintenance + and future development to members of the GraphQL-Python community. + + The current version 2 of Graphene is using Graphql-core 2 as core library for much of + the heavy lifting. Note that Graphene 2 is not compatible with GraphQL-core 3. + The new version 3 of Graphene will use GraphQL-core 3 instead of GraphQL-core 2. + +* [Ariadne](https://github.com/mirumee/ariadne) is a Python library for implementing + GraphQL servers using schema-first approach created by Mirumee Software. + + Ariadne is already using GraphQL-core 3 as its GraphQL implementation. + +* [Strawberry](https://github.com/strawberry-graphql/strawberry), created by Patrick + Arminio, is a new GraphQL library for Python 3, inspired by dataclasses, + that is also using GraphQL-core 3 as underpinning. + + +## Changelog + +Changes are tracked as +[GitHub releases](https://github.com/graphql-python/graphql-core/releases). + + +## Credits and history + +The GraphQL-core 3 library +* has been created and is maintained by Christoph Zwerschke +* uses ideas and code from GraphQL-core 2, a prior work by Syrus Akbary +* is a Python port of GraphQL.js which has been developed by Lee Byron and others + at Facebook, Inc. and is now maintained + by the [GraphQL foundation](https://gql.foundation/join/) + +Please watch the recording of Lee Byron's short keynote on the +[history of GraphQL](https://www.youtube.com/watch?v=VjHWkBr3tjI) +at the open source leadership summit 2019 to better understand +how and why GraphQL was created at Facebook and then became open sourced +and ported to many different programming languages. + + +## License + +GraphQL-core 3 is +[MIT-licensed](./LICENSE), +just like GraphQL.js. + + + + +%package help +Summary: Development documents and examples for graphql-core +Provides: python3-graphql-core-doc +%description help +# GraphQL-core 3 + +GraphQL-core 3 is a Python 3.6+ port of [GraphQL.js](https://github.com/graphql/graphql-js), +the JavaScript reference implementation for [GraphQL](https://graphql.org/), +a query language for APIs created by Facebook. + +[](https://badge.fury.io/py/graphql-core) +[](https://graphql-core-3.readthedocs.io) + + +[](https://github.com/ambv/black) + +The current version 3.2.3 of GraphQL-core is up-to-date with GraphQL.js version 16.6.0. + +An extensive test suite with over 2300 unit tests and 100% coverage comprises a +replication of the complete test suite of GraphQL.js, making sure this port is +reliable and compatible with GraphQL.js. + +Note that for various reasons, GraphQL-core does not use SemVer like GraphQL.js. Increases in the major version of GraphQL.js are reflected in the minor version of GraphQL-core instead. This means there can be breaking changes in the API when the minor version changes, and only patch releases are fully backward compatible. Therefore, we recommend something like `=~ 3.2.0` as version specifier when including GraphQL-core as a dependency. + + +## Documentation + +A more detailed documentation for GraphQL-core 3 can be found at +[graphql-core-3.readthedocs.io](https://graphql-core-3.readthedocs.io/). + +The documentation for GraphQL.js can be found at [graphql.org/graphql-js/](https://graphql.org/graphql-js/). + +The documentation for GraphQL itself can be found at [graphql.org](https://graphql.org/). + +There will be also [blog articles](https://cito.github.io/tags/graphql/) with more usage +examples. + + +## Getting started + +A general overview of GraphQL is available in the +[README](https://github.com/graphql/graphql-spec/blob/main/README.md) for the +[Specification for GraphQL](https://github.com/graphql/graphql-spec). That overview +describes a simple set of GraphQL examples that exist as [tests](tests) in this +repository. A good way to get started with this repository is to walk through that +README and the corresponding tests in parallel. + + +## Installation + +GraphQL-core 3 can be installed from PyPI using the built-in pip command: + + python -m pip install graphql-core + +You can also use [poetry](https://github.com/python-poetry/poetry) for installation in a +virtual environment: + + poetry install + + +## Usage + +GraphQL-core provides two important capabilities: building a type schema and +serving queries against that type schema. + +First, build a GraphQL type schema which maps to your codebase: + +```python +from graphql import ( + GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=lambda obj, info: 'world') + })) +``` + +This defines a simple schema, with one type and one field, that resolves to a fixed +value. The `resolve` function can return a value, a co-routine object or a list of +these. It takes two positional arguments; the first one provides the root or the +resolved parent field, the second one provides a `GraphQLResolveInfo` object which +contains information about the execution state of the query, including a `context` +attribute holding per-request state such as authentication information or database +session. Any GraphQL arguments are passed to the `resolve` functions as individual +keyword arguments. + +Note that the signature of the resolver functions is a bit different in GraphQL.js, +where the context is passed separately and arguments are passed as a single object. +Also note that GraphQL fields must be passed as a `GraphQLField` object explicitly. +Similarly, GraphQL arguments must be passed as `GraphQLArgument` objects. + +A more complex example is included in the top-level [tests](tests) directory. + +Then, serve the result of a query against that type schema. + +```python +from graphql import graphql_sync + +source = '{ hello }' + +print(graphql_sync(schema, source)) +``` + +This runs a query fetching the one field defined, and then prints the result: + +```python +ExecutionResult(data={'hello': 'world'}, errors=None) +``` + +The `graphql_sync` function will first ensure the query is syntactically and +semantically valid before executing it, reporting errors otherwise. + +```python +from graphql import graphql_sync + +source = '{ BoyHowdy }' + +print(graphql_sync(schema, source)) +``` + +Because we queried a non-existing field, we will get the following result: + +```python +ExecutionResult(data=None, errors=[GraphQLError( + "Cannot query field 'BoyHowdy' on type 'RootQueryType'.", + locations=[SourceLocation(line=1, column=3)])]) +``` + +The `graphql_sync` function assumes that all resolvers return values synchronously. By +using coroutines as resolvers, you can also create results in an asynchronous fashion +with the `graphql` function. + +```python +import asyncio +from graphql import ( + graphql, GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString) + + +async def resolve_hello(obj, info): + await asyncio.sleep(3) + return 'world' + +schema = GraphQLSchema( + query=GraphQLObjectType( + name='RootQueryType', + fields={ + 'hello': GraphQLField( + GraphQLString, + resolve=resolve_hello) + })) + + +async def main(): + query = '{ hello }' + print('Fetching the result...') + result = await graphql(schema, query) + print(result) + + +asyncio.run(main()) +``` + + +## Goals and restrictions + +GraphQL-core tries to reproduce the code of the reference implementation GraphQL.js +in Python as closely as possible and to stay up-to-date with the latest development of +GraphQL.js. + +GraphQL-core 3 (formerly known as GraphQL-core-next) has been created as a modern +alternative to [GraphQL-core 2](https://github.com/graphql-python/graphql-core-legacy), +a prior work by Syrus Akbary, based on an older version of GraphQL.js and also +targeting older Python versions. Some parts of GraphQL-core 3 have been inspired by +GraphQL-core 2 or directly taken over with only slight modifications, but most of the +code has been re-implemented from scratch, replicating the latest code in GraphQL.js +very closely and adding type hints for Python. + +Design goals for the GraphQL-core 3 library were: + +* to be a simple, cruft-free, state-of-the-art GraphQL implementation for current + Python versions +* to be very close to the GraphQL.js reference implementation, while still providing + a Pythonic API and code style +* to make extensive use of Python type hints, similar to how GraphQL.js used Flow + (and is now using TypeScript) +* to use [black](https://github.com/ambv/black) to achieve a consistent code style + while saving time and mental energy for more important matters +* to replicate the complete Mocha-based test suite of GraphQL.js + using [pytest](https://docs.pytest.org/) + with [pytest-describe](https://pypi.org/project/pytest-describe/) + +Some restrictions (mostly in line with the design goals): + +* requires Python 3.6 or newer +* does not support some already deprecated methods and options of GraphQL.js +* supports asynchronous operations only via async.io + (does not support the additional executors in GraphQL-core) + + +## Integration with other libraries and roadmap + +* [Graphene](http://graphene-python.org/) is a more high-level framework for building + GraphQL APIs in Python, and there is already a whole ecosystem of libraries, server + integrations and tools built on top of Graphene. Most of this Graphene ecosystem has + also been created by Syrus Akbary, who meanwhile has handed over the maintenance + and future development to members of the GraphQL-Python community. + + The current version 2 of Graphene is using Graphql-core 2 as core library for much of + the heavy lifting. Note that Graphene 2 is not compatible with GraphQL-core 3. + The new version 3 of Graphene will use GraphQL-core 3 instead of GraphQL-core 2. + +* [Ariadne](https://github.com/mirumee/ariadne) is a Python library for implementing + GraphQL servers using schema-first approach created by Mirumee Software. + + Ariadne is already using GraphQL-core 3 as its GraphQL implementation. + +* [Strawberry](https://github.com/strawberry-graphql/strawberry), created by Patrick + Arminio, is a new GraphQL library for Python 3, inspired by dataclasses, + that is also using GraphQL-core 3 as underpinning. + + +## Changelog + +Changes are tracked as +[GitHub releases](https://github.com/graphql-python/graphql-core/releases). + + +## Credits and history + +The GraphQL-core 3 library +* has been created and is maintained by Christoph Zwerschke +* uses ideas and code from GraphQL-core 2, a prior work by Syrus Akbary +* is a Python port of GraphQL.js which has been developed by Lee Byron and others + at Facebook, Inc. and is now maintained + by the [GraphQL foundation](https://gql.foundation/join/) + +Please watch the recording of Lee Byron's short keynote on the +[history of GraphQL](https://www.youtube.com/watch?v=VjHWkBr3tjI) +at the open source leadership summit 2019 to better understand +how and why GraphQL was created at Facebook and then became open sourced +and ported to many different programming languages. + + +## License + +GraphQL-core 3 is +[MIT-licensed](./LICENSE), +just like GraphQL.js. + + + + +%prep +%autosetup -n graphql-core-3.2.3 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-graphql-core -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Sat Feb 25 2023 Python_Bot <Python_Bot@openeuler.org> - 3.2.3-1 +- Package Spec generated @@ -0,0 +1 @@ +49790781ef70f3dd1714b44d99e06e0e graphql-core-3.2.3.tar.gz |