Grapix project generator

Implements Mix task for generating modular GraphQL API projects using Absinthe and Phoenix. The generated API project comes with two OTP Application components and a helper library:

• lib/foo_project is a stipped-down Phoenix application, wired up to serve your GraphQL API at /graphql. It's also set up to serve subscriptions over websockets, and to serve the GraphiQL playground at /graphiql.

• lib/foo_project_api is where you implement your API, using the Absinthe DSL to define your GraphQL types, fields, and resolvers. Ingress checking is implemented out of the box for the root fields only by default, but you can easily tune to suit your needs

  If you generated your project with Ecto, or if your business logic requires a stateful server, then this module will be a child app, wired into the main supervisor tree.

• lib/foo_project_auth implements a JWT claims validation strategy, using Joken.

Testing Support

The generated project includes a skeletal test framework for validating GraphQL executable documents with parameters, and for testing actual queries against the defined Schema and business logic (the tests bypass the HTTP server, but they do not bypass ingress checking fucntionality).

Installation

If available in Hex, the generator task can be installed by with the archive installer:

    $ archive.install hex grapix_task