backstop 0.1.0__tar.gz

backstop-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: backstop
+Version: 0.1.0
+Summary: Production-grade database safety platform — intercept, snapshot, recover
+Project-URL: Homepage, https://github.com/pratyush2514/Backstop
+Project-URL: Repository, https://github.com/pratyush2514/Backstop.git
+Project-URL: Issues, https://github.com/pratyush2514/Backstop/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: sqlglot>=23.0.0
+Requires-Dist: psycopg2-binary>=2.9.0
+Requires-Dist: pyarrow>=14.0.0
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: structlog>=24.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: moto[s3]>=5.0.0; extra == "dev"
+
+# Backstop Python Package
+
+Backstop provides:
+
+- the `backstop` CLI for restore, doctor, drill, backup, PITR, and WAL workflows;
+- a Python SDK for guarded `psycopg2` and SQLAlchemy usage;
+- local-first PostgreSQL safety tooling that works with S3-compatible storage.
+
+Project home:
+
+- https://github.com/pratyush2514/Backstop

backstop-0.1.0/README.md

@@ -0,0 +1,11 @@
+# Backstop Python Package
+
+Backstop provides:
+
+- the `backstop` CLI for restore, doctor, drill, backup, PITR, and WAL workflows;
+- a Python SDK for guarded `psycopg2` and SQLAlchemy usage;
+- local-first PostgreSQL safety tooling that works with S3-compatible storage.
+
+Project home:
+
+- https://github.com/pratyush2514/Backstop

backstop-0.1.0/backstop/__init__.py

@@ -0,0 +1,47 @@
+"""backstop — production-grade database safety platform.
+
+Public API
+----------
+guard(conn, storage, actor, mode) → GuardedConnection
+    Wrap a psycopg2 connection with backstop protection.
+
+protect_engine(engine, storage, actor, mode)
+    Attach backstop protection to a SQLAlchemy Engine.
+
+RiskLevel
+    Enum of risk classifications: SAFE, LOW, HIGH, CRITICAL.
+
+RiskResult
+    Dataclass describing the result of a SQL risk assessment.
+
+Example usage::
+
+    import psycopg2
+    import backstop
+
+    raw_conn = psycopg2.connect(DATABASE_URL)
+    db = backstop.guard(
+        conn=raw_conn,
+        storage="s3://my-bucket@http://localhost:9000",
+        actor="gpt-agent-prod",
+        mode="protect",
+    )
+
+    # All SQL executed through db.execute() is now intercepted and protected.
+    db.execute("DROP TABLE users")  # Snapshots users → S3, then drops the table
+    db.commit()
+"""
+
+from .guard import GuardedConnection, GuardedCursor, guard
+from .parser import RiskLevel, RiskResult
+from .sqlalchemy import protect_engine
+
+__all__ = [
+    "guard",
+    "GuardedConnection",
+    "GuardedCursor",
+    "protect_engine",
+    "RiskLevel",
+    "RiskResult",
+]
+