Skip to content

chore: add a justfile for common dev commands - #1096

Open
splusq wants to merge 2 commits into
huggingface:mainfrom
splusq:chore/justfile
Open

chore: add a justfile for common dev commands#1096
splusq wants to merge 2 commits into
huggingface:mainfrom
splusq:chore/justfile

Conversation

@splusq

@splusq splusq commented Aug 28, 2026

Copy link
Copy Markdown

Wraps the commands already documented in CLAUDE.md so they are discoverable via just --list and harder to get subtly wrong.

recipe what it runs
just install uv sync --all-extras
just test the CI invocation, same --ignore set and marker filter
just test-one <target> one file or pattern
just lint usort check + ruff format --check + ruff check
just format usort format + ruff format
just docs-sync scripts/sync_env_docs.py --fix

just test deliberately mirrors .github/workflows/test.yml rather than being a simpler pytest tests/, so a green local run means the same thing CI does.

Independent of the RFC 005 work I have open alongside this; split out so it can land or be dropped on its own.


Note

Low Risk
Developer-only task runner; no runtime, auth, or deployment behavior changes.

Overview
Adds a root justfile so common OpenEnv dev workflows are listed via just instead of copying commands from docs.

It sets PYTHONPATH=src:envs for recipes and wires just install to uv sync --all-extras. just test runs pytest with the same ignored env tests and marker filter as .github/workflows/test.yml, so local runs match CI. just test-one <target> runs a single file or pattern with the same pytest verbosity options.

Reviewed by Cursor Bugbot for commit c3c04f8. Bugbot is set up for automated code reviews on this repo. Configure here.

Wraps the commands already documented in CLAUDE.md (install, test, lint,
format, docs-sync) so they are discoverable via `just --list` and harder
to get subtly wrong. `just test` mirrors the CI invocation, including the
same --ignore set and marker filter.

Independent of the RFC 005 work; split out so it can land or be dropped
on its own.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@splusq
splusq marked this pull request as ready for review August 31, 2026 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant