Skip to content

Conversation

@kjaymiller
Copy link
Contributor

Summary

This PR adds a justfile to streamline common development tasks for the Black Python Devs website. The justfile provides convenient command recipes that wrap common operations using uv for package management.

Available Recipes

  • just install - Install project dependencies using uv
  • just serve - Run the development server with live reload
  • just build - Build the static site for production
  • just test - Run the test suite with pytest
  • just lint - Check code quality with ruff
  • just format - Format code with ruff
  • just pre-commit-run - Run all pre-commit hooks
  • just clean - Remove build artifacts and cache directories
  • just dev - Full development setup (install + pre-commit + serve)

Usage

After installing just, you can run any recipe:

just build
just test
just dev

Run just without arguments to see all available recipes.

Benefits

  • Consistent command interface across the project
  • All commands properly use uv for package management
  • Simplifies onboarding for new contributors
  • Reduces need to remember specific command syntax

🤖 Generated with Claude Code

This commit adds a justfile that provides convenient shortcuts for common
development tasks in the Black Python Devs website repository.

The justfile includes commands for:
- install: Install dependencies using uv sync
- serve: Run the render-engine development server
- build: Build the static site
- test: Run pytest tests (with verbose and coverage variants)
- lint: Run ruff checks and format validation
- format: Format code using ruff
- pre-commit-run: Execute pre-commit hooks
- clean: Remove build artifacts and cache directories
- dev: Full development workflow (install, lint, test, build)

All commands properly use uv run to execute tools within the project's
virtual environment. This improves developer experience by providing
a consistent, discoverable interface for common tasks.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
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.

2 participants