{"id":13469220,"url":"https://github.com/mirumee/ariadne","last_synced_at":"2025-05-08T22:18:39.730Z","repository":{"id":37984210,"uuid":"140265025","full_name":"mirumee/ariadne","owner":"mirumee","description":"Python library for implementing GraphQL servers using schema-first approach.","archived":false,"fork":false,"pushed_at":"2025-04-18T07:41:34.000Z","size":3100,"stargazers_count":2271,"open_issues_count":40,"forks_count":186,"subscribers_count":39,"default_branch":"main","last_synced_at":"2025-05-07T20:59:42.010Z","etag":null,"topics":["api","apollo-graphql","apollo-python","ariadne","asgi","django","django-graphql","graphql","graphql-python","graphql-server","python"],"latest_commit_sha":null,"homepage":"https://ariadnegraphql.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mirumee.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-07-09T09:46:17.000Z","updated_at":"2025-05-06T08:14:29.000Z","dependencies_parsed_at":"2024-01-08T11:09:23.721Z","dependency_job_id":"d95be426-309d-4f31-85d8-82fcd934a9de","html_url":"https://github.com/mirumee/ariadne","commit_stats":{"total_commits":1505,"total_committers":87,"mean_commits":"17.298850574712645","dds":0.5581395348837209,"last_synced_commit":"af244283987ef57c186a512a1186f819f4dd6e20"},"previous_names":[],"tags_count":54,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirumee%2Fariadne","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirumee%2Fariadne/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirumee%2Fariadne/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirumee%2Fariadne/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mirumee","download_url":"https://codeload.github.com/mirumee/ariadne/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252959066,"owners_count":21831778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","apollo-graphql","apollo-python","ariadne","asgi","django","django-graphql","graphql","graphql-python","graphql-server","python"],"created_at":"2024-07-31T15:01:29.530Z","updated_at":"2025-05-07T21:36:24.530Z","avatar_url":"https://github.com/mirumee.png","language":"Python","funding_links":[],"categories":["Python","Libraries","GraphQL","GraphQL Utilities","Implementations"],"sub_categories":["Python Libraries","Python"],"readme":"[![Ariadne](https://ariadnegraphql.org/img/logo-horizontal-sm.png)](https://ariadnegraphql.org)\n\n[![Documentation](https://img.shields.io/badge/docs-ariadnegraphql.org-brightgreen.svg)](https://ariadnegraphql.org)\n[![Codecov](https://codecov.io/gh/mirumee/ariadne/branch/master/graph/badge.svg)](https://codecov.io/gh/mirumee/ariadne)\n\n- - - - -\n\n# Ariadne\n\nAriadne is a Python library for implementing [GraphQL](http://graphql.github.io/) servers.\n\n- **Schema-first:** Ariadne enables Python developers to use schema-first approach to the API implementation. This is the leading approach used by the GraphQL community and supported by dozens of frontend and backend developer tools, examples, and learning resources. Ariadne makes all of this immediately available to you and other members of your team.\n- **Simple:** Ariadne offers small, consistent and easy to memorize API that lets developers focus on business problems, not the boilerplate.\n- **Open:** Ariadne was designed to be modular and open for customization. If you are missing or unhappy with something, extend or easily swap with your own.\n\nDocumentation is available [here](https://ariadnegraphql.org).\n\n\n## Features\n\n- Simple, quick to learn and easy to memorize API.\n- Compatibility with GraphQL.js version 15.5.1.\n- Queries, mutations and input types.\n- Asynchronous resolvers and query execution.\n- Subscriptions.\n- Custom scalars, enums and schema directives.\n- Unions and interfaces.\n- File uploads.\n- Defining schema using SDL strings.\n- Loading schema from `.graphql`, `.gql`, and `.graphqls` files.\n- WSGI middleware for implementing GraphQL in existing sites.\n- Apollo Tracing and [OpenTracing](http://opentracing.io) extensions for API monitoring.\n- Opt-in automatic resolvers mapping between `camelCase` and `snake_case`, and a `@convert_kwargs_to_snake_case` function decorator for converting `camelCase` kwargs to `snake_case`.\n- Built-in simple synchronous dev server for quick GraphQL experimentation and GraphQL Playground.\n- Support for [Apollo GraphQL extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=apollographql.vscode-apollo).\n- GraphQL syntax validation via `gql()` helper function. Also provides colorization if Apollo GraphQL extension is installed.\n- No global state or object registry, support for multiple GraphQL APIs in same codebase with explicit type reuse.\n- Support for `Apollo Federation`.\n\n\n## Installation\n\nAriadne can be installed with pip:\n\n```console\npip install ariadne\n```\n\nAriadne requires Python 3.9 or higher.\n\n\n## Quickstart\n\nThe following example creates an API defining `Person` type and single query field `people` returning a list of two persons. It also starts a local dev server with [GraphQL Playground](https://github.com/prisma/graphql-playground) available on the `http://127.0.0.1:8000` address.\n\nStart by installing [uvicorn](http://www.uvicorn.org/), an ASGI server we will use to serve the API:\n\n```console\npip install uvicorn\n```\n\nThen create an `example.py` file for your example application:\n\n```python\nfrom ariadne import ObjectType, QueryType, gql, make_executable_schema\nfrom ariadne.asgi import GraphQL\n\n# Define types using Schema Definition Language (https://graphql.org/learn/schema/)\n# Wrapping string in gql function provides validation and better error traceback\ntype_defs = gql(\"\"\"\n    type Query {\n        people: [Person!]!\n    }\n\n    type Person {\n        firstName: String\n        lastName: String\n        age: Int\n        fullName: String\n    }\n\"\"\")\n\n# Map resolver functions to Query fields using QueryType\nquery = QueryType()\n\n# Resolvers are simple python functions\n@query.field(\"people\")\ndef resolve_people(*_):\n    return [\n        {\"firstName\": \"John\", \"lastName\": \"Doe\", \"age\": 21},\n        {\"firstName\": \"Bob\", \"lastName\": \"Boberson\", \"age\": 24},\n    ]\n\n\n# Map resolver functions to custom type fields using ObjectType\nperson = ObjectType(\"Person\")\n\n@person.field(\"fullName\")\ndef resolve_person_fullname(person, *_):\n    return \"%s %s\" % (person[\"firstName\"], person[\"lastName\"])\n\n# Create executable GraphQL schema\nschema = make_executable_schema(type_defs, query, person)\n\n# Create an ASGI app using the schema, running in debug mode\napp = GraphQL(schema, debug=True)\n```\n\nFinally run the server:\n\n```console\nuvicorn example:app\n```\n\nFor more guides and examples, please see the [documentation](https://ariadnegraphql.org).\n\n## Versioning policy ##\n`ariadne` follows a custom versioning scheme where the minor version increases for breaking changes, while the patch version increments for bug fixes, enhancements, and other non-breaking updates.\n\nSince `ariadne` has not yet reached a stable API, this approach is in place until version 1.0.0. Once the API stabilizes, the project will adopt [Semantic Versioning](https://semver.org/).\n\n\n## Contributing\n\nWe are welcoming contributions to Ariadne! If you've found a bug or issue, feel free to use [GitHub issues](https://github.com/mirumee/ariadne/issues). If you have any questions or feedback, don't hesitate to catch us on [GitHub discussions](https://github.com/mirumee/ariadne/discussions/).\n\nFor guidance and instructions, please see [CONTRIBUTING.md](CONTRIBUTING.md).\n\nWebsite and the docs have their own GitHub repository: [mirumee/ariadne-website](https://github.com/mirumee/ariadne-website)\n\nAlso make sure you follow [@AriadneGraphQL](https://twitter.com/AriadneGraphQL) on Twitter for latest updates, news and random musings!\n\n**Crafted with ❤️ by [Mirumee Software](http://mirumee.com)**\nhello@mirumee.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirumee%2Fariadne","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirumee%2Fariadne","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirumee%2Fariadne/lists"}