61 lines
1.1 KiB
Markdown
61 lines
1.1 KiB
Markdown
TODO: Add general information about this project
|
|
|
|
TODO: Explain usage of docker vs podman
|
|
|
|
TODO: add https://crates.io/crates/cargo-semver-checks
|
|
|
|
## TODO: explain DB migration
|
|
|
|
To migrate a already deployed and running database, use
|
|
```sh
|
|
SKIP_DB_RUN=true ./scripts/init_db.sh
|
|
```
|
|
|
|
## Contribution
|
|
|
|
Conventions are enforced through commitizen using pre-commit.
|
|
Commits that do not comply with the conventions will be rejected.
|
|
|
|
Prerequisites for developers are:
|
|
|
|
- podman
|
|
- postgresql-client
|
|
- 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
|
|
|
|
## Maintainance
|
|
|
|
**Versioning:**
|
|
|
|
TODO; explain versioning
|
|
|
|
**Check for unused dependencies:**
|
|
|
|
Requirement: Needs `cargo install cargo-udeps --locked`
|
|
|
|
```sh
|
|
cargo +nightly udeps --all-targets
|
|
```
|
|
|
|
**Test with more output:**
|
|
|
|
```sh
|
|
cargo test -- --nocapture
|
|
```
|
|
|
|
**Test with tracing output:**
|
|
|
|
Requirement: Needs `cargo install bunyan`
|
|
|
|
```sh
|
|
TEST_LOG=true cargo test | bunyan
|
|
```
|