trenako

A website for model railway collectors.

Features

tbd

Tech Stack

• 🦀 Rust
• Cargo and cargo-make
• Docker / Docker compose

How to run

  git clone https://github.com/CarloMicieli/trenako
  cd trenako

  docker compose up

• The database admin webpage is available at http://localhost:9000/
• The open api documentation is available at http://localhost:9001/

Local development

All the most important tasks are defined in the Makefile.toml for cargo-make.

In order to install cargo-make just run the following command:

  cargo install --force cargo-make

To run the postgres database as detached docker container:

  cargo make docker-postgres-run

to execute the database migrations:

  cargo make db-migrate

The sqlx query! macro is checking the query commands against a live database, to avoid to fail the build when a database is not available the offline mode is handled saving the query information into a json file. To update the file run the following command:

  cargo make db-update-offline

Start the server

  cargo make run

    Finished dev [unoptimized + debuginfo] target(s) in 0.10s
     Running `target/debug/trenako`

 _                        _         
| |                      | |        
| |_ _ __ ___ _ __   __ _| | _____  
| __| '__/ _ \ '_ \ / _` | |/ / _ \ 
| |_| | |  __/ | | | (_| |   < (_) |
 \__|_|  \___|_| |_|\__,_|_|\_\___/

Starting the server (127.0.0.1:5000)...

Environment variables

Variable	Description
SERVER__HOST	the server host name
SERVER__PORT	the server port number
DATABASE__NAME	the database name
DATABASE__USERNAME	the database username
DATABASE__PASSWORD	the database password
DATABASE__HOST	the database hostname
DATABASE__PORT	the database port number
DATABASE__REQUIRE_SSL	the database connection requires SSL
DATABASE__MIN_CONNECTIONS	the database min number of connections
DATABASE__MAX_CONNECTIONS	the database max number of connections
LOGGING__FORMAT	the logging format (allowed values: json, compact and pretty)
LOGGING__LEVEL	the logging format (allowed values: error, warn, info, debug, trace)

Checks

Run all tests with the following command:

  cargo make test

The rust code is following the rust formatting standard (via rustfmt), to check if the formatting is correct:

  cargo make fmt-check

To run the rust linter (clippy):

  cargo make clippy

Contribution

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's code of conduct.

License

Apache 2.0 License

   Copyright 2022 Carlo Micieli

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.