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

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

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/0a/14/933037032608787fb92e365883ad6a741c235e0ff992865ec5d904a38f1e
DISTFILE[1]=		graphql_core-3.2.7-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

DISTNAME=		graphql_core-3.2.7.dist-info

GENERATED=		yes

[PY313].USES_ON=			python:v13,wheel

[PY314].USES_ON=			python:v14,wheel

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

GraphQL-core 3 is a Python 3.7+ 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.7 of GraphQL-core is up-to-date with GraphQL.js
version 16.9.0.

An extensive test suite with over 2500 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.
Changes 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 using something like `~= 3.2.0` as the 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


[FILE:125:distinfo]
17fc8f3ca4a42913d8e24d9ac9f08deddf0a0b2483076575757f6c412ead2ec0       207262 python-src/graphql_core-3.2.7-py3-none-any.whl