pythonanywhere-clis 1.0.0__py3-none-any.whl

pa_cli/crawler/console_crawler.py

@@ -0,0 +1,141 @@
+import re
+
+import requests
+import websocket
+from bs4 import BeautifulSoup
+
+from pa_cli.exceptions import APIError, AuthError, NetworkError
+
+
+class ConsoleCrawler:
+    def __init__(self, host: str = "www.pythonanywhere.com"):
+        self.base_url = f"https://{host}"
+        self.session = requests.Session()
+        self.session.headers.update({
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+        })
+
+    def login(self, username: str, password: str) -> bool:
+        login_url = f"{self.base_url}/login/"
+
+        try:
+            login_page_resp = self.session.get(login_url)
+            login_page_resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Failed to fetch login page: {e}") from e
+
+        soup = BeautifulSoup(login_page_resp.text, "html.parser")
+        csrf_input = soup.find("input", {"name": "csrfmiddlewaretoken"})
+        if csrf_input is None:
+            raise APIError("CSRF token not found on login page")
+
+        data = {
+            "csrfmiddlewaretoken": csrf_input["value"],
+            "auth-username": username,
+            "auth-password": password,
+            "login_view-current_step": "auth",
+        }
+
+        headers = {
+            "Referer": login_url,
+            "Origin": self.base_url,
+        }
+
+        try:
+            login_resp = self.session.post(login_url, data=data, headers=headers)
+            login_resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Login request failed: {e}") from e
+
+        if "/login/" in login_resp.url:
+            raise AuthError("Login failed. Check your username and password.")
+
+        return True
+
+    def list(self, username: str) -> list:
+        url = f"{self.base_url}/api/v0/user/{username}/consoles/"
+
+        try:
+            resp = self.session.get(url)
+            resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Failed to list consoles: {e}") from e
+
+        return resp.json()
+
+    def create(self, username: str, executable: str = "bash") -> dict:
+        csrftoken = self.session.cookies.get("csrftoken")
+        if not csrftoken:
+            raise APIError("CSRF token not found in session cookies")
+
+        url = f"{self.base_url}/api/v0/user/{username}/consoles/"
+        headers = {
+            "Referer": f"{self.base_url}/user/{username}/consoles/",
+            "X-CSRFToken": csrftoken,
+        }
+
+        try:
+            resp = self.session.post(url, json={"executable": executable}, headers=headers)
+            resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Failed to create console: {e}") from e
+
+        return resp.json()
+
+    def delete(self, username: str, console_id: int) -> None:
+        csrftoken = self.session.cookies.get("csrftoken")
+        if not csrftoken:
+            raise APIError("CSRF token not found in session cookies")
+
+        url = f"{self.base_url}/api/v0/user/{username}/consoles/{console_id}/"
+        headers = {
+            "Referer": f"{self.base_url}/user/{username}/consoles/",
+            "X-CSRFToken": csrftoken,
+        }
+
+        try:
+            resp = self.session.delete(url, headers=headers)
+            resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Failed to delete console: {e}") from e
+
+    def get_or_create(self, username: str, executable: str = "bash") -> int:
+        consoles = self.list(username)
+
+        if len(consoles) >= 2:
+            self.delete(username, consoles[0]["id"])
+            consoles = []
+
+        if consoles:
+            return consoles[0]["id"]
+
+        new_console = self.create(username, executable=executable)
+        return new_console["id"]
+
+    def activate(self, username: str, console_id: int) -> None:
+        frame_url = f"{self.base_url}/user/{username}/consoles/{console_id}/frame/"
+
+        try:
+            resp = self.session.get(frame_url)
+            resp.raise_for_status()
+        except requests.RequestException as e:
+            raise NetworkError(f"Failed to fetch console frame page: {e}") from e
+
+        match = re.search(r'LoadConsole\("([^"]+)",\s*"([^"]+)",\s*"([^"]+)"', resp.text)
+        if not match:
+            raise APIError("Could not parse WebSocket info from frame page")
+
+        console_server = match.group(1)
+        session_key = match.group(2)
+        parsed_console_id = match.group(3)
+
+        ws = None
+        try:
+            ws = websocket.create_connection(f"wss://{console_server}/sj/websocket")
+            ws.send(f"\x1b[{session_key};{parsed_console_id};;a")
+            ws.send("\x1b[8;24;80t")
+        except Exception as e:
+            raise NetworkError(f"WebSocket connection failed: {e}") from e
+        finally:
+            if ws:
+                ws.close()

pa_cli/exceptions.py

@@ -0,0 +1,18 @@
+class PACliError(Exception):
+    """Base exception for all pa-cli errors."""
+
+
+class AuthError(PACliError):
+    """Authentication failed (login, token, password)."""
+
+
+class APIError(PACliError):
+    """PythonAnywhere API returned an error."""
+
+
+class NotFoundError(APIError):
+    """Requested resource does not exist (404)."""
+
+
+class NetworkError(PACliError):
+    """Network connection failed."""

pa_cli/workflows/deploy.py

@@ -0,0 +1,215 @@
+import time
+from pathlib import Path
+
+import typer
+from rich.progress import Progress, SpinnerColumn, BarColumn, TextColumn, TimeRemainingColumn
+
+from pa_cli.api.files import FilesClient
+from pa_cli.api.consoles import ConsolesClient
+from pa_cli.api.webapps import WebappsClient
+from pa_cli.exceptions import PACliError
+
+POLL_INTERVAL = 2  # seconds between output checks
+MAX_WAIT = 300  # max seconds to wait for a command
+
+
+def _wait_for_console(client: ConsolesClient, username: str, console_id: int) -> str:
+    """Poll console output until the prompt returns or timeout."""
+    elapsed = 0
+    last_output = ""
+    while elapsed < MAX_WAIT:
+        time.sleep(POLL_INTERVAL)
+        elapsed += POLL_INTERVAL
+        result = client.get_output(username, console_id)
+        output = result.get("output", "")
+        if output != last_output:
+            last_output = output
+            # PythonAnywhere bash prompt patterns:
+            # - "username@host:~$ " (standard)
+            # - "$ " (simple)
+            # - ">>> " (Python REPL)
+            stripped = output.rstrip()
+            if (stripped.endswith("$") or
+                stripped.endswith(">>>") or
+                stripped.endswith("]$") or
+                stripped.endswith("#")):
+                break
+    return last_output
+
+
+def collect_files(local_dir: str) -> list:
+    """Collect all files in directory recursively."""
+    local_path = Path(local_dir)
+    return [f for f in local_path.rglob("*") if f.is_file()]
+
+
+def deploy_preview(account: dict, local_dir: str, domain: str, python_version: str) -> None:
+    """Print deploy preview without executing any operations."""
+    local_path = Path(local_dir)
+    username = account["username"]
+    remote_base = f"/home/{username}/{local_path.name}"
+
+    typer.echo("=== 部署预览 (dry-run) ===\n")
+
+    # Step 1: File list
+    typer.echo("📁 Step 1: 将要上传的文件")
+    files = collect_files(local_dir)
+    max_display = 20
+    for f in files[:max_display]:
+        size = f.stat().st_size
+        typer.echo(f"  - {f.relative_to(local_path)} ({size} bytes)")
+    if len(files) > max_display:
+        typer.echo(f"  ... 还有 {len(files) - max_display} 个文件")
+    typer.echo(f"  共 {len(files)} 个文件\n")
+
+    # Step 2: Environment setup
+    typer.echo("📦 Step 2: 环境配置")
+    typer.echo("  - 创建 bash console")
+    typer.echo(f"  - cd {remote_base}")
+    if (local_path / "requirements.txt").exists():
+        typer.echo(f"  - mkvirtualenv {local_path.name} --python=/usr/bin/{python_version}")
+        typer.echo(f"  - workon {local_path.name} && pip install -r requirements.txt")
+    typer.echo()
+
+    # Step 3: Webapp configuration
+    typer.echo("⚙️ Step 3: Webapp 配置")
+    typer.echo(f"  - 创建/更新 webapp: {domain}")
+    typer.echo(f"  - 源码目录: {remote_base}")
+    typer.echo()
+
+    # Step 4: Static file mapping
+    if (local_path / "static").exists():
+        typer.echo("📂 Step 4: 静态文件映射")
+        typer.echo(f"  - /static/ -> {remote_base}/static")
+        typer.echo()
+    else:
+        typer.echo("📂 Step 4: 无 static 目录，跳过\n")
+
+    # Step 5: Reload
+    typer.echo("🔄 Step 5: Reload webapp\n")
+
+    typer.echo("以上为预览，使用不带 --dry-run 的命令执行：")
+    typer.echo(f"  pa deploy {local_dir}")
+
+
+def deploy(
+    local_dir: str,
+    username: str,
+    token: str,
+    host: str,
+    domain: str,
+    python_version: str = "python310",
+    dry_run: bool = False,
+) -> str:
+    local_path = Path(local_dir)
+    if not local_path.is_dir():
+        raise PACliError(f"{local_dir} is not a directory")
+
+    if dry_run:
+        account = {"username": username}
+        deploy_preview(account, local_dir, domain, python_version)
+        return ""
+
+    remote_base = f"/home/{username}/{local_path.name}"
+    files_client = FilesClient(token=token, host=host)
+    consoles_client = ConsolesClient(token=token, host=host)
+    webapps_client = WebappsClient(token=token, host=host)
+
+    # Step 1: Upload files with progress bar
+    print(f"[1/5] Uploading {local_dir} to {remote_base}...")
+    try:
+        files = collect_files(local_dir)
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+            TextColumn("({task.completed}/{task.total})"),
+            TimeRemainingColumn(),
+        ) as progress:
+            task = progress.add_task("Uploading files...", total=len(files))
+            for file in files:
+                relative = file.relative_to(local_path)
+                remote = f"{remote_base}/{relative}".replace("\\", "/")
+                content = file.read_bytes()
+                files_client.upload(username, remote, content)
+                progress.advance(task)
+        print(f"  ✓ Uploaded {len(files)} files.")
+    except Exception as e:
+        print(f"  ✗ Upload failed: {e}")
+        print(f"  Hint: Retry with `pa deploy {local_dir} {domain}`")
+        raise
+
+    # Step 2: Setup environment via console
+    print(f"[2/5] Setting up environment...")
+    try:
+        console = consoles_client.create(username)
+        console_id = console["id"]
+
+        commands = [f"cd {remote_base}"]
+        if (local_path / "requirements.txt").exists():
+            commands.extend([
+                f"mkvirtualenv {local_path.name} --python=/usr/bin/{python_version}",
+                f"workon {local_path.name} && pip install -r requirements.txt",
+            ])
+
+        for cmd in commands:
+            consoles_client.send_input(username, console_id, cmd + "\n")
+            _wait_for_console(consoles_client, username, console_id)
+        print(f"  ✓ Environment configured.")
+    except Exception as e:
+        print(f"  ✗ Environment setup failed: {e}")
+        print(f"  Hint: Check requirements.txt and retry.")
+        raise
+
+    # Step 3: Create and configure webapp
+    print(f"[3/5] Configuring webapp {domain}...")
+    try:
+        webapps_client.create(username, domain, python_version)
+    except Exception as e:
+        if "already exists" not in str(e).lower():
+            print(f"  ✗ Webapp creation failed: {e}")
+            raise
+
+    try:
+        webapps_client.update(
+            username,
+            domain,
+            source_directory=remote_base,
+        )
+        print(f"  ✓ Webapp configured.")
+    except Exception as e:
+        print(f"  ✗ Webapp configuration failed: {e}")
+        raise
+
+    # Step 4: Add static file mapping if static dir exists
+    static_local = local_path / "static"
+    if static_local.exists():
+        print(f"[4/5] Adding static file mapping...")
+        try:
+            webapps_client.add_static_file(
+                username,
+                domain,
+                url="/static/",
+                path=f"{remote_base}/static",
+            )
+            print(f"  ✓ Static files mapped.")
+        except Exception as e:
+            print(f"  ✗ Static file mapping failed: {e}")
+            raise
+    else:
+        print(f"[4/5] No static directory, skipping.")
+
+    # Step 5: Reload
+    print(f"[5/5] Reloading webapp...")
+    try:
+        webapps_client.reload(username, domain)
+        print(f"  ✓ Webapp reloaded.")
+    except Exception as e:
+        print(f"  ✗ Reload failed: {e}")
+        print(f"  Hint: Run `pa webapp reload {domain}` manually.")
+        raise
+
+    url = f"https://{domain}"
+    print(f"\nDeploy complete: {url}")
+    return url

pythonanywhere_clis-1.0.0.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: pythonanywhere-clis
+Version: 1.0.0
+Summary: CLI tool for automating PythonAnywhere deployments
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: websocket-client>=1.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10; extra == "dev"
+Dynamic: license-file

pythonanywhere_clis-1.0.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+pa_cli/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+pa_cli/config.py,sha256=lspnQqOiy2IQvt3TbluBAFO1TMd_Pd-eVQp5yv_QPKo,9101
+pa_cli/exceptions.py,sha256=8iCO-E0CmMFLPoc8DD42Q_pBwydMr9UTvdZu0v31atI,399
+pa_cli/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pa_cli/api/always_on.py,sha256=VdZH2fL6xoPm0oW9ZZhPqQ58WEALQz7s4GnMxg9jN54,854
+pa_cli/api/client.py,sha256=2a9HhIEGo2km18Z1ZJ7e8cI8jOOIUrG2cLwUNmt3eGA,1693
+pa_cli/api/consoles.py,sha256=Jlc7ESH-323Jc6U8AzQrtZCzkawxL69YX65nbPyB-Kc,1405
+pa_cli/api/files.py,sha256=QgROylqN0JCMDmms9Vo9skPQ8tH13VepnEvSOvQbRPI,3731
+pa_cli/api/system.py,sha256=jPtVim9yI9HDkW-p8Mp5iw5nvjERWHNv9dxbSk6XZ54,284
+pa_cli/api/tasks.py,sha256=xqbD7pAIJZIoChvFJ5cu3D7FhV60mtNib1pnAo_PdwI,1735
+pa_cli/api/webapps.py,sha256=BqTvWEd4vqGa-nJcLEqOOlspsq6a_mO52eOgn8jqH84,2347
+pa_cli/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pa_cli/cli/account_cmd.py,sha256=sQ6tDOQQdEYFVv3X96XMLSI8IGgo1g5VV3HRdONr4Bg,4399
+pa_cli/cli/always_on_cmd.py,sha256=vXVIUYIU1-GDGZGaIfNxFaxqnsZnXEftgnfwA4Z87ls,3034
+pa_cli/cli/consoles_cmd.py,sha256=iVM8A3eWA3TB5CqAoz2CxDTiNMndFfLCnORC0gy3IAs,5295
+pa_cli/cli/deploy_cmd.py,sha256=HmEW9puQYyo0qQLycaSiCpY7EOvKh2ZaJrrSXRsY9lY,1601
+pa_cli/cli/files_cmd.py,sha256=Pw69uT1p308AbMPtkh74TVAWh92TV6XsqAm3Th3pK5I,10762
+pa_cli/cli/init_cmd.py,sha256=dF10pgI-JY0iViZMQPix9iBtWYZbn1Et_-UEsj-huj4,2415
+pa_cli/cli/main.py,sha256=pZI3z17gy4jDnjXDn0AdIe1vFgnCXQKorWZcdvaYD1E,2451
+pa_cli/cli/register_cmd.py,sha256=NgUptosvelNLpip74zBqsbBw1ZNmoXV8qWiY47n0dvU,1173
+pa_cli/cli/status_cmd.py,sha256=Aq4B_GGcHCbLLkZpNp-1FjbHOWmnLYLNyvJY7kXBQLk,2067
+pa_cli/cli/tasks_cmd.py,sha256=xhnHokyFQExYuhSAy78nMm0qioAQsvfLpPeGUdf27W4,4966
+pa_cli/cli/utils.py,sha256=2YhPeBLG-I7YAjfS-GObw8_Ya5q5DrXxCFIgDMTZUm4,788
+pa_cli/cli/webapps_cmd.py,sha256=s4UZd9Nvot1We3q4pn-oHKcc2bXU2kWWFCFlwBY-has,10044
+pa_cli/crawler/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pa_cli/crawler/account_crawler.py,sha256=dckmsaDahu_Qku3tMS-1kRai07P4enD2P9YJT8nnjzU,14612
+pa_cli/crawler/console_crawler.py,sha256=Kkf8zwjPADkhOAgP41ZzqD0ynqCYB2yyhWi-75DABVg,4928
+pa_cli/workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pa_cli/workflows/deploy.py,sha256=eyL-kj9Vu850_zYu9jKd-V7o5uh-Q2NVGoeolHQe8wY,7570
+pythonanywhere_clis-1.0.0.dist-info/licenses/LICENSE,sha256=SmW5HVgeBBg_e-WKSP-Fr2H1-Cz-K0uLb99Hl_rOSKE,1088
+pythonanywhere_clis-1.0.0.dist-info/METADATA,sha256=sGmWcU3lsTC2p7X35AxEsw-LzPvY0Yrp5n57xX6G4to,454
+pythonanywhere_clis-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pythonanywhere_clis-1.0.0.dist-info/entry_points.txt,sha256=AfIEhKkIidqwUmJGZXyv6cRk8rajD39WhgpmdxBkp5E,43
+pythonanywhere_clis-1.0.0.dist-info/top_level.txt,sha256=xYc8GaLj6sfmBa_9zcWs60tYHX-xQihKcB91Te74q2c,7
+pythonanywhere_clis-1.0.0.dist-info/RECORD,,

pythonanywhere_clis-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pythonanywhere_clis-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pa = pa_cli.cli.main:app

pythonanywhere_clis-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pythonanywhere-cli contributors
+
+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_clis-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pa_cli