Skip to content

Latest commit

 

History

History
77 lines (65 loc) · 1.96 KB

CONTRIBUTING.md

File metadata and controls

77 lines (65 loc) · 1.96 KB
Raw

Development

Prerequisites

Use the latest version of Rust.

On Linux, you'll need some additional system packages. Refer to the README for the list.

Commands

  • Run program:
    • cargo run
  • Run tests:
    • One-time setup:
      • Windows: 
        reg import tests/ludusavi.reg
cd tests/root3/game5
mklink /J data-symlink data
      • Other: 
        cd tests/root3/game5
ln -s data data-symlink
    • cargo test
  • Linting:
    • cargo fmt
    • cargo clippy --tests -- -D warnings
  • Activate pre-commit hooks (requires Python): 
    pip install --user pre-commit
pre-commit install

Environment variables

These are optional:

  • LUDUSAVI_VERSION:
    • If set, shown in the window title instead of the Cargo.toml version.
    • Intended for CI.
  • LUDUSAVI_VARIANT:
    • If set, shown in the window title in parentheses.
    • Intended for alternative builds, such as using different Iced renderers.

Icon

The master icon is assets/icon.kra, which you can edit using Krita and then export into the other formats.

Release preparation

Commands assume you are using Git Bash on Windows.

Dependencies (one-time)

pip install invoke
cargo install cargo-lichking

# Verified with commit ba58a5c44ccb7d2e0ca0238d833d17de17c2b53b:
curl -o /c/opt/flatpak-cargo-generator.py https://raw.githubusercontent.com/flatpak/flatpak-builder-tools/master/cargo/flatpak-cargo-generator.py
pip install aiohttp toml

Also install the Crowdin CLI manually.

Automated

Run:

invoke prerelease

Manual

  • Update version in CHANGELOG.md
  • Update version in Cargo.toml
  • Update version in assets/com.github.mtkennerly.ludusavi.metainfo.xml including the releases section and the screenshot URL.
  • Update the translation percentages in src/lang.rs
  • Run cargo build to update the version in Cargo.lock
  • Add the new version to .github/ISSUE_TEMPLATE/*.yaml.