classify-client/README.md

Classify Client

This is an optimized version of the classify client endpoint in Normandy.

Dev instructions

This is a normal Cargo project, so after cloning the repository, you can build and run it with

$ cargo build
$ cargo run

This project should run on the latest stable version of Rust. Unstable features are not allowed.

GeoIP Database

A GeoIP database will be downloaded automatically during the build.

Note: It relies on curl and tar commands. See build.rs for insights about how to obtain the file manually in case the .mmdb file does not show up in the current folder.

Configuration

Via environment variables:

• HOST: host (default: "localhost")
• PORT: port number (default: "8080")
• GEOIP_DB_PATH: path to GeoIP database (default: "./GeoLite2-Country.mmdb")
• HUMAN_LOGS: set to true to use human readable logging (default: MozLog as JSON)
• SENTRY_DSN: report errors to a Sentry instance (default: "")
• VERSION_FILE: path to version.json file (default: "./version.json")
• SENTRY_DSN: report errors to a Sentry instance (default: "")
• DEBUG: A boolean that enables extra debugging options, such as a /debug endpoint that shows internal server state.
• TRUSTED_PROXY_LIST: A comma-separated list of CIDR ranges that trusted proxies will be in. Supports both IPv4 and IPv6.

Tests

Tests can be run with Cargo as well

$ cargo test

Linting

Linting is handled via Therapist. After installing it, enable the git hooks using either therapist install or therapist install --fix. The --fix variant will automatically format your code upon commit. The variant without --fix will simply show an error and ask you to reformat the code using other means before committing. Therapist runs in CI.

The checks Therapist runs are:

• Rustfmt
• Clippy, using the clippy::all preset