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.
Files changed (91) hide show
  1. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/PKG-INFO +2 -21
  2. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/README.md +1 -20
  3. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/__init__.py +5 -3
  4. botversion_sdk-2.3.1/botversion_sdk/undo/lib/capture_prisma.py +311 -0
  5. botversion_sdk-2.3.1/botversion_sdk/undo/lib/hooks/prisma.py +75 -0
  6. botversion_sdk-2.3.1/botversion_sdk/undo/lib/prisma_io.py +177 -0
  7. botversion_sdk-2.3.1/botversion_sdk/undo/lib/prisma_schema.py +152 -0
  8. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/scanner.py +17 -2
  9. botversion_sdk-2.3.1/botversion_sdk/undo/lib/undo_prisma.py +244 -0
  10. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/PKG-INFO +2 -21
  11. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/SOURCES.txt +5 -0
  12. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/setup.py +1 -1
  13. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/__init__.py +0 -0
  14. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/__init__.py +0 -0
  15. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/bin/__init__.py +0 -0
  16. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/bin/scan_endpoints.py +0 -0
  17. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/client.py +0 -0
  18. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/interceptor.py +0 -0
  19. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/__init__.py +0 -0
  20. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/aiohttp.py +0 -0
  21. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/bottle.py +0 -0
  22. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/cherrypy.py +0 -0
  23. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/common.py +0 -0
  24. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django.py +0 -0
  25. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_bodies.py +0 -0
  26. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_urls.py +0 -0
  27. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/django_static_views.py +0 -0
  28. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/falcon.py +0 -0
  29. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/fastapi.py +0 -0
  30. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/fastapi_static.py +0 -0
  31. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/flask.py +0 -0
  32. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/multipart.py +0 -0
  33. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/pyramid.py +0 -0
  34. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/response_shapes.py +0 -0
  35. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/sanic.py +0 -0
  36. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/sanic_static.py +0 -0
  37. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/starlette.py +0 -0
  38. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/starlette_static.py +0 -0
  39. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/static_common.py +0 -0
  40. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scan/tornado.py +0 -0
  41. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/scanner_sdk/scanner.py +0 -0
  42. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/__main__.py +0 -0
  43. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/bin/__init__.py +0 -0
  44. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/bin/scan.py +0 -0
  45. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/__init__.py +0 -0
  46. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/action_id.py +0 -0
  47. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_guard.py +0 -0
  48. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mongo.py +0 -0
  49. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mssql.py +0 -0
  50. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_mysql.py +0 -0
  51. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_sql.py +0 -0
  52. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/capture_sqlite.py +0 -0
  53. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/gate.py +0 -0
  54. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/__init__.py +0 -0
  55. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/asyncpg.py +0 -0
  56. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mongodb.py +0 -0
  57. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mssql.py +0 -0
  58. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/mysql.py +0 -0
  59. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg.py +0 -0
  60. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg2.py +0 -0
  61. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/psycopg_async.py +0 -0
  62. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/hooks/sqlite.py +0 -0
  63. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/loader_watch.py +0 -0
  64. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/log.py +0 -0
  65. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/mssql_sql.py +0 -0
  66. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/mysql_sql.py +0 -0
  67. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/refuse.py +0 -0
  68. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/report.py +0 -0
  69. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/requester.py +0 -0
  70. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/setup_check.py +0 -0
  71. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_crypto.py +0 -0
  72. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_sql.py +0 -0
  73. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_store.py +0 -0
  74. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/snapshot_store_mongo.py +0 -0
  75. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/sql_classify.py +0 -0
  76. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/sqlite_sql.py +0 -0
  77. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/steps.py +0 -0
  78. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/tagger.py +0 -0
  79. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mongo.py +0 -0
  80. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mssql.py +0 -0
  81. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_mysql.py +0 -0
  82. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_pg.py +0 -0
  83. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_route.py +0 -0
  84. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/lib/undo_sqlite.py +0 -0
  85. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk/undo/register.py +0 -0
  86. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/dependency_links.txt +0 -0
  87. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/entry_points.txt +0 -0
  88. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/requires.txt +0 -0
  89. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/botversion_sdk.egg-info/top_level.txt +0 -0
  90. {botversion_sdk-2.3.0 → botversion_sdk-2.3.1}/pyproject.toml +0 -0
  91. {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.0
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[:]