tokenspeed-flashkda 0.0.1__tar.gz

tokenspeed_flashkda-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LightSeek Foundation <contact@lightseek.org>
+
+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.

tokenspeed_flashkda-0.0.1/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: tokenspeed-flashkda
+Version: 0.0.1
+Summary: Planning-stage capability interface for TokenSpeed FlashKDA kernels
+Author-email: LightSeek Foundation <contact@lightseek.org>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# TokenSpeed FlashKDA
+
+`tokenspeed-flashkda` is the planning-stage Python interface for FlashKDA
+kernels in TokenSpeed.
+
+The initial release does not yet ship a kernel implementation. It provides a
+small capability interface so callers can detect support and fail with a clear
+error while the kernels are under development.
+
+```python
+import tokenspeed_flashkda
+
+if tokenspeed_flashkda.is_available():
+    # Use the FlashKDA implementation.
+    ...
+else:
+    # Select another implementation.
+    ...
+```
+
+Call `tokenspeed_flashkda.require()` when FlashKDA is mandatory. It raises
+`FlashKDAUnavailableError` until an implementation is included in a future
+release.

tokenspeed_flashkda-0.0.1/README.md

@@ -0,0 +1,23 @@
+# TokenSpeed FlashKDA
+
+`tokenspeed-flashkda` is the planning-stage Python interface for FlashKDA
+kernels in TokenSpeed.
+
+The initial release does not yet ship a kernel implementation. It provides a
+small capability interface so callers can detect support and fail with a clear
+error while the kernels are under development.
+
+```python
+import tokenspeed_flashkda
+
+if tokenspeed_flashkda.is_available():
+    # Use the FlashKDA implementation.
+    ...
+else:
+    # Select another implementation.
+    ...
+```
+
+Call `tokenspeed_flashkda.require()` when FlashKDA is mandatory. It raises
+`FlashKDAUnavailableError` until an implementation is included in a future
+release.

tokenspeed_flashkda-0.0.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tokenspeed-flashkda"
+version = "0.0.1"
+description = "Planning-stage capability interface for TokenSpeed FlashKDA kernels"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "LightSeek Foundation", email = "contact@lightseek.org" },
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = []
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tokenspeed_flashkda"]

tokenspeed_flashkda-0.0.1/src/tokenspeed_flashkda/__init__.py

@@ -0,0 +1,27 @@
+"""Capability interface for TokenSpeed FlashKDA kernels."""
+
+from __future__ import annotations
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "FlashKDAUnavailableError",
+    "is_available",
+    "require",
+]
+
+
+class FlashKDAUnavailableError(RuntimeError):
+    """Raised when FlashKDA kernels are required but unavailable."""
+
+
+def is_available() -> bool:
+    """Return whether this release includes FlashKDA kernels."""
+    return False
+
+
+def require() -> None:
+    """Require FlashKDA kernels or raise a descriptive error."""
+    raise FlashKDAUnavailableError(
+        f"tokenspeed-flashkda {__version__} does not yet include FlashKDA kernels"
+    )

tokenspeed_flashkda-0.0.1/tests/test_package.py

@@ -0,0 +1,23 @@
+"""Tests for the planning-stage FlashKDA capability interface."""
+
+from __future__ import annotations
+
+import unittest
+
+import tokenspeed_flashkda
+
+
+class FlashKDAPackageTest(unittest.TestCase):
+    def test_reports_unavailable(self) -> None:
+        self.assertFalse(tokenspeed_flashkda.is_available())
+
+    def test_require_raises_descriptive_error(self) -> None:
+        with self.assertRaisesRegex(
+            tokenspeed_flashkda.FlashKDAUnavailableError,
+            r"tokenspeed-flashkda 0\.0\.1.*does not yet include",
+        ):
+            tokenspeed_flashkda.require()
+
+
+if __name__ == "__main__":
+    unittest.main()