postkit 0.1.0__tar.gz

postkit-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Build artifacts
+dist/
+
+# Python
+__pycache__/
+*.pyc
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+
+# Node
+node_modules/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+
+# Test artifacts
+*.log

postkit-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: postkit
+Version: 0.1.0
+Summary: PostgreSQL-native authentication and authorization SDK
+Project-URL: Homepage, https://github.com/varunchopra/postkit
+Project-URL: Repository, https://github.com/varunchopra/postkit
+Author: Varun Chopra
+License-Expression: Apache-2.0
+Keywords: authentication,authorization,postgresql,rebac,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+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 :: Database
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Requires-Dist: psycopg>=3.1.0
+Provides-Extra: binary
+Requires-Dist: psycopg[binary]>=3.1.0; extra == 'binary'
+Provides-Extra: dev
+Requires-Dist: psycopg[binary]>=3.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# postkit
+
+PostgreSQL-native authentication and authorization SDK.
+
+## Installation
+
+```bash
+pip install postkit
+```
+
+## Usage
+
+```python
+import psycopg
+from postkit.authz import AuthzClient
+from postkit.authn import AuthnClient
+
+conn = psycopg.connect("postgresql://...")
+cursor = conn.cursor()
+
+# Authorization
+authz = AuthzClient(cursor, namespace="my-app")
+authz.grant("admin", resource=("repo", "api"), subject=("user", "alice"))
+if authz.check("alice", "read", ("repo", "api")):
+    print("Access granted")
+
+# Authentication
+authn = AuthnClient(cursor, namespace="my-app")
+user_id = authn.create_user("alice@example.com", password_hash="argon2...")
+session_id = authn.create_session(user_id, token_hash="sha256...")
+```
+
+## Requirements
+
+- PostgreSQL 14+
+- The postkit SQL schema installed in your database
+
+See the [main repository](https://github.com/varunchopra/postkit) for SQL installation instructions.

postkit-0.1.0/README.md

@@ -0,0 +1,38 @@
+# postkit
+
+PostgreSQL-native authentication and authorization SDK.
+
+## Installation
+
+```bash
+pip install postkit
+```
+
+## Usage
+
+```python
+import psycopg
+from postkit.authz import AuthzClient
+from postkit.authn import AuthnClient
+
+conn = psycopg.connect("postgresql://...")
+cursor = conn.cursor()
+
+# Authorization
+authz = AuthzClient(cursor, namespace="my-app")
+authz.grant("admin", resource=("repo", "api"), subject=("user", "alice"))
+if authz.check("alice", "read", ("repo", "api")):
+    print("Access granted")
+
+# Authentication
+authn = AuthnClient(cursor, namespace="my-app")
+user_id = authn.create_user("alice@example.com", password_hash="argon2...")
+session_id = authn.create_session(user_id, token_hash="sha256...")
+```
+
+## Requirements
+
+- PostgreSQL 14+
+- The postkit SQL schema installed in your database
+
+See the [main repository](https://github.com/varunchopra/postkit) for SQL installation instructions.

postkit-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "postkit"
+version = "0.1.0"
+description = "PostgreSQL-native authentication and authorization SDK"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [{ name = "Varun Chopra" }]
+keywords = ["postgresql", "authentication", "authorization", "rebac", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "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 :: Database",
+    "Topic :: Security",
+]
+dependencies = ["psycopg>=3.1.0"]
+
+[project.optional-dependencies]
+binary = ["psycopg[binary]>=3.1.0"]
+dev = ["pytest>=7.0", "psycopg[binary]>=3.1.0"]
+
+[project.urls]
+Homepage = "https://github.com/varunchopra/postkit"
+Repository = "https://github.com/varunchopra/postkit"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/postkit"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

postkit-0.1.0/src/postkit/__init__.py

@@ -0,0 +1,9 @@
+"""
+postkit - PostgreSQL-native authentication and authorization SDK.
+
+Usage:
+    from postkit.authz import AuthzClient
+    from postkit.authn import AuthnClient
+"""
+
+__version__ = "0.1.0"

postkit-0.1.0/src/postkit/authn/__init__.py

@@ -0,0 +1,13 @@
+"""postkit.authn - Authentication client for PostgreSQL-native auth."""
+
+from postkit.authn.client import (
+    AuthnClient,
+    AuthnError,
+    AuthnValidationError,
+)
+
+__all__ = [
+    "AuthnClient",
+    "AuthnError",
+    "AuthnValidationError",
+]