Skills

A skill is a package of structured files that teaches an AI coding agent how to work with a specific tool or framework. The skill below was generated by Great Docs from this project’s documentation. Install it in your agent and it will be able to run commands, edit configuration, write content, and troubleshoot problems without step-by-step guidance from you.

Any agent — install with npx:

npx skills add https://databooth.github.io/pytest-just/

Codex / OpenCode

Tell the agent:
Fetch the skill file at https://databooth.github.io/pytest-just/skill.md and follow the instructions.

Manual — download the skill file:

curl -O https://databooth.github.io/pytest-just/skill.md

Or browse the SKILL.md file.

SKILL.md

---
name: pytest-just
description: >
  A pytest plugin for testing justfile recipes. Use when writing Python code that uses the pytest_just package.
license: MIT
compatibility: Requires Python >=3.10.
---

# pytest-just

A pytest plugin for testing justfile recipes

## Installation

```bash
pip install pytest-just
```

## API overview

### Classes

Core classes

- `JustfileFixture`: Helper for inspecting recipes and asserting justfile contract behaviour

### JustfileFixture Methods

Methods for the JustfileFixture class

- `JustfileFixture.recipe_names`
- `JustfileFixture.dependencies`
- `JustfileFixture.parameters`
- `JustfileFixture.parameter_names`
- `JustfileFixture.is_shebang`
- `JustfileFixture.is_private`
- `JustfileFixture.doc`
- `JustfileFixture.body`
- `JustfileFixture.show`
- `JustfileFixture.assignments`
- `JustfileFixture.aliases`
- `JustfileFixture.assert_exists`
- `JustfileFixture.assert_depends_on`
- `JustfileFixture.assert_parameter`
- `JustfileFixture.assert_body_contains`
- `JustfileFixture.assert_not_shebang`
- `JustfileFixture.assert_variable_referenced`
- `JustfileFixture.dry_run`
- `JustfileFixture.assert_dry_run_contains`

### Exceptions

Exception classes

- `JustCommandError`: Raised when invoking `just` fails
- `JustJsonFormatError`: Raised when `just --dump` JSON is malformed or incompatible
- `UnknownRecipeError`: Raised when a requested recipe does not exist

## Resources

- [Full documentation](https://databooth.github.io/pytest-just/)
- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Comprehensive documentation for LLMs