shinyhub 0.2.4__tar.gz

shinyhub-0.2.4/.gitignore

@@ -0,0 +1,23 @@
+.superpowers/
+docs/superpowers/
+go.work
+go.work.sum
+bin/
+tmp/
+.worktrees/
+CLAUDE.md
+CLAUDE.local.md
+
+# Runtime artifacts created when running the server from a checkout
+# (default config writes the SQLite DB and per-app data under ./data).
+/data/
+*.db
+*.db-shm
+*.db-wal
+
+# PyPI wheel build artifacts
+/packaging/python/src/shinyhub/_binary/shinyhub
+/packaging/python/dist/
+/packaging/python/build/
+/packaging/python/src/shinyhub.egg-info/
+/packaging/python/__pycache__/

shinyhub-0.2.4/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: shinyhub
+Version: 0.2.4
+Summary: Self-hosted platform for deploying and managing Shiny apps.
+Project-URL: Homepage, https://github.com/rvben/shinyhub
+Project-URL: Repository, https://github.com/rvben/shinyhub
+Project-URL: Issues, https://github.com/rvben/shinyhub/issues
+Author-email: "Ruben J. Jongejan" <ruben.jongejan@gmail.com>
+License-Expression: MIT
+Keywords: deployment,posit,shiny,shinyhub
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# shinyhub
+
+Python distribution of the [ShinyHub](https://github.com/rvben/shinyhub) CLI.
+
+ShinyHub is a self-hosted platform for deploying and managing Shiny apps
+(Python or R). This package bundles the `shinyhub` Go binary so Python
+users can install it with `pip` or `uv`:
+
+```bash
+uv tool install shinyhub
+# or:
+pip install shinyhub
+```
+
+## Usage
+
+```bash
+shinyhub --help                       # list subcommands
+shinyhub serve                        # run the server
+shinyhub login --host https://...     # authenticate against a server
+shinyhub deploy ./my-app --slug demo  # deploy an app
+```
+
+See [the project README](https://github.com/rvben/shinyhub) for full
+documentation, server configuration, and Docker usage.
+
+## Supported platforms
+
+Prebuilt binaries ship for:
+
+- Linux (amd64, arm64)
+- macOS (amd64, arm64)
+
+For other platforms, use the Docker image
+(`ghcr.io/rvben/shinyhub:latest`) or
+[build from source](https://github.com/rvben/shinyhub#from-source).

shinyhub-0.2.4/README.md

@@ -0,0 +1,36 @@
+# shinyhub
+
+Python distribution of the [ShinyHub](https://github.com/rvben/shinyhub) CLI.
+
+ShinyHub is a self-hosted platform for deploying and managing Shiny apps
+(Python or R). This package bundles the `shinyhub` Go binary so Python
+users can install it with `pip` or `uv`:
+
+```bash
+uv tool install shinyhub
+# or:
+pip install shinyhub
+```
+
+## Usage
+
+```bash
+shinyhub --help                       # list subcommands
+shinyhub serve                        # run the server
+shinyhub login --host https://...     # authenticate against a server
+shinyhub deploy ./my-app --slug demo  # deploy an app
+```
+
+See [the project README](https://github.com/rvben/shinyhub) for full
+documentation, server configuration, and Docker usage.
+
+## Supported platforms
+
+Prebuilt binaries ship for:
+
+- Linux (amd64, arm64)
+- macOS (amd64, arm64)
+
+For other platforms, use the Docker image
+(`ghcr.io/rvben/shinyhub:latest`) or
+[build from source](https://github.com/rvben/shinyhub#from-source).

shinyhub-0.2.4/hatch_build.py

@@ -0,0 +1,68 @@
+"""Hatchling hooks for the shinyhub wheel.
+
+CI exports two env vars before invoking ``python -m build``:
+
+* ``SHINYHUB_WHEEL_VERSION`` — the Git tag without the leading ``v``
+  (e.g. ``0.3.0``). ``VersionHook`` writes it into the project metadata.
+* ``SHINYHUB_WHEEL_PLATFORM`` — the wheel platform tag for this matrix
+  entry (e.g. ``manylinux_2_17_x86_64``). ``PlatformTagHook`` writes it
+  into the wheel's build-data.
+
+Local sanity builds without either env var get sensible defaults so the
+build does not blow up; those wheels are only ever used for smoke tests.
+
+When pip falls back to building a wheel from the sdist (because no
+matching binary wheel exists for the user's platform), ``PlatformTagHook``
+raises a ``RuntimeError`` with a clear explanation — see the
+binary-existence check in ``initialize``.
+"""
+import os
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+from hatchling.metadata.plugin.interface import MetadataHookInterface
+
+
+UNSUPPORTED_PLATFORM_MESSAGE = """\
+shinyhub does not ship a prebuilt binary for your platform.
+Supported: linux/amd64, linux/arm64, darwin/amd64, darwin/arm64.
+
+For other platforms:
+  - Use the Docker image: ghcr.io/rvben/shinyhub:latest
+  - Or build from source: https://github.com/rvben/shinyhub#from-source
+"""
+
+
+class VersionHook(MetadataHookInterface):
+    """Sources the package version from SHINYHUB_WHEEL_VERSION."""
+
+    PLUGIN_NAME = "custom"
+
+    def update(self, metadata: dict) -> None:
+        metadata["version"] = os.environ.get(
+            "SHINYHUB_WHEEL_VERSION", "0.0.0+local"
+        )
+
+
+class PlatformTagHook(BuildHookInterface):
+    """Includes the Go binary and sets the wheel's platform tag.
+
+    Runs for the wheel target only; sdist builds skip this hook, so
+    publishing an sdist does not require the binary to be present.
+    """
+
+    PLUGIN_NAME = "custom"
+
+    def initialize(self, version: str, build_data: dict) -> None:
+        binary = os.path.join(self.root, "src", "shinyhub", "_binary", "shinyhub")
+        if not os.path.isfile(binary):
+            raise RuntimeError(UNSUPPORTED_PLATFORM_MESSAGE)
+
+        build_data["force_include"][binary] = "shinyhub/_binary/shinyhub"
+
+        platform = os.environ.get("SHINYHUB_WHEEL_PLATFORM")
+        if not platform:
+            # Local sanity builds: let hatchling assign a default. CI always
+            # sets this, so the production path never hits this branch.
+            return
+        build_data["tag"] = f"py3-none-{platform}"
+        build_data["pure_python"] = False

shinyhub-0.2.4/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "shinyhub"
+dynamic = ["version"]
+description = "Self-hosted platform for deploying and managing Shiny apps."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  { name = "Ruben J. Jongejan", email = "ruben.jongejan@gmail.com" },
+]
+keywords = ["shiny", "shinyhub", "deployment", "posit"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+
+[project.urls]
+Homepage   = "https://github.com/rvben/shinyhub"
+Repository = "https://github.com/rvben/shinyhub"
+Issues     = "https://github.com/rvben/shinyhub/issues"
+
+[project.scripts]
+shinyhub = "shinyhub.__main__:main"
+
+# Metadata hook computes the dynamic version from SHINYHUB_WHEEL_VERSION.
+[tool.hatch.metadata.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/shinyhub"]
+
+# Build hook owns binary inclusion + platform tag. It raises when the
+# binary is absent, which is what pip sees when falling back to sdist
+# on an unsupported platform.
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/shinyhub",
+  "pyproject.toml",
+  "hatch_build.py",
+  "README.md",
+]
+# The binary is wheel-only. Keeping it out of the sdist is what makes
+# the sdist a usable stub: pip falls back to building a wheel from it
+# on unsupported platforms, the wheel build detects the missing binary,
+# and the build fails with a clear error.
+exclude = [
+  "src/shinyhub/_binary/shinyhub",
+]

shinyhub-0.2.4/src/shinyhub/__init__.py

@@ -0,0 +1,14 @@
+"""ShinyHub — deploy and manage Shiny apps.
+
+This Python package is a distribution vehicle for the ``shinyhub`` CLI.
+It does not expose a stable Python API; use the ``shinyhub`` command.
+"""
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+try:
+    __version__ = _pkg_version("shinyhub")
+except PackageNotFoundError:
+    __version__ = "0.0.0+unknown"
+
+__all__ = ["__version__"]

shinyhub-0.2.4/src/shinyhub/__main__.py

@@ -0,0 +1,27 @@
+"""Entry point for the ``shinyhub`` console script.
+
+We locate the embedded Go binary inside the installed package data and
+``os.execv`` to replace this Python process with it. Process replacement
+(rather than ``subprocess.run``) preserves signal handling, exit codes,
+stdio, and $0, so ``shinyhub`` behaves indistinguishably from the native
+binary for every caller.
+"""
+import os
+import sys
+from importlib.resources import files
+
+
+def main() -> None:
+    binary = files("shinyhub") / "_binary" / "shinyhub"
+    if not binary.is_file():
+        sys.stderr.write(
+            "shinyhub: embedded binary not found at "
+            f"{binary}. This wheel is broken; please report it at "
+            "https://github.com/rvben/shinyhub/issues.\n"
+        )
+        sys.exit(1)
+    os.execv(str(binary), ["shinyhub", *sys.argv[1:]])
+
+
+if __name__ == "__main__":
+    main()