Gitracker initial project

Author: s0b0lev

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run ruff format check
+        run: uv run ruff format --check .
+
+      - name: Run ruff linting
+        run: uv run ruff check .
+
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest -v --cov=gitrack --cov-report=xml --cov-report=term
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}
+        if: matrix.python-version == '3.12'

.gitignore

@@ -0,0 +1,56 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+.venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Ruff
+.ruff_cache/
+
+# GiTrack data
+.gitracker/
+
+# Distribution
+*.whl

.python-version

@@ -0,0 +1 @@
+3.12

README.md

@@ -0,0 +1,130 @@
+# GiTrack
+
+[![CI](https://github.com/yourusername/gitrack/actions/workflows/ci.yml/badge.svg)](https://github.com/yourusername/gitrack/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/yourusername/gitrack/branch/main/graph/badge.svg)](https://codecov.io/gh/yourusername/gitrack)
+[![PyPI version](https://badge.fury.io/py/gitrack.svg)](https://badge.fury.io/py/gitrack)
+
+Simple CLI tool to plan your work. Tasks are stored locally in a `.gitracker/` folder.
+
+## Installation
+
+```bash
+pip install gitrack
+```
+
+## Usage
+
+```bash
+$ gitrack [command] [options]
+```
+
+## Commands
+
+- `init`: Initialize a new GiTrack project
+- `add <task>`: Add a new task to your project
+- `list`: List all tasks (use `--all` to show completed tasks)
+- `complete <task_id>`: Mark a task as completed
+- `remove <task_id>`: Remove a task from your project
+
+## Example
+
+```bash
+# Initialize GiTrack in your project
+$ gitrack init
+✓ GiTrack initialized successfully!
+
+# Add some tasks
+$ gitrack add "Implement user authentication"
+✓ Added task: Implement user authentication
+ID: a1b2c3d4
+
+$ gitrack add "Write unit tests"
+✓ Added task: Write unit tests
+ID: e5f6g7h8
+
+# List all pending tasks
+$ gitrack list
+
+# Complete a task (you can use just the first few characters of the ID)
+$ gitrack complete a1b2
+
+# List all tasks including completed ones
+$ gitrack list --all
+
+# Remove a task
+$ gitrack remove e5f6
+```
+
+## Development
+
+### Setup
+
+1. Clone the repository
+2. Install development dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=gitrack --cov-report=html
+
+# Run specific test file
+pytest tests/test_cli.py
+```
+
+### Code Quality
+
+This project uses Ruff for linting and formatting:
+
+```bash
+# Check code
+ruff check .
+
+# Format code
+ruff format .
+
+# Check and fix
+ruff check --fix .
+```
+
+### Project Structure
+
+```
+gitrack/
+├── src/
+│   └── gitrack/
+│       ├── __init__.py
+│       ├── cli.py          # CLI interface
+│       ├── models.py       # Data models
+│       └── storage.py      # Storage handling
+├── tests/
+│   ├── conftest.py         # Pytest fixtures
+│   ├── test_cli.py         # CLI tests
+│   ├── test_models.py      # Model tests
+│   └── test_storage.py     # Storage tests
+├── pyproject.toml          # Project configuration
+└── README.md
+```
+
+### Building and Publishing
+
+```bash
+# Build the package
+pip install build
+python -m build
+
+# Upload to PyPI (requires credentials)
+pip install twine
+twine upload dist/*
+```
+
+## License
+
+MIT

pyproject.toml

@@ -0,0 +1,83 @@
+[project]
+name = "gitrack"
+version = "0.1.0"
+description = "Simple CLI tool to plan your work"
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    { name = "Your Name", email = "your.email@example.com" }
+]
+keywords = ["cli", "task", "planning", "productivity"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "click>=8.1.7",
+    "rich>=13.7.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+gitrack = "gitrack.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/yourusername/gitrack"
+Repository = "https://github.com/yourusername/gitrack"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gitrack"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--verbose",
+    "--cov=gitrack",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]  # unused imports in __init__.py
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

src/gitrack/__init__.py

@@ -0,0 +1,3 @@
+"""GiTrack - Simple CLI tool to plan your work."""
+
+__version__ = "0.1.0"