botversion-sdk 2.3.0__tar.gz → 2.3.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/PKG-INFO +2 -21
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/README.md +1 -20
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/__init__.py +5 -3
- botversion_sdk-2.3.1/botversion_sdk/undo/lib/capture_prisma.py +311 -0
- botversion_sdk-2.3.1/botversion_sdk/undo/lib/hooks/prisma.py +75 -0
- botversion_sdk-2.3.1/botversion_sdk/undo/lib/prisma_io.py +177 -0
- botversion_sdk-2.3.1/botversion_sdk/undo/lib/prisma_schema.py +152 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/scanner.py +17 -2
- botversion_sdk-2.3.1/botversion_sdk/undo/lib/undo_prisma.py +244 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/PKG-INFO +2 -21
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/SOURCES.txt +5 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/setup.py +1 -1
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/bin/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/bin/scan_endpoints.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/client.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/interceptor.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/aiohttp.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/bottle.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/cherrypy.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/common.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_bodies.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_urls.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_views.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/falcon.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/fastapi.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/fastapi_static.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/flask.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/multipart.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/pyramid.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/response_shapes.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/sanic.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/sanic_static.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/starlette.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/starlette_static.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/static_common.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/tornado.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scanner.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/__main__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/bin/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/bin/scan.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/action_id.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_guard.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mongo.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mssql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mysql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_sql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_sqlite.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/gate.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/__init__.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/asyncpg.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mongodb.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mssql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mysql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg2.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg_async.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/sqlite.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/loader_watch.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/log.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/mssql_sql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/mysql_sql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/refuse.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/report.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/requester.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/setup_check.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_crypto.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_sql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_store.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_store_mongo.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/sql_classify.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/sqlite_sql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/steps.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/tagger.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mongo.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mssql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mysql.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_pg.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_route.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_sqlite.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/register.py +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/dependency_links.txt +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/entry_points.txt +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/requires.txt +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/top_level.txt +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/pyproject.toml +0 -0
- {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: botversion-sdk
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.1
|
|
4
4
|
Summary: BotVersion SDK — automatically discover and register your API endpoints
|
|
5
5
|
Home-page: https://github.com/botversion/botversion-sdk-python
|
|
6
6
|
Author: BotVersion
|
|
@@ -42,43 +42,24 @@ Dynamic: summary
|
|
|
42
42
|
|
|
43
43
|
\# BotVersion SDK (Python)
|
|
44
44
|
|
|
45
|
-
|
|
46
|
-
|
|
47
45
|
BotVersion adds a self-updating AI agent to your SaaS backend.
|
|
48
46
|
|
|
49
|
-
|
|
50
|
-
|
|
51
47
|
\## What it does
|
|
52
48
|
|
|
53
|
-
|
|
54
|
-
|
|
55
49
|
\- Scans your codebase and automatically discovers your API endpoints.
|
|
56
50
|
|
|
57
51
|
\- Keeps the endpoint list live, so new endpoints are detected automatically the first time they are called.
|
|
58
52
|
|
|
59
53
|
\- Lets an AI agent act on your app through its real, current API surface, with no manual endpoint maintenance.
|
|
60
54
|
|
|
61
|
-
|
|
62
|
-
|
|
63
55
|
\## Installation
|
|
64
56
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
  pip install botversion-sdk
|
|
68
|
-
|
|
69
|
-
|
|
57
|
+
  pip install botversion-sdk
|
|
70
58
|
|
|
71
59
|
\## Quick start
|
|
72
60
|
|
|
73
|
-
|
|
74
|
-
|
|
75
61
|
Add the setup snippet to your backend entry file. See the documentation on your BotVersion dashboard for the exact snippet for your framework.
|
|
76
62
|
|
|
77
|
-
|
|
78
|
-
|
|
79
63
|
\## Support
|
|
80
64
|
|
|
81
|
-
|
|
82
|
-
|
|
83
65
|
For help, contact the BotVersion team through your dashboard.
|
|
84
|
-
|
|
@@ -1,42 +1,23 @@
|
|
|
1
1
|
\# BotVersion SDK (Python)
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
3
|
BotVersion adds a self-updating AI agent to your SaaS backend.
|
|
6
4
|
|
|
7
|
-
|
|
8
|
-
|
|
9
5
|
\## What it does
|
|
10
6
|
|
|
11
|
-
|
|
12
|
-
|
|
13
7
|
\- Scans your codebase and automatically discovers your API endpoints.
|
|
14
8
|
|
|
15
9
|
\- Keeps the endpoint list live, so new endpoints are detected automatically the first time they are called.
|
|
16
10
|
|
|
17
11
|
\- Lets an AI agent act on your app through its real, current API surface, with no manual endpoint maintenance.
|
|
18
12
|
|
|
19
|
-
|
|
20
|
-
|
|
21
13
|
\## Installation
|
|
22
14
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
  pip install botversion-sdk
|
|
26
|
-
|
|
27
|
-
|
|
15
|
+
  pip install botversion-sdk
|
|
28
16
|
|
|
29
17
|
\## Quick start
|
|
30
18
|
|
|
31
|
-
|
|
32
|
-
|
|
33
19
|
Add the setup snippet to your backend entry file. See the documentation on your BotVersion dashboard for the exact snippet for your framework.
|
|
34
20
|
|
|
35
|
-
|
|
36
|
-
|
|
37
21
|
\## Support
|
|
38
22
|
|
|
39
|
-
|
|
40
|
-
|
|
41
23
|
For help, contact the BotVersion team through your dashboard.
|
|
42
|
-
|
|
@@ -11,7 +11,7 @@ Normal requests are never touched. It never breaks the host app: any internal fa
|
|
|
11
11
|
"""
|
|
12
12
|
import importlib.util
|
|
13
13
|
|
|
14
|
-
from .lib import action_id, log, snapshot_crypto, tagger, undo_mongo, undo_mssql, undo_mysql, undo_pg, undo_route, undo_sqlite
|
|
14
|
+
from .lib import action_id, log, snapshot_crypto, tagger, undo_mongo, undo_mssql, undo_mysql, undo_pg, undo_prisma, undo_route, undo_sqlite
|
|
15
15
|
from .lib import report, scanner
|
|
16
16
|
from .lib.hooks import asyncpg as _asyncpg_hook
|
|
17
17
|
from .lib.hooks import psycopg as _psycopg3_hook
|
|
@@ -21,6 +21,7 @@ from .lib.hooks import sqlite as _sqlite_hook
|
|
|
21
21
|
from .lib.hooks import mysql as _mysql_hook
|
|
22
22
|
from .lib.hooks import mssql as _mssql_hook
|
|
23
23
|
from .lib.hooks import mongodb as _mongodb_hook
|
|
24
|
+
from .lib.hooks import prisma as _prisma_hook
|
|
24
25
|
|
|
25
26
|
__version__ = "0.4.0"
|
|
26
27
|
_started = False
|
|
@@ -68,7 +69,7 @@ def init(api_key=None, test_header=None, quiet=False):
|
|
|
68
69
|
tagger.set_api_key(api_key)
|
|
69
70
|
snapshot_crypto.set_api_key(api_key)
|
|
70
71
|
|
|
71
|
-
for _undo in (undo_pg, undo_sqlite, undo_mysql, undo_mssql, undo_mongo):
|
|
72
|
+
for _undo in (undo_prisma, undo_pg, undo_sqlite, undo_mysql, undo_mssql, undo_mongo):
|
|
72
73
|
if _undo not in undo_route.BACKENDS:
|
|
73
74
|
undo_route.BACKENDS.append(_undo) # turns Undo on for each database
|
|
74
75
|
targets = tagger.install() # 1. request tagger
|
|
@@ -81,7 +82,8 @@ def init(api_key=None, test_header=None, quiet=False):
|
|
|
81
82
|
"sqlite3": _sqlite_hook.attach(scan["hostRoot"]),
|
|
82
83
|
"mysql (PyMySQL, mysqlclient)": _mysql_hook.attach(scan["hostRoot"]),
|
|
83
84
|
"pyodbc (SQL Server)": _mssql_hook.attach(scan["hostRoot"]),
|
|
84
|
-
"pymongo (MongoDB)": _mongodb_hook.attach(scan["hostRoot"])
|
|
85
|
+
"pymongo (MongoDB)": _mongodb_hook.attach(scan["hostRoot"]),
|
|
86
|
+
"prisma (Prisma Client Python)": _prisma_hook.attach(scan["hostRoot"])}
|
|
85
87
|
report.print_report(scan, {"targets": targets, "header": tagger.get_header_name(),
|
|
86
88
|
"signedIds": tagger.has_api_key(), "hooks": hooks}) # 4. plain-language report
|
|
87
89
|
return {"ok": True}
|
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
from . import gate, tagger
|
|
2
|
+
from . import capture_guard as guard
|
|
3
|
+
from . import prisma_schema as PS
|
|
4
|
+
from . import snapshot_store as store
|
|
5
|
+
from .capture_sql import Result, _refuse, _refuse_async, key_of
|
|
6
|
+
from .prisma_io import (PrismaIO, actor_of, canon, delete_snapshots, dump, pk_object, pk_where,
|
|
7
|
+
result_row, snake, to_columns)
|
|
8
|
+
from .steps import drive_async, drive_sync
|
|
9
|
+
|
|
10
|
+
WRITES = ("create", "update", "delete", "update_many", "delete_many")
|
|
11
|
+
UNSAVABLE = ("create_many", "upsert", "execute_raw") # writes this package can never save
|
|
12
|
+
TX_ATTRS = ("_tx_id", "_transaction_id") # UNVERIFIED: how a client inside tx() marks itself
|
|
13
|
+
MAX_DEPTH = 5
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
class Skip(Exception):
|
|
17
|
+
pass
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def _decide(client, st, kwargs):
|
|
21
|
+
"""None = leave it alone, ("refuse", where, why) or ("capture", job)."""
|
|
22
|
+
method = snake(kwargs.get("method")) # UNVERIFIED: _execute is called with method=..., arguments=..., model=...
|
|
23
|
+
if method not in WRITES and method not in UNSAVABLE:
|
|
24
|
+
return None
|
|
25
|
+
try:
|
|
26
|
+
st.queries += 1
|
|
27
|
+
st.writes += 1
|
|
28
|
+
mcls = kwargs.get("model")
|
|
29
|
+
name = getattr(mcls, "__prisma_model__", None) or getattr(mcls, "__name__", None) # UNVERIFIED
|
|
30
|
+
label = (name or "?") + " " + method
|
|
31
|
+
if method in UNSAVABLE:
|
|
32
|
+
return ("refuse", label, method + " cannot be saved")
|
|
33
|
+
schema = PS.load()
|
|
34
|
+
if schema is None:
|
|
35
|
+
return ("refuse", label, "the Prisma schema file could not be read")
|
|
36
|
+
if schema.dialect is None or schema.dialect == "mongodb":
|
|
37
|
+
return ("refuse", label, "this database type is not supported through Prisma Python yet")
|
|
38
|
+
model = schema.models.get(name)
|
|
39
|
+
if model is not None and store.is_own_table(model.table):
|
|
40
|
+
return None # our own snapshot table is never captured
|
|
41
|
+
if model is None or model.unsupported or not model.pk:
|
|
42
|
+
return ("refuse", label, "model information not available or no primary key")
|
|
43
|
+
if any(getattr(client, a, None) for a in TX_ATTRS):
|
|
44
|
+
return ("refuse", label, "inside a host transaction")
|
|
45
|
+
args = kwargs.get("arguments") or {}
|
|
46
|
+
data = args.get("data")
|
|
47
|
+
if isinstance(data, dict):
|
|
48
|
+
rel = {f.name for f in model.fields if f.kind == "object"}
|
|
49
|
+
if any(k in rel and data[k] is not None for k in data):
|
|
50
|
+
return ("refuse", label, "nested writes touch other models")
|
|
51
|
+
if method in ("delete", "delete_many") and model.has_m2m:
|
|
52
|
+
return ("refuse", label, "implicit many-to-many links cannot be saved")
|
|
53
|
+
if actor_of(client, model.name) is None:
|
|
54
|
+
return ("refuse", label, "model accessor not found on the client")
|
|
55
|
+
return ("capture", {"client": client, "st": st, "model": model, "method": method,
|
|
56
|
+
"args": args, "schema": schema, "label": label})
|
|
57
|
+
except Exception:
|
|
58
|
+
return ("refuse", "?", "this write could not be read")
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def _rows_where(io, model, where, take=None):
|
|
62
|
+
kw = {}
|
|
63
|
+
if where is not None:
|
|
64
|
+
kw["where"] = where
|
|
65
|
+
if take:
|
|
66
|
+
kw["take"] = take
|
|
67
|
+
objs = yield io.call(model, "find_many", **kw)
|
|
68
|
+
return [dump(o) for o in (objs or [])]
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def _snap(io, st, model, row, kind, linked, saved_ids):
|
|
72
|
+
r = yield from store.save_snapshot(io, st, {
|
|
73
|
+
"table": model.table, "operation": kind, "primary_key": pk_object(model, row),
|
|
74
|
+
"before": to_columns(model, row), "after": None, "is_linked": linked})
|
|
75
|
+
if not r["ok"]:
|
|
76
|
+
raise Skip(r["reason"])
|
|
77
|
+
saved_ids.append(r["id"])
|
|
78
|
+
return r["id"]
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
def _before_update(io, job, saved_ids):
|
|
82
|
+
model, method, args = job["model"], job["method"], job["args"]
|
|
83
|
+
if method == "update":
|
|
84
|
+
row = yield io.call(model, "find_unique", where=args.get("where"))
|
|
85
|
+
rows = [] if row is None else [dump(row)]
|
|
86
|
+
else:
|
|
87
|
+
rows = yield from _rows_where(io, model, args.get("where"), store.ROW_LIMIT + 1)
|
|
88
|
+
c = store.check_capturable(len(rows), model.pk)
|
|
89
|
+
if not c["ok"]:
|
|
90
|
+
raise Skip(c["reason"])
|
|
91
|
+
items = []
|
|
92
|
+
for row in rows:
|
|
93
|
+
items.append({"id": (yield from _snap(io, job["st"], model, row, "update", False, saved_ids)), "row": row})
|
|
94
|
+
return {"groups": [{"model": model, "items": items, "kind": "update"}]}
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def _plan_delete(io, job):
|
|
98
|
+
"""Every row a delete will remove or change (through links). Saves nothing. Raises Skip when unsafe."""
|
|
99
|
+
model, method, args, schema = job["model"], job["method"], job["args"], job["schema"]
|
|
100
|
+
if method == "delete":
|
|
101
|
+
row = yield io.call(model, "find_unique", where=args.get("where"))
|
|
102
|
+
roots = [] if row is None else [dump(row)]
|
|
103
|
+
else:
|
|
104
|
+
roots = yield from _rows_where(io, model, args.get("where"), store.ROW_LIMIT + 1)
|
|
105
|
+
c = store.check_capturable(len(roots), model.pk)
|
|
106
|
+
if not c["ok"]:
|
|
107
|
+
raise Skip(c["reason"])
|
|
108
|
+
groups = [{"model": model, "rows": roots, "depth": 0, "kind": "delete"}]
|
|
109
|
+
tag = lambda m, r: m.name + "\x02" + key_of(r, m.pk)
|
|
110
|
+
deleted_at, cleared = {}, set()
|
|
111
|
+
for r in roots:
|
|
112
|
+
deleted_at[tag(model, r)] = 0
|
|
113
|
+
frontier = [groups[0]] if roots else []
|
|
114
|
+
total = len(roots)
|
|
115
|
+
depth = 1
|
|
116
|
+
while frontier:
|
|
117
|
+
nxt = []
|
|
118
|
+
for parent in frontier:
|
|
119
|
+
for link in schema.links.get(parent["model"].name, []):
|
|
120
|
+
cascades = link.rule == "Cascade"
|
|
121
|
+
if not cascades and link.rule not in ("SetNull", "SetDefault"):
|
|
122
|
+
continue # Restrict / NoAction: the database refuses the delete itself
|
|
123
|
+
child = schema.models.get(link.child)
|
|
124
|
+
if child is None or child.unsupported or not child.pk:
|
|
125
|
+
raise Skip("a linked model cannot be saved")
|
|
126
|
+
if child.has_m2m:
|
|
127
|
+
raise Skip("implicit many-to-many links cannot be saved")
|
|
128
|
+
ors = []
|
|
129
|
+
for r in parent["rows"]:
|
|
130
|
+
w = {f: r[t] for f, t in zip(link.from_fields, link.to_fields)}
|
|
131
|
+
if all(v is not None for v in w.values()):
|
|
132
|
+
ors.append(w)
|
|
133
|
+
if not ors:
|
|
134
|
+
continue
|
|
135
|
+
found = yield from _rows_where(io, child, {"OR": ors}, store.ROW_LIMIT + 1)
|
|
136
|
+
if not found:
|
|
137
|
+
continue
|
|
138
|
+
if depth > MAX_DEPTH:
|
|
139
|
+
raise Skip("links go too deep")
|
|
140
|
+
cc = store.check_capturable(len(found), child.pk)
|
|
141
|
+
if not cc["ok"]:
|
|
142
|
+
raise Skip(cc["reason"])
|
|
143
|
+
fresh = []
|
|
144
|
+
for r in found:
|
|
145
|
+
k = tag(child, r)
|
|
146
|
+
if cascades:
|
|
147
|
+
if k in deleted_at:
|
|
148
|
+
if deleted_at[k] != depth:
|
|
149
|
+
raise Skip("a row is reached through links of different depth")
|
|
150
|
+
continue
|
|
151
|
+
deleted_at[k] = depth
|
|
152
|
+
else:
|
|
153
|
+
if k in cleared:
|
|
154
|
+
continue
|
|
155
|
+
cleared.add(k)
|
|
156
|
+
fresh.append(r)
|
|
157
|
+
total += len(fresh)
|
|
158
|
+
if total > store.ROW_LIMIT:
|
|
159
|
+
raise Skip("too-many-rows")
|
|
160
|
+
if not fresh:
|
|
161
|
+
continue
|
|
162
|
+
grp = {"model": child, "rows": fresh, "depth": depth, "kind": "delete" if cascades else "update"}
|
|
163
|
+
groups.append(grp)
|
|
164
|
+
if cascades:
|
|
165
|
+
nxt.append(grp)
|
|
166
|
+
frontier = nxt
|
|
167
|
+
depth += 1
|
|
168
|
+
for g in groups: # a row that is deleted does not also need its link cleared
|
|
169
|
+
if g["kind"] == "update":
|
|
170
|
+
g["rows"] = [r for r in g["rows"] if tag(g["model"], r) not in deleted_at]
|
|
171
|
+
return [g for g in groups if g["rows"]]
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
def _before_delete(io, job, saved_ids):
|
|
175
|
+
groups = yield from _plan_delete(io, job)
|
|
176
|
+
out = []
|
|
177
|
+
for g in sorted(groups, key=lambda x: -x["depth"]): # deepest first, deleted rows last (Undo goes last to first)
|
|
178
|
+
items = []
|
|
179
|
+
for row in g["rows"]:
|
|
180
|
+
items.append({"id": (yield from _snap(io, job["st"], g["model"], row, g["kind"], g["depth"] > 0, saved_ids)),
|
|
181
|
+
"row": row})
|
|
182
|
+
out.append({"model": g["model"], "items": items, "kind": g["kind"]})
|
|
183
|
+
return {"groups": out}
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
def _settle(io, model, items, kind):
|
|
187
|
+
"""After the write: keep only the snapshots of rows this write really changed or removed."""
|
|
188
|
+
now = yield from _rows_where(io, model, {"OR": [pk_where(model, s["row"]) for s in items]})
|
|
189
|
+
by_key = {key_of(r, model.pk): r for r in now}
|
|
190
|
+
drop = []
|
|
191
|
+
for s in items:
|
|
192
|
+
cur = by_key.get(key_of(s["row"], model.pk))
|
|
193
|
+
if kind == "delete":
|
|
194
|
+
if cur is not None:
|
|
195
|
+
drop.append(s["id"]) # still there: this write did not delete it
|
|
196
|
+
continue
|
|
197
|
+
if cur is None or canon(to_columns(model, cur)) == canon(to_columns(model, s["row"])):
|
|
198
|
+
drop.append(s["id"]) # unchanged (or gone): nothing of this write to undo
|
|
199
|
+
continue
|
|
200
|
+
yield from store.save_after(io, s["id"], to_columns(model, cur))
|
|
201
|
+
yield from delete_snapshots(io, drop)
|
|
202
|
+
|
|
203
|
+
|
|
204
|
+
def _after_create(io, job, result, not_saved):
|
|
205
|
+
model = job["model"]
|
|
206
|
+
row = result_row(result)
|
|
207
|
+
if not row or not all(n in row for n in model.pk):
|
|
208
|
+
return not_saved("new row primary key not in the result")
|
|
209
|
+
full = yield io.call(model, "find_first", where={n: row[n] for n in model.pk})
|
|
210
|
+
if full is None:
|
|
211
|
+
return not_saved("new row could not be read back")
|
|
212
|
+
full = dump(full)
|
|
213
|
+
s = yield from store.save_snapshot(io, job["st"], {
|
|
214
|
+
"table": model.table, "operation": "insert", "primary_key": pk_object(model, full),
|
|
215
|
+
"before": None, "after": to_columns(model, full), "is_linked": False})
|
|
216
|
+
if not s["ok"]:
|
|
217
|
+
not_saved(s["reason"])
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
def run_capture(io, job):
|
|
221
|
+
st, method = job["st"], job["method"]
|
|
222
|
+
saved_ids = []
|
|
223
|
+
state = {"phase": "before", "failed": None}
|
|
224
|
+
|
|
225
|
+
def not_saved(why):
|
|
226
|
+
if state["phase"] == "before" and state["failed"] is None:
|
|
227
|
+
state["failed"] = why
|
|
228
|
+
if state["phase"] != "before" or st.confirmed:
|
|
229
|
+
st.unsaved = True
|
|
230
|
+
|
|
231
|
+
before = None
|
|
232
|
+
try:
|
|
233
|
+
if method in ("update", "update_many"):
|
|
234
|
+
before = yield from _before_update(io, job, saved_ids)
|
|
235
|
+
elif method in ("delete", "delete_many"):
|
|
236
|
+
before = yield from _before_delete(io, job, saved_ids)
|
|
237
|
+
except Skip as e:
|
|
238
|
+
not_saved(str(e))
|
|
239
|
+
except Exception as e:
|
|
240
|
+
not_saved("capture error " + str(store.err_code(e)))
|
|
241
|
+
if state["failed"]: # remove what was saved so far (a half-saved set could restore only part), then block unless confirmed
|
|
242
|
+
yield from delete_snapshots(io, saved_ids)
|
|
243
|
+
before = None
|
|
244
|
+
if not st.confirmed:
|
|
245
|
+
yield io.block(st, job["label"], state["failed"])
|
|
246
|
+
state["phase"] = "after"
|
|
247
|
+
r = (yield io.exec_host())
|
|
248
|
+
try: # also runs when the host's write failed: many-row writes can stop part-way
|
|
249
|
+
if not state["failed"]:
|
|
250
|
+
if method == "create":
|
|
251
|
+
if r["err"] is None:
|
|
252
|
+
yield from _after_create(io, job, r["result"], not_saved)
|
|
253
|
+
elif before:
|
|
254
|
+
for g in before["groups"]:
|
|
255
|
+
if g["items"]:
|
|
256
|
+
yield from _settle(io, g["model"], g["items"], g["kind"])
|
|
257
|
+
except Exception as e:
|
|
258
|
+
not_saved("capture error " + str(store.err_code(e)))
|
|
259
|
+
return r
|
|
260
|
+
|
|
261
|
+
|
|
262
|
+
def maybe_capture(client, kwargs, host_call):
|
|
263
|
+
"""Sync client. Returns Result when capture took over, otherwise None (the caller runs the write normally)."""
|
|
264
|
+
st = tagger.get_current()
|
|
265
|
+
if st is None or guard.is_unhooked():
|
|
266
|
+
return None
|
|
267
|
+
plan = _decide(client, st, kwargs)
|
|
268
|
+
if plan is None:
|
|
269
|
+
return None
|
|
270
|
+
if plan[0] == "refuse":
|
|
271
|
+
_refuse(st, plan[1], plan[2]) # raises Blocked, or returns when the user already confirmed
|
|
272
|
+
return None
|
|
273
|
+
io = PrismaIO(client, plan[1]["schema"], False, host_call)
|
|
274
|
+
try:
|
|
275
|
+
out = drive_sync(run_capture(io, plan[1]))
|
|
276
|
+
except gate.Blocked:
|
|
277
|
+
raise
|
|
278
|
+
except Exception:
|
|
279
|
+
if io.host_outcome is None:
|
|
280
|
+
st.unsaved = True
|
|
281
|
+
return None
|
|
282
|
+
out = io.host_outcome
|
|
283
|
+
if out["err"] is not None:
|
|
284
|
+
raise out["err"]
|
|
285
|
+
return Result(out["result"])
|
|
286
|
+
|
|
287
|
+
|
|
288
|
+
async def maybe_capture_async(client, kwargs, host_call):
|
|
289
|
+
"""Async client twin of maybe_capture."""
|
|
290
|
+
st = tagger.get_current()
|
|
291
|
+
if st is None or guard.is_unhooked():
|
|
292
|
+
return None
|
|
293
|
+
plan = _decide(client, st, kwargs)
|
|
294
|
+
if plan is None:
|
|
295
|
+
return None
|
|
296
|
+
if plan[0] == "refuse":
|
|
297
|
+
await _refuse_async(st, plan[1], plan[2])
|
|
298
|
+
return None
|
|
299
|
+
io = PrismaIO(client, plan[1]["schema"], True, host_call)
|
|
300
|
+
try:
|
|
301
|
+
out = await drive_async(run_capture(io, plan[1]))
|
|
302
|
+
except gate.Blocked:
|
|
303
|
+
raise
|
|
304
|
+
except Exception:
|
|
305
|
+
if io.host_outcome is None:
|
|
306
|
+
st.unsaved = True
|
|
307
|
+
return None
|
|
308
|
+
out = io.host_outcome
|
|
309
|
+
if out["err"] is not None:
|
|
310
|
+
raise out["err"]
|
|
311
|
+
return Result(out["result"])
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import asyncio
|
|
2
|
+
import functools
|
|
3
|
+
import inspect
|
|
4
|
+
from .. import capture_prisma as capture
|
|
5
|
+
from .. import loader_watch, undo_prisma
|
|
6
|
+
|
|
7
|
+
MARK = "_bv_hooked"
|
|
8
|
+
attached_copies = []
|
|
9
|
+
_MODULES = ("prisma._base_client", "prisma.client") # both hold the same client classes
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def _in_transaction(client):
|
|
13
|
+
return bool(getattr(client, "_tx_id", None)) # a client inside tx() carries a transaction id
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def _named(sig, self, args, kwargs):
|
|
17
|
+
"""The call as {method, arguments, model, root_selection}, whether passed by position (sync client) or by name (async client)."""
|
|
18
|
+
try:
|
|
19
|
+
d = dict(sig.bind(self, *args, **kwargs).arguments)
|
|
20
|
+
d.pop("self", None)
|
|
21
|
+
return d
|
|
22
|
+
except TypeError:
|
|
23
|
+
return dict(kwargs)
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def _wrap(orig):
|
|
27
|
+
sig = inspect.signature(orig)
|
|
28
|
+
if inspect.iscoroutinefunction(orig):
|
|
29
|
+
@functools.wraps(orig)
|
|
30
|
+
async def wrapper(self, *args, **kwargs):
|
|
31
|
+
try:
|
|
32
|
+
if not _in_transaction(self):
|
|
33
|
+
undo_prisma.remember(self, asyncio.get_running_loop())
|
|
34
|
+
except Exception:
|
|
35
|
+
pass
|
|
36
|
+
handled = await capture.maybe_capture_async(self, _named(sig, self, args, kwargs),
|
|
37
|
+
lambda: orig(self, *args, **kwargs))
|
|
38
|
+
if handled is not None:
|
|
39
|
+
return handled.value
|
|
40
|
+
return await orig(self, *args, **kwargs)
|
|
41
|
+
return wrapper
|
|
42
|
+
|
|
43
|
+
@functools.wraps(orig)
|
|
44
|
+
def wrapper(self, *args, **kwargs):
|
|
45
|
+
try:
|
|
46
|
+
if not _in_transaction(self):
|
|
47
|
+
undo_prisma.remember(self, None)
|
|
48
|
+
except Exception:
|
|
49
|
+
pass
|
|
50
|
+
handled = capture.maybe_capture(self, _named(sig, self, args, kwargs), lambda: orig(self, *args, **kwargs))
|
|
51
|
+
if handled is not None:
|
|
52
|
+
return handled.value
|
|
53
|
+
return orig(self, *args, **kwargs)
|
|
54
|
+
return wrapper
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def patch_module(mod):
|
|
58
|
+
"""Wraps _execute on every class of this module that defines it (async and sync clients)."""
|
|
59
|
+
patched = False
|
|
60
|
+
for _name, cls in inspect.getmembers(mod, inspect.isclass):
|
|
61
|
+
orig = cls.__dict__.get("_execute")
|
|
62
|
+
if orig is None or not callable(orig) or getattr(orig, MARK, False):
|
|
63
|
+
continue
|
|
64
|
+
wrapped = _wrap(orig)
|
|
65
|
+
setattr(wrapped, MARK, True)
|
|
66
|
+
setattr(cls, "_execute", wrapped)
|
|
67
|
+
patched = True
|
|
68
|
+
if patched:
|
|
69
|
+
attached_copies.append(getattr(mod, "__file__", None) or "unknown location")
|
|
70
|
+
return patched
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
def attach(host_root=None):
|
|
74
|
+
loader_watch.on_load(lambda name: name in _MODULES, patch_module)
|
|
75
|
+
return attached_copies[:]
|