modssc 0.0.4__tar.gz

modssc-0.0.4/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2
+
+[*.yaml]
+indent_size = 2

modssc-0.0.4/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @melvinbarbaux

modssc-0.0.4/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+# Code of Conduct
+
+We follow the Contributor Covenant Code of Conduct (version 2.1).
+
+By participating in this project, you agree to uphold this code.
+
+Enforcement
+For reporting unacceptable behavior, contact the project maintainers (see CODEOWNERS).

modssc-0.0.4/.github/CONTRIBUTING.md

@@ -0,0 +1,13 @@
+# Contributing
+
+## Local setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+pytest
+ruff check .
+ruff format .
+```

modssc-0.0.4/.github/GOVERNANCE.md

@@ -0,0 +1,22 @@
+# Governance
+
+## Roles
+Maintainers:
+- Review and merge pull requests
+- Cut releases and manage versioning
+- Decide on architectural changes
+
+Contributors:
+- Propose changes via pull requests
+- Add tests, docs, and changelog fragments
+
+## Decision process
+- Small changes: maintainer review + CI green
+- Architectural changes: short design note in the PR description, maintainer approval
+
+## Quality gates for new methods
+A new method must include:
+- tests (at least smoke + unit)
+- a quickstart example
+- a recipe / config used for reproduction or benchmark
+- a changelog fragment

modssc-0.0.4/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,79 @@
+name: Bug report
+description: Report a reproducible bug.
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting. Please provide a minimal reproduction.
+
+  - type: checkboxes
+    attributes:
+      label: Preflight
+      options:
+        - label: I searched existing issues and this is not a duplicate.
+          required: true
+        - label: I can reproduce this with the latest main branch.
+          required: false
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: What is wrong, and why it matters.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: Provide exact steps (commands, config files, minimal code).
+      placeholder: |
+        1. pip install -e ".[dev]"
+        2. modssc-datasets list
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Actual behavior / logs
+      description: Paste relevant logs or traceback (redact secrets).
+      render: text
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: ModSSC version
+      placeholder: 0.0.2 (or commit hash)
+    validations:
+      required: false
+
+  - type: dropdown
+    attributes:
+      label: Backend
+      options:
+        - "sklearn"
+        - "torch"
+        - "tensorflow"
+        - "graph (pyg)"
+        - "other / not sure"
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Environment
+      description: Python version, OS, CPU/GPU, install extras, etc.
+      placeholder: |
+        python: 3.12
+        os: macOS 14
+        extras: [torch, vision]
+    validations:
+      required: false

modssc-0.0.4/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions / design discussions
+    url: https://github.com/ModSSC/ModSSC/discussions
+    about: Use Discussions for questions and early design proposals.

modssc-0.0.4/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature request
+description: Suggest an improvement or a new capability.
+labels: ["enhancement"]
+body:
+  - type: textarea
+    attributes:
+      label: Problem
+      description: What problem are you trying to solve.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Proposed solution
+      description: What you want to happen, API sketch if possible.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Impact
+      description: Who benefits, what breaks, what changes in benchmark reproducibility.
+    validations:
+      required: false

modssc-0.0.4/.github/ISSUE_TEMPLATE/new_method.yml

@@ -0,0 +1,71 @@
+name: Add a new SSL method
+description: Request or propose a new semi-supervised method implementation.
+labels: ["method"]
+body:
+  - type: textarea
+    attributes:
+      label: Paper reference
+      description: Title, authors, venue, year, link (arXiv or DOI).
+    validations:
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: Setting
+      options:
+        - "inductive"
+        - "transductive"
+        - "both"
+    validations:
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: Modality
+      options:
+        - "tabular"
+        - "vision"
+        - "text"
+        - "audio"
+        - "graph"
+        - "multi"
+    validations:
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: Backend target
+      options:
+        - "sklearn"
+        - "torch"
+        - "tensorflow"
+        - "other"
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected results
+      description: Datasets, label regime, metric, expected numbers and tolerances.
+      placeholder: |
+        CIFAR-10, 40 labels, accuracy ~ 93.0 ± 0.5
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Notes about reproduction
+      description: Any tricky details (augmentations, EMA, schedules, thresholds).
+    validations:
+      required: false
+
+  - type: checkboxes
+    attributes:
+      label: Contribution checklist
+      options:
+        - label: I will add tests (smoke + unit, integration if relevant).
+          required: false
+        - label: I will add a recipe config and a quickstart example.
+          required: false
+        - label: I will add a changelog note (CHANGELOG.md).
+          required: false

modssc-0.0.4/.github/SECURITY.md

@@ -0,0 +1,12 @@
+# Security Policy
+
+## Supported versions
+Security fixes are provided on the latest released version and on the main branch.
+
+## Reporting a vulnerability
+Please do not open public issues for security reports.
+
+Preferred: use GitHub Security Advisories on the repository.
+Alternative: contact the maintainers privately (see CODEOWNERS / repository maintainers).
+
+We will acknowledge receipt and work on a fix as soon as possible.

modssc-0.0.4/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

modssc-0.0.4/.github/pull_request_template.md

@@ -0,0 +1,11 @@
+## Summary
+What does this PR change?
+
+## Checklist
+- [ ] Tests added or updated
+- [ ] CI green
+- [ ] Changelog updated
+- [ ] Documentation updated
+
+## Notes
+Anything reviewers should know?

modssc-0.0.4/.github/workflows/ci.yml

@@ -0,0 +1,106 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip wheel
+          pip install --prefer-binary -e ".[dev]"
+
+      - name: Ruff (lint and format check)
+        run: |
+          ruff check . && ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Free up disk space
+        run: |
+          sudo rm -rf /usr/local/lib/android
+          sudo rm -rf /usr/share/dotnet
+          sudo rm -rf /opt/ghc
+          sudo rm -rf /opt/hostedtoolcache/CodeQL
+          sudo rm -rf /usr/local/.ghcup
+          sudo rm -rf /usr/share/swift
+          sudo rm -rf /usr/local/share/boost
+          sudo docker image prune --all --force
+          sudo apt-get clean
+          df -h
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip wheel setuptools
+          # Install PyTorch CPU-only to save disk space
+          pip install --no-cache-dir torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+          # Install other dependencies
+          pip install --no-cache-dir --prefer-binary -e ".[dev,full]"
+
+      - name: Check memory
+        run: |
+          free -h
+          df -h
+
+      - name: Tests
+        run: |
+          pytest -n 4 --dist loadgroup --cov-report=xml:coverage.xml
+        env:
+          PYTHONHASHSEED: 0
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          fail_ci_if_error: true
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Build wheel and sdist
+        run: |
+          python -m pip install --upgrade pip wheel
+          pip install build
+          python -m build

modssc-0.0.4/.github/workflows/docs.yml

@@ -0,0 +1,72 @@
+name: Docs
+
+on:
+  push:
+    branches: ["main"]
+    tags: ["v*"]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Install docs dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[docs]"
+
+      - name: Build site (strict)
+        if: github.event_name == 'pull_request'
+        run: |
+          mkdocs build --strict --site-dir site
+
+      - name: Build site
+        if: github.event_name != 'pull_request'
+        run: |
+          mkdocs build --site-dir site
+
+      - name: Upload Pages artifact
+        if: github.event_name == 'push'
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+
+  deploy:
+    if: github.event_name == 'push'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

modssc-0.0.4/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+name: Release
+
+on:
+  push:
+    branches: ["main"]
+    tags: ["v*"]
+    paths:
+      - "src/**"
+      - "pyproject.toml"
+      - ".github/workflows/release.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: "pyproject.toml"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+          python -m build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v6
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    if: github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    env:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v7
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI (if configured)
+        if: ${{ env.PYPI_API_TOKEN != '' }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ env.PYPI_API_TOKEN }}
+          packages-dir: dist
+
+  release:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v7
+        with:
+          name: dist
+          path: dist
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          body_path: CHANGELOG.md

modssc-0.0.4/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+dist/
+build/
+
+# Tooling caches
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtualenv
+.venv/
+venv/
+ENV/
+env/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editors
+.vscode/
+.idea/
+
+# Docs build output
+site/
+docs/article_code/
+
+# Local artifacts, caches, runs
+data/
+outputs/
+runs/
+artifacts/
+cache/
+log/
+coverage.xml
+analysis/

modssc-0.0.4/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.9
+    hooks:
+      - id: ruff
+        args: ["."]
+        pass_filenames: false
+        always_run: true
+      - id: ruff-format
+        args: ["--check", "."]
+        pass_filenames: false
+        always_run: true
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: >-
+          bash -c 'if [ ! -x ./.venv/bin/python ]; then echo "Missing ./.venv/bin/python. Run: python3 -m venv .venv && ./.venv/bin/pip install -e \".[dev,full]\""; exit 1; fi; exec ./.venv/bin/python -m pytest'
+        language: system
+        args: ["-n", "4", "--dist", "loadgroup", "--cov-report=xml:coverage.xml"]
+        pass_filenames: false
+        always_run: true

modssc-0.0.4/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on "Keep a Changelog", and this project adheres to Semantic Versioning.
+
+## 0.0.4
+- Added multiple semi-supervised methods.
+
+## 0.0.3
+- Fixed bugs and improved logging for inductive methods.
+
+## 0.0.2
+- Updated github workflow
+
+## 0.0.1
+- Initial public release.

modssc-0.0.4/CITATION.bib

@@ -0,0 +1,9 @@
+@misc{barbaux2025modsscmodularframeworksemisupervised,
+      title={ModSSC: A Modular Framework for Semi-Supervised Classification on Heterogeneous Data},
+      author={Melvin Barbaux},
+      year={2025},
+      eprint={2512.13228},
+      archivePrefix={arXiv},
+      primaryClass={cs.LG},
+      url={https://arxiv.org/abs/2512.13228},
+}

modssc-0.0.4/CITATION.cff

@@ -0,0 +1,29 @@
+cff-version: 1.2.0
+message: "If you use ModSSC in your research, please cite it."
+title: "ModSSC: A Modular Framework for Semi-Supervised Classification on Heterogeneous Data"
+authors:
+  - family-names: "Barbaux"
+    given-names: "Melvin"
+license: "MIT"
+repository-code: "https://github.com/ModSSC/ModSSC"
+url: "https://hal.science/hal-05415109"
+keywords:
+  - semi-supervised learning
+  - classification
+  - reproducibility
+  - transductive learning
+  - inductive learning
+preferred-citation:
+  type: unpublished
+  title: "ModSSC: A Modular Framework for Semi-Supervised Classification on Heterogeneous Data"
+  authors:
+    - family-names: "Barbaux"
+      given-names: "Melvin"
+  year: 2025
+  month: 12
+  url: "https://hal.science/hal-05415109"
+  notes: "Preprint describing the open source ModSSC framework for inductive and transductive semi-supervised classification on heterogeneous data."
+  identifiers:
+    - type: other
+      value: "hal-05415109"
+      description: "HAL ID"