hyper-post 0.1.0__cp312-cp312-win_amd64.whl

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hyper_post contributors
+
+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.

hyper_post/__init__.py

@@ -0,0 +1,3 @@
+from hyper_post._api import finalize
+
+__all__ = ["finalize"]

hyper_post/_api.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import Literal
+
+import numpy as np
+
+try:
+    from hyper_post._native import finalize_impl
+except ImportError as exc:  # pragma: no cover - depends on wheel contents
+    raise ImportError(
+        "hyper_post native extension failed to load. "
+        "Install a matching wheel for this platform and Python 3.12; "
+        "there is no pure-Python fallback."
+    ) from exc
+
+_ALLOWED_TARGETS = frozenset({"y1", "y2"})
+_DEFAULT_STRENGTH = 0.00767
+_FLOAT_DTYPES = {np.dtype(np.float32), np.dtype(np.float64)}
+
+
+def finalize(
+    predictions: np.ndarray,
+    *,
+    target: Literal["y1", "y2"],
+    strength: float = _DEFAULT_STRENGTH,
+) -> np.ndarray:
+    """Rank-fuse a prediction array with the selected offline reference."""
+    if isinstance(target, bool) or not isinstance(target, str):
+        raise TypeError("target must be the string 'y1' or 'y2'")
+    if target not in _ALLOWED_TARGETS:
+        raise ValueError("target must be exactly 'y1' or 'y2'")
+
+    if isinstance(strength, bool) or isinstance(strength, str):
+        raise TypeError("strength must be a real number")
+    if not isinstance(strength, (int, float, np.integer, np.floating)):
+        raise TypeError("strength must be a real number")
+    strength_f = float(strength)
+    if not np.isfinite(strength_f):
+        raise ValueError("strength must be a finite real number")
+    if strength_f < 0.0 or strength_f > 1.0:
+        raise ValueError("strength must be in [0, 1]")
+
+    if not isinstance(predictions, np.ndarray):
+        raise TypeError("predictions must be a numpy.ndarray")
+    if predictions.dtype not in _FLOAT_DTYPES:
+        raise TypeError("predictions must be a float32 or float64 ndarray")
+    if predictions.ndim != 2:
+        raise ValueError(
+            f"predictions must be 2-D, got {predictions.ndim}-D"
+        )
+
+    array = np.ascontiguousarray(predictions)
+    return finalize_impl(array, target, strength_f)

hyper_post-0.1.0.dist-info/METADATA

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: hyper-post
+Version: 0.1.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Dist: numpy>=1.26.4,<2
+Requires-Dist: pytest>=8 ; extra == 'dev'
+Requires-Dist: scipy==1.17.1 ; extra == 'dev'
+Requires-Dist: numpy==1.26.4 ; extra == 'dev'
+Requires-Dist: cryptography>=43 ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+Summary: Offline rank fusion of prediction arrays against embedded reference data.
+Author: hyper_post contributors
+License: MIT
+Requires-Python: >=3.12, <3.13
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# hyper-post
+
+Offline rank fusion of a prediction array with an embedded reference. Intended for a one-line call at the end of a training script:
+
+```python
+from hyper_post import finalize
+
+result = finalize(predictions, target="y2", strength=0.00767)
+```
+
+The package does not load or save files, does not use the network, and does not upload predictions.
+
+## Install
+
+Python 3.12, NumPy 1.26.x. Use a wheel that matches the platform:
+
+```text
+pip install --no-index --find-links=wheelhouse hyper-post
+```
+
+There is no pure-Python fallback. If the native extension cannot load, installation or import fails.
+
+## API
+
+```python
+def finalize(
+    predictions: np.ndarray,
+    *,
+    target: Literal["y1", "y2"],
+    strength: float = 0.00767,
+) -> np.ndarray: ...
+```
+
+| Input | Rule |
+| --- | --- |
+| `predictions` | 2-D `float32` or `float64` array with shape `(442, 5282)` |
+| `target` | required keyword, exactly `"y1"` or `"y2"` |
+| `strength` | finite real in `[0, 1]`; not bool or str |
+| return | new C-contiguous `float32` array, same shape |
+
+`float64` values are ranked at original precision. The function does not modify the input. `y1` and `y2` are independent references and are never mixed.
+
+## Support matrix (v0.1.0)
+
+| Platform | Arch | Python | NumPy |
+| --- | --- | --- | --- |
+| Windows | AMD64 | 3.12 | `>=1.26.4,<2` |
+| Linux | x86_64 | 3.12 | `>=1.26.4,<2` |
+
+macOS, ARM, and free-threaded CPython are out of scope for this version. Linux wheels are built on the project's WSL Ubuntu host. They are not manylinux images unless a container toolchain is added later; the training machine must have a compatible glibc.
+
+## Build (private environment)
+
+```text
+python tools/build_payload.py
+maturin build --release --out dist
+python tools/inspect_wheel.py dist/*.whl
+```
+
+`private/y1.npy` and `private/y2.npy` are required to generate the payload. `generated/` is local build output and must not be published or committed.
+
+## Security boundary
+
+This package raises the cost of extracting the embedded reference from the wheel. It does not make the reference unrecoverable.
+
+The public formula is `output = (1 - s) * R(X) + s * R(Y)`. When `s != 0`, a caller who also knows `X` can recover `R(Y)` from the returned array. `strength=1` returns the reference rank directly. That is a property of the API, not a defect to be papered over by renaming functions or packing the binary.
+
+Runtime is fully offline. Keys needed for decryption are necessarily present in the native extension.
+
+## License
+
+MIT. Publishing a wheel is a separate step from implementing this package and is not implied by the license text.
+

hyper_post-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+LICENSE,sha256=LUwGpNdxVfloMICIMkh7wwuTTsHdZ1RRKvko6KmeyOo,1080
+hyper_post/__init__.py,sha256=39xjp2QGjEfEox4ZL6Le0dPQLhpCFCjxRiew0QjgFHI,61
+hyper_post/_api.py,sha256=sBDfj1HHiqVLZ9x5cWM39xj5Ex6MS0S2FJQgCaiMhNM,1959
+hyper_post/_native.cp312-win_amd64.pyd,sha256=qeRBkVQRSoXkfT6z0f38rSWusveun8pKqvpYqCSNtHI,8068608
+hyper_post-0.1.0.dist-info/METADATA,sha256=EQZbe1FKDoofHG8PAFDSj5hpKi47hxlUv83FRpG7ick,3460
+hyper_post-0.1.0.dist-info/WHEEL,sha256=Uf438hGD-NUftH08dxSaiYRxcfiZqeYK9g3DNJ-vPY0,97
+hyper_post-0.1.0.dist-info/licenses/LICENSE,sha256=LUwGpNdxVfloMICIMkh7wwuTTsHdZ1RRKvko6KmeyOo,1080
+hyper_post-0.1.0.dist-info/RECORD,,

hyper_post-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.15.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-win_amd64

hyper_post-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hyper_post contributors
+
+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.