Goodnessuc / pavex_tutorial_examples

LogRocket Article Pavex tutorial code

pavex_tutorial

Getting started

Prerequisites

• Rust
• cargo-px
• Pavex

Useful commands

This API is built using the Pavex web framework, which relies on code generation.
You need to use the cargo px command instead of cargo: it ensures that the server_sdk crate is correctly regenerated when the application blueprint changes.

cargo px is a wrapper around cargo that will automatically regenerate the server SDK when needed. Check out its documentation for more details.

Build

cargo px build

Run

cargo px run

Test

cargo px test

Configuration

All configurable parameters are listed in server/src/configuration/schema.rs.

Configuration values are loaded from two sources:

• Configuration files
• Environment variables

Environment variables take precedence over configuration files.

All configuration files are in the server/configuration folder. The application can be run in two different profiles: dev and prod.
The settings that you want to share across all profiles should be placed in server/configuration/base.yml. Profile-specific configuration files can be then used to override or supply additional values on top of the default settings ( e.g. server/configuration/dev.yml).

You can specify the app profile that you want to use by setting the APP_PROFILE environment variable; e.g.:

APP_PROFILE=prod cargo px run

for running the application with the prod profile.

By default, the dev profile is used since APP_PROFILE is set to dev in the .env file at the root of the project. The .env file should not be committed to version control: it is meant to be used for local development only, so that each developer can specify their own environment variables for secret values (e.g. database credentials) that shouldn't be stored in configuration files (given their sensitive nature).