fitrank 0.1.0__tar.gz

fitrank-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+*.so
+
+# Packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tests and coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Tool caches
+.mypy_cache/
+.ruff_cache/
+
+# FitRank run outputs
+runs/
+
+# Editors and OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+.claude/

fitrank-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Faïd Adéshinan ALAGBE
+
+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.

fitrank-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.5
+Name: fitrank
+Version: 0.1.0
+Summary: Train, compare and rank scikit-learn models from a single YAML config.
+Project-URL: Homepage, https://github.com/Adeshinan/fitrank
+Project-URL: Repository, https://github.com/Adeshinan/fitrank
+Project-URL: Issues, https://github.com/Adeshinan/fitrank/issues
+Author: Faïd Adéshinan ALAGBE
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automl,benchmark,machine-learning,model-selection,scikit-learn
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: joblib>=1.3
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: scikit-learn>=1.4
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pandas-stubs; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1; extra == 'excel'
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=14.0; extra == 'parquet'
+Description-Content-Type: text/markdown
+
+# FitRank
+
+Train, compare and rank scikit-learn models from a single YAML config. Find the best model for your data.
+
+> Work in progress — version 1.0 planned for November 2026.

fitrank-0.1.0/README.md

@@ -0,0 +1,5 @@
+# FitRank
+
+Train, compare and rank scikit-learn models from a single YAML config. Find the best model for your data.
+
+> Work in progress — version 1.0 planned for November 2026.

fitrank-0.1.0/pyproject.toml

@@ -0,0 +1,108 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fitrank"
+dynamic = ["version"]
+description = "Train, compare and rank scikit-learn models from a single YAML config."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [{ name = "Faïd Adéshinan ALAGBE" }]
+keywords = ["machine-learning", "scikit-learn", "model-selection", "automl", "benchmark"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dependencies = [
+    "scikit-learn>=1.4",
+    "pandas>=2.0",
+    "numpy>=1.24",
+    "pyyaml>=6.0",
+    "pydantic>=2.0",
+    "joblib>=1.3",
+    "typer>=0.12",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+excel = ["openpyxl>=3.1"]
+parquet = ["pyarrow>=14.0"]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.6",
+    "mypy>=1.10",
+    "pre-commit>=3.7",
+    "pandas-stubs",
+    "types-PyYAML",
+    "build",
+    "twine",
+]
+
+# The `fitrank` command is added on day 8 (feat/j08-api-cli):
+# [project.scripts]
+# fitrank = "fitrank.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/Adeshinan/fitrank"
+Repository = "https://github.com/Adeshinan/fitrank"
+Issues = "https://github.com/Adeshinan/fitrank/issues"
+
+[tool.hatch.version]
+path = "src/fitrank/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fitrank"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/fitrank", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "UP",  # pyupgrade
+    "SIM", # flake8-simplify
+    "N",   # pep8-naming
+]
+ignore = [
+    "N803", # scikit-learn convention: argument names X, X_train
+    "N806", # scikit-learn convention: variable names X, X_train
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = ["src"]
+
+[[tool.mypy.overrides]]
+module = ["sklearn.*", "joblib.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+
+[tool.coverage.run]
+source = ["fitrank"]
+branch = true

fitrank-0.1.0/src/fitrank/__init__.py

@@ -0,0 +1,5 @@
+"""FitRank: train, compare and rank scikit-learn models from a single YAML config."""
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

fitrank-0.1.0/tests/test_smoke.py

@@ -0,0 +1,13 @@
+"""Smoke tests: the package installs and exposes its version."""
+
+import re
+
+import fitrank
+
+
+def test_version_is_exposed() -> None:
+    assert fitrank.__version__ == "0.1.0"
+
+
+def test_version_follows_semver() -> None:
+    assert re.fullmatch(r"\d+\.\d+\.\d+([a-z]+\d+)?", fitrank.__version__)