# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-graphql-core
VERSION=		3.2.5
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		GraphQL implementation (3.12)
SDESC[v13]=		GraphQL implementation (3.13)
HOMEPAGE=		https://github.com/graphql-python/graphql-core
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/e3/dc/078bd6b304de790618ebb95e2aedaadb78f4527ac43a9ad8815f006636b6
DISTFILE[1]=		graphql_core-3.2.5-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		graphql_core-3.2.5.dist-info

GENERATED=		yes

[PY312].USES_ON=			python:v12,wheel

[PY313].USES_ON=			python:v13,wheel

[FILE:3072:descriptions/desc.single]
# GraphQL-core 3

GraphQL-core 3 is a Python 3.6+ port of [GraphQL.js],
the JavaScript reference implementation for [GraphQL],
a query language for APIs created by Facebook.

[PyPI version]
[Documentation Status]
![Test Status]
![Lint Status]
[Code Style]

The current version 3.2.5 of GraphQL-core is up-to-date with GraphQL.js
version 16.8.2.

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].

The documentation for GraphQL.js can be found at [graphql.org/graphql-js/].

The documentation for GraphQL itself can be found at [graphql.org].

There will be also [blog articles] with more usage
examples.

## Getting started

A general overview of GraphQL is available in the
[README] for the
[Specification for GraphQL]. That overview
describes a simple set of GraphQL examples that exist as [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] 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


[FILE:125:distinfo]
2f150d5096448aa4f8ab26268567bbfeef823769893b39c1a2e1409590939c8a       203189 python-src/graphql_core-3.2.5-py3-none-any.whl