iskakov 0.2.0__tar.gz

iskakov-0.2.0/LICENSE

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

iskakov-0.2.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: iskakov
+Version: 0.2.0
+Summary: Alias for own-baseline: does a single-cell potency score add anything beyond its own low-order primitive?
+Author: Damir Iskakov
+License: MIT License
+        
+        Copyright (c) 2026 Damir Iskakov
+        
+        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.
+        
+Project-URL: Homepage, https://iskakov.dev/ownbaseline
+Project-URL: Repository, https://github.com/IskakovDamir/ownbaseline
+Project-URL: Issues, https://github.com/IskakovDamir/ownbaseline/issues
+Keywords: single-cell,scRNA-seq,potency,stemness,benchmarking,incremental-validity,null-calibration,CytoTRACE,SCENT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+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 :: Bio-Informatics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: own-baseline>=0.2.0
+Dynamic: license-file
+
+# iskakov
+
+`pip install iskakov` installs [`own-baseline`](https://pypi.org/project/own-baseline/)
+and gives you its command line under a second name. The two names run the same
+program:
+
+```bash
+pip install iskakov
+
+iskakov    check cells.h5ad --score obs:ccat --ordinal obs:stage \
+                            --primitive degree-corr --ordinal-source experimental
+ownbaseline check ...        # identical
+```
+
+Import the real package in scripts:
+
+```python
+from own_baseline import conditional_skill_report
+```
+
+## What the tool does
+
+A potency score is supposed to order single cells by developmental potential.
+Most published scores are built on a low-order primitive of the same expression
+matrix: the number of genes detected, the correlation of a cell's profile with
+network node degree, the Shannon entropy of the profile, the library size.
+`own-baseline` asks whether the score orders a held-out ordinal any better than
+that primitive does on its own. It rank-residualizes the score on its
+author-declared primitive, takes Kendall's tau_b against the ordinal, and
+compares the result against a measured floor from a 200-seed null grid indexed
+by sample size, rank correlation, kernel and covariate count. The floor table
+ships inside the wheel, so the answer does not depend on a network call.
+
+Four verbs: `check`, `floors`, `primitives`, `verify`.
+
+## Where the code lives
+
+Source, tests, the null grid and the documentation are in the `own-baseline`
+repository. This distribution is 60 lines of forwarding.
+
+MIT licensed.

iskakov-0.2.0/README.md

@@ -0,0 +1,41 @@
+# iskakov
+
+`pip install iskakov` installs [`own-baseline`](https://pypi.org/project/own-baseline/)
+and gives you its command line under a second name. The two names run the same
+program:
+
+```bash
+pip install iskakov
+
+iskakov    check cells.h5ad --score obs:ccat --ordinal obs:stage \
+                            --primitive degree-corr --ordinal-source experimental
+ownbaseline check ...        # identical
+```
+
+Import the real package in scripts:
+
+```python
+from own_baseline import conditional_skill_report
+```
+
+## What the tool does
+
+A potency score is supposed to order single cells by developmental potential.
+Most published scores are built on a low-order primitive of the same expression
+matrix: the number of genes detected, the correlation of a cell's profile with
+network node degree, the Shannon entropy of the profile, the library size.
+`own-baseline` asks whether the score orders a held-out ordinal any better than
+that primitive does on its own. It rank-residualizes the score on its
+author-declared primitive, takes Kendall's tau_b against the ordinal, and
+compares the result against a measured floor from a 200-seed null grid indexed
+by sample size, rank correlation, kernel and covariate count. The floor table
+ships inside the wheel, so the answer does not depend on a network call.
+
+Four verbs: `check`, `floors`, `primitives`, `verify`.
+
+## Where the code lives
+
+Source, tests, the null grid and the documentation are in the `own-baseline`
+repository. This distribution is 60 lines of forwarding.
+
+MIT licensed.

iskakov-0.2.0/iskakov.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: iskakov
+Version: 0.2.0
+Summary: Alias for own-baseline: does a single-cell potency score add anything beyond its own low-order primitive?
+Author: Damir Iskakov
+License: MIT License
+        
+        Copyright (c) 2026 Damir Iskakov
+        
+        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.
+        
+Project-URL: Homepage, https://iskakov.dev/ownbaseline
+Project-URL: Repository, https://github.com/IskakovDamir/ownbaseline
+Project-URL: Issues, https://github.com/IskakovDamir/ownbaseline/issues
+Keywords: single-cell,scRNA-seq,potency,stemness,benchmarking,incremental-validity,null-calibration,CytoTRACE,SCENT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+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 :: Bio-Informatics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: own-baseline>=0.2.0
+Dynamic: license-file
+
+# iskakov
+
+`pip install iskakov` installs [`own-baseline`](https://pypi.org/project/own-baseline/)
+and gives you its command line under a second name. The two names run the same
+program:
+
+```bash
+pip install iskakov
+
+iskakov    check cells.h5ad --score obs:ccat --ordinal obs:stage \
+                            --primitive degree-corr --ordinal-source experimental
+ownbaseline check ...        # identical
+```
+
+Import the real package in scripts:
+
+```python
+from own_baseline import conditional_skill_report
+```
+
+## What the tool does
+
+A potency score is supposed to order single cells by developmental potential.
+Most published scores are built on a low-order primitive of the same expression
+matrix: the number of genes detected, the correlation of a cell's profile with
+network node degree, the Shannon entropy of the profile, the library size.
+`own-baseline` asks whether the score orders a held-out ordinal any better than
+that primitive does on its own. It rank-residualizes the score on its
+author-declared primitive, takes Kendall's tau_b against the ordinal, and
+compares the result against a measured floor from a 200-seed null grid indexed
+by sample size, rank correlation, kernel and covariate count. The floor table
+ships inside the wheel, so the answer does not depend on a network call.
+
+Four verbs: `check`, `floors`, `primitives`, `verify`.
+
+## Where the code lives
+
+Source, tests, the null grid and the documentation are in the `own-baseline`
+repository. This distribution is 60 lines of forwarding.
+
+MIT licensed.

iskakov-0.2.0/iskakov.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+iskakov.py
+pyproject.toml
+iskakov.egg-info/PKG-INFO
+iskakov.egg-info/SOURCES.txt
+iskakov.egg-info/dependency_links.txt
+iskakov.egg-info/entry_points.txt
+iskakov.egg-info/requires.txt
+iskakov.egg-info/top_level.txt
+tests/test_alias.py

iskakov-0.2.0/iskakov.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iskakov-0.2.0/iskakov.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+iskakov = iskakov:main

iskakov-0.2.0/iskakov.egg-info/requires.txt

@@ -0,0 +1 @@
+own-baseline>=0.2.0

iskakov-0.2.0/iskakov.egg-info/top_level.txt

@@ -0,0 +1 @@
+iskakov

iskakov-0.2.0/iskakov.py

@@ -0,0 +1,32 @@
+"""``pip install iskakov`` installs the own-baseline diagnostic.
+
+This distribution carries no analysis code. It depends on ``own-baseline`` and
+re-exports that package's command line under a second name, so ``iskakov`` and
+``ownbaseline`` are the same program. In scripts, import the real package:
+
+    from own_baseline import conditional_skill_report
+
+This module exists for the console entry point.
+"""
+from __future__ import annotations
+
+__version__ = "0.2.0"
+
+_MISSING = (
+    "iskakov is an alias for own-baseline, and own-baseline is not installed "
+    "in this environment.\n"
+    "    pip install own-baseline"
+)
+
+
+def main() -> int:
+    """Run the own-baseline command line."""
+    try:
+        from own_baseline.cli import main as _main
+    except ImportError:
+        raise SystemExit(_MISSING)
+    return _main()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

iskakov-0.2.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iskakov"
+version = "0.2.0"
+description = "Alias for own-baseline: does a single-cell potency score add anything beyond its own low-order primitive?"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [{ name = "Damir Iskakov" }]
+keywords = ["single-cell", "scRNA-seq", "potency", "stemness", "benchmarking",
+            "incremental-validity", "null-calibration", "CytoTRACE", "SCENT"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "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 :: Bio-Informatics",
+]
+dependencies = ["own-baseline>=0.2.0"]
+
+[project.scripts]
+iskakov = "iskakov:main"
+
+[project.urls]
+Homepage = "https://iskakov.dev/ownbaseline"
+Repository = "https://github.com/IskakovDamir/ownbaseline"
+Issues = "https://github.com/IskakovDamir/ownbaseline/issues"
+
+[tool.setuptools]
+py-modules = ["iskakov"]

iskakov-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

iskakov-0.2.0/tests/test_alias.py

@@ -0,0 +1,51 @@
+"""The alias has one job: hand the own-baseline command line a second name.
+
+Two things can break it. The dependency can go missing, in which case the user
+should see one sentence and not a traceback. And the forwarded entry point can
+drift from what own-baseline actually exposes, which is what happens when the
+real package renames its main.
+"""
+import subprocess
+import sys
+from importlib.metadata import entry_points
+
+import iskakov
+
+
+def test_module_is_not_a_package():
+    """A module-level __getattr__ that forwards to own_baseline answers __path__
+    as well, and Python then treats this module as a package rooted in someone
+    else's directory. It cost a broken console script once; keep it flat."""
+    assert not hasattr(iskakov, "__path__")
+
+
+def test_console_script_is_declared():
+    scripts = {e.name: e.value for e in entry_points(group="console_scripts")}
+    assert scripts.get("iskakov") == "iskakov:main"
+
+
+def test_forwards_to_own_baseline():
+    from own_baseline.cli import main as real
+    assert iskakov.main.__module__ == "iskakov"
+    r = subprocess.run([sys.executable, "-c",
+                        "import iskakov, sys; sys.argv=['iskakov','floors',"
+                        "'--n','39505','--rho','0.4844','--no-color']; "
+                        "raise SystemExit(iskakov.main())"],
+                       capture_output=True, text=True)
+    assert r.returncode == 0, r.stderr
+    assert "+0.0247" in r.stdout, r.stdout
+    assert callable(real)
+
+
+def test_missing_dependency_gives_a_sentence(tmp_path):
+    """Blocking own_baseline should produce the install line, not a traceback."""
+    blocker = tmp_path / "own_baseline.py"
+    blocker.write_text("raise ImportError('blocked for the test')\n")
+    r = subprocess.run([sys.executable, "-c",
+                        "import iskakov; raise SystemExit(iskakov.main())"],
+                       capture_output=True, text=True,
+                       env={**dict(__import__("os").environ),
+                            "PYTHONPATH": str(tmp_path)})
+    assert r.returncode == 1
+    assert "pip install own-baseline" in r.stderr
+    assert "Traceback" not in r.stderr