mirror of
https://github.com/shadoll/moma.git
synced 2026-08-28 03:27:34 +00:00
sha
2e652ae58a
feat: Introduce poster rendering views with multiple engines feat: Implement ASCII art poster renderer using PIL feat: Create base class for poster renderers feat: Add RichPixels renderer for high-quality terminal image display feat: Implement Viu terminal image viewer renderer feat: Add ProposedFilenameView for generating standardized filenames feat: Create RenameConfirmScreen for renaming files with confirmation feat: Implement SettingsScreen for configuring application settings feat: Add custom PosterWidget for rendering poster images
1.9 KiB
1.9 KiB
Developer Guide
Version: 0.7.0-dev Last Updated: 2026-01-01
📘 For complete development documentation, see ENGINEERING_GUIDE.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 ENGINEERING_GUIDE.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 ENGINEERING_GUIDE.md - Release Process
Documentation
- ENGINEERING_GUIDE.md - Complete technical reference
- README.md - User guide
- INSTALL.md - Installation instructions
- CHANGELOG.md - Version history
- REFACTORING_PROGRESS.md - Future plans
- ToDo.md - Current tasks
For complete documentation, see ENGINEERING_GUIDE.md