freepod 0.1.1__tar.gz

freepod-0.1.1/.gitignore

@@ -0,0 +1,53 @@
+# Python
+__pycache__/**
+*.py[cod]
+*.pyc
+*.pyo
+*.pyd
+*.so
+*.egg-info/
+build/
+dist/
+.eggs/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+coverage.xml
+pytest.xml
+
+# Virtualenv
+.venv/
+venv/
+
+# Local env overrides (may contain secrets)
+.env
+.env.local
+
+# SQLite
+*.db
+*.sqlite3
+
+
+# IDE
+.idea/
+.vscode/
+
+# OS
+.DS_Store
+Thumbs.db
+
+var/
+
+# Playwright MCP artifacts
+.playwright-mcp/
+
+.claude/worktrees
+
+# OpenCode tooling artifacts
+.opencode/node_modules/
+.opencode/package-lock.json
+.opencode/bun.lock
+
+api/static/

freepod-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2026 Erik van Zijst <erik.van.zijst@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

freepod-0.1.1/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.5
+Name: freepod
+Version: 0.1.1
+Summary: Command-line client for Freepod — take a local project directory to a running deployment on freepod.eu.
+Project-URL: Homepage, https://freepod.eu
+Project-URL: Repository, https://github.com/erikvanzijst/freepod
+Project-URL: Issues, https://github.com/erikvanzijst/freepod/issues
+Author-email: Freepod <erik@freepod.eu>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,deployment,freepod,paas
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.24
+Requires-Dist: pathspec>=1.0
+Description-Content-Type: text/markdown
+
+# freepod
+
+Take a local project directory to a running deployment on
+[freepod.eu](https://freepod.eu).
+
+```bash
+pip install freepod
+```
+
+```bash
+cd myapp
+freepod login      # sign in through the browser
+freepod init       # choose a hostname for this project
+freepod deploy     # https://myapp.freepod.eu
+```
+
+`deploy` packs the working tree, uploads it, builds a container image on the
+platform and releases it. By the time the command returns, the app is live on
+its own hostname over HTTPS. Ship a new version by running it again.
+
+There is no Dockerfile to write and nothing to configure:
+[Railpack](https://railpack.com) detects the stack — Node, Python, Go, Java,
+PHP, Ruby, Rust and more — and builds an image from your source as it is.
+
+## What you need
+
+- **A Freepod account.** `freepod login` opens the sign-in page, which is also
+  where you can register.
+- **Python 3.9 or newer**, for the CLI itself. The project you deploy can be in
+  any language Railpack supports.
+- **An app that listens on `$PORT`.** The platform assigns the port and passes
+  it in the environment, so bind `0.0.0.0:$PORT` (`process.env.PORT`,
+  `os.environ["PORT"]`, …) rather than a fixed number. An app that picks its own
+  port receives no traffic.
+
+Deployments have no persistent disk. Whatever the app writes to its own
+filesystem is gone when it restarts, and at every release.
+
+## Commands
+
+| Command          | What it does                                                                             |
+|------------------|------------------------------------------------------------------------------------------|
+| `freepod login`  | Sign in, and remember the credential.                                                    |
+| `freepod init`   | Set the current directory up as a project: choose a hostname, write `.freepod.json`.     |
+| `freepod deploy` | Pack, build and release the current project.                                             |
+| `freepod whoami` | Report who you are signed in as.                                                         |
+| `freepod logout` | Forget the stored credential.                                                            |
+
+`freepod --help` and `freepod <command> --help` cover the flags.
+
+## Hostnames
+
+`init` asks for one. A bare name becomes a subdomain of the platform: `myapp` is
+served at `myapp.freepod.eu`. To use a domain of your own, point a CNAME at
+`freepod.eu` first, then give `init` the full name. Certificates are issued and
+renewed for you either way.
+
+## .freepod.json
+
+`init` writes it, and it is meant to be committed. It records the hostname you
+chose and which deployment this directory belongs to, so the next `deploy` —
+yours, a coworker's, or CI's — updates that same app instead of creating a
+second one. To change a value, edit the file; the next deploy applies it.
+
+## What gets uploaded
+
+The working tree, minus `.git/`, anything your `.gitignore` excludes, and the
+usual build output (`node_modules/`, `.venv/`, `__pycache__/`, `dist/`, …). A
+`.freepodignore` file — same syntax as `.gitignore`, and applied last — keeps
+out anything else the build does not need.
+
+Re-including a file follows git's rules, with one wrinkle worth knowing: the
+negation has to name the path (`!node_modules/patched.js`; a bare
+`!patched.js` does nothing), and nothing beneath a directory you excluded
+yourself can come back. Exclude `build/*` rather than `build/` if you need an
+exception.
+
+## Output
+
+The address is the only thing `deploy` writes to stdout. The build log, the
+progress bar and every status line go to stderr:
+
+```bash
+URL=$(freepod deploy)
+```
+
+---
+
+Deployments are listed and managed at [freepod.eu](https://freepod.eu). Source
+and issues: [github.com/erikvanzijst/freepod](https://github.com/erikvanzijst/freepod).

freepod-0.1.1/README.md

@@ -0,0 +1,90 @@
+# freepod
+
+Take a local project directory to a running deployment on
+[freepod.eu](https://freepod.eu).
+
+```bash
+pip install freepod
+```
+
+```bash
+cd myapp
+freepod login      # sign in through the browser
+freepod init       # choose a hostname for this project
+freepod deploy     # https://myapp.freepod.eu
+```
+
+`deploy` packs the working tree, uploads it, builds a container image on the
+platform and releases it. By the time the command returns, the app is live on
+its own hostname over HTTPS. Ship a new version by running it again.
+
+There is no Dockerfile to write and nothing to configure:
+[Railpack](https://railpack.com) detects the stack — Node, Python, Go, Java,
+PHP, Ruby, Rust and more — and builds an image from your source as it is.
+
+## What you need
+
+- **A Freepod account.** `freepod login` opens the sign-in page, which is also
+  where you can register.
+- **Python 3.9 or newer**, for the CLI itself. The project you deploy can be in
+  any language Railpack supports.
+- **An app that listens on `$PORT`.** The platform assigns the port and passes
+  it in the environment, so bind `0.0.0.0:$PORT` (`process.env.PORT`,
+  `os.environ["PORT"]`, …) rather than a fixed number. An app that picks its own
+  port receives no traffic.
+
+Deployments have no persistent disk. Whatever the app writes to its own
+filesystem is gone when it restarts, and at every release.
+
+## Commands
+
+| Command          | What it does                                                                             |
+|------------------|------------------------------------------------------------------------------------------|
+| `freepod login`  | Sign in, and remember the credential.                                                    |
+| `freepod init`   | Set the current directory up as a project: choose a hostname, write `.freepod.json`.     |
+| `freepod deploy` | Pack, build and release the current project.                                             |
+| `freepod whoami` | Report who you are signed in as.                                                         |
+| `freepod logout` | Forget the stored credential.                                                            |
+
+`freepod --help` and `freepod <command> --help` cover the flags.
+
+## Hostnames
+
+`init` asks for one. A bare name becomes a subdomain of the platform: `myapp` is
+served at `myapp.freepod.eu`. To use a domain of your own, point a CNAME at
+`freepod.eu` first, then give `init` the full name. Certificates are issued and
+renewed for you either way.
+
+## .freepod.json
+
+`init` writes it, and it is meant to be committed. It records the hostname you
+chose and which deployment this directory belongs to, so the next `deploy` —
+yours, a coworker's, or CI's — updates that same app instead of creating a
+second one. To change a value, edit the file; the next deploy applies it.
+
+## What gets uploaded
+
+The working tree, minus `.git/`, anything your `.gitignore` excludes, and the
+usual build output (`node_modules/`, `.venv/`, `__pycache__/`, `dist/`, …). A
+`.freepodignore` file — same syntax as `.gitignore`, and applied last — keeps
+out anything else the build does not need.
+
+Re-including a file follows git's rules, with one wrinkle worth knowing: the
+negation has to name the path (`!node_modules/patched.js`; a bare
+`!patched.js` does nothing), and nothing beneath a directory you excluded
+yourself can come back. Exclude `build/*` rather than `build/` if you need an
+exception.
+
+## Output
+
+The address is the only thing `deploy` writes to stdout. The build log, the
+progress bar and every status line go to stderr:
+
+```bash
+URL=$(freepod deploy)
+```
+
+---
+
+Deployments are listed and managed at [freepod.eu](https://freepod.eu). Source
+and issues: [github.com/erikvanzijst/freepod](https://github.com/erikvanzijst/freepod).

freepod-0.1.1/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+# A floor rather than an open range: 1.27 is the first release that understands
+# PEP 639, which the `license`/`license-files` fields below depend on.
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "freepod"
+dynamic = ["version"]
+description = "Command-line client for Freepod — take a local project directory to a running deployment on freepod.eu."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Freepod", email = "erik@freepod.eu" }]
+keywords = ["freepod", "deployment", "paas", "cli"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Build Tools",
+]
+
+dependencies = [
+  "click>=8.0",
+  "httpx>=0.24",
+  "pathspec>=1.0",
+]
+
+[project.urls]
+Homepage = "https://freepod.eu"
+Repository = "https://github.com/erikvanzijst/freepod"
+Issues = "https://github.com/erikvanzijst/freepod/issues"
+
+[project.scripts]
+freepod = "freepod.cli:main"
+
+[tool.hatch.version]
+path = "src/freepod/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/freepod"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/freepod", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+]

freepod-0.1.1/src/freepod/__init__.py

@@ -0,0 +1,86 @@
+"""freepod — the Freepod command-line client.
+
+The package is a pure client of the public Freepod REST API. It shares no code
+with the API server and imports nothing from it.
+
+This module holds only the error hierarchy, because every other module raises
+from it and a leaf module keeps the imports acyclic. Each error carries the
+exit code its class maps onto; see `cli-distribution` § *Exit codes
+distinguish failure classes*.
+"""
+
+from __future__ import annotations
+
+__all__ = [
+    "FreepodError",
+    "UsageError",
+    "AuthenticationError",
+    "PermissionError_",
+    "BuildFailed",
+    "RolloutFailed",
+    "EXIT_OK",
+    "EXIT_ERROR",
+    "EXIT_USAGE",
+    "EXIT_NOT_AUTHENTICATED",
+    "EXIT_BUILD_FAILED",
+    "EXIT_ROLLOUT_FAILED",
+]
+
+__version__ = "0.1.1"
+
+EXIT_OK = 0
+EXIT_ERROR = 1
+EXIT_USAGE = 2
+EXIT_NOT_AUTHENTICATED = 3
+EXIT_BUILD_FAILED = 4
+EXIT_ROLLOUT_FAILED = 5
+
+
+class FreepodError(Exception):
+    """Anything that should end the run with a readable message.
+
+    Subclasses override `exit_code` to select their row of the exit-code
+    table. The base class is the "unexpected error" row.
+    """
+
+    exit_code = EXIT_ERROR
+
+
+class UsageError(FreepodError):
+    """The command was invoked wrongly. Nothing was attempted."""
+
+    exit_code = EXIT_USAGE
+
+
+class AuthenticationError(FreepodError):
+    """No usable credential, or one the platform will not accept.
+
+    Raised for the 401 row of the status-code contract, where re-authenticating
+    would succeed and change nothing, as well as for the ordinary "you are not
+    logged in" case.
+    """
+
+    exit_code = EXIT_NOT_AUTHENTICATED
+
+
+class PermissionError_(FreepodError):
+    """Authenticated, but not permitted to act on the resource.
+
+    Named with a trailing underscore so it cannot shadow the builtin. This is
+    the API's own 403 — a credential problem no refresh can fix — and it is
+    deliberately *not* an `AuthenticationError`, so it never triggers a login.
+    """
+
+    exit_code = EXIT_ERROR
+
+
+class BuildFailed(FreepodError):
+    """The build reached a non-successful terminal status."""
+
+    exit_code = EXIT_BUILD_FAILED
+
+
+class RolloutFailed(FreepodError):
+    """The rollout failed, or waiting for it timed out."""
+
+    exit_code = EXIT_ROLLOUT_FAILED

freepod-0.1.1/src/freepod/__main__.py

@@ -0,0 +1,10 @@
+"""Support `python -m freepod` alongside the installed `freepod` script."""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())