Flaxon 0.3.0 and Teloce-Py 0.3.0 are available on PyPI. Release instructions are maintained on this site; source links identify the framework snapshot. Check version and upgrade guidance.

GraphQL Example

This runnable example serves a small GraphQL API and a browser demo from the same Flaxon application. It includes queries, mutations, nested resolvers, GraphiQL, and the normal Flaxon health endpoints.

The directory is named grahql for compatibility with the existing example path. The application itself and the documentation use the correct GraphQL spelling.

Run it

From the repository root:

python -m pip install -e .
flaxon run docs.examples.grahql.app:app --reload

Open:

Demo UI: http://127.0.0.1:8000/
GraphQL endpoint: http://127.0.0.1:8000/graphql
GraphiQL: http://127.0.0.1:8000/graphql/graphiql
Altair: http://127.0.0.1:8000/graphql/altair

Copyable request

curl -X POST http://127.0.0.1:8000/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ users { id name email posts { id title } } }"}'

Create a user. Flaxon GraphQL's current parser expects arguments separated by spaces or newlines, not commas:

mutation {
  createUser(name: "Bob" email: "bob@example.com") {
    id
    name
    email
  }
}

The demo stores records in memory so it is deterministic and requires no database. For production, move the resolver reads and writes into a service or repository, add authentication and authorization, and use a persistent database. The browser page uses relative URLs, so it also works when the app is served on a non-local host.