Jefe

A comprehensive Git repository management system with web and CLI interfaces.

Features

• Web Interface: Modern web-based UI for repository management
• CLI Tool: Command-line interface for automation and scripting
• Server API: RESTful API for programmatic access
• Repository Adapters: Integration with various Git hosting platforms
• Data Management: Robust data persistence and querying

Quick Start

Prerequisites

• Python 3.11 or higher
• uv package manager (recommended) or pip

Installation

# Using uv (recommended)
uv sync

# Or using pip
pip install -e ".[dev]"

Verification

# Test import
python -c "import jefe; print(jefe.__version__)"

# Run tests
pytest

# Type checking
mypy src/jefe

# Linting
ruff check src/jefe

Project Structure

jefe/
├── src/jefe/
│   ├── server/          # API and server components
│   ├── cli/             # Command-line interface
│   ├── web/             # Web interface components
│   ├── adapters/        # Integration adapters
│   └── data/            # Data models and database
├── tests/               # Test suite
├── pyproject.toml       # Project configuration
└── README.md            # This file

Development

Running Tests

pytest

# With coverage
pytest --cov=src/jefe

Type Checking

mypy src/jefe

Code Quality

# Linting
ruff check src/jefe

# Formatting
black src/jefe
ruff check --fix src/jefe

# Organize imports
isort src/jefe

License

MIT License - See LICENSE file for details

Contributing

Contributions welcome! Please ensure:

• All tests pass: pytest
• Type checking passes: mypy src/jefe
• Code is formatted: ruff format . && black .