BUILD: pypi publishing

Author: mdw771

.github/workflows/publish-pypi.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build distributions
+        run: uv build --all-packages --no-sources --out-dir dist
+
+      - name: Publish distributions
+        run: uv publish --trusted-publishing always dist/*

README.md

@@ -13,7 +13,21 @@ task-manager, tool, memory, skill, and WebUI primitives. The repository is a
 
 ## Installation
 
-### Option 1: `uv` Workspace Sync (recommended)
+### Option 1: PyPI
+
+Install the core runtime:
+
+```bash
+pip install eaa-core
+```
+
+Install the core runtime plus the domain packages:
+
+```bash
+pip install eaa-core eaa-imaging eaa-spectroscopy
+```
+
+### Option 2: `uv` Workspace Sync
 
 From the repository root:
 
@@ -29,7 +43,7 @@ This installs the workspace members into the repository-local environment as
 editable packages. Use `--all-extras` for local development so optional
 dependencies needed by docs, memory, and workflow examples are not removed.
 
-### Option 2: `pip`
+### Option 3: Editable Source Install
 
 ```bash
 python -m venv .venv

docs/installation.md

@@ -1,6 +1,20 @@
 # Installation
 
-## Recommended: `uv`
+## PyPI
+
+Install the core runtime:
+
+```bash
+pip install eaa-core
+```
+
+Install the core runtime plus the domain packages:
+
+```bash
+pip install eaa-core eaa-imaging eaa-spectroscopy
+```
+
+## Source development with `uv`
 
 At the repository root:
 
@@ -12,6 +26,24 @@ which python
 
 After activation, `which python` should resolve to `.venv/bin/python`.
 
+To sync a smaller source-development environment, select a workspace package.
+Domain packages depend on `eaa-core`, so selecting one domain package also
+installs the core runtime:
+
+```bash
+# Core runtime only
+uv sync --package eaa-core
+
+# Core runtime plus imaging
+uv sync --package eaa-imaging
+
+# Core runtime plus spectroscopy
+uv sync --package eaa-spectroscopy
+
+# Core runtime plus both domain packages
+uv sync --all-packages
+```
+
 Optional extras are declared in `pyproject.toml`. The most relevant ones are:
 
 - `docs` for the Material for MkDocs documentation toolchain
@@ -26,7 +58,7 @@ extra set with:
 uv sync --extra docs
 ```
 
-## Editable install with `pip`
+## Editable source install with `pip`
 
 ```bash
 python -m venv .venv

packages/eaa-core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eaa-core"
-version = "0.1.0"
+version = "1.0.0"
 description = "Core runtime, shared tooling, and generic task managers for EAA."
 requires-python = ">=3.11"
 dependencies = [

packages/eaa-imaging/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eaa-imaging"
-version = "0.1.0"
+version = "1.0.0"
 description = "Imaging and microscopy task managers, tools, and adapters for EAA."
 requires-python = ">=3.11"
 dependencies = [
-    "eaa-core>=0.1.0",
+    "eaa-core>=1.0.0,<2.0.0",
     "numpy",
     "pillow",
     "requests",
@@ -19,7 +19,7 @@ dependencies = [
 
 [project.optional-dependencies]
 bo = [
-    "eaa-core[bo]>=0.1.0",
+    "eaa-core[bo]>=1.0.0,<2.0.0",
 ]
 dev = [
     "pytest",

packages/eaa-spectroscopy/pyproject.toml

@@ -4,18 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eaa-spectroscopy"
-version = "0.1.0"
+version = "1.0.0"
 description = "Spectroscopy tools and adaptive-sampling task managers for EAA."
 requires-python = ">=3.11"
 dependencies = [
-    "eaa-core>=0.1.0",
+    "eaa-core>=1.0.0,<2.0.0",
     "numpy",
     "scipy",
 ]
 
 [project.optional-dependencies]
 bo = [
-    "eaa-core[bo]>=0.1.0",
+    "eaa-core[bo]>=1.0.0,<2.0.0",
 ]
 dev = [
     "pytest",