This repository contain a fully working example of a service written with actix. It is meant to be as close as production ready as possible while remaining minimal and easy to understand. The service itself is a basic Create / Read / Update / Delete of a todo list, showcasing good production practices for web applications
- A fast web service in an extensible port and adapter pattern, using dependency injection
- Documented sources you can play around and make experimental changes with
- Multi stage docker file for building minimal images
- API documentation and manual testing with Swagger UI, Redoc, Rapi
- Async postgres client storage example
- Unit testing using fixtures
- Integration testing
- Access logging
Run docker compose up -d. On the first creation of db, it sends too soon a ready signal which may crash the web app. You may do docker compose start app to restart the service
Out of the box you will need a running postgres local instance. The code is provided without Tls option enabled. Once your postgres server is running, simply cargo run. Alternatively
you can use an in-memory store provided. Swapping storage method is only a couple of line changes in the main.rs.
- Unit testing
cargo test --lib --bins - Integration testing
cargo test --test '*'. You will need to run the server instance to be able to pass integration test. See notes in the source file.
MIT Meant to be used, derived or commercialised freely and openly anywhere.