code-sandboxes 1.10.0__tar.gz → 1.11.0__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 (298) hide show
  1. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/PKG-INFO +2 -2
  2. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/README.md +1 -1
  3. code_sandboxes-1.11.0/code_sandboxes/__version__.py +1 -0
  4. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/builds.py +8 -1
  5. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/datalayer.py +99 -31
  6. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/contract.py +147 -6
  7. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/resolve.py +101 -8
  8. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/spec.py +62 -8
  9. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/README.md +1 -1
  10. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/environments/specification.mdx +1 -1
  11. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docusaurus.config.js +0 -8
  12. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/README.md +1 -1
  13. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/pyproject.toml +1 -0
  14. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/schemas/environment-v1alpha1.json +2 -1
  15. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_builds.py +32 -1
  16. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_builders.py +8 -2
  17. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_datalayer_builder.py +19 -40
  18. code_sandboxes-1.11.0/tests/test_environment_foreign_contract_layer.py +491 -0
  19. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_resolve.py +1 -1
  20. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_spec.py +3 -0
  21. code_sandboxes-1.10.0/code_sandboxes/__version__.py +0 -1
  22. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/build.yaml +0 -0
  23. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/environments-live.yaml +0 -0
  24. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/py-code-style.yaml +0 -0
  25. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/py-tests.yaml +0 -0
  26. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/py-typing.yaml +0 -0
  27. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/release.yaml +0 -0
  28. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.github/workflows/reusable-python.yaml +0 -0
  29. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.gitignore +0 -0
  30. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.licenserc.yaml +0 -0
  31. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.pre-commit-config.yaml +0 -0
  32. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/.vscode/settings.json +0 -0
  33. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/CHANGELOG.md +0 -0
  34. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/Dockerfile +0 -0
  35. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/LICENSE +0 -0
  36. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/Makefile +0 -0
  37. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/RELEASE.md +0 -0
  38. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/__init__.py +0 -0
  39. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/base.py +0 -0
  40. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/bridge_mount.py +0 -0
  41. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/cli.py +0 -0
  42. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/client.py +0 -0
  43. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/commands.py +0 -0
  44. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/console.py +0 -0
  45. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/contents.py +0 -0
  46. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/__init__.py +0 -0
  47. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/__main__.py +0 -0
  48. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/accounts.py +0 -0
  49. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/__init__.py +0 -0
  50. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/daytona.py +0 -0
  51. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/e2b.py +0 -0
  52. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/managed.py +0 -0
  53. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/adapters/modal.py +0 -0
  54. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/attest.py +0 -0
  55. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/bases.py +0 -0
  56. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/breaker.py +0 -0
  57. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/build_secrets.py +0 -0
  58. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/builders.py +0 -0
  59. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/canonical.py +0 -0
  60. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/conformance.py +0 -0
  61. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/constraints/sandbox-contract-v1.txt +0 -0
  62. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/constraints/wheelhouse/README.md +0 -0
  63. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/constraints/wheelhouse/jupyter_server-2.21.0+datalayer.1-py3-none-any.whl +0 -0
  64. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/doctor/__init__.py +0 -0
  65. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/doctor/build.py +0 -0
  66. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/doctor/datalayer_sandbox.py +0 -0
  67. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/doctor/report.schema.json +0 -0
  68. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/errors.py +0 -0
  69. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/files.py +0 -0
  70. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/image_import.py +0 -0
  71. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/lifecycle.py +0 -0
  72. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/policy.py +0 -0
  73. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/redact.py +0 -0
  74. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/resolve_conda.py +0 -0
  75. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/environments/schema.py +0 -0
  76. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/exceptions.py +0 -0
  77. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/filesystem.py +0 -0
  78. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/interfaces.py +0 -0
  79. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/jupyter_ingress.py +0 -0
  80. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/lifecycle.py +0 -0
  81. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/manage.py +0 -0
  82. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/models.py +0 -0
  83. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/provider_ingress.py +0 -0
  84. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/providers.py +0 -0
  85. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/__init__.py +0 -0
  86. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/cloudflare/__init__.py +0 -0
  87. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/cloudflare/cloudflare.py +0 -0
  88. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/coreweave/__init__.py +0 -0
  89. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/coreweave/coreweave.py +0 -0
  90. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/datalayer/__init__.py +0 -0
  91. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/datalayer/datalayer.py +0 -0
  92. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/daytona/__init__.py +0 -0
  93. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/daytona/daytona.py +0 -0
  94. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/docker/__init__.py +0 -0
  95. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/docker/docker.py +0 -0
  96. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/e2b/__init__.py +0 -0
  97. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/e2b/e2b.py +0 -0
  98. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/eval/__init__.py +0 -0
  99. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/eval/eval.py +0 -0
  100. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/google_colab/__init__.py +0 -0
  101. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/google_colab/client.py +0 -0
  102. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/google_colab/google_colab.py +0 -0
  103. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/jupyter_server/__init__.py +0 -0
  104. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/jupyter_server/jupyter_server.py +0 -0
  105. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/kaggle/__init__.py +0 -0
  106. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/kaggle/client.py +0 -0
  107. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/kaggle/execute.py +0 -0
  108. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/kaggle/kaggle.py +0 -0
  109. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/kaggle/live.py +0 -0
  110. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/marimo/__init__.py +0 -0
  111. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/marimo/cells.py +0 -0
  112. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/marimo/marimo.py +0 -0
  113. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/marimo/reactive.py +0 -0
  114. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/marimo/reactive_kernel.py +0 -0
  115. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/modal/__init__.py +0 -0
  116. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/modal/modal.py +0 -0
  117. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/monty/__init__.py +0 -0
  118. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/code_sandboxes/sandboxes/monty/monty.py +0 -0
  119. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docker/Dockerfile +0 -0
  120. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/.gitignore +0 -0
  121. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/LICENSE +0 -0
  122. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/Makefile +0 -0
  123. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/babel.config.js +0 -0
  124. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/api-reference/_category_.yml +0 -0
  125. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/api-reference/index.mdx +0 -0
  126. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/cli/_category_.yml +0 -0
  127. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/cli/index.mdx +0 -0
  128. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/contribute/_category_.yml +0 -0
  129. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/contribute/index.mdx +0 -0
  130. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/environments/_category_.yml +0 -0
  131. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/environments/contract.mdx +0 -0
  132. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/environments/index.mdx +0 -0
  133. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/environments/spike-2026-09.mdx +0 -0
  134. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/examples/_category_.yml +0 -0
  135. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/examples/index.mdx +0 -0
  136. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/guide/_category_.yml +0 -0
  137. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/guide/index.mdx +0 -0
  138. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/index.mdx +0 -0
  139. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/install/_category_.yml +0 -0
  140. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/install/index.mdx +0 -0
  141. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/provider-ingress/index.mdx +0 -0
  142. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/_category_.yml +0 -0
  143. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/cloudflare.mdx +0 -0
  144. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/coreweave.mdx +0 -0
  145. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/datalayer.mdx +0 -0
  146. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/daytona.mdx +0 -0
  147. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/docker.mdx +0 -0
  148. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/e2b.mdx +0 -0
  149. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/eval.mdx +0 -0
  150. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/google-colab.mdx +0 -0
  151. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/index.mdx +0 -0
  152. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/jupyter-server.mdx +0 -0
  153. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/kaggle.mdx +0 -0
  154. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/marimo.mdx +0 -0
  155. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/modal.mdx +0 -0
  156. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/docs/providers/monty.mdx +0 -0
  157. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/package.json +0 -0
  158. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/sidebars.js +0 -0
  159. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow1.js +0 -0
  160. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow1.module.css +0 -0
  161. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow2.js +0 -0
  162. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow2.module.css +0 -0
  163. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow3.js +0 -0
  164. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/components/HomepageRow3.module.css +0 -0
  165. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/css/custom.css +0 -0
  166. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/pages/index.module.css +0 -0
  167. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/pages/markdown-page.md +0 -0
  168. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/theme/CustomDocItem.tsx +0 -0
  169. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/src/theme/IconsTitle.tsx +0 -0
  170. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/bricks.svg +0 -0
  171. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/building-construction.svg +0 -0
  172. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/cloud-sun.svg +0 -0
  173. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/cloud.svg +0 -0
  174. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/collaboration.svg +0 -0
  175. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/copy-left.svg +0 -0
  176. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/logo.png +0 -0
  177. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/logo.svg +0 -0
  178. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/personas/business.svg +0 -0
  179. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/personas/data-scientist.svg +0 -0
  180. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/personas/devops.svg +0 -0
  181. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/datalayer/project/project-line.svg +0 -0
  182. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/favicon.ico +0 -0
  183. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/jupyter.svg +0 -0
  184. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/open-source.svg +0 -0
  185. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/react-js.svg +0 -0
  186. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/react-js2.svg +0 -0
  187. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/ringed-planet.svg +0 -0
  188. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/robot.svg +0 -0
  189. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/rocket.svg +0 -0
  190. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/shield.svg +0 -0
  191. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/sparkles.svg +0 -0
  192. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/streamlit.gif +0 -0
  193. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/super-hero.svg +0 -0
  194. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/target.svg +0 -0
  195. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/docs/static/img/thumbs-up.svg +0 -0
  196. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/Makefile +0 -0
  197. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/cloudflare_sandbox_example.py +0 -0
  198. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/coreweave_sandbox_example.py +0 -0
  199. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/datalayer_sandbox_example.py +0 -0
  200. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/daytona_sandbox_example.py +0 -0
  201. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/docker_sandbox_example.py +0 -0
  202. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/e2b_sandbox_example.py +0 -0
  203. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/eval_sandbox_example.py +0 -0
  204. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/google_colab_sandbox_example.py +0 -0
  205. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/jupyter_server_sandbox_example.py +0 -0
  206. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/kaggle_sandbox_example.py +0 -0
  207. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/modal_sandbox_example.py +0 -0
  208. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/exec/monty_sandbox_example.py +0 -0
  209. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/Makefile +0 -0
  210. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/cloudflare_sandbox_example.py +0 -0
  211. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/coreweave_sandbox_example.py +0 -0
  212. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/datalayer_sandbox_example.py +0 -0
  213. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/daytona_sandbox_example.py +0 -0
  214. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/docker_sandbox_example.py +0 -0
  215. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/e2b_sandbox_example.py +0 -0
  216. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/eval_sandbox_example.py +0 -0
  217. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/google_colab_sandbox_example.py +0 -0
  218. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/jupyter_server_sandbox_example.py +0 -0
  219. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/kaggle_sandbox_example.py +0 -0
  220. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/modal_sandbox_example.py +0 -0
  221. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/examples/repl/monty_sandbox_example.py +0 -0
  222. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/__init__.py +0 -0
  223. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/conftest.py +0 -0
  224. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/egress_logs/buildctl-base.log +0 -0
  225. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/egress_logs/buildctl-curl.log +0 -0
  226. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/egress_logs/buildctl-pip.log +0 -0
  227. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/egress_logs/buildctl-uv.log +0 -0
  228. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/egress_logs/micromamba.log +0 -0
  229. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_a_datalayer_sandbox_can_be_interrupted.py +0 -0
  230. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_bridge_mount.py +0 -0
  231. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_cli_exec.py +0 -0
  232. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_cli_repl.py +0 -0
  233. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_client.py +0 -0
  234. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_client_contents.py +0 -0
  235. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_client_files.py +0 -0
  236. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_client_outcome_error_output.py +0 -0
  237. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_cloudflare.py +0 -0
  238. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_commands_envelope.py +0 -0
  239. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_console.py +0 -0
  240. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_contents_contract.py +0 -0
  241. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_contents_live_matrix.py +0 -0
  242. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_coreweave.py +0 -0
  243. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_datalayer_sandbox.py +0 -0
  244. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_daytona.py +0 -0
  245. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_e2b.py +0 -0
  246. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_accounts.py +0 -0
  247. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_attest.py +0 -0
  248. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_bases.py +0 -0
  249. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_breaker.py +0 -0
  250. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_build_secrets.py +0 -0
  251. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_canonical.py +0 -0
  252. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_conformance.py +0 -0
  253. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_constraints.py +0 -0
  254. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_contract.py +0 -0
  255. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_cross_variant_report.py +0 -0
  256. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_daytona_builder.py +0 -0
  257. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_dockerfile_source.py +0 -0
  258. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_doctor.py +0 -0
  259. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_e2b_builder.py +0 -0
  260. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_egress_refusals.py +0 -0
  261. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_errors.py +0 -0
  262. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_image_import.py +0 -0
  263. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_lifecycle.py +0 -0
  264. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_live_matrix.py +0 -0
  265. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_managed_builders.py +0 -0
  266. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_modal_builder.py +0 -0
  267. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_organization_policy.py +0 -0
  268. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_redact.py +0 -0
  269. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_resolve_conda.py +0 -0
  270. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_environment_spec_organization_policy.py +0 -0
  271. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_eval.py +0 -0
  272. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_every_variant_has_a_real_interrupt.py +0 -0
  273. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_factory.py +0 -0
  274. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_google_colab.py +0 -0
  275. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_integration.py +0 -0
  276. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_jupyter_ingress.py +0 -0
  277. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_jupyter_server.py +0 -0
  278. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_jupyter_server_streaming.py +0 -0
  279. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_kaggle.py +0 -0
  280. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_kaggle_execute.py +0 -0
  281. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_kaggle_live.py +0 -0
  282. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_kaggle_session.py +0 -0
  283. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_kernel_client_compatibility.py +0 -0
  284. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_lifecycle_vocabulary.py +0 -0
  285. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_manage.py +0 -0
  286. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_manage_datalayer.py +0 -0
  287. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_marimo_cells.py +0 -0
  288. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_marimo_reactive_kernel.py +0 -0
  289. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_marimo_sandbox.py +0 -0
  290. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_modal_google_colab_sandbox.py +0 -0
  291. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_modal_session.py +0 -0
  292. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_models.py +0 -0
  293. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_output_line_fidelity.py +0 -0
  294. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_provider_catalog_names.py +0 -0
  295. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_provider_ingress.py +0 -0
  296. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_providers.py +0 -0
  297. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_sandboxes.py +0 -0
  298. {code_sandboxes-1.10.0 → code_sandboxes-1.11.0}/tests/test_the_kill_relaunch_drill.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: code_sandboxes
3
- Version: 1.10.0
3
+ Version: 1.11.0
4
4
  Project-URL: Home, https://github.com/datalayer/code-sandboxes
5
5
  Author-email: Datalayer <info@datalayer.io>
6
6
  License: BSD 3-Clause License
@@ -106,7 +106,7 @@ Description-Content-Type: text/markdown
106
106
  ~ BSD 3-Clause License
107
107
  -->
108
108
 
109
- [![Datalayer](https://assets.datalayer.tech/datalayer-25.svg)](https://datalayer.io)
109
+ [![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai)
110
110
 
111
111
  [![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
112
112
  [![PyPI - Version](https://img.shields.io/pypi/v/code-sandboxes)](https://pypi.org/project/code-sandboxes)
@@ -4,7 +4,7 @@
4
4
  ~ BSD 3-Clause License
5
5
  -->
6
6
 
7
- [![Datalayer](https://assets.datalayer.tech/datalayer-25.svg)](https://datalayer.io)
7
+ [![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai)
8
8
 
9
9
  [![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
10
10
  [![PyPI - Version](https://img.shields.io/pypi/v/code-sandboxes)](https://pypi.org/project/code-sandboxes)
@@ -0,0 +1 @@
1
+ __version__ = "1.11.0"
@@ -166,10 +166,17 @@ def fetch_command(entry: BuildEntry) -> str:
166
166
  """
167
167
  destination = _absolute(entry.destination_path)
168
168
  directory = posixpath.dirname(destination) or "/"
169
+ # `destination` is a user-controlled spec field. The digest is pattern-checked,
170
+ # but the path is not, so the whole `sha256sum -c` line is passed through
171
+ # shlex.quote — exactly as `directory`, `source_uri` and `destination` already
172
+ # are — to keep a path with shell metacharacters from breaking out of the
173
+ # command. The two-space "<digest> <path>" format sha256sum -c expects is
174
+ # preserved inside the quoted string.
175
+ check_line = f"{entry.sha256} {destination}"
169
176
  return (
170
177
  f"mkdir -p {shlex.quote(directory)}"
171
178
  f" && curl -fsSL {shlex.quote(entry.source_uri)} -o {shlex.quote(destination)}"
172
- f' && echo "{entry.sha256} {destination}" | sha256sum -c'
179
+ f" && echo {shlex.quote(check_line)} | sha256sum -c"
173
180
  )
174
181
 
175
182
 
@@ -61,7 +61,7 @@ from ..builders import (
61
61
  owner_cache_repository,
62
62
  owner_repository,
63
63
  )
64
- from ..contract import SANDBOX_CONTRACT_V1, pin_dockerfile_base
64
+ from ..contract import SANDBOX_CONTRACT_V1, pin_dockerfile_base, pin_foreign_dockerfile_base
65
65
  from ..errors import (
66
66
  ARTIFACT_MISSING,
67
67
  BUILD_FAILED,
@@ -73,14 +73,15 @@ from ..errors import (
73
73
  from ..files import files_step
74
74
  from ..resolve import (
75
75
  WHEELHOUSE_IMAGE_PATH,
76
- WHEELHOUSE_PATH,
77
76
  apt_pins_in,
78
77
  apt_snapshot_in,
79
78
  buildkit_proxy,
80
79
  buildkit_proxy_options,
80
+ contract_base_in,
81
81
  egress_findings,
82
82
  egress_hosts_text,
83
83
  egress_refused_hosts,
84
+ foreign_bootstrap_lines,
84
85
  locked_versions,
85
86
  )
86
87
  from ..resolve_conda import (
@@ -90,7 +91,7 @@ from ..resolve_conda import (
90
91
  micromamba_bootstrap_dockerfile_line,
91
92
  micromamba_install_command,
92
93
  )
93
- from ..spec import BuildSecret, Environment, command_names_secret
94
+ from ..spec import FOREIGN_SOURCES, BuildSecret, Environment, command_names_secret
94
95
 
95
96
  __all__ = [
96
97
  "ECR_ENVIRONMENT_PREFIX",
@@ -131,6 +132,22 @@ DEFAULT_MAX_ARTIFACT_BYTES = 20 * 1024**3
131
132
  #: Raising this is a change to every Datalayer build, so it is one constant
132
133
  #: with one reason, not a literal inside the Dockerfile's own text.
133
134
  DOCKERFILE_FRONTEND = "docker/dockerfile:1.10"
135
+ #: PID 1 of a foreign image's sandbox, which reaps and forwards signals as the
136
+ #: contract asks. Static, so it runs on any Debian-derived image, and fetched by
137
+ #: checksum, so the layer is the same every time.
138
+ TINI_URL = "https://github.com/krallin/tini/releases/download/v0.19.0/tini-static-amd64"
139
+ TINI_SHA256 = "c5b0666b4cb676901f90dfcb37106783c5fe2077b04590973b885950611b30ee"
140
+ #: What the sandbox's server needs of the approved base it is not built on.
141
+ CONTRACT_LAYER_FILES = (
142
+ "/opt/datalayer/bin/datalayer-sandbox",
143
+ "/opt/datalayer/constraints/",
144
+ "/opt/datalayer/wheelhouse/",
145
+ "/usr/local/share/jupyter_config.py",
146
+ "/usr/local/sbin/start-jupyter.sh",
147
+ )
148
+ #: Where a foreign image's own working directory is kept: a task's commands run
149
+ #: there, while the sandbox's stays the contract's.
150
+ TASK_WORKDIR_FILE = "/opt/datalayer/task-workdir"
134
151
 
135
152
  #: The first frontend with `--mount=type=secret,env=` (see above).
136
153
  SECRET_ENV_FRONTEND = (1, 10)
@@ -164,27 +181,82 @@ def _head(request: BuildRequest, authored: Any) -> list[str]:
164
181
  f"# Lock: {request.lock_digest}",
165
182
  ]
166
183
  if authored is not None:
167
- lines.append(pin_dockerfile_base(authored.content, request.resolved_base).rstrip("\n"))
184
+ pin = (
185
+ pin_foreign_dockerfile_base
186
+ if request.environment.spec.build.source == "foreignDockerfile"
187
+ else pin_dockerfile_base
188
+ )
189
+ lines.append(pin(authored.content, request.resolved_base).rstrip("\n"))
168
190
  else:
169
191
  lines.append(f"FROM {request.resolved_base}")
170
192
  return lines
171
193
 
172
194
 
173
- def _pip_lock_command(find_links: str, *, authored: bool) -> str:
174
- """Install the pip lock: `sync` to it, or `install` it over an authored Dockerfile.
195
+ def _pip_lock_command(find_links: str, *, authored: bool, foreign: bool = False) -> str:
196
+ """Install the pip lock: `sync` to it, or `install` it over what is already there.
175
197
 
176
198
  `sync` removes whatever the lock does not name, and a `dockerfile`
177
199
  source's lock does not name what the Dockerfile itself installed
178
- (`DOCKERFILE_COVERAGE`). The lock's pins, the protected ones included,
179
- win either way.
200
+ (`DOCKERFILE_COVERAGE`), nor does a foreign image's name what the image
201
+ holds. The lock's pins, the protected ones included, win either way. A
202
+ distribution's Python calls itself externally managed; a foreign image's
203
+ is the one the contract's packages go into.
180
204
  """
181
- verb, target = ("install", "-r ") if authored else ("sync", "")
205
+ verb, target = ("install", "-r ") if authored or foreign else ("sync", "")
206
+ managed = " --break-system-packages" if foreign else ""
182
207
  return (
183
- f"uv pip {verb} --system --require-hashes --find-links {find_links} "
208
+ f"uv pip {verb} --system{managed} --require-hashes --find-links {find_links} "
184
209
  f"{target}/opt/datalayer/lock.txt"
185
210
  )
186
211
 
187
212
 
213
+ def _contract_layer(request: BuildRequest) -> list[str]:
214
+ """What makes a foreign image a sandbox, before its lock is installed: the
215
+ contract's files from the approved base it was resolved against, so they
216
+ are the channel's own, and PID 1."""
217
+ contract_base = contract_base_in(request.lock_text)
218
+ if not contract_base:
219
+ raise EnvironmentsError(
220
+ SPEC_INVALID,
221
+ "this lock names no approved base to layer the contract from: resolve again",
222
+ detail={"field": "lock", "source": request.environment.spec.build.source},
223
+ )
224
+ return [
225
+ *foreign_bootstrap_lines(),
226
+ *[f"COPY --from={contract_base} {path} {path}" for path in CONTRACT_LAYER_FILES],
227
+ f"ADD --checksum=sha256:{TINI_SHA256} {TINI_URL} /opt/datalayer/bin/tini",
228
+ "RUN chmod 0755 /opt/datalayer /opt/datalayer/bin /opt/datalayer/bin/tini "
229
+ "/opt/datalayer/bin/datalayer-sandbox /opt/datalayer/constraints "
230
+ "/opt/datalayer/wheelhouse /usr/local/sbin/start-jupyter.sh",
231
+ 'RUN python3 -m pip install --no-cache-dir "uv==0.12.11"',
232
+ ]
233
+
234
+
235
+ def _contract_user() -> list[str]:
236
+ """The contract's user, home and start, after everything is installed. A
237
+ uid 1000 the image already has becomes it; what the image kept in its
238
+ working directory stays usable by it, but for the reserved tree and what
239
+ holds it, which stay root's wherever that directory is."""
240
+ contract = SANDBOX_CONTRACT_V1
241
+ user, uid, gid, home = contract.user, contract.uid, contract.gid, contract.home
242
+ reserved, reserved_parent = contract.reserved_path, str(Path(contract.reserved_path).parent)
243
+ return [
244
+ f"RUN pwd > {TASK_WORKDIR_FILE} && chmod 0644 {TASK_WORKDIR_FILE} "
245
+ f'&& if [ "$(pwd)" != / ]; then find "$(pwd)" -path {reserved} -prune '
246
+ f"-o ! -path {reserved_parent} ! -path / -exec chown -h {uid}:{gid} {{}} +; fi",
247
+ f"RUN (getent group {gid} >/dev/null || groupadd -g {gid} users) "
248
+ f"&& if getent passwd {uid} >/dev/null; then "
249
+ f'usermod -l {user} -g {gid} -d {home} "$(getent passwd {uid} | cut -d: -f1)"; '
250
+ f"else useradd -u {uid} -g {gid} -d {home} -s /bin/bash {user}; fi "
251
+ f"&& mkdir -p {home}/.local/share/jupyter/runtime/external_kernels "
252
+ f"&& chown -R {uid}:{gid} {home}",
253
+ f"ENV HOME={home} LANG={contract.locale} LC_ALL={contract.locale} "
254
+ f"LANGUAGE={contract.locale} TZ=Etc/UTC PATH=$PATH:/opt/datalayer/bin",
255
+ 'ENTRYPOINT ["/opt/datalayer/bin/tini", "-g", "--"]',
256
+ 'CMD ["/usr/local/sbin/start-jupyter.sh"]',
257
+ ]
258
+
259
+
188
260
  class Builder:
189
261
  """The Datalayer variant: BuildKit into the owner's ECR repository.
190
262
 
@@ -272,7 +344,13 @@ class Builder:
272
344
  # `image` resolves from an imported reference instead of an
273
345
  # approved base (E3-04). Neither changes how this builder itself
274
346
  # builds, once the resolver has done its part.
275
- build_sources=("packages", "dependencyFile", "image", "dockerfile"),
347
+ build_sources=(
348
+ "packages",
349
+ "dependencyFile",
350
+ "image",
351
+ "dockerfile",
352
+ "foreignDockerfile",
353
+ ),
276
354
  package_managers=("uv", "pip"),
277
355
  # Nothing is forbidden by the builder itself: BuildKit is the
278
356
  # reference implementation of a Dockerfile, and what the contract
@@ -352,7 +430,8 @@ class Builder:
352
430
  """
353
431
  spec = request.environment.spec
354
432
  apt = apt_pins_in(request.lock_text)
355
- authored = spec.build.dockerfile if spec.build.source == "dockerfile" else None
433
+ source = spec.build.source
434
+ authored = spec.build.dockerfile if source in ("dockerfile", "foreignDockerfile") else None
356
435
  lines = _head(request, authored)
357
436
  lines += [
358
437
  f'LABEL io.datalayer.environment="{request.environment.metadata.name}" \\',
@@ -383,20 +462,13 @@ class Builder:
383
462
  " && rm -rf /var/lib/apt/lists/*",
384
463
  ]
385
464
  )
386
- # An imported image (E3-04) cannot be assumed to carry `uv` or the
387
- # wheelhouse the way an approved base does (E1-05): both are brought
388
- # to this stage instead, the same as the resolver's own solve
389
- # already does for the same reason. An approved base needs neither,
390
- # so this changes nothing about a build that already works.
391
- imported = spec.build.source == "image"
392
- imported_wheelhouse = f"{WHEELHOUSE_IMAGE_PATH}-import"
393
- find_links = imported_wheelhouse if imported else WHEELHOUSE_IMAGE_PATH
465
+ # A foreign image (E3-04) carries none of what an approved base does
466
+ # (E1-05): the contract is layered on it, from the approved base it
467
+ # was resolved against. An approved base needs none of this.
468
+ foreign = source in FOREIGN_SOURCES
469
+ find_links = WHEELHOUSE_IMAGE_PATH
394
470
  lines.append("USER root")
395
- if imported:
396
- lines += [
397
- f"COPY wheelhouse/ {imported_wheelhouse}/",
398
- 'RUN pip install --no-cache-dir "uv==0.12.11"',
399
- ]
471
+ lines += _contract_layer(request) if foreign else []
400
472
  if is_conda_lock(request.lock_text):
401
473
  # A conda source (E3-02): the lock is an `@EXPLICIT` file
402
474
  # `micromamba install --file` installs without re-solving, and the
@@ -433,9 +505,10 @@ class Builder:
433
505
  # `--find-links` for what no index has — a protected pin's
434
506
  # own wheel, the fork's local version above all (E1-04).
435
507
  "RUN --mount=type=cache,target=/root/.cache/uv "
436
- + _pip_lock_command(find_links, authored=authored is not None),
508
+ + _pip_lock_command(find_links, authored=authored is not None, foreign=foreign),
437
509
  ]
438
510
  )
511
+ lines += _contract_user() if foreign else []
439
512
  # A build secret is mounted on the postInstall commands that name it
440
513
  # and nowhere else (§4.1, D-11): never an `ARG` or `ENV`, which bakes a
441
514
  # value into the image's history, never the package-install or files
@@ -500,11 +573,6 @@ class Builder:
500
573
  root = Path(directory)
501
574
  (root / "Dockerfile").write_text(self.dockerfile(request), encoding="utf-8")
502
575
  (root / "lock.txt").write_text(request.lock_text, encoding="utf-8")
503
- if request.environment.spec.build.source == "image":
504
- wheelhouse = root / "wheelhouse"
505
- wheelhouse.mkdir()
506
- for wheel in WHEELHOUSE_PATH.glob("*.whl"):
507
- (wheelhouse / wheel.name).write_bytes(wheel.read_bytes())
508
576
  metadata = root / "metadata.json"
509
577
  # A secret's value is never written under `root`: that directory
510
578
  # is also `--local context=`, sent to `buildkitd` as ordinary
@@ -27,11 +27,13 @@ import sys
27
27
  from collections.abc import Mapping, Sequence
28
28
  from dataclasses import dataclass
29
29
  from pathlib import Path
30
+ from typing import Any
30
31
 
31
32
  from pydantic import BaseModel, ConfigDict
32
33
 
33
34
  from .bases import APPROVED_BASES, ApprovedBase, is_approved_repository
34
- from .errors import CAPABILITY_UNSUPPORTED, SPEC_INVALID, EnvironmentsError
35
+ from .errors import CAPABILITY_UNSUPPORTED, POLICY_DENIED, SPEC_INVALID, EnvironmentsError
36
+ from .image_import import image_registry_allowed, parse_image_reference
35
37
 
36
38
  __all__ = [
37
39
  "CONTRACT_V1",
@@ -52,9 +54,12 @@ __all__ = [
52
54
  "contract_markdown",
53
55
  "dockerfile_base",
54
56
  "dockerfile_findings_for_build",
57
+ "foreign_dockerfile_base",
58
+ "foreign_dockerfile_findings",
55
59
  "get_contract",
56
60
  "parse_dockerfile",
57
61
  "pin_dockerfile_base",
62
+ "pin_foreign_dockerfile_base",
58
63
  "validate_build_context",
59
64
  "validate_dockerfile",
60
65
  ]
@@ -263,6 +268,8 @@ class DockerfileFinding:
263
268
  line: int
264
269
  instruction: str
265
270
  message: str
271
+ #: Set when this is a policy's refusal rather than a problem with the file.
272
+ code: Any = None
266
273
 
267
274
  def to_dict(self) -> dict[str, object]:
268
275
  return {"line": self.line, "instruction": self.instruction, "message": self.message}
@@ -333,7 +340,11 @@ def _tokens(arguments: str) -> list[str]:
333
340
 
334
341
 
335
342
  def _check_from(
336
- instruction: DockerfileInstruction, stages: set[str], contract: SandboxContract
343
+ instruction: DockerfileInstruction,
344
+ stages: set[str],
345
+ contract: SandboxContract,
346
+ *,
347
+ foreign: bool = False,
337
348
  ) -> list[DockerfileFinding]:
338
349
  findings: list[DockerfileFinding] = []
339
350
  tokens = _tokens(instruction.arguments)
@@ -372,7 +383,7 @@ def _check_from(
372
383
  "the approved bases; name the base itself",
373
384
  )
374
385
  )
375
- elif not is_approved_repository(image):
386
+ elif not foreign and not is_approved_repository(image):
376
387
  findings.append(
377
388
  DockerfileFinding(
378
389
  instruction.line,
@@ -394,14 +405,15 @@ def _mount_options(argument: str) -> dict[str, str]:
394
405
 
395
406
 
396
407
  def validate_dockerfile(
397
- text: str, *, contract: SandboxContract = SANDBOX_CONTRACT_V1
408
+ text: str, *, contract: SandboxContract = SANDBOX_CONTRACT_V1, foreign: bool = False
398
409
  ) -> list[DockerfileFinding]:
399
410
  """Everything in a Dockerfile the contract refuses, in line order.
400
411
 
401
412
  Refused: the instructions a provider's builder does not implement, a
402
413
  base that is not approved (or cannot be checked), a platform other than
403
414
  the contract's, privileged builds, the host network, Docker socket mounts
404
- and host bind mounts.
415
+ and host bind mounts. With `foreign`, a base is not asked to be approved:
416
+ `foreign_dockerfile_findings` holds it to the registries instead.
405
417
  """
406
418
  findings: list[DockerfileFinding] = []
407
419
  stages: set[str] = set()
@@ -413,7 +425,7 @@ def validate_dockerfile(
413
425
  DockerfileFinding(instruction.line, keyword, f"{keyword} is refused: {reason}")
414
426
  )
415
427
  if keyword == "FROM":
416
- findings.extend(_check_from(instruction, stages, contract))
428
+ findings.extend(_check_from(instruction, stages, contract, foreign=foreign))
417
429
  if "docker.sock" in instruction.arguments:
418
430
  findings.append(
419
431
  DockerfileFinding(instruction.line, keyword, "mounts the Docker socket")
@@ -627,6 +639,135 @@ def dockerfile_base(
627
639
  )
628
640
 
629
641
 
642
+ def _foreign_froms(text: str) -> list[tuple[int, str]]:
643
+ """Every `FROM` that names an image rather than an earlier stage: line, image."""
644
+ stages: set[str] = set()
645
+ found: list[tuple[int, str]] = []
646
+ for instruction in parse_dockerfile(text):
647
+ if instruction.keyword != "FROM":
648
+ continue
649
+ image, alias = _from_image(instruction)
650
+ if image and image.lower() not in stages:
651
+ found.append((instruction.line, image))
652
+ if alias:
653
+ stages.add(alias)
654
+ return found
655
+
656
+
657
+ def foreign_dockerfile_findings(
658
+ text: str, *, registries: tuple[str, ...]
659
+ ) -> list[DockerfileFinding]:
660
+ """What a Dockerfile on a foreign base must be: the contract's refusals, one
661
+ base, in `registries`, and no build context.
662
+
663
+ One base because one digest is pinned and one image is layered on. Its
664
+ registry is held to the same list an `image` source is, so this source
665
+ reaches nothing an `image` cannot; there is no credential here, so a
666
+ private registry is refused. An approved base has its own source, whose
667
+ packages the layer would fight.
668
+ """
669
+ findings = validate_dockerfile(text, foreign=True)
670
+ refused = {finding.line for finding in findings}
671
+ froms = _foreign_froms(text)
672
+ if not froms:
673
+ findings.append(DockerfileFinding(1, "FROM", "names no base image"))
674
+ for line, image in froms[1:]:
675
+ findings.append(
676
+ DockerfileFinding(
677
+ line, "FROM", f"`{image}` is a second base: the build pins and layers one"
678
+ )
679
+ )
680
+ for line, image in froms[:1]:
681
+ if "$" in image or line in refused:
682
+ continue
683
+ if is_approved_repository(image):
684
+ findings.append(
685
+ DockerfileFinding(
686
+ line, "FROM", f"`{image}` is an approved base: use the `dockerfile` source"
687
+ )
688
+ )
689
+ continue
690
+ try:
691
+ parsed = parse_image_reference(image)
692
+ except EnvironmentsError as error:
693
+ findings.append(DockerfileFinding(line, "FROM", error.message))
694
+ continue
695
+ if not image_registry_allowed(parsed, registries):
696
+ findings.append(
697
+ DockerfileFinding(
698
+ line,
699
+ "FROM",
700
+ f"`{parsed.registry}` is not an allowed registry; allowed: "
701
+ + ", ".join(registries),
702
+ POLICY_DENIED,
703
+ )
704
+ )
705
+ findings += _foreign_stage_findings(text)
706
+ findings += [
707
+ finding
708
+ for finding in dockerfile_findings_for_build(text)
709
+ if finding.instruction in ("COPY", "ADD", "escape")
710
+ ]
711
+ return sorted(findings, key=lambda finding: finding.line)
712
+
713
+
714
+ def _foreign_stage_findings(text: str) -> list[DockerfileFinding]:
715
+ """A `--from=` that names no earlier stage: BuildKit would pull it as an
716
+ image, past the one base the registries and the digest hold."""
717
+ findings: list[DockerfileFinding] = []
718
+ stages: set[str] = set()
719
+ count = 0
720
+ for instruction in parse_dockerfile(text):
721
+ if instruction.keyword == "FROM":
722
+ _image, alias = _from_image(instruction)
723
+ stages.update({alias} if alias else set())
724
+ count += 1
725
+ continue
726
+ named: list[str] = []
727
+ for token in _tokens(instruction.arguments):
728
+ if not token.startswith("--"):
729
+ break
730
+ if instruction.keyword == "COPY" and token.startswith("--from="):
731
+ named.append(token.split("=", 1)[1])
732
+ if instruction.keyword == "RUN" and token.startswith("--mount="):
733
+ named += [_mount_options(token).get("from", "")]
734
+ for source in filter(None, named):
735
+ earlier = source.lower() in stages or (source.isdigit() and int(source) < count - 1)
736
+ if not earlier:
737
+ findings.append(
738
+ DockerfileFinding(
739
+ instruction.line,
740
+ instruction.keyword,
741
+ f"`{source}` is not an earlier stage: the one base is the only image "
742
+ "a build on a foreign base pulls",
743
+ )
744
+ )
745
+ return findings
746
+
747
+
748
+ def foreign_dockerfile_base(text: str) -> str:
749
+ """The one image a foreign Dockerfile builds on."""
750
+ return _foreign_froms(text)[0][1]
751
+
752
+
753
+ def pin_foreign_dockerfile_base(text: str, reference: str) -> str:
754
+ """The Dockerfile as it is built: its base pinned to `reference`, directives gone."""
755
+ line, image = _foreign_froms(text)[0]
756
+ # As a token, from the `FROM` on: a continuation can carry it to a later line.
757
+ token = re.compile(rf"(?<!\S){re.escape(image)}(?!\S)")
758
+ pinned = False
759
+ rewritten: list[str] = []
760
+ in_directives = True
761
+ for number, raw in enumerate(text.splitlines(), start=1):
762
+ if in_directives and _DIRECTIVE.match(raw.strip()):
763
+ continue
764
+ in_directives = False
765
+ if number >= line and not pinned and token.search(raw):
766
+ raw, pinned = token.sub(lambda _match: reference, raw, count=1), True
767
+ rewritten.append(raw)
768
+ return "\n".join(rewritten) + "\n"
769
+
770
+
630
771
  def pin_dockerfile_base(
631
772
  text: str, reference: str, bases: Mapping[str, ApprovedBase] = APPROVED_BASES
632
773
  ) -> str: