modssc 0.0.1__tar.gz

modssc-0.0.1/.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.1/.github/CODEOWNERS

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

modssc-0.0.1/.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.1/.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.1/.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.1/.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.1.dev0 (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.1/.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.1/.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.1/.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.1/.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.1/.github/dependabot.yml

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

modssc-0.0.1/.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.1/.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+name: CI (disabled)
+
+# CI is temporarily disabled.
+# The original workflow is preserved below (commented out) so it can be restored easily.
+
+on:
+  workflow_dispatch:
+
+jobs:
+  disabled:
+    if: ${{ false }}
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "CI disabled"
+
+# ---------------------------------------------------------------------------
+# Original workflow (commented out)
+# ---------------------------------------------------------------------------
+#
+# name: CI
+#
+# on:
+#   push:
+#     branches: ["main"]
+#   pull_request:
+#
+# 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
+#         env:
+#           PYTHONHASHSEED: 0
+#
+#   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.1/.gitignore

@@ -0,0 +1,43 @@
+# 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/
+
+# Local artifacts, caches, runs
+data/
+outputs/
+runs/
+artifacts/
+cache/
+docs/
+log/

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

@@ -0,0 +1,15 @@
+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: ["--fix"]
+      - id: ruff-format

modssc-0.0.1/CHANGELOG.md

@@ -0,0 +1,8 @@
+# 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.1
+- Initial public release.

modssc-0.0.1/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.1/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"

modssc-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ModSSC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

modssc-0.0.1/Makefile

@@ -0,0 +1,53 @@
+.DEFAULT_GOAL := help
+
+VENV_PY := .venv/bin/python
+PYTHON ?= $(if $(wildcard $(VENV_PY)),$(VENV_PY),python)
+
+.PHONY: help install-dev install-docs lint format test docs-serve docs-build build check-dist release-prep clean
+
+help:
+	@echo "Targets:"
+	@echo "  install-dev   Install dev dependencies"
+	@echo "  install-docs  Install docs dependencies"
+	@echo "  format        Format with Ruff"
+	@echo "  lint          Lint with Ruff"
+	@echo "  test          Run pytest"
+	@echo "  docs-serve    Serve docs locally (MkDocs)"
+	@echo "  docs-build    Build docs (MkDocs)"
+	@echo "  build         Build sdist/wheel with build"
+	@echo "  check-dist    Validate dist metadata with twine"
+	@echo "  release-prep  Build + twine check (no publish)"
+
+install-dev:
+	$(PYTHON) -m pip install --upgrade pip
+	$(PYTHON) -m pip install -e ".[dev]"
+
+install-docs:
+	$(PYTHON) -m pip install --upgrade pip
+	$(PYTHON) -m pip install -e ".[docs]"
+
+lint:
+	$(PYTHON) -m ruff check .
+
+format:
+	$(PYTHON) -m ruff format .
+
+test:
+	$(PYTHON) -m pytest
+
+docs-serve:
+	$(PYTHON) -m mkdocs serve
+
+docs-build:
+	$(PYTHON) -m mkdocs build
+
+build:
+	$(PYTHON) -m build
+
+check-dist:
+	$(PYTHON) -m twine check dist/*
+
+release-prep: build check-dist
+
+clean:
+	rm -rf dist build htmlcov .coverage .pytest_cache .ruff_cache cache artifacts data outputs runs site