feat: Initial project scaffolding and configuration

- Add pyproject.toml with project metadata and dependencies (black, isort, loguru, pydantic, pylint, pytest, etc.)
- Add uv.lock and .python-version for Python 3.13 environment management
- Add .pylintrc for Google style and Pylint-Pydantic integration
- Add VS Code settings for Python analysis
- Add GitHub Actions workflows for uv cache and linting
- Add src/ package with core config and logging modules (Loguru setup)
- Add main.py entry point using settings and logger
- Add tests/ with pytest for main function
- Add __init__.py files for package structure

Author: milsman2

.github/workflows/cache-uv-build.yaml

@@ -0,0 +1,43 @@
+name: Build uv cache
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'uv.lock'
+      - 'pyproject.toml'
+  workflow_dispatch:
+
+jobs:
+  build-cache:
+    runs-on: ubuntu-latest
+    env:
+      UV_VERSION: '0.9.27'
+      PYTHON_VERSION: '3.13'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: ${{ env.UV_VERSION }}
+          python-version: ${{ env.PYTHON_VERSION }}
+          enable-cache: false
+
+      - name: Install dependencies and populate cache
+        run: |
+          echo "Building global UV cache..."
+          uv sync --group dev
+          echo "Cache populated successfully"
+
+      - name: Save uv caches
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            ~/.cache/uv
+            ~/.local/share/uv
+            .venv
+          key: uv-main-${{ env.UV_VERSION }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'uv.lock') }}

.github/workflows/uv-build.yaml

@@ -0,0 +1,54 @@
+name: UV Build - Pylint Lint
+
+on:
+  pull_request:
+    branches:
+      - '*'
+
+jobs:
+  pylint-lint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    env:
+      UV_VERSION: '0.8.4'
+      PYTHON_VERSION: '3.13'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Restore global uv cache
+        id: cache-restore
+        uses: actions/cache/restore@v4
+        with:
+          path: |
+            ~/.cache/uv
+            ~/.local/share/uv
+            .venv
+          key: uv-main-${{ env.UV_VERSION }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'uv.lock') }}
+          restore-keys: |
+            uv-main-
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: ${{ env.UV_VERSION }}
+          python-version: ${{ env.PYTHON_VERSION }}
+          enable-cache: false
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Run pylint
+        run: uv run -- pylint src
+
+      - name: Save uv caches
+        if: steps.cache-restore.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            ~/.cache/uv
+            ~/.local/share/uv
+            .venv
+          key: uv-main-${{ env.UV_VERSION }}-${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'uv.lock') }}