zero2prod_axum/README.md

62 lines
1.1 KiB
Markdown
Raw Normal View History

TODO: Add general information about this project
2023-12-25 16:46:41 +01:00
2024-01-01 14:34:42 +01:00
TODO: Explain usage of docker vs podman
TODO: add https://crates.io/crates/cargo-semver-checks
2024-01-01 14:34:42 +01:00
## TODO: explain DB migration
To migrate a already deployed and running database, use
```sh
SKIP_DB_RUN=true ./scripts/init_db.sh
```
2023-12-25 16:46:41 +01:00
## Contribution
Conventions are enforced through commitizen using pre-commit.
2023-12-25 16:46:41 +01:00
Commits that do not comply with the conventions will be rejected.
Prerequisites for developers are:
2023-12-25 16:56:26 +01:00
- podman
2023-12-25 16:46:41 +01:00
- postgresql-client
2023-12-25 16:56:26 +01:00
- sqlx
- commitizen
- pre-commit
Current contribution workflow is:
0. TODO: fork/clone repo and install commitizen and pre-commit
1. Modify repo
2. Use `cz c` to add a commit
3. Push changes
4. Open pull/merge request
2024-01-30 16:19:19 +01:00
## Maintainance
**Versioning:**
2024-02-04 13:48:31 +01:00
2024-01-30 16:19:19 +01:00
TODO; explain versioning
**Check for unused dependencies:**
2024-02-04 13:48:31 +01:00
Requirement: Needs `cargo install cargo-udeps --locked`
2024-01-30 16:19:19 +01:00
```sh
cargo +nightly udeps --all-targets
```
2024-02-04 13:48:31 +01:00
2024-02-12 10:56:26 +01:00
**Test with more output:**
```sh
cargo test -- --nocapture
```
2024-02-04 13:48:31 +01:00
**Test with tracing output:**
Requirement: Needs `cargo install bunyan`
```sh
TEST_LOG=true cargo test | bunyan
```