Refactor: Codebase restructuring, added unit tests, CI workflow

.github/workflows/test.yaml

@@ -0,0 +1,42 @@
+name: Run Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/[email protected]
+
+      - name: Setup uv
+        uses: astral-sh/[email protected]
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/[email protected]
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Sync dependencies
+        run: uv sync --all-extras --dev --locked
+
+      - name: Run tests
+        run: uv run pytest --cov=acmsg --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/[email protected]
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+      - name: Check types with mypy
+        run: uv run mypy src/acmsg

.gitignore

@@ -3,3 +3,12 @@
 **/__pycache__
 **/*.egg-info
 dist/
+build/
+.pytest_cache/
+.coverage
+coverage.xml
+.mypy_cache/
+.ruff_cache/
+*.log
+.DS_Store
+justfile

MANIFEST.in

@@ -1,2 +1,4 @@
-include src/acmsg/assets/*.md
-include src/acmsg/assets/*.yaml
+include src/acmsg/templates/assets/*.md
+include src/acmsg/templates/assets/*.yaml
+include src/acmsg/*.py
+include src/acmsg/*/*.py

justfile

@@ -0,0 +1,27 @@
+default:
+  help
+
+help:
+    @just --list
+
+build:
+    @echo "Running uv build..."
+    uv build
+
+clean:
+    @echo "Cleaning cache dirs..."
+    uv clean
+    fd -uE .venv "__pycache__|.*_cache|dist|egg-info" | xargs rm -rf
+
+test: clean
+    @echo "Running tests..."
+    pytest
+    mypy src/acmsg
+
+sync:
+    @echo "Running uv sync..."
+    uv sync --all-packages --dev
+
+bump-version:
+    @echo "Running bump-version..."
+    nix run .#bump-version

pyproject.toml

@@ -18,6 +18,9 @@ dependencies = [
   "pyyaml (>=6.0.2,<7.0.0)",
   "colorama (>=0.4.6,<0.5.0)",
   "jinja2>=3.1.6",
+  "types-colorama>=0.4.15.20240311",
+  "types-pyyaml>=6.0.12.20250402",
+  "types-requests>=2.32.0.20250328",
 ]
 
 [project.urls]
@@ -32,18 +35,33 @@ build-backend = "setuptools.build_meta"
 
 [tool.setuptools]
 package-dir = { "" = "src" }
-packages = ["acmsg"]
 include-package-data = true
 
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["acmsg*"]
+namespaces = false
+
 [tool.commitizen]
 name = "cz_conventional_commits"
 tag_format = "v$version"
+ignored_tag_formats = ["latest"]
 version_scheme = "pep440"
 version_provider = "pep621"
 update_changelog_on_bump = true
 major_version_zero = true
+
+
 [dependency-groups]
 dev = [
-    "commitizen>=4.6.3",
-    "ipython>=9.2.0",
+  "commitizen>=4.6.3",
+  "ipython>=9.2.0",
+  "mypy>=1.15.0",
+  "pytest>=7.4.0",
+  "pytest-cov>=4.1.0",
 ]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+pythonpath = ["src"]

pytest.ini

@@ -0,0 +1,10 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+addopts = --cov=acmsg --cov-report=term-missing --cov-report=xml --no-cov-on-fail -v
+log_cli = false
+log_cli_level = INFO
+log_format = %(asctime)s %(levelname)s %(message)s
+log_date_format = %Y-%m-%d %H:%M:%S

src/acmsg/__init__.py

@@ -0,0 +1,23 @@
+"""Automatic git commit message generator using AI models & the OpenRouter API."""
+
+from importlib.metadata import version as _version
+
+__version__ = _version(__name__)
+
+from .core.config import Config
+from .core.git import GitUtils
+from .core.generation import CommitMessageGenerator, format_message
+from .api.openrouter import OpenRouterClient
+from .exceptions import AcmsgError, ApiError, GitError, ConfigError
+
+__all__ = [
+    "Config",
+    "GitUtils",
+    "CommitMessageGenerator",
+    "format_message",
+    "OpenRouterClient",
+    "AcmsgError",
+    "ApiError",
+    "GitError",
+    "ConfigError",
+]