fishladder 0.0.1__tar.gz

fishladder-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy src
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        include:
+          - os: windows-latest
+            python-version: "3.12"
+          - os: macos-latest
+            python-version: "3.12"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: pytest --cov=fishladder --cov-report=term-missing
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*

fishladder-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

fishladder-0.0.1/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Vitor
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

fishladder-0.0.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.5
+Name: fishladder
+Version: 0.0.1
+Summary: Evaluation framework for online multi-target active learning on data streams.
+Project-URL: Homepage, https://github.com/vitor-costa-garcia/fishladder
+Project-URL: Issues, https://github.com/vitor-costa-garcia/fishladder/issues
+Author-email: Vitor da Costa Garcia <vitorcostagarcia2006@gmail.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: active-learning,data-streams,multi-target-regression,online-learning
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: numpy
+Requires-Dist: pandas
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: plots
+Requires-Dist: matplotlib; extra == 'plots'
+Description-Content-Type: text/markdown
+
+# fishladder
+
+[![CI](https://github.com/vitor-costa-garcia/fishladder/actions/workflows/ci.yml/badge.svg)](https://github.com/vitor-costa-garcia/fishladder/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/fishladder)](https://pypi.org/project/fishladder/)
+[![License](https://img.shields.io/pypi/l/fishladder)](https://github.com/vitor-costa-garcia/fishladder/blob/main/LICENSE)
+
+**An evaluation framework for online multi-output active learning on data streams.**
+
+> ⚠️ **Early development.** This release (`0.0.1`) mainly reserves the package name.
+> There is no usable API yet, and everything described below is planned work that
+> may change.
+
+## What is this?
+
+In many streaming applications (soft sensors, process monitoring, environmental
+sensing), each instance arrives with several outputs to predict, and obtaining
+the true values is expensive. An active learner has to decide, on the fly, which
+labels are worth asking for, and for which outputs.
+
+Existing stream-learning libraries support active learning only for
+single-output classification, and existing active learning libraries mostly
+assume a pool of data rather than a stream. fishladder aims to fill the gap by
+providing tools to **evaluate** active learning methods in this setting. Like a
+fish ladder lets only some fish past a dam, the goal is to study which labels
+are worth letting through.
+
+## Planned scope
+
+- **Multi-output streams:** multi-target regression first, multi-label
+  classification afterwards. Single-output streams as the special case of one
+  output.
+- **Output-level querying:** oracles that can reveal a subset of the outputs of
+  an instance, with per-output costs.
+- **Budget management** measured in cost, not just number of queries.
+- **Prequential, cost-indexed evaluation** with per-output metrics.
+- **A tidy experiment log**, from which metrics and plots are computed.
+- **Baseline query strategies**, plus a synthetic multi-output stream generator.
+- Compatibility with existing streaming libraries (such as
+  [River](https://riverml.xyz)) rather than a replacement for them.
+
+None of this is implemented in `0.0.1`.
+
+## Installation
+
+```bash
+pip install fishladder
+```
+
+This currently installs an empty placeholder package.
+
+## Contributing and feedback
+
+The project scope is still being defined. Ideas, use cases and criticism are
+welcome through [GitHub issues](https://github.com/vitor-costa-garcia/fishladder/issues).
+
+## License
+
+BSD 3-Clause. See [LICENSE](https://github.com/vitor-costa-garcia/fishladder/blob/main/LICENSE).

fishladder-0.0.1/README.md

@@ -0,0 +1,58 @@
+# fishladder
+
+[![CI](https://github.com/vitor-costa-garcia/fishladder/actions/workflows/ci.yml/badge.svg)](https://github.com/vitor-costa-garcia/fishladder/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/fishladder)](https://pypi.org/project/fishladder/)
+[![License](https://img.shields.io/pypi/l/fishladder)](https://github.com/vitor-costa-garcia/fishladder/blob/main/LICENSE)
+
+**An evaluation framework for online multi-output active learning on data streams.**
+
+> ⚠️ **Early development.** This release (`0.0.1`) mainly reserves the package name.
+> There is no usable API yet, and everything described below is planned work that
+> may change.
+
+## What is this?
+
+In many streaming applications (soft sensors, process monitoring, environmental
+sensing), each instance arrives with several outputs to predict, and obtaining
+the true values is expensive. An active learner has to decide, on the fly, which
+labels are worth asking for, and for which outputs.
+
+Existing stream-learning libraries support active learning only for
+single-output classification, and existing active learning libraries mostly
+assume a pool of data rather than a stream. fishladder aims to fill the gap by
+providing tools to **evaluate** active learning methods in this setting. Like a
+fish ladder lets only some fish past a dam, the goal is to study which labels
+are worth letting through.
+
+## Planned scope
+
+- **Multi-output streams:** multi-target regression first, multi-label
+  classification afterwards. Single-output streams as the special case of one
+  output.
+- **Output-level querying:** oracles that can reveal a subset of the outputs of
+  an instance, with per-output costs.
+- **Budget management** measured in cost, not just number of queries.
+- **Prequential, cost-indexed evaluation** with per-output metrics.
+- **A tidy experiment log**, from which metrics and plots are computed.
+- **Baseline query strategies**, plus a synthetic multi-output stream generator.
+- Compatibility with existing streaming libraries (such as
+  [River](https://riverml.xyz)) rather than a replacement for them.
+
+None of this is implemented in `0.0.1`.
+
+## Installation
+
+```bash
+pip install fishladder
+```
+
+This currently installs an empty placeholder package.
+
+## Contributing and feedback
+
+The project scope is still being defined. Ideas, use cases and criticism are
+welcome through [GitHub issues](https://github.com/vitor-costa-garcia/fishladder/issues).
+
+## License
+
+BSD 3-Clause. See [LICENSE](https://github.com/vitor-costa-garcia/fishladder/blob/main/LICENSE).

fishladder-0.0.1/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fishladder"
+version = "0.0.1"
+description = "Evaluation framework for online multi-target active learning on data streams."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [{ name = "Vitor da Costa Garcia", email = "vitorcostagarcia2006@gmail.com" }]
+keywords = ["active-learning", "data-streams", "online-learning", "multi-target-regression"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "numpy",
+    "pandas",
+]
+
+[project.optional-dependencies]
+plots = ["matplotlib"]
+dev = ["pytest", "pytest-cov", "ruff", "mypy"]
+
+[project.urls]
+Homepage = "https://github.com/vitor-costa-garcia/fishladder"
+Issues = "https://github.com/vitor-costa-garcia/fishladder/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fishladder"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

fishladder-0.0.1/src/fishladder/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

fishladder-0.0.1/tests/test_import.py

@@ -0,0 +1,5 @@
+import fishladder
+
+
+def test_version():
+    assert fishladder.__version__