covarage and move to src structure

Author: VikingInOrbit

.coverage

@@ -0,0 +1,74 @@
+name: CI
+
+on:
+  push: {}
+  pull_request: {}
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [3.14]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Show Python and pip info (debug)
+        run: |
+          python -V
+          python -c "import sys; print(sys.executable)"
+          python -m pip --version
+          python -m pip list
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-${{ matrix.python-version }}-
+            ${{ runner.os }}-pip-
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build setuptools wheel
+
+      - name: Install package and test deps (editable)
+        run: python -m pip install -e ".[testing]"
+
+      - name: Install pre-commit
+        run: python -m pip install pre-commit
+
+      - name: Run pre-commit hooks
+        run: pre-commit run --all-files
+      - name: Ensure repo on PYTHONPATH (optional)
+        run: echo "PYTHONPATH=$(pwd)" >> $GITHUB_ENV
+
+      - name: Debug Python path and import package
+        run: |
+          python - <<'PY'
+          import sys, importlib
+          print("=== sys.path ===")
+          for p in sys.path:
+              print(" -", p)
+          print("=== Import package ===")
+
+      - name: Run tests with coverage
+        run: pytest --cov=src --cov-report=xml
+
+      - name: Enforce coverage threshold
+        env:
+          BRANCH: ${{ github.ref_name }}
+        run: |
+          python tools/ci_check_coverage.py "$BRANCH"
+
+      - name: Upload coverage to artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-xml
+          path: coverage.xml

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: Publish Python package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.14"
+      - name: Install build tools
+        run: python -m pip install --upgrade build twine
+      - name: Build dist
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/publish-pypi.yml

@@ -0,0 +1,20 @@
+repos:
+  - repo: local
+    hooks:
+      - id: pytestCoverage
+        name: pytest with coverage
+        entry: python tools/checkCoverage.py
+        language: system
+        pass_filenames: false
+        always_run: true
+  - repo: https://github.com/psf/black
+    rev: 24.1.0
+    hooks:
+      - id: black
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+  
+
+

.pre-commit-config.yaml

@@ -11,10 +11,41 @@ in terminal for project
 py -m pip install git+https://github.com/VikingInOrbit/GabesPythonToolBox.git
 '''
 
-Import what you need, when you need it. 
-using "import GabesPythonToolBox as GTB" for all
-or import "GabesPythonToolBox.Category.lib as (XX)"
-That’s it. You're good to go.
+
+## How to install
+
+Quick install for development and testing:
+
+```bash
+python -m venv .venv
+python -m pip install pip-tools
+pip-compile requirements.in
+python -m pip install -r requirements.txt
+python -m pip install -e .
+```
+
+## Development Setup
+
+How to commit code destined for dev:
+
+```bash
+pip install pre-commit
+pre-commit install
+pre-commit install --hook-type pre-push
+pre-commit install --hook-type commit-msg
+pre-commit run --all-files
+```
+
+
+If pre-commit fails:
+
+```bash
+pytest -q --maxfail=1  
+tox 
+isort .  
+black .
+```
+
 
 ### comands
 #### unit test