modal-proxy 0.1.0__tar.gz

modal_proxy-0.1.0/.gitignore

@@ -0,0 +1,276 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+.venv-*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# task folders for local custom claude workflow
+*/*/_tasks/
+.sesskey
+
+# Node.js
+node_modules/
+
+# Frontend build artifacts
+frontend-dist/
+
+# ignore review files
+.reviews/
+
+# files necessary to smuggle session id into reviewers
+.claude/sessionid
+
+# Claude Code local settings (session-specific permissions)
+.claude/settings.local.json
+
+# PR status and URL files written by main_claude_stop_hook.sh for status line display
+.claude/pr_url
+.claude/pr_status
+
+# History of commits reviewed by main_claude_stop_hook.sh (to detect stuck agents)
+.claude/reviewed_commits
+
+# Local Claude settings backup files
+.claude/*.bak
+
+# Local mng settings (not committed)
+.mng/settings.local.toml
+
+# so the user can make their own notification script
+scripts/notify_user.local.sh
+
+# Test output files (slow tests, coverage summaries)
+.test_output/
+
+# TMR output directories (reports + test outputs)
+tmr_*/
+
+# Active session marker file (used to detect interrupted sessions)
+.claude/active
+
+# we stick the image build artifacts here
+.mng/dev/build/
+.mng/dev/secrets/
+
+# Offload caches and local files
+.offload/**
+test-results/**
+current.tar.gz
+
+# Minds deploy-time build artifacts
+.minds/
+
+# Autofix working artifacts
+.autofix/
+
+# Demo recordings (asciinema .cast, .txt, and scripts)
+.demos/
+
+# for git worktrees from other repos
+.external_worktrees/
+
+# ignore coverage files generated within subprojects
+cov.xml

modal_proxy-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: modal-proxy
+Version: 0.1.0
+Summary: Abstraction layer over Modal SDK for mng: supports direct, testing, and remote modes
+Requires-Python: >=3.11
+Requires-Dist: concurrency-group==0.1.8
+Requires-Dist: imbue-common==0.1.8
+Requires-Dist: mng==0.1.8
+Requires-Dist: modal==1.3.1
+Requires-Dist: resource-guards==0.1.1
+Description-Content-Type: text/markdown
+
+# modal-proxy
+
+Abstraction layer over the [Modal](https://modal.com) SDK for [mng](../mng/README.md).
+
+This library defines a `ModalInterface` ABC that captures every interaction mng_modal has with Modal. Three implementations are planned:
+
+1. **DirectModalInterface** -- calls the Modal Python SDK directly (the current behavior, extracted from mng_modal)
+2. **TestingModalInterface** -- fakes Modal behavior locally (volumes become directories, sandboxes become process groups) for integration testing without remote calls
+3. **RemoteModalInterface** -- proxies calls to a web server, enabling a managed service that translates user credentials into real Modal API calls
+
+## Usage
+
+The `ModalInterface` is intended to be injected into `ModalProviderInstance` (in mng_modal) rather than having mng_modal call the Modal SDK directly.

modal_proxy-0.1.0/README.md

@@ -0,0 +1,13 @@
+# modal-proxy
+
+Abstraction layer over the [Modal](https://modal.com) SDK for [mng](../mng/README.md).
+
+This library defines a `ModalInterface` ABC that captures every interaction mng_modal has with Modal. Three implementations are planned:
+
+1. **DirectModalInterface** -- calls the Modal Python SDK directly (the current behavior, extracted from mng_modal)
+2. **TestingModalInterface** -- fakes Modal behavior locally (volumes become directories, sandboxes become process groups) for integration testing without remote calls
+3. **RemoteModalInterface** -- proxies calls to a web server, enabling a managed service that translates user credentials into real Modal API calls
+
+## Usage
+
+The `ModalInterface` is intended to be injected into `ModalProviderInstance` (in mng_modal) rather than having mng_modal call the Modal SDK directly.

modal_proxy-0.1.0/conftest.py

@@ -0,0 +1,13 @@
+"""Project-level conftest for modal-proxy.
+
+When running tests from libs/modal_proxy/, this conftest provides the common pytest hooks
+that would otherwise come from the monorepo root conftest.py (which is not discovered
+when pytest runs from a subdirectory).
+
+When running from the monorepo root, the root conftest.py registers the hooks first,
+and this file's register_conftest_hooks() call is a no-op (guarded by a module-level flag).
+"""
+
+from imbue.imbue_common.conftest_hooks import register_conftest_hooks
+
+register_conftest_hooks(globals())

modal_proxy-0.1.0/imbue/modal_proxy/data_types.py

@@ -0,0 +1,49 @@
+# Simple data types used by the modal_proxy interfaces.
+
+from enum import auto
+
+from pydantic import Field
+
+from imbue.imbue_common.enums import UpperCaseStrEnum
+from imbue.imbue_common.frozen_model import FrozenModel
+
+
+class StreamType(UpperCaseStrEnum):
+    """Controls how stdout/stderr are handled for sandbox exec commands.
+
+    Mirrors modal.stream_type.StreamType for the values we use.
+    """
+
+    PIPE = auto()
+    DEVNULL = auto()
+
+
+class TunnelInfo(FrozenModel):
+    """Connection info for a sandbox port tunnel.
+
+    Mirrors the tunnel object returned by modal.Sandbox.tunnels().
+    """
+
+    tcp_socket: tuple[str, int] = Field(description="(host, port) tuple for the tunnel endpoint")
+
+
+class FileEntryType(UpperCaseStrEnum):
+    """Type of entry in a volume directory listing.
+
+    Mirrors modal.volume.FileEntryType.
+    """
+
+    FILE = auto()
+    DIRECTORY = auto()
+
+
+class FileEntry(FrozenModel):
+    """A single file or directory entry from a volume listing.
+
+    Mirrors modal.volume.FileEntry for the fields we use.
+    """
+
+    path: str = Field(description="Path of the entry")
+    type: FileEntryType = Field(description="Whether this is a file or directory")
+    mtime: float = Field(default=0.0, description="Last modification time as a Unix timestamp")
+    size: int = Field(default=0, description="Size in bytes")