irregex 0.1.0__tar.gz

irregex-0.1.0/LICENSE

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

irregex-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: irregex
+Version: 0.1.0
+Summary: Python integration for the irregex search and similarity engine
+Keywords: code-search,regex,similarity,compression
+Author: The Billy Company
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/The-Billy-Company/irregex
+Project-URL: Repository, https://github.com/The-Billy-Company/irregex
+Project-URL: Issues, https://github.com/The-Billy-Company/irregex/issues
+Description-Content-Type: text/markdown
+
+# irregex
+
+Python integration for the native
+[irregex](https://github.com/The-Billy-Company/billy/tree/main/libs/kernels/irregex)
+search and similarity engine.
+
+The package provides a dependency-free subprocess API for invoking an installed
+`irregex` binary and decoding its NDJSON output:
+
+```python
+import irregex
+
+matches = irregex.records(
+    "context",
+    "resident similarity cache",
+    "-e",
+    "Resident",
+    "--all",
+)
+```
+
+Set `IRREGEX_BIN` to an explicit executable path or place the native binary on
+`PATH`. If neither is available, the API raises `ExecutableNotFound` with
+installation guidance.
+
+## Install
+
+```console
+python3 -m pip install irregex
+```
+
+This initial package is the Python bridge; native binary wheels will follow.
+
+## License
+
+MIT

irregex-0.1.0/README.md

@@ -0,0 +1,36 @@
+# irregex
+
+Python integration for the native
+[irregex](https://github.com/The-Billy-Company/billy/tree/main/libs/kernels/irregex)
+search and similarity engine.
+
+The package provides a dependency-free subprocess API for invoking an installed
+`irregex` binary and decoding its NDJSON output:
+
+```python
+import irregex
+
+matches = irregex.records(
+    "context",
+    "resident similarity cache",
+    "-e",
+    "Resident",
+    "--all",
+)
+```
+
+Set `IRREGEX_BIN` to an explicit executable path or place the native binary on
+`PATH`. If neither is available, the API raises `ExecutableNotFound` with
+installation guidance.
+
+## Install
+
+```console
+python3 -m pip install irregex
+```
+
+This initial package is the Python bridge; native binary wheels will follow.
+
+## License
+
+MIT

irregex-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["uv_build>=0.11.16,<0.12"]
+build-backend = "uv_build"
+
+[project]
+name = "irregex"
+version = "0.1.0"
+description = "Python integration for the irregex search and similarity engine"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "The Billy Company" }]
+keywords = ["code-search", "regex", "similarity", "compression"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/The-Billy-Company/irregex"
+Repository = "https://github.com/The-Billy-Company/irregex"
+Issues = "https://github.com/The-Billy-Company/irregex/issues"
+
+[tool.uv.build-backend]
+module-name = "irregex"

irregex-0.1.0/src/irregex/__init__.py

@@ -0,0 +1,52 @@
+"""Python integration for the native irregex engine."""
+
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any
+
+__all__ = ["ExecutableNotFound", "executable", "records", "run"]
+__version__ = "0.1.0"
+
+
+class ExecutableNotFound(FileNotFoundError):
+    """Raised when the native irregex executable cannot be located."""
+
+
+def executable() -> str:
+    """Return the configured native irregex executable."""
+    if configured := os.environ.get("IRREGEX_BIN"):
+        path = Path(configured).expanduser()
+        if path.is_file() and os.access(path, os.X_OK):
+            return str(path)
+        raise ExecutableNotFound(f"IRREGEX_BIN is not executable: {path}")
+
+    if found := shutil.which("irregex"):
+        return found
+    raise ExecutableNotFound(
+        "irregex is not installed; build the native engine or set IRREGEX_BIN"
+    )
+
+
+def run(
+    *arguments: str,
+    check: bool = True,
+    capture_output: bool = True,
+) -> subprocess.CompletedProcess[str]:
+    """Run the native irregex CLI with text-mode I/O."""
+    return subprocess.run(
+        [executable(), *arguments],
+        check=check,
+        capture_output=capture_output,
+        text=True,
+    )
+
+
+def records(*arguments: str) -> list[dict[str, Any]]:
+    """Run an irregex verb in JSON mode and decode its NDJSON records."""
+    result = run(*arguments, "--json")
+    return [json.loads(line) for line in result.stdout.splitlines() if line]