pycontrol-install 0.1.0a1__tar.gz

pycontrol_install-0.1.0a1/.gitignore

@@ -0,0 +1,58 @@
+### macOS
+# Finder metadata
+.DS_Store
+
+# Thumbnails
+._*
+
+# Custom folder icons
+Icon
+
+# Volume root files
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+### Python
+# Byte-compiled files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# dotenv environment variable files
+.env
+
+# Virtual environments
+.venv
+env/
+venv/
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.pytest_cache/
+
+# Type checkers
+.mypy_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+# .python-version

pycontrol_install-0.1.0a1/LICENSE.txt

@@ -0,0 +1,8 @@
+Copyright © 2026 Howard Hughes Medical Institute
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of HHMI nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pycontrol_install-0.1.0a1/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: pycontrol-install
+Version: 0.1.0a1
+Summary: uvx installer for the global pyControl GUI and its workspaces.
+Project-URL: Homepage, https://github.com/karpova-lab/pycontrol-install
+Author: pyControl contributors
+License: GPL-3.0-or-later
+License-File: LICENSE.txt
+Keywords: behaviour,neuroscience,pycontrol,uv
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# pycontrol-install
+
+`pycontrol-install` is a small `uvx` installer for pyControl. It installs
+`pycontrol-gui` (and the `pycontrol` CLI) **once per machine** with
+`uv tool install`, scaffolds plain-data workspace folders, and remembers the
+workspace so the global `pycontrol-gui` command opens it on the next launch.
+
+Install `uv`, then install pyControl and create a workspace:
+
+```bash
+uvx pycontrol-install my-workspace --launch
+```
+
+This:
+
+1. runs `uv tool install pycontrol-gui` into a self-contained, uv-managed
+   environment, putting `pycontrol-gui` and `pycontrol` on your PATH,
+2. scaffolds the `my-workspace` data folder (no `pyproject.toml`, `.venv`, or
+   lockfile — workspaces are pure data),
+3. remembers it as the GUI's current workspace,
+4. offers to create an OS shortcut (macOS `~/Applications`, Windows Start
+   menu, Linux application menu), and
+5. launches the GUI (`--launch`).
+
+After setup, launch the GUI from anywhere with `pycontrol-gui`.
+
+To initialize the current directory instead:
+
+```bash
+uvx pycontrol-install . --launch
+```
+
+This package intentionally uses `uv`. Users who prefer pip can still install
+and run pyControl manually from a Python 3.11+ virtual environment; see the
+`pycontrol-core` getting-started guide for the pip/venv workflow.
+
+## Usage
+
+```bash
+pycontrol-install [path] [--launch] [--force] [--shortcut | --no-shortcut] [--update-gui]
+```
+
+`path` defaults to the current directory. Relative paths are resolved from the
+directory where the command is run. Re-running `pycontrol-install` is safe: the
+global install is refreshed (`--reinstall`) and workspace scaffolding is a safe
+merge.
+
+Examples:
+
+```bash
+pycontrol-install
+pycontrol-install my-workspace --launch
+pycontrol-install ~/pycontrol-workspaces/ws1 --with-slack
+pycontrol-install my-workspace --no-shortcut
+```
+
+## Updating the GUI
+
+```bash
+uvx pycontrol-install --update-gui
+```
+
+Reinstalls the newest `pycontrol-gui` against a freshly refreshed package
+index, preserving integration extras recorded in the uv tool receipt.
+(`uv tool upgrade pycontrol-gui` also works; `--update-gui` additionally
+guarantees the index is revalidated and the pyControl resolution strategy is
+applied.)
+
+## Integration helpers
+
+Optional integration dependencies are installed into the global tool
+environment:
+
+```bash
+pycontrol-install my-workspace --with-slack
+pycontrol-install my-workspace --with-notion
+pycontrol-install my-workspace --with-s3
+pycontrol-install my-workspace --with-integrations
+```
+
+To add an integration to an existing install without touching any workspace,
+combine it with `--update-gui`:
+
+```bash
+uvx pycontrol-install --update-gui --with-slack
+```
+
+## Release smoke tests
+
+Package indexes can be overridden:
+
+```bash
+pycontrol-install test-workspace \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/
+```
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check src tests
+```

pycontrol_install-0.1.0a1/README.md

@@ -0,0 +1,104 @@
+# pycontrol-install
+
+`pycontrol-install` is a small `uvx` installer for pyControl. It installs
+`pycontrol-gui` (and the `pycontrol` CLI) **once per machine** with
+`uv tool install`, scaffolds plain-data workspace folders, and remembers the
+workspace so the global `pycontrol-gui` command opens it on the next launch.
+
+Install `uv`, then install pyControl and create a workspace:
+
+```bash
+uvx pycontrol-install my-workspace --launch
+```
+
+This:
+
+1. runs `uv tool install pycontrol-gui` into a self-contained, uv-managed
+   environment, putting `pycontrol-gui` and `pycontrol` on your PATH,
+2. scaffolds the `my-workspace` data folder (no `pyproject.toml`, `.venv`, or
+   lockfile — workspaces are pure data),
+3. remembers it as the GUI's current workspace,
+4. offers to create an OS shortcut (macOS `~/Applications`, Windows Start
+   menu, Linux application menu), and
+5. launches the GUI (`--launch`).
+
+After setup, launch the GUI from anywhere with `pycontrol-gui`.
+
+To initialize the current directory instead:
+
+```bash
+uvx pycontrol-install . --launch
+```
+
+This package intentionally uses `uv`. Users who prefer pip can still install
+and run pyControl manually from a Python 3.11+ virtual environment; see the
+`pycontrol-core` getting-started guide for the pip/venv workflow.
+
+## Usage
+
+```bash
+pycontrol-install [path] [--launch] [--force] [--shortcut | --no-shortcut] [--update-gui]
+```
+
+`path` defaults to the current directory. Relative paths are resolved from the
+directory where the command is run. Re-running `pycontrol-install` is safe: the
+global install is refreshed (`--reinstall`) and workspace scaffolding is a safe
+merge.
+
+Examples:
+
+```bash
+pycontrol-install
+pycontrol-install my-workspace --launch
+pycontrol-install ~/pycontrol-workspaces/ws1 --with-slack
+pycontrol-install my-workspace --no-shortcut
+```
+
+## Updating the GUI
+
+```bash
+uvx pycontrol-install --update-gui
+```
+
+Reinstalls the newest `pycontrol-gui` against a freshly refreshed package
+index, preserving integration extras recorded in the uv tool receipt.
+(`uv tool upgrade pycontrol-gui` also works; `--update-gui` additionally
+guarantees the index is revalidated and the pyControl resolution strategy is
+applied.)
+
+## Integration helpers
+
+Optional integration dependencies are installed into the global tool
+environment:
+
+```bash
+pycontrol-install my-workspace --with-slack
+pycontrol-install my-workspace --with-notion
+pycontrol-install my-workspace --with-s3
+pycontrol-install my-workspace --with-integrations
+```
+
+To add an integration to an existing install without touching any workspace,
+combine it with `--update-gui`:
+
+```bash
+uvx pycontrol-install --update-gui --with-slack
+```
+
+## Release smoke tests
+
+Package indexes can be overridden:
+
+```bash
+pycontrol-install test-workspace \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/
+```
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check src tests
+```

pycontrol_install-0.1.0a1/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pycontrol-install"
+version = "0.1.0a1"
+description = "uvx installer for the global pyControl GUI and its workspaces."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "GPL-3.0-or-later" }
+authors = [{ name = "pyControl contributors" }]
+keywords = ["neuroscience", "behaviour", "pycontrol", "uv"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Topic :: Scientific/Engineering",
+]
+
+[project.scripts]
+pycontrol-install = "pycontrol_install.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/karpova-lab/pycontrol-install"
+
+[dependency-groups]
+dev = [
+  "pytest>=8",
+  "ruff>=0.5",
+]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+  "/.git",
+  "/.pytest_cache",
+  "/.ruff_cache",
+  "/.venv",
+  "/build",
+  "/dist",
+  "*.egg-info",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pycontrol_install"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = "-ra --strict-markers --strict-config"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src", "tests"]

pycontrol_install-0.1.0a1/src/pycontrol_install/__init__.py

@@ -0,0 +1,5 @@
+"""pyControl global installer."""
+
+__version__ = "0.1.0a1"
+
+__all__ = ["__version__"]

pycontrol_install-0.1.0a1/src/pycontrol_install/cli.py

@@ -0,0 +1,334 @@
+"""Command-line installer for the global pyControl app and its workspaces.
+
+``pycontrol-install`` installs ``pycontrol-gui`` once per machine with
+``uv tool install``, scaffolds plain-data workspace folders, and remembers the
+workspace so the globally installed ``pycontrol-gui`` command opens it on the
+next launch.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import shlex
+import shutil
+import subprocess
+import sys
+import tomllib
+from collections.abc import Sequence
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Protocol
+
+from pycontrol_install.shortcuts import create_shortcut
+
+GUI_PACKAGE = "pycontrol-gui"
+CORE_PACKAGE = "pycontrol-core"
+_INTEGRATION_EXTRAS = ("notion", "s3", "slack")
+_PRERELEASE_CHOICES = ("allow", "disallow", "if-necessary", "explicit", "if-necessary-or-explicit")
+
+
+class BootstrapError(RuntimeError):
+    """Expected bootstrap failure suitable for a one-line CLI error."""
+
+
+class CommandRunner(Protocol):
+    """Small abstraction for testing command construction without invoking uv."""
+
+    def has_command(self, name: str) -> bool: ...
+
+    def run(self, cwd: Path, command: Sequence[str]) -> None: ...
+
+    def run_capture(self, cwd: Path, command: Sequence[str]) -> str: ...
+
+
+@dataclass(frozen=True)
+class BootstrapConfig:
+    """Parsed bootstrap options."""
+
+    target: Path
+    launch: bool
+    force: bool
+    python: str
+    prerelease: str
+    index_url: str | None
+    extra_index_url: str | None
+    integration_extras: tuple[str, ...]
+    update_gui: bool
+    shortcut: bool | None
+
+
+class SubprocessRunner:
+    """Run commands on the local machine."""
+
+    def has_command(self, name: str) -> bool:
+        return shutil.which(name) is not None
+
+    def run(self, cwd: Path, command: Sequence[str]) -> None:
+        print(f"Running in {cwd}: {shlex.join(command)}")
+        try:
+            subprocess.run(command, cwd=cwd, check=True)
+        except FileNotFoundError as exc:
+            raise BootstrapError(f"command not found: {command[0]}") from exc
+        except subprocess.CalledProcessError as exc:
+            raise BootstrapError(f"command failed with exit code {exc.returncode}: {shlex.join(command)}") from exc
+
+    def run_capture(self, cwd: Path, command: Sequence[str]) -> str:
+        try:
+            completed = subprocess.run(command, cwd=cwd, check=True, capture_output=True, text=True)
+        except FileNotFoundError as exc:
+            raise BootstrapError(f"command not found: {command[0]}") from exc
+        except subprocess.CalledProcessError as exc:
+            raise BootstrapError(f"command failed with exit code {exc.returncode}: {shlex.join(command)}") from exc
+        return completed.stdout.strip()
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="pycontrol-install",
+        description="Install the pyControl GUI globally with uv and create a workspace data folder.",
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Workspace path to create or initialize (default: current directory).",
+    )
+    parser.add_argument(
+        "--launch",
+        action="store_true",
+        help="Launch the pyControl GUI after the workspace is ready.",
+    )
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Pass --force to workspace scaffolding so differing bundled files are overwritten.",
+    )
+    parser.add_argument(
+        "--update-gui",
+        action="store_true",
+        help="Reinstall the newest pyControl GUI (preserving installed integration extras) and exit.",
+    )
+    parser.add_argument(
+        "--shortcut",
+        action=argparse.BooleanOptionalAction,
+        default=None,
+        help="Create (or skip) an OS shortcut for the pyControl GUI without prompting.",
+    )
+    parser.add_argument(
+        "--python",
+        default="3.12",
+        help="Python version request for the global tool environment (default: 3.12).",
+    )
+    parser.add_argument(
+        "--prerelease",
+        choices=_PRERELEASE_CHOICES,
+        default="if-necessary-or-explicit",
+        help=(
+            "uv prerelease resolution strategy (default: if-necessary-or-explicit, which selects pyControl "
+            "alphas because no stable release exists yet while keeping third-party dependencies stable)."
+        ),
+    )
+    parser.add_argument(
+        "--index-url",
+        default=None,
+        help="Package index URL for uv tool install, or PYCONTROL_INSTALL_INDEX_URL.",
+    )
+    parser.add_argument(
+        "--extra-index-url",
+        default=None,
+        help="Extra package index URL for uv tool install, or PYCONTROL_INSTALL_EXTRA_INDEX_URL.",
+    )
+    parser.add_argument(
+        "--with-slack",
+        action="store_true",
+        help="Install Slack notification dependencies into the global tool environment.",
+    )
+    parser.add_argument(
+        "--with-notion",
+        action="store_true",
+        help="Install Notion helper dependencies into the global tool environment.",
+    )
+    parser.add_argument(
+        "--with-s3",
+        action="store_true",
+        help="Install S3 export helper dependencies into the global tool environment.",
+    )
+    parser.add_argument(
+        "--with-integrations",
+        action="store_true",
+        help="Install all optional integration helper dependencies into the global tool environment.",
+    )
+    return parser
+
+
+def config_from_args(args: argparse.Namespace) -> BootstrapConfig:
+    selected = set(_INTEGRATION_EXTRAS if args.with_integrations else ())
+    if args.with_notion:
+        selected.add("notion")
+    if args.with_s3:
+        selected.add("s3")
+    if args.with_slack:
+        selected.add("slack")
+
+    return BootstrapConfig(
+        target=Path(args.path),
+        launch=bool(args.launch),
+        force=bool(args.force),
+        python=str(args.python),
+        prerelease=str(args.prerelease),
+        index_url=args.index_url or os.environ.get("PYCONTROL_INSTALL_INDEX_URL") or None,
+        extra_index_url=args.extra_index_url or os.environ.get("PYCONTROL_INSTALL_EXTRA_INDEX_URL") or None,
+        integration_extras=tuple(extra for extra in _INTEGRATION_EXTRAS if extra in selected),
+        update_gui=bool(args.update_gui),
+        shortcut=args.shortcut,
+    )
+
+
+def bootstrap(config: BootstrapConfig, runner: CommandRunner | None = None) -> Path | None:
+    """Install the GUI globally, then scaffold and remember the workspace.
+
+    Returns the workspace path, or ``None`` for ``--update-gui`` runs.
+    """
+    runner = runner or SubprocessRunner()
+    if not runner.has_command("uv"):
+        raise BootstrapError(
+            "uv is required because pycontrol-install uses uv; install it from "
+            "https://docs.astral.sh/uv/getting-started/installation/"
+        )
+
+    cwd = Path.cwd()
+    receipt = _receipt_path(runner, cwd)
+
+    if config.update_gui:
+        if receipt is None or not receipt.is_file():
+            raise BootstrapError(
+                f"{GUI_PACKAGE} is not installed as a uv tool yet; run pycontrol-install without --update-gui first."
+            )
+        extras = tuple(sorted({*_extras_from_receipt(receipt), *config.integration_extras}))
+        runner.run(cwd, _install_command(config, extras=extras, reinstall=True))
+        print(f"{GUI_PACKAGE} reinstalled at the newest version.")
+        return None
+
+    reinstall = receipt is not None and receipt.is_file()
+    runner.run(cwd, _install_command(config, extras=config.integration_extras, reinstall=reinstall))
+
+    bin_dir = Path(runner.run_capture(cwd, ["uv", "tool", "dir", "--bin"]))
+    target = _prepare_target(config.target)
+
+    workspace_init = [str(bin_dir / "pycontrol"), "workspace", "init", str(target)]
+    if config.force:
+        workspace_init.append("--force")
+    runner.run(target, workspace_init)
+
+    runner.run(target, [str(bin_dir / GUI_PACKAGE), "--set-workspace", str(target)])
+
+    if _shortcut_wanted(config.shortcut):
+        _create_shortcut_nonfatal(bin_dir)
+
+    if config.launch:
+        runner.run(target, [str(bin_dir / GUI_PACKAGE), str(target)])
+
+    return target
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    try:
+        workspace = bootstrap(config_from_args(args))
+    except BootstrapError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 2
+
+    if workspace is not None:
+        print(f"Workspace ready: {workspace}")
+        if not args.launch:
+            print(f"Launch anytime with: {GUI_PACKAGE}")
+        print(f"If the {GUI_PACKAGE} command is not found in new terminals, run: uv tool update-shell")
+    return 0
+
+
+def _install_command(config: BootstrapConfig, *, extras: tuple[str, ...], reinstall: bool) -> list[str]:
+    # --refresh: resolve against a revalidated index so a release published
+    # moments ago is picked up instead of a cached older version.
+    # --force: claim the pycontrol/pycontrol-gui executables even when a stale
+    # shim or an older tool install already provides them.
+    command = [
+        "uv",
+        "tool",
+        "install",
+        "--refresh",
+        "--force",
+        "--python",
+        config.python,
+        "--prerelease",
+        config.prerelease,
+    ]
+    if config.index_url:
+        command.extend(["--index-url", config.index_url])
+    if config.extra_index_url:
+        command.extend(["--extra-index-url", config.extra_index_url])
+    if extras:
+        command.extend(["--with", f"{CORE_PACKAGE}[{','.join(sorted(extras))}]"])
+    command.extend(["--with-executables-from", CORE_PACKAGE])
+    if reinstall:
+        command.append("--reinstall")
+    command.append(GUI_PACKAGE)
+    return command
+
+
+def _receipt_path(runner: CommandRunner, cwd: Path) -> Path | None:
+    try:
+        tool_dir = runner.run_capture(cwd, ["uv", "tool", "dir"])
+    except BootstrapError:
+        return None
+    if not tool_dir:
+        return None
+    return Path(tool_dir) / GUI_PACKAGE / "uv-receipt.toml"
+
+
+def _extras_from_receipt(receipt: Path) -> tuple[str, ...]:
+    """Recover ``pycontrol-core`` extras from the uv tool receipt so an update
+    reinstall keeps previously chosen integrations."""
+    try:
+        data = tomllib.loads(receipt.read_text(encoding="utf-8"))
+    except (OSError, tomllib.TOMLDecodeError):
+        return ()
+    requirements = data.get("tool", {}).get("requirements", [])
+    for requirement in requirements:
+        if isinstance(requirement, dict) and requirement.get("name") == CORE_PACKAGE:
+            extras = requirement.get("extras", [])
+            return tuple(sorted(str(extra) for extra in extras if str(extra) in _INTEGRATION_EXTRAS))
+    return ()
+
+
+def _prepare_target(raw_target: Path) -> Path:
+    target = raw_target.expanduser().resolve()
+    if target.exists() and not target.is_dir():
+        raise BootstrapError(f"target exists and is not a directory: {target}")
+    target.mkdir(parents=True, exist_ok=True)
+    return target
+
+
+def _shortcut_wanted(shortcut: bool | None) -> bool:
+    if shortcut is not None:
+        return shortcut
+    if not sys.stdin.isatty():
+        return False
+    answer = input("Create an OS shortcut for the pyControl GUI? [Y/n] ").strip().lower()
+    return answer in ("", "y", "yes")
+
+
+def _create_shortcut_nonfatal(bin_dir: Path) -> None:
+    try:
+        created = create_shortcut(bin_dir)
+    except Exception as exc:  # noqa: BLE001 - shortcuts are a nicety, never fatal.
+        print(f"warning: could not create a shortcut: {exc}", file=sys.stderr)
+        return
+    if created is not None:
+        print(f"Shortcut created: {created}")
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

pycontrol_install-0.1.0a1/src/pycontrol_install/shortcuts.py

@@ -0,0 +1,116 @@
+"""Optional OS shortcuts pointing at the globally installed ``pycontrol-gui``.
+
+All variants target the stable uv tool shim (``<uv tool bin dir>/pycontrol-gui``),
+which survives upgrades, so shortcuts never need regeneration.
+"""
+
+from __future__ import annotations
+
+import plistlib
+import subprocess
+import sys
+from pathlib import Path
+
+APP_NAME = "pyControl GUI"
+_BUNDLE_IDENTIFIER = "org.pycontrol.gui-launcher"
+
+
+def create_shortcut(bin_dir: Path, home: Path | None = None, platform: str | None = None) -> Path | None:
+    """Create a double-clickable shortcut for the current OS.
+
+    Returns the created shortcut path, or ``None`` when the platform has no
+    shortcut support. Raises on failure; callers treat that as non-fatal.
+    """
+    home = home or Path.home()
+    platform = platform or sys.platform
+    if platform == "darwin":
+        return create_macos_app_bundle(bin_dir, home)
+    if platform == "win32":
+        return create_windows_start_menu_shortcut(bin_dir)
+    if platform.startswith("linux"):
+        return create_linux_desktop_entry(bin_dir, home)
+    return None
+
+
+def create_macos_app_bundle(bin_dir: Path, home: Path) -> Path:
+    """Minimal ~/Applications app bundle wrapping the pycontrol-gui shim."""
+    bundle = home / "Applications" / f"{APP_NAME}.app"
+    macos_dir = bundle / "Contents" / "MacOS"
+    macos_dir.mkdir(parents=True, exist_ok=True)
+
+    info = {
+        "CFBundleName": APP_NAME,
+        "CFBundleDisplayName": APP_NAME,
+        "CFBundleIdentifier": _BUNDLE_IDENTIFIER,
+        "CFBundlePackageType": "APPL",
+        "CFBundleExecutable": "pycontrol-gui-launcher",
+    }
+    with (bundle / "Contents" / "Info.plist").open("wb") as stream:
+        plistlib.dump(info, stream)
+
+    launcher = macos_dir / "pycontrol-gui-launcher"
+    launcher.write_text(macos_launcher_script(bin_dir), encoding="utf-8", newline="\n")
+    launcher.chmod(launcher.stat().st_mode | 0o111)
+    return bundle
+
+
+def macos_launcher_script(bin_dir: Path) -> str:
+    return f'#!/bin/sh\nexec "{bin_dir / "pycontrol-gui"}" "$@"\n'
+
+
+def create_windows_start_menu_shortcut(bin_dir: Path) -> Path:
+    """Start-menu .lnk via the WScript.Shell COM object (no extra dependencies)."""
+    completed = subprocess.run(
+        ["powershell", "-NoProfile", "-Command", windows_shortcut_command(bin_dir)],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    link_path = completed.stdout.strip().splitlines()[-1] if completed.stdout.strip() else ""
+    if not link_path:
+        raise RuntimeError("PowerShell did not report the created shortcut path")
+    return Path(link_path)
+
+
+def windows_shortcut_command(bin_dir: Path) -> str:
+    target = bin_dir / "pycontrol-gui.exe"
+    return (
+        "$programs = [Environment]::GetFolderPath('Programs'); "
+        f"$link = Join-Path $programs '{APP_NAME}.lnk'; "
+        "$shell = New-Object -ComObject WScript.Shell; "
+        "$shortcut = $shell.CreateShortcut($link); "
+        f"$shortcut.TargetPath = '{target}'; "
+        "$shortcut.Save(); "
+        "Write-Output $link"
+    )
+
+
+def create_linux_desktop_entry(bin_dir: Path, home: Path) -> Path:
+    applications = home / ".local" / "share" / "applications"
+    applications.mkdir(parents=True, exist_ok=True)
+    entry = applications / "pycontrol-gui.desktop"
+    entry.write_text(linux_desktop_entry(bin_dir), encoding="utf-8", newline="\n")
+    return entry
+
+
+def linux_desktop_entry(bin_dir: Path) -> str:
+    return (
+        "[Desktop Entry]\n"
+        "Type=Application\n"
+        f"Name={APP_NAME}\n"
+        f'Exec="{bin_dir / "pycontrol-gui"}"\n'
+        "Terminal=false\n"
+        "Categories=Science;\n"
+    )
+
+
+__all__ = [
+    "APP_NAME",
+    "create_linux_desktop_entry",
+    "create_macos_app_bundle",
+    "create_shortcut",
+    "create_windows_start_menu_shortcut",
+    "linux_desktop_entry",
+    "macos_launcher_script",
+    "windows_shortcut_command",
+]

pycontrol_install-0.1.0a1/tests/test_cli.py

@@ -0,0 +1,266 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+import pytest
+
+from pycontrol_install.cli import BootstrapError, bootstrap, build_parser, config_from_args, main
+
+
+@dataclass(frozen=True)
+class Call:
+    cwd: Path
+    command: tuple[str, ...]
+
+
+class FakeRunner:
+    def __init__(self, *, has_uv: bool = True, tool_dir: Path | None = None, bin_dir: Path | None = None) -> None:
+        self.has_uv = has_uv
+        self.tool_dir = tool_dir
+        self.bin_dir = bin_dir or Path("/fake/bin")
+        self.calls: list[Call] = []
+
+    def has_command(self, name: str) -> bool:
+        return name == "uv" and self.has_uv
+
+    def run(self, cwd: Path, command: tuple[str, ...] | list[str]) -> None:
+        self.calls.append(Call(cwd=cwd, command=tuple(command)))
+
+    def run_capture(self, cwd: Path, command: tuple[str, ...] | list[str]) -> str:
+        self.calls.append(Call(cwd=cwd, command=tuple(command)))
+        if tuple(command) == ("uv", "tool", "dir"):
+            if self.tool_dir is None:
+                return ""
+            return str(self.tool_dir)
+        if tuple(command) == ("uv", "tool", "dir", "--bin"):
+            return str(self.bin_dir)
+        raise AssertionError(f"unexpected capture command: {command}")
+
+
+def _config(argv: list[str]):
+    parser = build_parser()
+    return config_from_args(parser.parse_args(argv))
+
+
+def _install_command(*, extras: str | None = None, reinstall: bool = False, index: tuple[str, ...] = ()) -> tuple[str, ...]:
+    command = [
+        "uv",
+        "tool",
+        "install",
+        "--refresh",
+        "--force",
+        "--python",
+        "3.12",
+        "--prerelease",
+        "if-necessary-or-explicit",
+        *index,
+    ]
+    if extras:
+        command.extend(["--with", f"pycontrol-core[{extras}]"])
+    command.extend(["--with-executables-from", "pycontrol-core"])
+    if reinstall:
+        command.append("--reinstall")
+    command.append("pycontrol-gui")
+    return tuple(command)
+
+
+def _write_receipt(tool_dir: Path, *, extras: list[str] | None = None) -> None:
+    package_dir = tool_dir / "pycontrol-gui"
+    package_dir.mkdir(parents=True, exist_ok=True)
+    extras_toml = ""
+    if extras:
+        listed = ", ".join(f'"{extra}"' for extra in extras)
+        extras_toml = f", extras = [{listed}]"
+    (package_dir / "uv-receipt.toml").write_text(
+        "[tool]\n"
+        "requirements = [\n"
+        '    { name = "pycontrol-gui" },\n'
+        f'    {{ name = "pycontrol-core"{extras_toml} }},\n'
+        "]\n",
+        encoding="utf-8",
+    )
+
+
+def test_defaults_install_globally_and_initialize_current_directory(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools", bin_dir=tmp_path / "bin")
+
+    workspace = bootstrap(_config(["--no-shortcut"]), runner)
+
+    ws = tmp_path.resolve()
+    bin_dir = tmp_path / "bin"
+    assert workspace == ws
+    assert runner.calls == [
+        Call(ws, ("uv", "tool", "dir")),
+        Call(ws, _install_command()),
+        Call(ws, ("uv", "tool", "dir", "--bin")),
+        Call(ws, (str(bin_dir / "pycontrol"), "workspace", "init", str(ws))),
+        Call(ws, (str(bin_dir / "pycontrol-gui"), "--set-workspace", str(ws))),
+    ]
+
+
+def test_relative_path_creates_child_workspace(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools")
+
+    workspace = bootstrap(_config(["my-workspace", "--no-shortcut"]), runner)
+
+    assert workspace == (tmp_path / "my-workspace").resolve()
+    assert workspace.is_dir()
+
+
+def test_existing_install_adds_reinstall(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    tool_dir = tmp_path / "tools"
+    _write_receipt(tool_dir)
+    runner = FakeRunner(tool_dir=tool_dir)
+
+    bootstrap(_config(["--no-shortcut"]), runner)
+
+    assert runner.calls[1].command == _install_command(reinstall=True)
+
+
+def test_force_only_changes_the_workspace_init_step(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools", bin_dir=tmp_path / "bin")
+
+    bootstrap(_config(["ws", "--force", "--no-shortcut"]), runner)
+
+    ws = (tmp_path / "ws").resolve()
+    workspace_init = runner.calls[3].command
+    # The install command is unchanged by the user's --force flag ...
+    assert runner.calls[1].command == _install_command()
+    # ... which is instead forwarded to workspace scaffolding.
+    assert workspace_init == (str(tmp_path / "bin" / "pycontrol"), "workspace", "init", str(ws), "--force")
+
+
+def test_file_target_errors(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    target = tmp_path / "workspace.txt"
+    target.write_text("not a directory\n")
+
+    with pytest.raises(BootstrapError, match="not a directory"):
+        bootstrap(_config([str(target), "--no-shortcut"]), FakeRunner(tool_dir=tmp_path / "tools"))
+
+
+def test_launch_runs_global_gui_with_workspace_path(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools", bin_dir=tmp_path / "bin")
+
+    bootstrap(_config(["ws", "--launch", "--no-shortcut"]), runner)
+
+    ws = (tmp_path / "ws").resolve()
+    assert runner.calls[-1] == Call(ws, (str(tmp_path / "bin" / "pycontrol-gui"), str(ws)))
+
+
+def test_integration_extras_are_installed_globally(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools")
+
+    bootstrap(_config(["ws", "--with-slack", "--with-s3", "--no-shortcut"]), runner)
+
+    assert runner.calls[1].command == _install_command(extras="s3,slack")
+
+
+def test_all_integrations_are_added_in_deterministic_order(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools")
+
+    bootstrap(_config(["ws", "--with-integrations", "--no-shortcut"]), runner)
+
+    assert "pycontrol-core[notion,s3,slack]" in runner.calls[1].command
+
+
+def test_index_options_are_passed_to_install(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    runner = FakeRunner(tool_dir=tmp_path / "tools")
+
+    bootstrap(
+        _config(
+            [
+                "ws",
+                "--no-shortcut",
+                "--index-url",
+                "https://test.pypi.org/simple/",
+                "--extra-index-url",
+                "https://pypi.org/simple/",
+            ]
+        ),
+        runner,
+    )
+
+    assert runner.calls[1].command == _install_command(
+        index=(
+            "--index-url",
+            "https://test.pypi.org/simple/",
+            "--extra-index-url",
+            "https://pypi.org/simple/",
+        )
+    )
+
+
+def test_update_gui_reinstalls_with_receipt_extras_and_skips_scaffolding(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.chdir(tmp_path)
+    tool_dir = tmp_path / "tools"
+    _write_receipt(tool_dir, extras=["slack", "notion"])
+    runner = FakeRunner(tool_dir=tool_dir)
+
+    result = bootstrap(_config(["--update-gui"]), runner)
+
+    assert result is None
+    assert runner.calls == [
+        Call(tmp_path.resolve(), ("uv", "tool", "dir")),
+        Call(tmp_path.resolve(), _install_command(extras="notion,slack", reinstall=True)),
+    ]
+
+
+def test_update_gui_merges_new_extras_with_receipt(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    tool_dir = tmp_path / "tools"
+    _write_receipt(tool_dir, extras=["slack"])
+    runner = FakeRunner(tool_dir=tool_dir)
+
+    bootstrap(_config(["--update-gui", "--with-s3"]), runner)
+
+    assert runner.calls[1].command == _install_command(extras="s3,slack", reinstall=True)
+
+
+def test_update_gui_without_existing_install_errors(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.chdir(tmp_path)
+
+    with pytest.raises(BootstrapError, match="not installed"):
+        bootstrap(_config(["--update-gui"]), FakeRunner(tool_dir=tmp_path / "tools"))
+
+
+def test_missing_uv_is_reported() -> None:
+    with pytest.raises(BootstrapError, match="uv is required"):
+        bootstrap(_config([]), FakeRunner(has_uv=False))
+
+
+def test_main_reports_bootstrap_errors(capsys: pytest.CaptureFixture[str], monkeypatch: pytest.MonkeyPatch) -> None:
+    def fail(_config):
+        raise BootstrapError("bad workspace")
+
+    monkeypatch.setattr("pycontrol_install.cli.bootstrap", fail)
+
+    rc = main(["."])
+
+    assert rc == 2
+    assert capsys.readouterr().err == "error: bad workspace\n"
+
+
+def test_main_prints_launch_hint(capsys: pytest.CaptureFixture[str], monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
+    monkeypatch.setattr("pycontrol_install.cli.bootstrap", lambda _config: tmp_path)
+
+    rc = main(["."])
+
+    assert rc == 0
+    out = capsys.readouterr().out
+    assert f"Workspace ready: {tmp_path}" in out
+    assert "Launch anytime with: pycontrol-gui" in out
+    assert "uv tool update-shell" in out

pycontrol_install-0.1.0a1/tests/test_shortcuts.py

@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+import os
+import plistlib
+from pathlib import Path
+
+from pycontrol_install import shortcuts
+
+
+def test_macos_app_bundle_wraps_the_gui_shim(tmp_path: Path) -> None:
+    bin_dir = tmp_path / "bin"
+    home = tmp_path / "home"
+
+    bundle = shortcuts.create_macos_app_bundle(bin_dir, home)
+
+    assert bundle == home / "Applications" / "pyControl GUI.app"
+    with (bundle / "Contents" / "Info.plist").open("rb") as stream:
+        info = plistlib.load(stream)
+    assert info["CFBundleExecutable"] == "pycontrol-gui-launcher"
+    assert info["CFBundlePackageType"] == "APPL"
+    launcher = bundle / "Contents" / "MacOS" / "pycontrol-gui-launcher"
+    text = launcher.read_text(encoding="utf-8")
+    assert text.startswith("#!/bin/sh\n")
+    assert str(bin_dir / "pycontrol-gui") in text
+    assert os.access(launcher, os.X_OK)
+
+
+def test_macos_bundle_overwrites_existing(tmp_path: Path) -> None:
+    bin_dir = tmp_path / "bin"
+    home = tmp_path / "home"
+    shortcuts.create_macos_app_bundle(tmp_path / "old-bin", home)
+
+    shortcuts.create_macos_app_bundle(bin_dir, home)
+
+    launcher = home / "Applications" / "pyControl GUI.app" / "Contents" / "MacOS" / "pycontrol-gui-launcher"
+    assert str(bin_dir / "pycontrol-gui") in launcher.read_text(encoding="utf-8")
+
+
+def test_windows_shortcut_command_targets_exe(tmp_path: Path) -> None:
+    command = shortcuts.windows_shortcut_command(tmp_path / "bin")
+
+    assert "WScript.Shell" in command
+    assert "pyControl GUI.lnk" in command
+    assert str(tmp_path / "bin" / "pycontrol-gui.exe") in command
+    assert "Write-Output $link" in command
+
+
+def test_linux_desktop_entry_written_under_home(tmp_path: Path) -> None:
+    bin_dir = tmp_path / "bin"
+    home = tmp_path / "home"
+
+    entry = shortcuts.create_linux_desktop_entry(bin_dir, home)
+
+    assert entry == home / ".local" / "share" / "applications" / "pycontrol-gui.desktop"
+    text = entry.read_text(encoding="utf-8")
+    assert "[Desktop Entry]" in text
+    assert f'Exec="{bin_dir / "pycontrol-gui"}"' in text
+    assert "Terminal=false" in text
+
+
+def test_create_shortcut_dispatches_by_platform(tmp_path: Path) -> None:
+    bin_dir = tmp_path / "bin"
+    home = tmp_path / "home"
+
+    assert shortcuts.create_shortcut(bin_dir, home, platform="darwin") == home / "Applications" / "pyControl GUI.app"
+    assert (
+        shortcuts.create_shortcut(bin_dir, home, platform="linux")
+        == home / ".local" / "share" / "applications" / "pycontrol-gui.desktop"
+    )
+    assert shortcuts.create_shortcut(bin_dir, home, platform="sunos") is None

pycontrol_install-0.1.0a1/uv.lock

@@ -0,0 +1,108 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pycontrol-install"
+version = "0.1.0a3"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=8" },
+    { name = "ruff", specifier = ">=0.5" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/84/0e/b5858858d74958632c49b72cb25a3976ff9f632397626715be71c89d3971/pytest-9.1.0.tar.gz", hash = "sha256:41dd9148c08072446394cefd3d79701701335a9f4cae69ba92e39f6c7f5c061c", size = 1634181, upload-time = "2026-06-13T18:52:45.983Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8b/5a/ba30a81239b909821b3153e303e7def45178bf353da4f72380e6c5e8793b/pytest-9.1.0-py3-none-any.whl", hash = "sha256:8ebb0e7888bdf2bdfc602ec51f8f62d50200af37356c74e503c79a94f5c81f32", size = 386453, upload-time = "2026-06-13T18:52:44.045Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.15.17"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/a9/3abdf488f1bf3d24c699415e454ed554a6350d5d89ce183be1ee0a3361ac/ruff-0.15.17.tar.gz", hash = "sha256:2ec446937fd16c8c4de2674a209cc5af64d9c6f17d21fbf1151054fa0bcf5219", size = 4743346, upload-time = "2026-06-11T17:54:47.663Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/4d/e11259f5da07cb6afb2d074c31bf09da9671993f7329d4f15d2fdc458301/ruff-0.15.17-py3-none-linux_armv6l.whl", hash = "sha256:d9feddb927fc68bd295f5eebc587a7e42cfaf9b65f60ca4a2386febff575da8f", size = 10856677, upload-time = "2026-06-11T17:54:49.533Z" },
+    { url = "https://files.pythonhosted.org/packages/29/3e/772d679e1a0dc058e58875bd2c0cb713a0530877b4a76fee3c7966df0d49/ruff-0.15.17-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:25805a226d741c47d274a35ad5c10a7dde175fcddfa511d7cf3da0a21eb3eab7", size = 11223443, upload-time = "2026-06-11T17:55:00.573Z" },
+    { url = "https://files.pythonhosted.org/packages/68/58/bd41f7688b2fd5623012605130ed70e60aa7f2244baa3d5066bdd61530c8/ruff-0.15.17-py3-none-macosx_11_0_arm64.whl", hash = "sha256:f6ad73b14c2d18a3bf8ad7cb6974294d7f613a7898604826058e6ac64918ef4d", size = 10566458, upload-time = "2026-06-11T17:55:07.52Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/5b/733371013fcf1ec339e477ece6ab42bfe10bdd9bba8ee88a9516aa56bfc0/ruff-0.15.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ba0c1e4f95bcb3869d0d30cbd5917071ef2e28665abfec970cdab0492c713ed", size = 10914483, upload-time = "2026-06-11T17:55:05.501Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cc/6f24251cc0252f7239391ccb85833f320efad14ebe5b443943f37ced6332/ruff-0.15.17-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:81647960f10bff57d2e51cadd0c3950fe598400c852863a038720ef5b8cca91e", size = 10647497, upload-time = "2026-06-11T17:54:57.733Z" },
+    { url = "https://files.pythonhosted.org/packages/68/dd/0d10c17ce1a1624d6fc3156309c3f834fdb5dfaad026ec90c85684f3990e/ruff-0.15.17-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e01a84ddbc8c16c23055ba3924476850f1bbc1917cebbb9376665a63e74260d", size = 11416967, upload-time = "2026-06-11T17:54:51.461Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/91/556bfb156f6144f355e831c23db00b2fc4120f86b3ce81cc5f7fd2df51f3/ruff-0.15.17-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:84fe9f653152f8f294f9f7e03bf3a453d8b4a27f7a59c78c8666167f2b17b96c", size = 12335770, upload-time = "2026-06-11T17:54:45.793Z" },
+    { url = "https://files.pythonhosted.org/packages/88/82/8b5999aa13355e926f06d9f42a32dcca862f623bf0363785ff89d607dffd/ruff-0.15.17-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c0fe88a7676e7a05b73174d4d4a59cb2ac21ff8263583f87a81a6018475a978", size = 11575441, upload-time = "2026-06-11T17:54:32.661Z" },
+    { url = "https://files.pythonhosted.org/packages/11/93/f10377bb04109ca0e8cbc483ff1982c54b6d418210041776f93e8cdc7fa9/ruff-0.15.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ecfc3c7878fff94633ab0348524e093f9ce3243080416dd7d14f8ba400174719", size = 11557614, upload-time = "2026-06-11T17:54:34.698Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/a6/eeeae7f7d5493df41649ab3db92f086b2d0a30199e4efdf8e3dd7a033f24/ruff-0.15.17-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:b8461180b22420b1bdc289909410930761629fddf2a5aaf60fae1ab26cedc4c4", size = 11544450, upload-time = "2026-06-11T17:54:39.042Z" },
+    { url = "https://files.pythonhosted.org/packages/32/88/5991ce565129a24dd4a00db1254b3b5db2e53018cbe4018ea5a89738e727/ruff-0.15.17-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:6eccbe50a038b503e7140b441aa9c7fc8c1f36edf23ebef9f4165c2f28f568b7", size = 10892524, upload-time = "2026-06-11T17:55:09.432Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/1d/0fdd248313425f55223968af04b0a42125466a8d88d21c1d99c6af0a51e8/ruff-0.15.17-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:382fc0521025f5a8ad447d8bdd523545d0d7646adb718eb1c2dac5065ec27c0f", size = 10659573, upload-time = "2026-06-11T17:54:36.824Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/0e/072e8260deb9461062ce9311ced27a8e541229a6ffd483013dd37661e43e/ruff-0.15.17-py3-none-musllinux_1_2_i686.whl", hash = "sha256:456d41fcd1b2777ad63f09a6e7121d43f7b688bbc76a800c10f7f8fb1f912c3f", size = 11127818, upload-time = "2026-06-11T17:55:03.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/b4/55060a34163121498014696b5f656db5b8c6963768f227dbf0d76b311073/ruff-0.15.17-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:b1a04bcc94ae6194e9db05d16ad31f298a7194bfbcb08258bbe589cee1d587b8", size = 11655901, upload-time = "2026-06-11T17:54:53.562Z" },
+    { url = "https://files.pythonhosted.org/packages/49/71/9b29d6b87cef468d697f43c6a91e3fae4a80185779d7d5a4ef27d173439f/ruff-0.15.17-py3-none-win32.whl", hash = "sha256:596065960ab1ff593f744220c9fe6580eda00a95003cffa9f4048bb5b1bf0392", size = 10925574, upload-time = "2026-06-11T17:54:55.723Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/b2/8fc77f3723228836fa5d12497eb71c808f83782e10d058d2b15cfa14640b/ruff-0.15.17-py3-none-win_amd64.whl", hash = "sha256:6769e5fa1710b179b92e0bfa5a51735b35baea9013dadb06d5f44cbcf9547084", size = 12058788, upload-time = "2026-06-11T17:54:41.042Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/c7/c53e8dbff9c9dc4b7928773421ae294a5d28fcb8dcda1a089579d3a7e510/ruff-0.15.17-py3-none-win_arm64.whl", hash = "sha256:f3be1fbb34bcdfd146240d8fb92a709d4c2c8191348580a3c044ec60fa0b4456", size = 11355275, upload-time = "2026-06-11T17:54:43.635Z" },
+]