A template for creating services in Rust using Axum, Prisma and async-graphql. This uses the super cool Prisma.

You'll want to have cargo-watch installed for the best DX, however it isn't required.

cargo install cargo-watch

Then you can run the cargo-watch -x run command to watch for changes and automatically rebuild the project.

To set up prisma, run:

1. cargo prisma generate create the prisma.rs file, see prisma/schema.prisma
2. cargo prisma db push sync the code and database

cargo prisma generate # outputs client to src/prisma.rs cargo prisma db push # outputs sqlite db to prisma/dev.db (specified in schema.prisma) cargo seed # seeds the database with some data (unimplemented, create a seed based on your needs)

For more in-depth information about the prisma client, see the Prisma Client Rust Docs.

To run the server, run:

cargo run # or cargo-watch -x run

Go to localhost:8080/api/graphql to see the playground. You can see the schema and the docs, but a few examples would be:

# Create user mutation { createUser(input: { displayName: "oromei" }) { id } } # Delete user mutation { deleteUser(id: "cf5a7caf-6e18-4759-bbfc-8da15978dec9") { id } } # Create post mutation { createPost( input: { content: "Woah there!" userId: "5ab80953-c38c-4ec8-8b4b-3ecc4bc1196f" } ) { id content user { displayName } } } # Get one user query { getUser(id: "cf5a7caf-6e18-4759-bbfc-8da15978dec9") { id displayName } } # Get all users query { getUsers { id displayName } } # Get one post query { getPost(id: "d97920e2-83fb-44d0-81c1-93e13b69b7ff") { id content user { id displayName } } } # Get all posts query { getPosts { id content user { displayName } } }

I will try to make it become a more and more complete

This template uses Axum, but the bulk of the setup is for async_graphql + prisma. You should be able to easily swap out Axum for your preferred framework (e.g. Rocket, actix, etc).

The simple use of async_graphql means that queries are done in a less efficient manner than could be, since fetching relations using with is never utilized and relations are loaded separately. Additionally, dataloader is not utilized because I can't be bothered.