htx-cli 0.1.0__py3-none-any.whl

disk_cli/config.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+from typing import Any
+from urllib.parse import urlencode
+
+DEFAULT_APP_ID = "R41nXZEwpfl6tw6KYyoEZ4FYST4BXPlF"
+DEFAULT_BACKEND_URL = "https://disk.6-79.cn"
+DEFAULT_QINIU_UPLOAD_URL = "https://up.qiniup.com"
+DEFAULT_SSO_URL = "https://sso.6-79.cn/oauth/"
+DEFAULT_STATE_PATH = Path.home() / ".config" / "htx-cli" / "state.json"
+LEGACY_STATE_PATH = Path.home() / ".config" / "disk-cli" / "state.json"
+
+
+@dataclass
+class DiskSettings:
+    backend_url: str = field(default_factory=lambda: os.getenv("DISK_BACKEND_URL", DEFAULT_BACKEND_URL))
+    sso_url: str = field(default_factory=lambda: os.getenv("DISK_SSO_URL", DEFAULT_SSO_URL))
+    sso_app_id: str = field(default_factory=lambda: os.getenv("DISK_SSO_APP_ID", DEFAULT_APP_ID))
+    qiniu_upload_url: str = field(default_factory=lambda: os.getenv("DISK_QINIU_UPLOAD_URL", DEFAULT_QINIU_UPLOAD_URL))
+    token: str | None = None
+    user: dict[str, Any] | None = None
+    state_path: Path = DEFAULT_STATE_PATH
+
+    @classmethod
+    def load(cls, state_path: Path | None = None) -> "DiskSettings":
+        resolved_path = (state_path or DEFAULT_STATE_PATH).expanduser()
+        if state_path is None and not resolved_path.exists() and LEGACY_STATE_PATH.exists():
+            resolved_path = LEGACY_STATE_PATH
+        if not resolved_path.exists():
+            return cls(state_path=resolved_path)
+
+        data = json.loads(resolved_path.read_text(encoding="utf-8"))
+        return cls(
+            backend_url=data.get("backend_url", os.getenv("DISK_BACKEND_URL", DEFAULT_BACKEND_URL)),
+            sso_url=data.get("sso_url", os.getenv("DISK_SSO_URL", DEFAULT_SSO_URL)),
+            sso_app_id=data.get("sso_app_id", os.getenv("DISK_SSO_APP_ID", DEFAULT_APP_ID)),
+            qiniu_upload_url=data.get(
+                "qiniu_upload_url",
+                os.getenv("DISK_QINIU_UPLOAD_URL", DEFAULT_QINIU_UPLOAD_URL),
+            ),
+            token=data.get("token"),
+            user=data.get("user"),
+            state_path=resolved_path,
+        )
+
+    def save(self) -> None:
+        self.state_path.parent.mkdir(parents=True, exist_ok=True)
+        payload = asdict(self)
+        payload["state_path"] = str(self.state_path)
+        self.state_path.write_text(
+            json.dumps(payload, ensure_ascii=False, indent=2) + "\n",
+            encoding="utf-8",
+        )
+
+    def clear_auth(self) -> None:
+        self.token = None
+        self.user = None
+
+    def oauth_authorize_url(self, *, state: str | None = "htx-cli") -> str:
+        params = {"app_id": self.sso_app_id}
+        if state:
+            params["state"] = state
+        return f"{self.sso_url}?{urlencode(params)}"

htx_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: htx-cli
+Version: 0.1.0
+Summary: htx-cli command-line client for the Disk backend API
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: rich<14,>=13.9
+Requires-Dist: requests<3,>=2.32
+
+# htx-cli
+
+`htx-cli` is a command-line client for the Disk backend API. It supports:
+
+- SSO-based login by exchanging an authorization `code` for the backend JWT token
+- Listing remote Disk directories
+- Uploading a local file into a remote Disk directory
+- Uploading a local directory recursively while recreating its folder structure remotely
+
+## Install
+
+```bash
+source /Users/jyonn/Projects/venv/django/bin/activate
+pip install -e .
+```
+
+## Commands
+
+Print the SSO authorization URL:
+
+```bash
+htx login --print-url
+```
+
+Interactive login:
+
+```bash
+htx login
+```
+
+You can also paste the full callback URL directly:
+
+```bash
+htx login --code 'https://d.6-79.cn/oauth/qtb/callback?code=...'
+```
+
+Show the authenticated user:
+
+```bash
+htx whoami
+```
+
+List the root directory:
+
+```bash
+htx ls
+```
+
+List a nested remote directory by path:
+
+```bash
+htx ls /Photos/2024
+```
+
+List a remote resource directly by resource ID:
+
+```bash
+htx ls id:Ab12Cd
+```
+
+The shorter `@资源ID` form works too:
+
+```bash
+htx ls @Ab12Cd
+```
+
+Upload a local file into a remote directory:
+
+```bash
+htx upload ./report.pdf /Docs
+```
+
+Upload a local directory recursively. The local directory name is created or reused under the target remote directory:
+
+```bash
+htx upload ./albums /Photos
+```
+
+Create a directory under the remote root:
+
+```bash
+htx mkdir Projects
+```
+
+Create a directory under a specific remote folder:
+
+```bash
+htx mkdir 2026 /Photos
+htx mkdir Archive @Ab12Cd
+```
+
+Rename a remote resource:
+
+```bash
+htx rename /Photos/old-name.jpg new-name.jpg
+```
+
+Move a remote resource into another remote directory:
+
+```bash
+htx mv /Photos/new-name.jpg /Archive
+```
+
+Delete a remote file:
+
+```bash
+htx rm /Archive/new-name.jpg
+```
+
+Delete a non-empty remote directory recursively:
+
+```bash
+htx rm --recursive /Archive
+```
+
+Download a remote file to the current directory:
+
+```bash
+htx download /Docs/report.pdf
+```
+
+Download a remote file into a chosen local path:
+
+```bash
+htx download @Ab12Cd ./downloads/report.pdf
+```
+
+Download a remote directory recursively:
+
+```bash
+htx download @Ab12Cd ./downloads/Archive
+```
+
+Create a remote link resource:
+
+```bash
+htx link Search https://www.google.com /Bookmarks
+```
+
+## State File
+
+The CLI stores the backend JWT token and the last fetched user payload in:
+
+```text
+~/.config/htx-cli/state.json
+```
+
+Use `--config` to point to a different state file.

htx_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+disk_cli/__init__.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
+disk_cli/__main__.py,sha256=PSQ4rpL0dG6f-qH4N7H-gD9igQkdHzH4yVZDcW8lfZo,80
+disk_cli/api.py,sha256=xUeBfjK9peyQJQ8kTA64-OuTax9uDO6X3rJO36WQ4-A,13259
+disk_cli/cli.py,sha256=MmTHHSmE4pd4-FTsjHd5rL953K7VwbKJzpyKNtlAqng,27521
+disk_cli/config.py,sha256=FEon2w6BxY7LnaQg2dvHMRhnerkqzhXtl_tAl9IPnU0,2772
+htx_cli-0.1.0.dist-info/METADATA,sha256=6YvLBN--qRU_Zkh6hGo6WlqVM1ArA5b2AwP2lcEwGqE,2620
+htx_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+htx_cli-0.1.0.dist-info/entry_points.txt,sha256=30CRqDTSLDcKllLPd2VuweGtRGaMwBT0BdhbcMk-jMQ,42
+htx_cli-0.1.0.dist-info/top_level.txt,sha256=-48I7cKRUrqajp2Wa_N_lJBGALIsBzP2WsdnC7IGRMM,9
+htx_cli-0.1.0.dist-info/RECORD,,

htx_cli-0.1.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
+

htx_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+htx = disk_cli.cli:main

htx_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+disk_cli