Feat/code review

.github/workflows/bump-version.yml

@@ -1,67 +1,26 @@
 # .github/workflows/bump-version.yml
-name: Bump Version on Merge to Main
- 
+name: Sync Version on Merge to Main
+
 on:
   push:
     branches:
       - main
 
 jobs:
-  bump-version:
+  tag-version:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-      id-token: write
 
     steps:
       - uses: actions/checkout@v4
         with:
-          fetch-depth: 0  # Fetch all history for all branches and tags
+          fetch-depth: 0
 
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
 
-      - run: pip install python-semantic-release
-
-      - name: Configure Git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      - name: Run Semantic Release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: semantic-release version
+      - name: Synchronize tag and pyproject version
+        run: python scripts/check_version_match.py --fix --write
 
-      - name: Push changes
-        run: |
-          git push --follow-tags
-      - name: "Install Poetry"
-        run: pip install poetry
-      - name: "Determine version bump type"
-        run: |
-            git fetch --tags
-            # This defaults to a patch type, unless a feature commit was pushed, then set type to minor
-            LAST_TAG=$(git describe --tags $(git rev-list --tags --max-count=1))
-            LAST_COMMIT=$(git log -1 --format='%H')
-            echo "Last git tag: $LAST_TAG"
-            echo "Last git commit: $LAST_COMMIT"
-            echo "Commits:"
-            git log --no-merges --pretty=oneline $LAST_TAG...$LAST_COMMIT
-            git log --no-merges --pretty=format:"%s" $LAST_TAG...$LAST_COMMIT | grep -q ^feat: && BUMP_TYPE="minor" || BUMP_TYPE="patch"
-            echo "Version bump type: $BUMP_TYPE"
-            echo "BUMP_TYPE=$BUMP_TYPE" >> $GITHUB_ENV
-        env:
-            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: "Version bump"
-        run: |
-            poetry version $BUMP_TYPE
-      - name: "Push new version"
-        run: |
-            git add pyproject.toml
-            git commit -m "Update version to $(poetry version -s)"
-            git pull --ff-only origin main
-            git push origin main --follow-tags
-        env:
-            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Test with Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache Poetry dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: ${{ runner.os }}-poetry-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}
+
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: poetry install --with dev --no-interaction
+
+      - name: Check runtime dependencies
+        run: |
+          poetry run python - <<'PY'
+          import importlib, sys
+          missing = [m for m in ("pandas",) if importlib.util.find_spec(m) is None]
+          if missing:
+              print("Missing dependencies:", ", ".join(missing))
+              sys.exit(1)
+          PY
+
+      - name: Verify version matches tag
+        if: startsWith(github.ref, 'refs/tags/')
+        run: python scripts/check_version_match.py
+
+      - name: Run tests with coverage
+        run: poetry run pytest --cov=gen_surv --cov-report=xml --cov-report=term
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.11'
+        uses: codecov/codecov-action@v5
+        with:
+          files: coverage.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  lint:
+    name: Code Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Cache Poetry dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: ${{ runner.os }}-poetry-3.11-${{ hashFiles('**/poetry.lock') }}
+
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: poetry install --with dev --no-interaction
+
+      - name: Run pre-commit checks
+        run: poetry run pre-commit run --all-files

.github/workflows/docs.yml

@@ -0,0 +1,34 @@
+name: Documentation Build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Cache Poetry dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: ${{ runner.os }}-poetry-3.11-${{ hashFiles('**/poetry.lock') }}
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+      - name: Install dependencies
+        run: poetry install --with docs
+      - name: Build documentation
+        run: poetry run sphinx-build -W -b html docs/source docs/build
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: docs/build/

.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Verify version matches tag
+        run: python scripts/check_version_match.py
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+      - name: Publish
+        env:
+          POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_TOKEN }}
+        run: poetry publish --build --no-interaction

.gitignore

@@ -50,3 +50,4 @@ dist/
 # Temporary
 *.log
 *.tmp
+.hypothesis/

.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 24.1.0
+    hooks:
+      - id: black
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.1.0
+    hooks:
+      - id: flake8
+        additional_dependencies: [flake8-pyproject]
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.15.0
+    hooks:
+      - id: mypy
+        pass_filenames: false
+        args: [--config-file=pyproject.toml, gen_surv]

.readthedocs.yml

@@ -4,10 +4,22 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.11"
+  jobs:
+    post_create_environment:
+      - pip install poetry
+    post_install:
+      - poetry config virtualenvs.create false
+      - poetry install --with docs
 
 python:
   install:
-    - requirements: docs/requirements.txt
+    - method: pip
+      path: .
 
 sphinx:
   configuration: docs/source/conf.py
+  fail_on_warning: false
+
+formats:
+  - pdf
+  - epub

CHANGELOG.md

@@ -1,5 +1,40 @@
 # CHANGELOG
 
+## v1.0.9 (2025-08-02)
+
+### Features
+- export datasets to RDS files
+- test workflow runs on a Python version matrix
+- scikit-learn compatible data generator
+- compatibility helpers for lifelines and scikit-survival
+
+### Documentation
+- updated usage examples and tutorials
+- document optional scikit-survival dependency throughout the docs
+
+### Continuous Integration
+- auto-tag releases using the version check script
+
+### Misc
+- README quick example uses `covariate_range`
+
+## v1.0.8 (2025-07-30)
+
+### Documentation
+- ensure absolute path resolution in `conf.py`
+- drop unsupported theme option
+- define bibliography anchors and headings
+- fix tutorial links to non-existing docs
+- add additional references to the bibliography
+
+### Testing
+- add CLI integration test
+- expand piecewise generator test coverage
+
+### Misc
+- remove fix_recommendations.md
+
+
 
 ## v1.0.0 (2025-06-06)
 
@@ -186,9 +221,6 @@
 - Update pyproject
   ([`a4b25e4`](https://github.com/DiogoRibeiro7/genSurvPy/commit/a4b25e470954091254b1384a44a991a47341bf80))
 
-- Work
-  ([`5ac5130`](https://github.com/DiogoRibeiro7/genSurvPy/commit/5ac513098238a8298430d1a95c6fbeed99db4cad))
-
 ### Continuous Integration
 
 - Add GitHub Actions workflow for test automation
@@ -218,6 +250,3 @@
 
 - Implement THMM data generator and finalize full model suite
   ([`1e667ba`](https://github.com/DiogoRibeiro7/genSurvPy/commit/1e667babf28892c3a85c43477562f2de85f07f3c))
-
-- Work
-  ([`45de359`](https://github.com/DiogoRibeiro7/genSurvPy/commit/45de359bbb0d7fbc671e41fa07d3a37b09e68e18))