pythonanywhere-briefcase-plugin 0.0.1a3__tar.gz

pythonanywhere_briefcase_plugin-0.0.1a3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PythonAnywhere
+
+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.

pythonanywhere_briefcase_plugin-0.0.1a3/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: pythonanywhere-briefcase-plugin
+Version: 0.0.1a3
+Summary: A Briefcase publication channel plugin for deploying static web apps to PythonAnywhere.
+Keywords: briefcase,pythonanywhere,deployment,web,static
+Author: Filip Lajszczak
+Author-email: Filip Lajszczak <filip@lajszczak.dev>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Requires-Dist: pythonanywhere-core>=0.3.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# pythonanywhere-briefcase-plugin
+
+A [Briefcase](https://briefcase.readthedocs.io/) publication channel plugin for deploying static web apps to [PythonAnywhere](https://www.pythonanywhere.com/).
+
+> **Note:** This package depends on the publication channels feature in Briefcase, which has not been included in a release yet. Until it is released, install Briefcase from main:
+> ```
+> pip install git+https://github.com/beeware/briefcase@main
+> ```
+
+## Prerequisites
+
+* A PythonAnywhere account
+* An API token (from your [Account page](https://www.pythonanywhere.com/account/#api_token))
+
+## Installation
+
+```console
+$ pip install pythonanywhere-briefcase-plugin
+```
+
+## Quick start
+
+Build and package your web app:
+
+```console
+$ briefcase create web static
+$ briefcase build web static
+$ briefcase package web static
+```
+
+Set your PythonAnywhere API token:
+
+```console
+$ export API_TOKEN=your-api-token-here
+```
+
+Publish:
+
+```console
+$ briefcase publish web static
+```
+
+Your app will be deployed to `https://<username>.pythonanywhere.com/`.
+
+## Documentation
+
+Full documentation is available at [https://briefcase.pythonanywhere.com/](https://briefcase.pythonanywhere.com/).
+
+## Contributing
+
+Development requires [uv](https://docs.astral.sh/uv/getting-started/installation/).
+
+```console
+$ git clone https://github.com/pythonanywhere/pythonanywhere-briefcase-plugin.git
+$ cd pythonanywhere-briefcase-plugin
+$ uv sync
+$ uvx pre-commit install
+$ uv run pytest
+```
+
+## License
+
+MIT license.

pythonanywhere_briefcase_plugin-0.0.1a3/README.md

@@ -0,0 +1,63 @@
+# pythonanywhere-briefcase-plugin
+
+A [Briefcase](https://briefcase.readthedocs.io/) publication channel plugin for deploying static web apps to [PythonAnywhere](https://www.pythonanywhere.com/).
+
+> **Note:** This package depends on the publication channels feature in Briefcase, which has not been included in a release yet. Until it is released, install Briefcase from main:
+> ```
+> pip install git+https://github.com/beeware/briefcase@main
+> ```
+
+## Prerequisites
+
+* A PythonAnywhere account
+* An API token (from your [Account page](https://www.pythonanywhere.com/account/#api_token))
+
+## Installation
+
+```console
+$ pip install pythonanywhere-briefcase-plugin
+```
+
+## Quick start
+
+Build and package your web app:
+
+```console
+$ briefcase create web static
+$ briefcase build web static
+$ briefcase package web static
+```
+
+Set your PythonAnywhere API token:
+
+```console
+$ export API_TOKEN=your-api-token-here
+```
+
+Publish:
+
+```console
+$ briefcase publish web static
+```
+
+Your app will be deployed to `https://<username>.pythonanywhere.com/`.
+
+## Documentation
+
+Full documentation is available at [https://briefcase.pythonanywhere.com/](https://briefcase.pythonanywhere.com/).
+
+## Contributing
+
+Development requires [uv](https://docs.astral.sh/uv/getting-started/installation/).
+
+```console
+$ git clone https://github.com/pythonanywhere/pythonanywhere-briefcase-plugin.git
+$ cd pythonanywhere-briefcase-plugin
+$ uv sync
+$ uvx pre-commit install
+$ uv run pytest
+```
+
+## License
+
+MIT license.

pythonanywhere_briefcase_plugin-0.0.1a3/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "pythonanywhere-briefcase-plugin"
+version = "0.0.1a3"
+description = "A Briefcase publication channel plugin for deploying static web apps to PythonAnywhere."
+requires-python = ">= 3.10"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    {name = "Filip Lajszczak", email = "filip@lajszczak.dev"},
+]
+keywords = ["briefcase", "pythonanywhere", "deployment", "web", "static"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+]
+dependencies = [
+    "pythonanywhere-core >= 0.3.0",
+]
+
+[build-system]
+requires = ["uv_build >= 0.7.2, < 0.8"]
+build-backend = "uv_build"
+
+[dependency-groups]
+test = [
+    "pytest >= 9.0",
+    "pytest-cov >= 7.0",
+    "pytest-mock >= 3.10",
+    "responses >= 0.25",
+]
+dev = [
+    {include-group = "test"},
+    "briefcase @ git+https://github.com/beeware/briefcase@fca2cab707794f169b61fe2641d31af262bc5566",
+    "ruff >= 0.11",
+]
+
+[project.entry-points."briefcase.channels.web.static"]
+pythonanywhere = "pythonanywhere_briefcase_plugin:PythonAnywherePublicationChannel"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff.lint]
+extend-select = [
+    "E", "W", "F", "UP", "B", "I", "RUF",
+]
+
+[tool.coverage.run]
+branch = true
+source_pkgs = ["pythonanywhere_briefcase_plugin"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

pythonanywhere_briefcase_plugin-0.0.1a3/src/pythonanywhere_briefcase_plugin/__init__.py

@@ -0,0 +1,4 @@
+from pythonanywhere_briefcase_plugin.channel import PythonAnywherePublicationChannel
+
+__version__ = "0.0.1a3"
+__all__ = ["PythonAnywherePublicationChannel"]

pythonanywhere_briefcase_plugin-0.0.1a3/src/pythonanywhere_briefcase_plugin/channel.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import os
+import tempfile
+from pathlib import Path
+from typing import TYPE_CHECKING
+from zipfile import ZipFile
+
+from briefcase.channels.base import BasePublicationChannel
+from briefcase.exceptions import BriefcaseCommandError
+from pythonanywhere_core.base import get_username
+from pythonanywhere_core.exceptions import (
+    AuthenticationError,
+    NoTokenError,
+    PythonAnywhereApiException,
+)
+from pythonanywhere_core.files import Files
+from pythonanywhere_core.webapp import Webapp
+
+import pythonanywhere_briefcase_plugin
+
+if TYPE_CHECKING:
+    from briefcase.channels.base import PublishCommandAPI
+    from briefcase.config import AppConfig
+
+
+class PythonAnywherePublicationChannel(BasePublicationChannel):
+    @property
+    def name(self) -> str:
+        return "pythonanywhere"
+
+    def _resolve_username(self, app: AppConfig) -> str:
+        username = getattr(app, "pythonanywhere_username", None)
+        if username:
+            return username
+
+        return get_username()
+
+    def _resolve_domain(self, app: AppConfig) -> str:
+        domain = getattr(app, "pythonanywhere_domain", None)
+        if domain:
+            return domain
+
+        username = self._resolve_username(app)
+        return f"{username}.pythonanywhere.com"
+
+    def publish_app(self, app: AppConfig, command: PublishCommandAPI, **options):
+        dist_path = command.distribution_path(app)
+        if not dist_path.exists():
+            raise BriefcaseCommandError(
+                f"Distribution artifact not found: {dist_path}\n\n"
+                "Run 'briefcase package web static' first."
+            )
+
+        os.environ["PYTHONANYWHERE_CLIENT"] = (
+            f"pythonanywhere-briefcase-plugin/{pythonanywhere_briefcase_plugin.__version__}"
+        )
+
+        username = self._resolve_username(app)
+        domain = self._resolve_domain(app)
+        remote_path = f"/home/{username}/{app.app_name}"
+
+        try:
+            with tempfile.TemporaryDirectory() as tmpdir:
+                with ZipFile(dist_path) as zf:
+                    zf.extractall(tmpdir)
+                Files().tree_post(tmpdir, remote_path)
+
+            webapp = Webapp(domain)
+            try:
+                webapp.get()
+            except PythonAnywhereApiException:
+                webapp.create(
+                    python_version="3.13",
+                    virtualenv_path=None,
+                    project_path=Path(remote_path),
+                    nuke=False,
+                )
+
+            webapp.create_static_file_mapping("/", Path(remote_path))
+            webapp.reload()
+        except NoTokenError as e:
+            raise BriefcaseCommandError(
+                "PythonAnywhere API token not found.\n\n"
+                "Set the API_TOKEN environment variable with "
+                "your token from\n"
+                "https://www.pythonanywhere.com/account/#api_token"
+            ) from e
+        except AuthenticationError as e:
+            raise BriefcaseCommandError(
+                "PythonAnywhere API authentication failed.\n\n"
+                "Check that your API_TOKEN environment variable "
+                "contains a valid token."
+            ) from e
+        except PythonAnywhereApiException as e:
+            raise BriefcaseCommandError(f"PythonAnywhere API error: {e}") from e