mint-sdk 1.0.0a1__tar.gz

mint_sdk-1.0.0a1/.gitignore

@@ -0,0 +1,102 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+env/
+venv/
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Code Quality Tools
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Node/Frontend
+node_modules/
+/frontend/dist/
+packages/sdk-frontend/dist/
+npm-debug.log*
+bun-debug.log*
+yarn-debug.log*
+
+# TypeScript
+*.tsbuildinfo
+frontend/vite.config.d.ts
+frontend/vite.config.js
+
+# IDE/Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.AppleDouble
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+config.json
+config.dev.toml
+
+# SDK Python build
+packages/sdk-python/dist/
+
+# hatch-vcs generated version files
+api/_version.py
+packages/sdk-python/src/mld_sdk/_version.py
+
+# Histoire
+.histoire/
+
+# VitePress cache + synced content
+site/.vitepress/cache/
+site/changelog.md
+
+# Database
+data/*.db
+
+# MLD CLI runtime data
+.mld/
+
+# Claude Code
+.claude/
+
+# Playwright E2E
+e2e/playwright-report/
+e2e/test-results/
+e2e/blob-report/
+
+# Git Worktrees
+.worktrees/
+
+# SDK test/eval artifacts
+packages/sdk-python/mld-init-test/
+skills/mint-sdk-plugin/evals/
+skills/mint-sdk-plugin/mint-sdk-plugin-workspace/
+
+# Local plugin development
+mld-ms-planner/
+
+# Local data
+data/
+frontend/data/
+.superpowers/
+.omx/
+
+# Skill eval/workspace artifacts (post-R-3 paths; old sdk/skill/* patterns
+# above remain until R-3 merges and the rename consolidates)
+skills/mint-sdk-plugin/evals/
+skills/mint-sdk-plugin/mint-sdk-plugin-workspace/

mint_sdk-1.0.0a1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: mint-sdk
+Version: 1.0.0a1
+Summary: MINT Plugin SDK - Build analysis plugins for the MINT (Mass-spec INtegrated Toolkit) platform
+Project-URL: Homepage, https://github.com/MorscherLab/mld
+Project-URL: Documentation, https://github.com/MorscherLab/mld/tree/main/packages/sdk-python#readme
+Project-URL: Repository, https://github.com/MorscherLab/mld
+Author-email: MorscherLab <morscher@chem.ethz.ch>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typer>=0.15.0
+Provides-Extra: dev
+Requires-Dist: aiosqlite>=0.19.0; extra == 'dev'
+Requires-Dist: greenlet>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: sqlmodel>=0.0.16; extra == 'dev'
+Provides-Extra: local-db
+Requires-Dist: aiosqlite>=0.19.0; extra == 'local-db'
+Requires-Dist: sqlmodel>=0.0.16; extra == 'local-db'
+Description-Content-Type: text/markdown
+
+# MLD SDK (Python)
+
+SDK for building analysis plugins that integrate with the MLD platform.
+
+> **Full Documentation:** See the [comprehensive docs](../../docs/index.md) for detailed API reference and guides.
+> - [API Reference](../../docs/python/api-reference.md)
+> - [Plugin Development Guide](../../docs/python/plugin-guide.md)
+> - [Exception Handling](../../docs/python/exceptions.md)
+
+## Installation
+
+```bash
+# From PyPI (when published)
+uv add mld-sdk
+
+# From git
+uv add git+https://github.com/EstrellaXD/mld#subdirectory=sdk
+```
+
+## Quick Start
+
+Create a plugin by implementing the `AnalysisPlugin` interface:
+
+```python
+from mld_sdk import AnalysisPlugin, PluginMetadata, PluginCapabilities
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello from my plugin!"}
+
+class MyPlugin(AnalysisPlugin):
+    @property
+    def metadata(self) -> PluginMetadata:
+        return PluginMetadata(
+            name="My Plugin",
+            version="1.0.0",
+            description="My analysis plugin",
+            analysis_type="metabolomics",
+            routes_prefix="/my-plugin",
+            capabilities=PluginCapabilities(
+                requires_auth=True,
+                requires_experiments=True,
+            ),
+        )
+
+    def get_routers(self):
+        return [(router, "")]
+
+    async def initialize(self, context=None):
+        self._context = context
+
+    async def shutdown(self):
+        pass
+```
+
+## Plugin Package Structure
+
+```
+mld-plugin-example/
+├── pyproject.toml
+├── README.md
+└── src/mld_plugin_example/
+    ├── __init__.py
+    └── plugin.py
+```
+
+### pyproject.toml
+
+```toml
+[project]
+name = "mld-plugin-example"
+version = "1.0.0"
+dependencies = ["mld-sdk>=1.0.0"]
+
+[project.entry-points."mld.plugins"]
+example = "mld_plugin_example.plugin:MyPlugin"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mld_plugin_example"]
+```
+
+The entry point `mld.plugins` is how the platform discovers your plugin.
+
+## Platform Context
+
+When running integrated with the platform, your plugin receives a `PlatformContext` that provides access to:
+
+- Authentication dependencies (`get_current_user_dependency()`)
+- Repositories for experiments, samples, users, etc.
+- Platform configuration
+
+```python
+async def initialize(self, context=None):
+    self._context = context
+    if context:
+        # Running integrated - use platform services
+        self.experiment_repo = context.get_experiment_repository()
+    else:
+        # Running standalone
+        pass
+```
+
+## Installation Commands
+
+```bash
+# Install from GitHub
+uv add git+https://github.com/org/mld-plugin-example
+
+# Install specific version
+uv add git+https://github.com/org/mld-plugin-example@v1.0.0
+
+# Install from PyPI
+uv add mld-plugin-example
+
+# Install local plugin for development
+uv add --editable ./my-plugin
+```

mint_sdk-1.0.0a1/README.md

@@ -0,0 +1,124 @@
+# MLD SDK (Python)
+
+SDK for building analysis plugins that integrate with the MLD platform.
+
+> **Full Documentation:** See the [comprehensive docs](../../docs/index.md) for detailed API reference and guides.
+> - [API Reference](../../docs/python/api-reference.md)
+> - [Plugin Development Guide](../../docs/python/plugin-guide.md)
+> - [Exception Handling](../../docs/python/exceptions.md)
+
+## Installation
+
+```bash
+# From PyPI (when published)
+uv add mld-sdk
+
+# From git
+uv add git+https://github.com/EstrellaXD/mld#subdirectory=sdk
+```
+
+## Quick Start
+
+Create a plugin by implementing the `AnalysisPlugin` interface:
+
+```python
+from mld_sdk import AnalysisPlugin, PluginMetadata, PluginCapabilities
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/hello")
+async def hello():
+    return {"message": "Hello from my plugin!"}
+
+class MyPlugin(AnalysisPlugin):
+    @property
+    def metadata(self) -> PluginMetadata:
+        return PluginMetadata(
+            name="My Plugin",
+            version="1.0.0",
+            description="My analysis plugin",
+            analysis_type="metabolomics",
+            routes_prefix="/my-plugin",
+            capabilities=PluginCapabilities(
+                requires_auth=True,
+                requires_experiments=True,
+            ),
+        )
+
+    def get_routers(self):
+        return [(router, "")]
+
+    async def initialize(self, context=None):
+        self._context = context
+
+    async def shutdown(self):
+        pass
+```
+
+## Plugin Package Structure
+
+```
+mld-plugin-example/
+├── pyproject.toml
+├── README.md
+└── src/mld_plugin_example/
+    ├── __init__.py
+    └── plugin.py
+```
+
+### pyproject.toml
+
+```toml
+[project]
+name = "mld-plugin-example"
+version = "1.0.0"
+dependencies = ["mld-sdk>=1.0.0"]
+
+[project.entry-points."mld.plugins"]
+example = "mld_plugin_example.plugin:MyPlugin"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mld_plugin_example"]
+```
+
+The entry point `mld.plugins` is how the platform discovers your plugin.
+
+## Platform Context
+
+When running integrated with the platform, your plugin receives a `PlatformContext` that provides access to:
+
+- Authentication dependencies (`get_current_user_dependency()`)
+- Repositories for experiments, samples, users, etc.
+- Platform configuration
+
+```python
+async def initialize(self, context=None):
+    self._context = context
+    if context:
+        # Running integrated - use platform services
+        self.experiment_repo = context.get_experiment_repository()
+    else:
+        # Running standalone
+        pass
+```
+
+## Installation Commands
+
+```bash
+# Install from GitHub
+uv add git+https://github.com/org/mld-plugin-example
+
+# Install specific version
+uv add git+https://github.com/org/mld-plugin-example@v1.0.0
+
+# Install from PyPI
+uv add mld-plugin-example
+
+# Install local plugin for development
+uv add --editable ./my-plugin
+```

mint_sdk-1.0.0a1/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "mint-sdk"
+dynamic = ["version"]
+description = "MINT Plugin SDK - Build analysis plugins for the MINT (Mass-spec INtegrated Toolkit) platform"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [{ name = "MorscherLab", email = "morscher@chem.ethz.ch" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Framework :: FastAPI",
+]
+
+dependencies = ["fastapi>=0.109.0", "pydantic>=2.0.0", "typer>=0.15.0", "httpx>=0.28.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0.0", "pytest-asyncio>=0.21.0", "sqlmodel>=0.0.16", "aiosqlite>=0.19.0", "greenlet>=3.0.0"]
+local-db = ["sqlmodel>=0.0.16", "aiosqlite>=0.19.0"]
+
+[project.urls]
+Homepage = "https://github.com/MorscherLab/mld"
+Documentation = "https://github.com/MorscherLab/mld/tree/main/packages/sdk-python#readme"
+Repository = "https://github.com/MorscherLab/mld"
+
+[project.scripts]
+mint = "mint_sdk.cli:main"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+tag-pattern = "^v(?P<version>\\d+\\.\\d+\\.\\d+.*)$"
+raw-options.root = "../.."
+raw-options.git_describe_command = "git describe --dirty --tags --long --abbrev=40 --match v[0-9]*"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/mint_sdk/_version.py"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mint_sdk"]

mint_sdk-1.0.0a1/src/mint_sdk/__init__.py

@@ -0,0 +1,131 @@
+"""
+MINT Plugin SDK
+
+SDK for building analysis plugins that integrate with the MINT platform.
+"""
+
+from mint_sdk.context import PlatformContext
+
+# Exceptions
+from mint_sdk.exceptions import (
+    ConfigurationException,
+    ConflictException,
+    NotFoundException,
+    PermissionException,
+    PluginException,
+    PluginLifecycleException,
+    RepositoryException,
+    ValidationException,
+)
+from mint_sdk.export import auto_json_to_csv, auto_json_to_summary, auto_json_to_tree
+
+# Local database (optional dependency)
+from mint_sdk.local_database import LocalDatabase, LocalDatabaseConfig
+from mint_sdk.logging import get_plugin_logger
+
+# Migration framework (requires sqlalchemy — optional dependency)
+try:
+    from mint_sdk.migrations import (
+        MigrationOps,
+        MigrationResult,
+        MigrationRunner,
+        PluginMigration,
+    )
+except ImportError:
+    pass
+from mint_sdk.models import PluginCapabilities, PluginMetadata, PluginType
+from mint_sdk.plugin import (
+    AnalysisPlugin,
+    HealthStatus,
+    LifecycleHookResult,
+    PluginHealth,
+)
+
+# Repository protocols and data models
+from mint_sdk.repositories import (
+    DesignData,
+    # Data models
+    Experiment,
+    # Repository protocols
+    ExperimentRepository,
+    PlatformConfig,
+    PluginAnalysisResult,
+    PluginDataRepository,
+    PluginExperimentData,  # backward compatibility alias for DesignData
+    PluginRoleRepository,
+    User,
+    UserPluginRole,
+    UserRepository,
+)
+
+# App factory and helpers
+from mint_sdk.app import (
+    PluginDependency,
+    SPAStaticFiles,
+    create_standalone_app,
+    require_context,
+)
+
+# API Client
+from mint_sdk.client import MINTClient
+
+try:
+    from mint_sdk._version import __version__
+except ImportError:
+    __version__ = "0.0.0"
+
+__all__ = [
+    # API Client
+    "MINTClient",
+    # Core plugin classes
+    "AnalysisPlugin",
+    "PluginMetadata",
+    "PluginCapabilities",
+    "PluginType",
+    "PlatformContext",
+    # Lifecycle types
+    "HealthStatus",
+    "PluginHealth",
+    "LifecycleHookResult",
+    # Exceptions
+    "PluginException",
+    "ValidationException",
+    "PermissionException",
+    "ConfigurationException",
+    "RepositoryException",
+    "NotFoundException",
+    "ConflictException",
+    "PluginLifecycleException",
+    # Local database
+    "LocalDatabase",
+    "LocalDatabaseConfig",
+    # Data models
+    "Experiment",
+    "DesignData",
+    "PluginExperimentData",  # backward compatibility alias
+    "PluginAnalysisResult",
+    "User",
+    "UserPluginRole",
+    # Repository protocols
+    "ExperimentRepository",
+    "PluginDataRepository",
+    "PluginRoleRepository",
+    "UserRepository",
+    "PlatformConfig",
+    # Export utilities
+    "auto_json_to_tree",
+    "auto_json_to_csv",
+    "auto_json_to_summary",
+    # Logging
+    "get_plugin_logger",
+    # Migration framework
+    "MigrationOps",
+    "MigrationResult",
+    "MigrationRunner",
+    "PluginMigration",
+    # App factory and helpers
+    "create_standalone_app",
+    "SPAStaticFiles",
+    "PluginDependency",
+    "require_context",
+]