reinhardt-admin-cli

Global command-line tool for Reinhardt project management.

Overview

reinhardt-admin-cli is the Django's django-admin equivalent for Reinhardt. It provides utilities for creating new projects and applications.

Installation

Install globally using cargo. While Reinhardt is on a pre-release (-rc.* / -alpha.*), cargo install requires an explicit --version because pre-releases are not selected by default. Once 0.1.0 stable ships, omit --version to pull the latest stable (or keep --version as an opt-in reproducibility pin). The literal below is auto-bumped by release-plz on each release.

cargo install reinhardt-admin-cli --version "0.1.0-rc.30"

This installs the reinhardt-admin command.

Usage

Create a New Project

# Create a RESTful API project
reinhardt-admin startproject myproject --with-rest

# Create a Pages (WASM + SSR) project
reinhardt-admin startproject myproject --with-pages

# Using --template flag (equivalent)
reinhardt-admin startproject myproject --template rest
reinhardt-admin startproject myproject --template pages

# Create project in a specific directory
reinhardt-admin startproject myproject --with-rest /path/to/directory

Create a New App

# Create a RESTful API app
reinhardt-admin startapp myapp --with-rest

# Create a Pages (WASM + SSR) app
reinhardt-admin startapp myapp --with-pages

# Using --template flag (equivalent)
reinhardt-admin startapp myapp --template rest
reinhardt-admin startapp myapp --template pages

# Create app in a specific directory
reinhardt-admin startapp myapp --with-rest /path/to/directory

Other Commands

# Display help
reinhardt-admin --help

# Display version
reinhardt-admin --version

Manage Plugins

Manage Reinhardt plugins (Dentdelion):

# List installed plugins
reinhardt-admin plugin list
reinhardt-admin plugin list --verbose
reinhardt-admin plugin list --enabled
reinhardt-admin plugin list --disabled

# Show plugin information
reinhardt-admin plugin info auth-delion
reinhardt-admin plugin info auth-delion --remote

# Install a plugin
reinhardt-admin plugin install auth-delion
reinhardt-admin plugin install auth-delion --version 0.1.0-rc.30

# Remove a plugin
reinhardt-admin plugin remove auth-delion

# Enable / disable a plugin
reinhardt-admin plugin enable auth-delion
reinhardt-admin plugin disable auth-delion

# Search for plugins on crates.io
reinhardt-admin plugin search auth

# Update plugin(s)
reinhardt-admin plugin update auth-delion
reinhardt-admin plugin update --all

Format All Code

Format all Rust files in the project (Rust + page! DSL):

# Format all files in the project
reinhardt-admin fmt-all

# Check formatting without modifying files
reinhardt-admin fmt-all --check

Format page! Macro DSL

Format page! macro DSL in your source files:

# Format all Rust files in the current directory
reinhardt-admin fmt .

# Format a specific file
reinhardt-admin fmt src/main.rs

# Check formatting without modifying files
reinhardt-admin fmt --check .

# Show all files (including unchanged)
reinhardt-admin fmt -v .

Ignore Markers

You can control which page! macros should be skipped during formatting by using special comment markers:

File-Wide Ignore

Skip formatting for the entire file by adding // reinhardt-fmt: ignore-all at the beginning (within the first 50 lines, before any code):

// reinhardt-fmt: ignore-all

use reinhardt_pages::prelude::*;

page!(|| { div{bad_format} })  // Will not be formatted

Range Ignore

Skip formatting for multiple macros within a range using // reinhardt-fmt: off and // reinhardt-fmt: on:

// reinhardt-fmt: off
page!(|| { div{bad1} })
page!(|| { span{bad2} })
// reinhardt-fmt: on

page!(|| { p { good } })  // This will be formatted

Individual Macro Ignore

Skip formatting for a specific macro by adding // reinhardt-fmt: ignore on the line immediately before it:

// reinhardt-fmt: ignore
page!(|| { div{bad} })

page!(|| { span { good } })  // This will be formatted

Priority Order

When multiple markers are present, they are applied in this priority order:

1. Individual marker (highest) - // reinhardt-fmt: ignore
2. Range marker (medium) - // reinhardt-fmt: off/on
3. File-wide marker (lowest) - // reinhardt-fmt: ignore-all

Notes

• Markers are case-sensitive and spaces are optional (e.g., //reinhardt-fmt:ignore also works)
• Individual markers must be on the line immediately before the macro (no blank lines)
• Range markers can span multiple macros
• Nested off markers will generate a warning but use the first off position
• Unclosed ranges (missing on) will extend to the end of the file

Verbosity Levels

• Default: Show formatted files, errors, and summary (with color output)
• -v: Also show unchanged files
• -vv: Show all file processing status (deprecated, same as -v)

Output Format

• Progress display: Shows current processing position in [1/50] format
• Color output:
  • Success (Formatted): Green
  • Error: Red
  • Unchanged: Gray (dimmed)
  • Progress counter: Blue

Example Output

$ reinhardt-admin fmt .
[1/47] Formatted: src/main.rs
[2/47] Formatted: src/config/settings.rs
[3/47] Error src/broken.rs: Parse error

Summary: 2 formatted, 45 unchanged, 1 errors

Django Equivalents

Project Templates

reinhardt-admin-cli includes two project templates:

• rest: RESTful API project (use --with-rest or --template rest)
• pages: WASM + SSR project with reinhardt-pages (use --with-pages or --template pages)

App Templates

Apps can be created in two forms:

• Module (default): Created in apps/ directory
• Workspace: Separate crate in workspace

Features

• Embedded Templates: Templates are compiled into the binary using rust-embed
• No External Dependencies: Works without internet connection
• Django-Compatible: Familiar interface for Django developers

Architecture

reinhardt-admin-cli depends on reinhardt-commands for its core functionality:

reinhardt-admin-cli (CLI binary)
    ↓
reinhardt-commands (Library)
    ↓
StartProjectCommand / StartAppCommand

License

Licensed under the BSD 3-Clause License.