moma/DEVELOP.md

Developer Guide

Version: 0.8.11 Last Updated: 2026-04-11

📘 For complete development documentation, see AGENTS.md

Quick reference for developers working on the moma project.

---

Quick Setup

# Install UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and setup
cd /Users/sha/Developer/sha.dev/moma
uv sync --extra dev

---

Essential Commands

# Run from source
uv run moma [directory]

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov=src

# Type check
uv run mypy src/

# Version bump
uv run bump-version

# Full release
uv run release

# Build distribution
uv build

---

Debugging

# Enable detailed logging
FORMATTER_LOG=1 uv run moma /path/to/directory

# Check logs
cat formatter.log

# Clear cache
rm -rf ~/.cache/moma/

---

Testing

# All tests
uv run pytest

# Specific file
uv run pytest src/test/test_services.py

# Verbose
uv run pytest -xvs

# Generate sample files
uv run python src/test/fill_sample_mediafiles.py

See AGENTS.md - Testing Strategy

---

Release Process

# 1. Bump version
uv run bump-version

# 2. Run full release
uv run release

# 3. Test installation
uv tool install .

# 4. Manual testing
uv run moma /path/to/test/media

See AGENTS.md - Release Process

---

Documentation

• AGENTS.md - Complete technical reference
• README.md - User guide
• INSTALL.md - Installation instructions
• CHANGELOG.md - Version history
• docs/REFACTORING_PROGRESS.md - Future plans
• docs/ToDo.md - Current tasks

---

For complete documentation, see AGENTS.md