# testing

> Run tests, linting, and formatting checks for dotenvage

- Author: Jacobus Geluk
- Repository: agnos-ai/dotenvage
- Version: 20260129151134
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/agnos-ai/dotenvage
- Web: https://mule.run/skillshub/@@agnos-ai/dotenvage~testing:20260129151134

---

---
name: testing
description:
  Run tests, linting, and formatting checks for dotenvage
---

# Testing Skill

Use this skill when running tests, checking code quality, or verifying
the codebase compiles and passes all checks.

## Running Tests

```bash
# Run all tests
cargo test

# Run a specific test
cargo test test_name

# Run tests with output
cargo test -- --nocapture
```

## Formatting

Formatting requires the nightly toolchain:

```bash
# Check formatting (CI mode)
cargo +nightly fmt --all -- --check

# Apply formatting fixes
cargo +nightly fmt --all
```

## Linting with Clippy

Clippy also requires nightly with strict settings:

```bash
cargo +nightly clippy --all-targets --all-features -- -D warnings -W missing-docs
```

This enforces:

- All warnings as errors (`-D warnings`)
- Documentation on all public items (`-W missing-docs`)
- Max 120 lines per function
- Max nesting depth of 5

## Full Check Workflow

Run all checks in sequence:

```bash
cargo +nightly fmt --all -- --check && \
cargo +nightly clippy --all-targets --all-features -- -D warnings -W missing-docs && \
cargo test
```

## Building

```bash
# Debug build
cargo build

# Release build
cargo build --release

# Check only (faster, no codegen)
cargo check
```

## NPM Package Testing

For the N-API bindings:

```bash
cd npm/dotenvage-napi
cargo build
npm test
```

## Git Hooks (Automatic Checks)

Git hooks in `.githooks/` run automatically on commit via Rhusky:

- **pre-commit**: Runs fmt and clippy on Rust files
- **commit-msg**: Validates conventional commit format with scope
- **post-commit**: Verifies commit signature

If hooks aren't active, run `cargo build` to trigger Rhusky
installation. Hooks are skipped in CI environments.

## Common Issues

### Nightly toolchain not installed

```bash
rustup install nightly
```

### Missing docs warning

All public items need documentation. Add doc comments:

```rust
/// Brief description of the function.
pub fn my_function() {}
```