graphcore-kernel 0.1.0__py3-none-any.whl

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 (343) hide show
  1. graphcore/__init__.py +5 -0
  2. graphcore/agent_frontend/__init__.py +8 -0
  3. graphcore/agent_frontend/api.py +69 -0
  4. graphcore/agent_frontend/base/__init__.py +11 -0
  5. graphcore/agent_frontend/base/views.py +167 -0
  6. graphcore/agent_frontend/client.py +31 -0
  7. graphcore/agent_frontend/context.py +157 -0
  8. graphcore/agent_frontend/errors.py +12 -0
  9. graphcore/agent_frontend/loading.py +54 -0
  10. graphcore/agent_frontend/registry.py +42 -0
  11. graphcore/agent_frontend/render.py +207 -0
  12. graphcore/agent_frontend/server.py +103 -0
  13. graphcore/agent_frontend/signatures.py +35 -0
  14. graphcore/agent_frontend/testing.py +45 -0
  15. graphcore/agent_frontend/tests/__init__.py +0 -0
  16. graphcore/agent_frontend/tests/fakes.py +114 -0
  17. graphcore/agent_frontend/tests/test_frontend.py +447 -0
  18. graphcore/agent_frontend/tests/test_loading.py +83 -0
  19. graphcore/agent_frontend/tests/test_server.py +109 -0
  20. graphcore/agent_frontend/tools.py +137 -0
  21. graphcore/api/__init__.py +4 -0
  22. graphcore/api/graph_api.py +378 -0
  23. graphcore/api/predicate_codec.py +81 -0
  24. graphcore/api/tests/__init__.py +0 -0
  25. graphcore/api/tests/test_changed_entities.py +109 -0
  26. graphcore/api/tests/test_graph_api.py +290 -0
  27. graphcore/api/tests/test_graph_api_access.py +94 -0
  28. graphcore/api/tests/test_graph_api_grants.py +90 -0
  29. graphcore/api/tests/test_predicate_codec.py +83 -0
  30. graphcore/api/tests/test_subtree_query.py +79 -0
  31. graphcore/apps.py +71 -0
  32. graphcore/auth/__init__.py +1 -0
  33. graphcore/auth/authn/README.md +178 -0
  34. graphcore/auth/authn/__init__.py +3 -0
  35. graphcore/auth/authn/authenticator.py +120 -0
  36. graphcore/auth/authn/onboarding.py +105 -0
  37. graphcore/auth/authn/principals.py +20 -0
  38. graphcore/auth/authn/resource_metadata.py +43 -0
  39. graphcore/auth/authn/service_accounts.py +96 -0
  40. graphcore/auth/authn/testing.py +96 -0
  41. graphcore/auth/authn/tests/__init__.py +0 -0
  42. graphcore/auth/authn/tests/test_authenticator.py +145 -0
  43. graphcore/auth/authn/tests/test_onboarding.py +145 -0
  44. graphcore/auth/authn/tests/test_service_accounts.py +180 -0
  45. graphcore/auth/authn/users.py +59 -0
  46. graphcore/auth/authz/__init__.py +0 -0
  47. graphcore/auth/authz/access_port.py +120 -0
  48. graphcore/auth/authz/adapter/__init__.py +0 -0
  49. graphcore/auth/authz/adapter/default_access_adapter.py +556 -0
  50. graphcore/auth/authz/adapter/tests/__init__.py +0 -0
  51. graphcore/auth/authz/adapter/tests/test_default_adapter.py +543 -0
  52. graphcore/auth/authz/adapter/tests/test_entity_write_hooks.py +207 -0
  53. graphcore/auth/authz/adapter/tests/test_group_types.py +70 -0
  54. graphcore/auth/authz/adapter/tests/test_sync_support.py +209 -0
  55. graphcore/auth/authz/defaults.py +26 -0
  56. graphcore/auth/authz/kernel_policy.py +191 -0
  57. graphcore/auth/authz/kernel_writes.py +31 -0
  58. graphcore/auth/authz/lookups.py +25 -0
  59. graphcore/auth/authz/policy.py +403 -0
  60. graphcore/auth/authz/tests/__init__.py +0 -0
  61. graphcore/auth/authz/tests/test_can_contain.py +150 -0
  62. graphcore/auth/authz/tests/test_contained_by.py +167 -0
  63. graphcore/auth/authz/tests/test_creation.py +391 -0
  64. graphcore/auth/authz/tests/test_delete_permission.py +82 -0
  65. graphcore/auth/authz/tests/test_granted_to_me.py +160 -0
  66. graphcore/auth/authz/tests/test_integration.py +637 -0
  67. graphcore/auth/authz/tests/test_invites.py +184 -0
  68. graphcore/auth/authz/tests/test_kernel_policy.py +140 -0
  69. graphcore/auth/authz/tests/test_lockout.py +132 -0
  70. graphcore/auth/authz/tests/test_policy.py +329 -0
  71. graphcore/auth/authz/tests/test_primitives.py +73 -0
  72. graphcore/auth/authz/tests/test_principal_creation.py +62 -0
  73. graphcore/bootstrap/__init__.py +0 -0
  74. graphcore/bootstrap/deployment.py +67 -0
  75. graphcore/bootstrap/signals.py +16 -0
  76. graphcore/bootstrap/tests/__init__.py +0 -0
  77. graphcore/bootstrap/tests/test_deployment_seed.py +154 -0
  78. graphcore/broadcast/__init__.py +4 -0
  79. graphcore/broadcast/broadcaster.py +201 -0
  80. graphcore/broadcast/channels.py +56 -0
  81. graphcore/broadcast/tests/__init__.py +0 -0
  82. graphcore/broadcast/tests/test_broadcaster.py +444 -0
  83. graphcore/celery.py +14 -0
  84. graphcore/docs/AGENT_FRONTEND_TDD.md +389 -0
  85. graphcore/docs/ARCHITECTURE_PRINCIPLES.md +152 -0
  86. graphcore/docs/AUTHORIZATION_TECHNICAL_TDD.md +1379 -0
  87. graphcore/docs/ENTITY_REFERENCE_TDD.md +561 -0
  88. graphcore/docs/GRAPHAPI_FRONT_DOOR.md +173 -0
  89. graphcore/docs/RUNTIME.md +90 -0
  90. graphcore/docs/SCHEDULING_TDD.md +244 -0
  91. graphcore/docs/STRATEGY_EXECUTION_TDD.md +1043 -0
  92. graphcore/docs/VIEW_ENTITY_TDD.md +522 -0
  93. graphcore/docs/VIEW_SYSTEM_TDD.md +307 -0
  94. graphcore/docs/__init__.py +0 -0
  95. graphcore/docs/doc_topics.py +97 -0
  96. graphcore/docs/docs_discovery.py +64 -0
  97. graphcore/docs/public_api.py +56 -0
  98. graphcore/domain/__init__.py +0 -0
  99. graphcore/domain/entity/Entity.py +204 -0
  100. graphcore/domain/entity/__init__.py +0 -0
  101. graphcore/domain/entity/deployment/Deployment.py +25 -0
  102. graphcore/domain/entity/deployment/__init__.py +0 -0
  103. graphcore/domain/entity/grant/Grant.py +31 -0
  104. graphcore/domain/entity/grant/__init__.py +0 -0
  105. graphcore/domain/entity/group/Group.py +48 -0
  106. graphcore/domain/entity/group/README.md +88 -0
  107. graphcore/domain/entity/group/__init__.py +0 -0
  108. graphcore/domain/entity/invite/Invite.py +31 -0
  109. graphcore/domain/entity/invite/__init__.py +0 -0
  110. graphcore/domain/entity/request_template/RequestTemplate.py +48 -0
  111. graphcore/domain/entity/request_template/__init__.py +0 -0
  112. graphcore/domain/entity/request_template/tests/__init__.py +0 -0
  113. graphcore/domain/entity/request_template/tests/test_request_template.py +52 -0
  114. graphcore/domain/entity/service_account/ServiceAccount.py +41 -0
  115. graphcore/domain/entity/service_account/__init__.py +0 -0
  116. graphcore/domain/entity/strategy_request/StrategyRequest.py +61 -0
  117. graphcore/domain/entity/strategy_request/__init__.py +0 -0
  118. graphcore/domain/entity/strategy_request/tests/__init__.py +0 -0
  119. graphcore/domain/entity/strategy_request/tests/test_strategy_request_entity.py +35 -0
  120. graphcore/domain/entity/tests/__init__.py +0 -0
  121. graphcore/domain/entity/tests/test_entity.py +227 -0
  122. graphcore/domain/entity/tests/test_grant_group_entities.py +36 -0
  123. graphcore/domain/entity/tests/test_write_once_fields.py +98 -0
  124. graphcore/domain/entity/user/User.py +39 -0
  125. graphcore/domain/entity/user/__init__.py +0 -0
  126. graphcore/domain/entity/user/tests/__init__.py +0 -0
  127. graphcore/domain/entity/user/tests/test_user_entity.py +33 -0
  128. graphcore/domain/entity/view/View.py +37 -0
  129. graphcore/domain/entity/view/__init__.py +0 -0
  130. graphcore/domain/entity/view/position.py +78 -0
  131. graphcore/domain/entity/view/tests/__init__.py +0 -0
  132. graphcore/domain/entity/view/tests/test_position.py +71 -0
  133. graphcore/domain/entity/view/tests/test_view_entity.py +134 -0
  134. graphcore/domain/strategy/BaseStrategy.py +759 -0
  135. graphcore/domain/strategy/DeploymentStrategies.py +55 -0
  136. graphcore/domain/strategy/GrantStrategies.py +189 -0
  137. graphcore/domain/strategy/GroupStrategies.py +193 -0
  138. graphcore/domain/strategy/InviteStrategies.py +84 -0
  139. graphcore/domain/strategy/RequestTemplateStrategies.py +126 -0
  140. graphcore/domain/strategy/ViewStrategies.py +219 -0
  141. graphcore/domain/strategy/__init__.py +0 -0
  142. graphcore/domain/strategy/runner.py +84 -0
  143. graphcore/domain/strategy/session.py +56 -0
  144. graphcore/domain/strategy/tests/BaseStrategyTest.py +167 -0
  145. graphcore/domain/strategy/tests/__init__.py +0 -0
  146. graphcore/domain/strategy/tests/test_BaseStrategies.py +870 -0
  147. graphcore/domain/strategy/tests/test_grant_strategies.py +245 -0
  148. graphcore/domain/strategy/tests/test_group_strategies.py +99 -0
  149. graphcore/domain/strategy/tests/test_runner.py +220 -0
  150. graphcore/domain/strategy/tests/test_strategy_locks.py +446 -0
  151. graphcore/domain/strategy/tests/test_utils.py +95 -0
  152. graphcore/domain/strategy/tests/test_view_strategies.py +436 -0
  153. graphcore/errors.py +145 -0
  154. graphcore/execution/README.md +97 -0
  155. graphcore/execution/StrategyExecutorService.py +333 -0
  156. graphcore/execution/__init__.py +0 -0
  157. graphcore/execution/dispatcher.py +19 -0
  158. graphcore/execution/environments/__init__.py +0 -0
  159. graphcore/execution/environments/celery.py +59 -0
  160. graphcore/execution/environments/in_process.py +55 -0
  161. graphcore/execution/local_session.py +117 -0
  162. graphcore/execution/redis_run_events.py +74 -0
  163. graphcore/execution/requests.py +22 -0
  164. graphcore/execution/run_events.py +85 -0
  165. graphcore/execution/strategy_context.py +54 -0
  166. graphcore/execution/tasks.py +34 -0
  167. graphcore/execution/tests/__init__.py +5 -0
  168. graphcore/execution/tests/contract.py +171 -0
  169. graphcore/execution/tests/support.py +310 -0
  170. graphcore/execution/tests/test_dispatchers.py +76 -0
  171. graphcore/execution/tests/test_executor.py +368 -0
  172. graphcore/execution/tests/test_local_session.py +95 -0
  173. graphcore/execution/tests/test_reconcile_runs.py +134 -0
  174. graphcore/execution/tests/test_run_events.py +106 -0
  175. graphcore/execution/tests/test_strategy_context.py +62 -0
  176. graphcore/gateway/__init__.py +1 -0
  177. graphcore/gateway/remote.py +35 -0
  178. graphcore/gateway/tests/__init__.py +0 -0
  179. graphcore/gateway/tests/test_remote.py +30 -0
  180. graphcore/graph/EntityService.py +710 -0
  181. graphcore/graph/__init__.py +0 -0
  182. graphcore/graph/entity_cache.py +152 -0
  183. graphcore/graph/tests/__init__.py +4 -0
  184. graphcore/graph/tests/test_EntityService.py +908 -0
  185. graphcore/graph/tests/test_EntityService_list.py +170 -0
  186. graphcore/graph/tests/test_EntityService_model_resolution.py +339 -0
  187. graphcore/graph/tests/test_EntityService_referrers.py +236 -0
  188. graphcore/graph/tests/test_EntityService_routing.py +119 -0
  189. graphcore/graph/tests/test_dependent_on.py +141 -0
  190. graphcore/graph/tests/test_engine_is_type_agnostic.py +25 -0
  191. graphcore/graph/tests/test_engine_resolves_read_permission.py +93 -0
  192. graphcore/graph/tests/test_entity_cache.py +159 -0
  193. graphcore/graph/tests/test_null_entity_cache.py +12 -0
  194. graphcore/management/__init__.py +0 -0
  195. graphcore/management/commands/__init__.py +0 -0
  196. graphcore/management/commands/dev_reset.py +18 -0
  197. graphcore/management/commands/graphcore_createadmin.py +65 -0
  198. graphcore/management/commands/graphcore_policy.py +59 -0
  199. graphcore/management/commands/graphcore_status.py +98 -0
  200. graphcore/management/tests/__init__.py +0 -0
  201. graphcore/management/tests/test_createadmin.py +78 -0
  202. graphcore/management/tests/test_policy_command.py +46 -0
  203. graphcore/management/tests/test_status_command.py +85 -0
  204. graphcore/migrations/0001_initial.py +186 -0
  205. graphcore/migrations/0002_invite.py +26 -0
  206. graphcore/migrations/__init__.py +0 -0
  207. graphcore/models.py +11 -0
  208. graphcore/persistence/ENTITY_REPOSITORY_TECHNICAL_TDD.md +396 -0
  209. graphcore/persistence/__init__.py +6 -0
  210. graphcore/persistence/django/__init__.py +0 -0
  211. graphcore/persistence/django/backends.py +43 -0
  212. graphcore/persistence/django/bindings.py +28 -0
  213. graphcore/persistence/django/cache.py +38 -0
  214. graphcore/persistence/django/compiler.py +214 -0
  215. graphcore/persistence/django/identity.py +18 -0
  216. graphcore/persistence/django/models.py +252 -0
  217. graphcore/persistence/django/repository.py +525 -0
  218. graphcore/persistence/django/tests/__init__.py +0 -0
  219. graphcore/persistence/django/tests/test_backends.py +68 -0
  220. graphcore/persistence/django/tests/test_compiler.py +269 -0
  221. graphcore/persistence/django/tests/test_repository.py +472 -0
  222. graphcore/persistence/django/tests/test_shared_column.py +120 -0
  223. graphcore/persistence/django/tests/test_threads.py +50 -0
  224. graphcore/persistence/django/tests/test_update_shape.py +175 -0
  225. graphcore/persistence/django/threads.py +38 -0
  226. graphcore/persistence/repository.py +172 -0
  227. graphcore/persistence/tests/__init__.py +0 -0
  228. graphcore/persistence/tests/contract.py +688 -0
  229. graphcore/persistence/tests/evaluate.py +51 -0
  230. graphcore/persistence/tests/fixtures.py +32 -0
  231. graphcore/persistence/tests/memory.py +263 -0
  232. graphcore/persistence/tests/test_memory_repository.py +10 -0
  233. graphcore/persistence/tests/test_query_types.py +127 -0
  234. graphcore/public/__init__.py +9 -0
  235. graphcore/public/api.py +9 -0
  236. graphcore/public/apps.py +10 -0
  237. graphcore/public/auth/__init__.py +1 -0
  238. graphcore/public/auth/grants.py +7 -0
  239. graphcore/public/auth/onboarding.py +8 -0
  240. graphcore/public/auth/perms.py +7 -0
  241. graphcore/public/auth/policy.py +10 -0
  242. graphcore/public/auth/roles.py +8 -0
  243. graphcore/public/auth/subjects.py +7 -0
  244. graphcore/public/entities/__init__.py +32 -0
  245. graphcore/public/errors.py +19 -0
  246. graphcore/public/persistence/__init__.py +44 -0
  247. graphcore/public/persistence/django.py +24 -0
  248. graphcore/public/scheduling.py +23 -0
  249. graphcore/public/strategies/__init__.py +85 -0
  250. graphcore/public/test_settings.py +16 -0
  251. graphcore/public/testing.py +47 -0
  252. graphcore/registry/EntityDirectory.py +246 -0
  253. graphcore/registry/README.md +147 -0
  254. graphcore/registry/StrategyDirectory.py +308 -0
  255. graphcore/registry/TYPE_METADATA_PLACEMENT.md +66 -0
  256. graphcore/registry/__init__.py +0 -0
  257. graphcore/registry/app_discovery.py +108 -0
  258. graphcore/registry/decorators.py +77 -0
  259. graphcore/registry/discovery.py +111 -0
  260. graphcore/registry/registry.py +79 -0
  261. graphcore/registry/tests/__init__.py +0 -0
  262. graphcore/registry/tests/test_agent_frontend_discovery.py +56 -0
  263. graphcore/registry/tests/test_app_config.py +36 -0
  264. graphcore/registry/tests/test_discovery.py +147 -0
  265. graphcore/registry/tests/test_entity_directory_storage.py +73 -0
  266. graphcore/registry/tests/test_import_package.py +87 -0
  267. graphcore/registry/tests/test_principal_flag.py +67 -0
  268. graphcore/registry/tests/test_strategy_directory.py +29 -0
  269. graphcore/routes/__init__.py +116 -0
  270. graphcore/routes/tests/__init__.py +0 -0
  271. graphcore/routes/tests/test_routes.py +90 -0
  272. graphcore/runtime.py +243 -0
  273. graphcore/scheduling/__init__.py +0 -0
  274. graphcore/scheduling/beat_scheduler.py +164 -0
  275. graphcore/scheduling/beat_tasks.py +63 -0
  276. graphcore/scheduling/scheduler.py +37 -0
  277. graphcore/scheduling/tests/__init__.py +0 -0
  278. graphcore/scheduling/tests/contract.py +136 -0
  279. graphcore/scheduling/tests/memory.py +42 -0
  280. graphcore/scheduling/tests/test_beat_scheduler.py +87 -0
  281. graphcore/scheduling/tests/test_memory_scheduler.py +15 -0
  282. graphcore/scheduling/tests/test_ticks.py +143 -0
  283. graphcore/tasks.py +9 -0
  284. graphcore/test_settings.py +78 -0
  285. graphcore/testing/__init__.py +0 -0
  286. graphcore/testing/case.py +112 -0
  287. graphcore/testing/runner.py +32 -0
  288. graphcore/testing/settings.py +26 -0
  289. graphcore/testing/tests/__init__.py +0 -0
  290. graphcore/testing/tests/agent_view_fixture.py +19 -0
  291. graphcore/testing/tests/test_case_and_runner.py +219 -0
  292. graphcore/testing/tests/test_settings_for_apps.py +50 -0
  293. graphcore/tests/__init__.py +0 -0
  294. graphcore/tests/ids.py +14 -0
  295. graphcore/tests/public_api_manifest.py +102 -0
  296. graphcore/tests/runs.py +7 -0
  297. graphcore/tests/test_app_discovery.py +90 -0
  298. graphcore/tests/test_composition_boundaries.py +231 -0
  299. graphcore/tests/test_docs_discovery.py +108 -0
  300. graphcore/tests/test_no_print.py +70 -0
  301. graphcore/tests/test_packaging.py +64 -0
  302. graphcore/tests/test_public_api_boundaries.py +229 -0
  303. graphcore/tests/test_public_api_contract.py +62 -0
  304. graphcore/tests/test_public_api_docs.py +28 -0
  305. graphcore/tests/test_runtime.py +42 -0
  306. graphcore/tests/test_shared_type_boundaries.py +128 -0
  307. graphcore/tests/test_shared_types.py +144 -0
  308. graphcore/tests/test_test_settings.py +45 -0
  309. graphcore/transport/__init__.py +0 -0
  310. graphcore/transport/agent_asgi.py +68 -0
  311. graphcore/transport/agent_client.py +85 -0
  312. graphcore/transport/channel_layer.py +68 -0
  313. graphcore/transport/consumers.py +507 -0
  314. graphcore/transport/routing.py +6 -0
  315. graphcore/transport/tests/__init__.py +0 -0
  316. graphcore/transport/tests/test_agent_client.py +31 -0
  317. graphcore/transport/tests/test_api_views.py +733 -0
  318. graphcore/transport/tests/test_channel_layer.py +96 -0
  319. graphcore/transport/tests/test_consumers.py +963 -0
  320. graphcore/transport/tests/test_resource_metadata.py +67 -0
  321. graphcore/transport/urls.py +29 -0
  322. graphcore/transport/views.py +358 -0
  323. graphcore/types/__init__.py +4 -0
  324. graphcore/types/access.py +114 -0
  325. graphcore/types/api.py +76 -0
  326. graphcore/types/entities.py +100 -0
  327. graphcore/types/entity_id.py +85 -0
  328. graphcore/types/execution.py +41 -0
  329. graphcore/types/identity.py +20 -0
  330. graphcore/types/onboarding.py +20 -0
  331. graphcore/types/query.py +116 -0
  332. graphcore/types/schedules.py +91 -0
  333. graphcore/types/strategy.py +73 -0
  334. graphcore/types/tests/__init__.py +0 -0
  335. graphcore/types/tests/test_entity_id.py +50 -0
  336. graphcore/urls.py +5 -0
  337. graphcore_kernel-0.1.0.dist-info/METADATA +94 -0
  338. graphcore_kernel-0.1.0.dist-info/RECORD +343 -0
  339. graphcore_kernel-0.1.0.dist-info/WHEEL +5 -0
  340. graphcore_kernel-0.1.0.dist-info/entry_points.txt +2 -0
  341. graphcore_kernel-0.1.0.dist-info/licenses/LICENSE +202 -0
  342. graphcore_kernel-0.1.0.dist-info/licenses/NOTICE +2 -0
  343. graphcore_kernel-0.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,150 @@
1
+ """`can_contain`: which types may be placed directly inside an entity, checked
2
+ on every write - see docs/AUTHORIZATION_TECHNICAL_TDD.md (Type policy)."""
3
+ from asgiref.sync import async_to_sync
4
+ from django.test import TransactionTestCase
5
+
6
+ from graphcore.auth.authz.lookups import find_group_by_key
7
+ from graphcore.bootstrap.deployment import ensure_deployment
8
+ from graphcore.domain.entity.Entity import Entity
9
+ from graphcore.domain.entity.grant.Grant import Grant
10
+ from graphcore.domain.entity.user.User import User
11
+ from graphcore.domain.strategy.BaseStrategy import CreateEntity, ReparentChild
12
+ from graphcore.domain.strategy.GrantStrategies import CreateGrant
13
+ from graphcore.domain.strategy.GroupStrategies import CreateGroup
14
+ from graphcore.errors import InvalidRequest
15
+ from graphcore.execution.strategy_context import kernel_internal_context
16
+ from graphcore.registry.registry import DEFAULT_REGISTRY
17
+ from graphcore.runtime import django_runtime
18
+ from graphcore.auth.authz.defaults import ADMINS_GROUP_KEY
19
+ from graphcore.types.identity import Principal
20
+ from graphcore.tests.runs import run
21
+
22
+ TEST_REGISTRY = DEFAULT_REGISTRY.fork_open()
23
+
24
+
25
+ class _Note(Entity):
26
+ pass
27
+
28
+
29
+ class _AuditedGrant(Grant):
30
+ pass
31
+
32
+
33
+ TEST_REGISTRY.entities.register_entity(_Note, app_label='graphcore')
34
+ TEST_REGISTRY.entities.register_entity(_AuditedGrant, app_label='graphcore')
35
+
36
+
37
+ class CanContainTests(TransactionTestCase):
38
+ def setUp(self):
39
+ self.runtime = django_runtime(TEST_REGISTRY)
40
+ self.service = self.runtime.entity_service
41
+ self.executor = self.runtime.executor
42
+ self.deployment_id = self.runtime.deployment_entity_id
43
+
44
+ async def _seed(self):
45
+ await ensure_deployment(self.service, TEST_REGISTRY)
46
+
47
+ async def _user(self, username):
48
+ user = self.service.create(User, username=username)
49
+ with kernel_internal_context():
50
+ await self.service.save_entity(user, None)
51
+ return Principal(principal_entity_id=user.entity_id)
52
+
53
+ async def _admin(self):
54
+ admin = await self._user('contains-admin')
55
+ admins = await find_group_by_key(self.service, ADMINS_GROUP_KEY)
56
+ admins.add_member(admin.principal_entity_id)
57
+ with kernel_internal_context():
58
+ await self.service.save_entity(admins, None)
59
+ return admin
60
+
61
+ async def _create(self, target_id, entity_cls, principal):
62
+ request = CreateEntity.request_constructor(
63
+ target_entity_id=target_id, entity_type_id=TEST_REGISTRY.entities.get_entity_type_id(entity_cls),
64
+ )
65
+ request, _ = await run(self.executor, request, principal=principal)
66
+ return request.ret_val['child_entity']
67
+
68
+ async def _kernel_save(self, entity_cls, parent_id):
69
+ entity = self.service.create(entity_cls)
70
+ entity.parent_id = parent_id
71
+ if isinstance(entity, Grant):
72
+ entity.subject_id, entity.role_name = 'contains-subject', 'member'
73
+ with kernel_internal_context():
74
+ return await self.service.save_entity(entity, None)
75
+
76
+ @async_to_sync
77
+ async def test_no_target_creates_at_the_top_level(self):
78
+ await self._seed()
79
+ member = await self._user('contains-member')
80
+ note_id = await self._create(None, _Note, member)
81
+ self.assertIsNone((await self.service.load_from_db(note_id)).parent_id)
82
+
83
+ @async_to_sync
84
+ async def test_creating_under_the_deployment_is_refused(self):
85
+ await self._seed()
86
+ member = await self._user('contains-placer')
87
+ with self.assertRaisesMessage(InvalidRequest, 'Deployment cannot contain _Note'):
88
+ await self._create(self.deployment_id, _Note, member)
89
+
90
+ @async_to_sync
91
+ async def test_a_group_under_the_deployment_is_refused(self):
92
+ await self._seed()
93
+ member = await self._user('contains-grouper')
94
+ request = CreateGroup.request_constructor(self.deployment_id, name='Team')
95
+ with self.assertRaisesMessage(InvalidRequest, 'Deployment cannot contain Group'):
96
+ await run(self.executor, request, principal=member)
97
+
98
+ @async_to_sync
99
+ async def test_reparenting_a_members_entity_under_the_deployment_is_refused(self):
100
+ await self._seed()
101
+ member = await self._user('contains-mover')
102
+ note_id = await self._create(None, _Note, member)
103
+ request = ReparentChild.request_constructor(note_id, self.deployment_id)
104
+ with self.assertRaisesMessage(InvalidRequest, 'Deployment cannot contain _Note'):
105
+ await run(self.executor, request, principal=member)
106
+
107
+ @async_to_sync
108
+ async def test_a_grant_can_be_created_under_the_deployment(self):
109
+ await self._seed()
110
+ admin = await self._admin()
111
+ member = await self._user('contains-grantee')
112
+ request = CreateGrant.request_constructor(
113
+ target_entity_id=self.deployment_id, subject_id=member.principal_entity_id, role_name='admin',
114
+ )
115
+ request, _ = await run(self.executor, request, principal=admin)
116
+ grant = await self.service.load_from_db(request.ret_val['grant_entity_id'])
117
+ self.assertEqual(grant.parent_id, self.deployment_id)
118
+
119
+ @async_to_sync
120
+ async def test_nothing_can_be_created_under_a_grant(self):
121
+ await self._seed()
122
+ grant = await self._kernel_save(Grant, self.deployment_id)
123
+ with self.assertRaisesMessage(InvalidRequest, 'Grant cannot contain _Note'):
124
+ await self._kernel_save(_Note, grant.entity_id)
125
+
126
+ @async_to_sync
127
+ async def test_kernel_internal_writes_are_refused_too(self):
128
+ await self._seed()
129
+ with self.assertRaisesMessage(InvalidRequest, 'cannot contain'):
130
+ await self._kernel_save(_Note, self.deployment_id)
131
+
132
+ @async_to_sync
133
+ async def test_a_subclass_of_a_contained_type_is_allowed(self):
134
+ await self._seed()
135
+ grant = await self._kernel_save(_AuditedGrant, self.deployment_id)
136
+ self.assertEqual(grant.parent_id, self.deployment_id)
137
+
138
+ @async_to_sync
139
+ async def test_only_administrators_read_the_deployments_grants(self):
140
+ await self._seed()
141
+ member = await self._user('contains-reader')
142
+ admin = await self._admin()
143
+ deployment = await self.service.get_entity(self.deployment_id, member)
144
+ grant_ids = [cid for cid in deployment.children_ids]
145
+ self.assertTrue(grant_ids)
146
+
147
+ as_member = await self.service.get_entities(grant_ids, member)
148
+ self.assertTrue(all(getattr(r, 'cause', None) == 'forbidden' for r in as_member.values()))
149
+ as_admin = await self.service.get_entities(grant_ids, admin)
150
+ self.assertTrue(all(isinstance(r, Grant) for r in as_admin.values()))
@@ -0,0 +1,167 @@
1
+ """`contained_by`: which types an entity may be placed directly inside, checked
2
+ on every create and move - see docs/AUTHORIZATION_TECHNICAL_TDD.md (Type policy)."""
3
+ from asgiref.sync import async_to_sync
4
+ from django.test import TransactionTestCase
5
+
6
+ from graphcore.bootstrap.deployment import ensure_deployment
7
+ from graphcore.domain.entity.Entity import Entity
8
+ from graphcore.domain.entity.user.User import User
9
+ from graphcore.domain.strategy.BaseStrategy import (
10
+ CreateEntity,
11
+ ReparentChild,
12
+ SetAttributes,
13
+ )
14
+ from graphcore.errors import InvalidRequest
15
+ from graphcore.execution.strategy_context import kernel_internal_context
16
+ from graphcore.registry.registry import DEFAULT_REGISTRY
17
+ from graphcore.runtime import django_runtime
18
+ from graphcore.types.entity_id import new_entity_id
19
+ from graphcore.types.identity import Principal
20
+ from graphcore.tests.runs import run
21
+
22
+ TEST_REGISTRY = DEFAULT_REGISTRY.fork_open()
23
+
24
+
25
+ class _Book(Entity):
26
+ pass
27
+
28
+
29
+ class _SpecialBook(_Book):
30
+ pass
31
+
32
+
33
+ class _Shelf(Entity):
34
+ pass
35
+
36
+
37
+ class _Chapter(Entity):
38
+ pass
39
+
40
+
41
+ class _Appendix(_Chapter):
42
+ pass
43
+
44
+
45
+ for _cls in (_Book, _SpecialBook, _Shelf, _Chapter, _Appendix):
46
+ TEST_REGISTRY.entities.register_entity(_cls, app_label='graphcore')
47
+ TEST_REGISTRY.policy.define(_Book, shareable=True)
48
+ TEST_REGISTRY.policy.define(_Chapter, contained_by=[_Book])
49
+
50
+
51
+ class ContainedByTests(TransactionTestCase):
52
+ def setUp(self):
53
+ self.runtime = django_runtime(TEST_REGISTRY)
54
+ self.service = self.runtime.entity_service
55
+ self.executor = self.runtime.executor
56
+
57
+ async def _member(self, username):
58
+ await ensure_deployment(self.service, TEST_REGISTRY)
59
+ user = self.service.create(User, username=username)
60
+ with kernel_internal_context():
61
+ await self.service.save_entity(user, None)
62
+ return Principal(principal_entity_id=user.entity_id)
63
+
64
+ async def _create(self, target_id, entity_cls, principal):
65
+ request = CreateEntity.request_constructor(
66
+ target_entity_id=target_id, entity_type_id=TEST_REGISTRY.entities.get_entity_type_id(entity_cls),
67
+ )
68
+ request, _ = await run(self.executor, request, principal=principal)
69
+ return request.ret_val['child_entity']
70
+
71
+ async def _move(self, entity_id, parent_id, principal):
72
+ request = ReparentChild.request_constructor(entity_id, parent_id)
73
+ await run(self.executor, request, principal=principal)
74
+
75
+ async def _kernel_save(self, entity_cls, parent_id):
76
+ entity = self.service.create(entity_cls)
77
+ entity.parent_id = parent_id
78
+ with kernel_internal_context():
79
+ return await self.service.save_entity(entity, None)
80
+
81
+ @async_to_sync
82
+ async def test_created_inside_an_admitted_parent(self):
83
+ member = await self._member('cb-author')
84
+ book_id = await self._create(None, _Book, member)
85
+ chapter_id = await self._create(book_id, _Chapter, member)
86
+ self.assertEqual((await self.service.load_from_db(chapter_id)).parent_id, book_id)
87
+
88
+ @async_to_sync
89
+ async def test_generic_create_without_a_target_is_refused(self):
90
+ member = await self._member('cb-loose')
91
+ with self.assertRaisesMessage(InvalidRequest, '_Chapter cannot be top-level; it must be placed inside _Book'):
92
+ await self._create(None, _Chapter, member)
93
+
94
+ @async_to_sync
95
+ async def test_created_inside_another_type_is_refused(self):
96
+ member = await self._member('cb-shelver')
97
+ shelf_id = await self._create(None, _Shelf, member)
98
+ with self.assertRaisesMessage(InvalidRequest, '_Chapter must be placed inside _Book, not _Shelf'):
99
+ await self._create(shelf_id, _Chapter, member)
100
+
101
+ @async_to_sync
102
+ async def test_a_subclass_of_an_admitted_parent_is_admitted(self):
103
+ member = await self._member('cb-special')
104
+ book_id = await self._create(None, _SpecialBook, member)
105
+ chapter_id = await self._create(book_id, _Chapter, member)
106
+ self.assertEqual((await self.service.load_from_db(chapter_id)).parent_id, book_id)
107
+
108
+ @async_to_sync
109
+ async def test_a_subclass_inherits_contained_by(self):
110
+ member = await self._member('cb-appendix')
111
+ with self.assertRaisesMessage(InvalidRequest, '_Appendix cannot be top-level'):
112
+ await self._create(None, _Appendix, member)
113
+
114
+ @async_to_sync
115
+ async def test_moving_to_the_top_level_is_refused_and_leaves_the_entity_in_place(self):
116
+ member = await self._member('cb-detacher')
117
+ book_id = await self._create(None, _Book, member)
118
+ chapter_id = await self._create(book_id, _Chapter, member)
119
+ with self.assertRaisesMessage(InvalidRequest, 'cannot be top-level'):
120
+ await self._move(chapter_id, None, member)
121
+ self.assertEqual((await self.service.load_from_db(chapter_id)).parent_id, book_id)
122
+
123
+ @async_to_sync
124
+ async def test_moving_into_another_type_is_refused(self):
125
+ member = await self._member('cb-misplacer')
126
+ book_id = await self._create(None, _Book, member)
127
+ shelf_id = await self._create(None, _Shelf, member)
128
+ chapter_id = await self._create(book_id, _Chapter, member)
129
+ with self.assertRaisesMessage(InvalidRequest, 'must be placed inside _Book, not _Shelf'):
130
+ await self._move(chapter_id, shelf_id, member)
131
+ self.assertEqual((await self.service.load_from_db(chapter_id)).parent_id, book_id)
132
+
133
+ @async_to_sync
134
+ async def test_moving_between_admitted_parents_is_allowed(self):
135
+ member = await self._member('cb-mover')
136
+ first = await self._create(None, _Book, member)
137
+ second = await self._create(None, _Book, member)
138
+ chapter_id = await self._create(first, _Chapter, member)
139
+ await self._move(chapter_id, second, member)
140
+ self.assertEqual((await self.service.load_from_db(chapter_id)).parent_id, second)
141
+
142
+ @async_to_sync
143
+ async def test_writes_that_do_not_move_are_not_rechecked(self):
144
+ member = await self._member('cb-editor')
145
+ book_id = await self._create(None, _Book, member)
146
+ chapter_id = await self._create(book_id, _Chapter, member)
147
+ request = SetAttributes.request_constructor(chapter_id, {'title': 'One'})
148
+ await run(self.executor, request, principal=member)
149
+ self.assertEqual((await self.service.load_from_db(chapter_id)).get_attribute('title'), 'One')
150
+
151
+ @async_to_sync
152
+ async def test_kernel_internal_writes_are_refused_too(self):
153
+ await self._member('cb-kernel')
154
+ with self.assertRaisesMessage(InvalidRequest, 'cannot be top-level'):
155
+ await self._kernel_save(_Chapter, None)
156
+
157
+ @async_to_sync
158
+ async def test_a_missing_parent_is_refused(self):
159
+ await self._member('cb-orphan')
160
+ with self.assertRaisesMessage(InvalidRequest, 'does not exist'):
161
+ await self._kernel_save(_Chapter, new_entity_id(self.service.backend_id))
162
+
163
+ @async_to_sync
164
+ async def test_types_without_contained_by_may_be_top_level(self):
165
+ member = await self._member('cb-free')
166
+ shelf_id = await self._create(None, _Shelf, member)
167
+ self.assertIsNone((await self.service.load_from_db(shelf_id)).parent_id)