opa-golib-python-bindings 0.1.0__tar.gz → 0.1.2__tar.gz

opa_golib_python_bindings-0.1.2/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.5
+Name: opa-golib-python-bindings
+Version: 0.1.2
+Summary: Python bindings for the OPA (Open Policy Agent) Rego engine via a Go c-shared library
+Project-URL: Homepage, https://github.com/phi1010/opa-golib-python-bindings
+Project-URL: Repository, https://github.com/phi1010/opa-golib-python-bindings
+Project-URL: Issues, https://github.com/phi1010/opa-golib-python-bindings/issues
+Author: Phillip Kuhrt
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: authorization,opa,open-policy-agent,policy,rego
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Go
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.14
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opa-golib-python-bindings
+
+Python bindings for the [OPA](https://www.openpolicyagent.org/) Rego engine, embedding
+`github.com/open-policy-agent/opa/v1/rego` via a Go c-shared library and a stdlib-only
+ctypes wrapper.
+
+## Build
+
+Requires Go >= 1.26 and Python >= 3.14.
+
+```sh
+make build   # builds src/opa_bindings/libopabridge.so
+make test    # builds + runs pytest
+```
+
+## Usage
+
+```python
+from opa_bindings import OpaEngine
+
+users = {"alice": {"role": "admin"}}
+
+with OpaEngine() as engine:
+    engine.add_policy("authz.rego", """
+package authz
+
+allow if lookup_user(input.user).role == "admin"
+""")
+    engine.add_data({"admin": ["alice"]}, path="roles")   # deep-merged; conflicts raise
+    engine.register_function("lookup_user", lambda name: users.get(name))
+
+    engine.eval_document("authz.allow", {"user": "alice"})  # -> True
+    engine.eval_query("x = data.roles.admin[_]")            # -> [{"x": "alice"}]
+```
+
+Notes:
+
+- `add_data` deep-merges objects; identical values coexist, conflicting values raise
+  `OpaError(code="merge_conflict")` naming the conflicting path.
+- `register_function` infers arity from the callable's signature. A `*args` function is
+  variadic and is called from Rego with a single array argument: `many(["a", "b"])`
+  (OPA does not support variadic builtins with return values).
+- Builtin arguments and return values are JSON-compatible objects. A callback exception
+  becomes an evaluation error; returning is fine.
+- An undefined document raises `OpaUndefinedError`.
+- Rego `print(...)` output is captured per evaluation: set `engine.print_handler`
+  to a `callable(message, location)` to receive it (default: written to stderr);
+  `engine.last_prints` holds the `(message, location)` pairs of the last eval.

opa_golib_python_bindings-0.1.2/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "opa-golib-python-bindings"
+version = "0.1.2"
+description = "Python bindings for the OPA (Open Policy Agent) Rego engine via a Go c-shared library"
+readme = "README.md"
+license = "Apache-2.0"
+authors = [{ name = "Phillip Kuhrt" }]
+keywords = ["opa", "open-policy-agent", "rego", "policy", "authorization"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: POSIX :: Linux",
+  "Operating System :: MacOS",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Go",
+  "Topic :: Security",
+  "Topic :: Software Development :: Libraries",
+]
+requires-python = ">=3.14"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/phi1010/opa-golib-python-bindings"
+Repository = "https://github.com/phi1010/opa-golib-python-bindings"
+Issues = "https://github.com/phi1010/opa-golib-python-bindings/issues"
+
+[project.optional-dependencies]
+dev = ["pytest"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/opa_bindings"]
+artifacts = ["src/opa_bindings/libopabridge.so"]
+
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/opa_bindings",
+  "go/*.go",
+  "go/*.c",
+  "go/go.mod",
+  "go/go.sum",
+  "Makefile",
+  "hatch_build.py",
+  "README.md",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

opa_golib_python_bindings-0.1.0/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.5
-Name: opa-golib-python-bindings
-Version: 0.1.0
-Summary: Python bindings for the OPA (Open Policy Agent) Rego engine via a Go c-shared library
-License-File: LICENSE
-Requires-Python: >=3.14
-Provides-Extra: dev
-Requires-Dist: pytest; extra == 'dev'

opa_golib_python_bindings-0.1.0/pyproject.toml

@@ -1,35 +0,0 @@
-[project]
-name = "opa-golib-python-bindings"
-version = "0.1.0"
-description = "Python bindings for the OPA (Open Policy Agent) Rego engine via a Go c-shared library"
-requires-python = ">=3.14"
-dependencies = []
-
-[project.optional-dependencies]
-dev = ["pytest"]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/opa_bindings"]
-artifacts = ["src/opa_bindings/libopabridge.so"]
-
-[tool.hatch.build.targets.wheel.hooks.custom]
-path = "hatch_build.py"
-
-[tool.hatch.build.targets.sdist]
-include = [
-  "src/opa_bindings",
-  "go/*.go",
-  "go/*.c",
-  "go/go.mod",
-  "go/go.sum",
-  "Makefile",
-  "hatch_build.py",
-  "README.md",
-]
-
-[tool.pytest.ini_options]
-pythonpath = ["src"]