cloud-tc 0.1.0__py3-none-any.whl

cloud_tc/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

cloud_tc/cli.py

@@ -0,0 +1,422 @@
+from __future__ import annotations
+
+import json
+import os
+import stat
+import sys
+from pathlib import Path
+from typing import Optional
+
+import httpx
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from cloud_tc import __version__
+
+IS_WINDOWS = sys.platform.startswith("win")
+
+
+def _enable_windows_ansi() -> None:
+    if not IS_WINDOWS:
+        return
+    try:
+        import ctypes
+        kernel32 = ctypes.windll.kernel32
+        ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004
+        for handle_id in (-11, -12):
+            h = kernel32.GetStdHandle(handle_id)
+            mode = ctypes.c_uint32()
+            if kernel32.GetConsoleMode(h, ctypes.byref(mode)):
+                kernel32.SetConsoleMode(h, mode.value | ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+    except Exception:
+        pass
+
+
+_enable_windows_ansi()
+
+app = typer.Typer(
+    no_args_is_help=True,
+    add_completion=False,
+    pretty_exceptions_show_locals=False,
+    help="Terminal client for OnlySq Cloud 2.0",
+)
+console = Console()
+
+
+def _config_dir() -> Path:
+    """
+    Cross-platform per-user config directory.
+
+    Windows:  %APPDATA%\\cloud-tc
+    macOS:    ~/Library/Application Support/cloud-tc
+    Linux/*:  $XDG_CONFIG_HOME/cloud-tc, fallback ~/.config/cloud-tc
+
+    Legacy ~/.cloud-tc (used by 0.1.0) is honored if it already exists.
+    """
+    override = os.environ.get("CLOUD_TC_HOME")
+    if override:
+        return Path(override).expanduser()
+
+    legacy = Path.home() / ".cloud-tc"
+    if legacy.exists():
+        return legacy
+
+    if IS_WINDOWS:
+        base = os.environ.get("APPDATA") or str(Path.home() / "AppData" / "Roaming")
+        return Path(base) / "cloud-tc"
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / "cloud-tc"
+    xdg = os.environ.get("XDG_CONFIG_HOME") or str(Path.home() / ".config")
+    return Path(xdg) / "cloud-tc"
+
+
+CONFIG_DIR = _config_dir()
+CONFIG_FILE = CONFIG_DIR / "config.json"
+DEFAULT_BASE = "https://cloud.onlysq.ru"
+
+
+def _save(data: dict) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(data, indent=2), encoding="utf-8")
+    if not IS_WINDOWS:
+        try:
+            CONFIG_FILE.chmod(stat.S_IRUSR | stat.S_IWUSR)
+        except Exception:
+            pass
+
+
+def _load() -> dict:
+    if not CONFIG_FILE.exists():
+        return {}
+    try:
+        return json.loads(CONFIG_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+
+
+def _client(require_auth: bool = True) -> httpx.Client:
+    cfg = _load()
+    base = cfg.get("base_url") or os.environ.get("TC_BASE_URL") or DEFAULT_BASE
+    token = cfg.get("token") or os.environ.get("TC_TOKEN")
+    headers = {"User-Agent": f"cloud-tc/{__version__} ({sys.platform})"}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    elif require_auth:
+        console.print("[red]no token configured[/] · run [bold]tc login --token tck_…[/]")
+        raise typer.Exit(1)
+    return httpx.Client(base_url=base, headers=headers, timeout=120.0, follow_redirects=False)
+
+
+def _hsize(n) -> str:
+    n = int(n or 0)
+    units = ["B", "KB", "MB", "GB", "TB", "PB"]
+    if n >= 1024 ** 6:
+        return "∞"
+    i = 0
+    f = float(n)
+    while f >= 1024 and i < len(units) - 1:
+        f /= 1024
+        i += 1
+    if i == 0:
+        return f"{int(f)} {units[i]}"
+    if i == 1:
+        return f"{f:.1f} {units[i]}"
+    return f"{f:.2f} {units[i]}"
+
+
+def _fail_if_bad(r: httpx.Response, ctx: str = "") -> dict:
+    try:
+        data = r.json()
+    except Exception:
+        data = {"raw": r.text}
+    if r.status_code >= 300 or (isinstance(data, dict) and data.get("ok") is False):
+        msg = data.get("error") if isinstance(data, dict) else r.text
+        console.print(f"[red]{ctx or 'error'}[/] HTTP {r.status_code} · {msg}")
+        raise typer.Exit(1)
+    return data
+
+
+@app.command()
+def version():
+    console.print(f"cloud-tc [bold]{__version__}[/] · {sys.platform} · python {sys.version.split()[0]}")
+
+
+@app.command()
+def info():
+    cfg = _load()
+    console.print(f"[bold]cloud-tc[/] v{__version__}")
+    console.print(f"  platform: {sys.platform}")
+    console.print(f"  config:   {CONFIG_FILE}")
+    if cfg:
+        console.print(f"  base_url = {cfg.get('base_url', DEFAULT_BASE)}")
+        if cfg.get("token"):
+            console.print(f"  token    = {cfg['token'][:14]}…")
+    else:
+        console.print("  [dim]not logged in[/]")
+
+
+@app.command()
+def login(
+    token: str = typer.Option(..., "--token", "-t", help="API token (tck_…) — create one at /v2/ui/settings"),
+    base_url: str = typer.Option(DEFAULT_BASE, "--base-url", "-u"),
+):
+    """Save an API token locally and verify it works."""
+    with httpx.Client(base_url=base_url, headers={"Authorization": f"Bearer {token}"}, timeout=30) as cli:
+        r = cli.get("/v2/quota")
+        if r.status_code != 200:
+            console.print(f"[red]token rejected[/] HTTP {r.status_code} · {r.text}")
+            raise typer.Exit(1)
+        q = r.json()
+    _save({"token": token, "base_url": base_url})
+    console.print(
+        f"[green]ok[/] logged in · used {_hsize(q['used_bytes'])} / "
+        f"{_hsize(q['quota_bytes'])}"
+    )
+
+
+@app.command()
+def logout():
+    """Remove the local config."""
+    if CONFIG_FILE.exists():
+        CONFIG_FILE.unlink()
+    console.print("[green]ok[/] config removed")
+
+
+@app.command()
+def me():
+    """Print the current user profile."""
+    with _client() as cli:
+        r = cli.get("/auth/me")
+        data = _fail_if_bad(r, "me")
+        u = data.get("user") or {}
+        console.print(f"[bold]{u.get('name')}[/] · {u.get('email') or 'no email'}")
+        console.print(f"  sauth_id: {u.get('sauth_id')}  level: {u.get('level')}{' · admin' if u.get('is_admin') else ''}")
+        console.print(f"  storage:  {_hsize(u.get('used_bytes'))} / {_hsize(u.get('quota_bytes'))}")
+        if u.get("has_legacy"):
+            console.print(f"  legacy:   {'migrated' if u.get('migrated') else 'linked, not migrated'}")
+
+
+@app.command()
+def quota():
+    """Show used / total quota."""
+    with _client() as cli:
+        r = cli.get("/v2/quota")
+        q = _fail_if_bad(r, "quota")
+        used = q["used_bytes"]
+        total = q["quota_bytes"]
+        pct = (used / max(1, total)) * 100
+        if total >= 1024 ** 6:
+            console.print(f"used [bold]{_hsize(used)}[/] / ∞ (unlimited tier)")
+        else:
+            console.print(f"used [bold]{_hsize(used)}[/] / {_hsize(total)} ([yellow]{pct:.1f}%[/])")
+
+
+@app.command()
+def ls(folder_id: Optional[int] = typer.Argument(None, help="folder id (omit for root)")):
+    """List files in a folder."""
+    with _client() as cli:
+        q = f"?folder_id={folder_id}" if folder_id else "?root=1"
+        r = cli.get(f"/v2/files{q}")
+        data = _fail_if_bad(r, "list")
+        files = data.get("files", [])
+        if not files:
+            console.print("[dim]empty[/]")
+            return
+        t = Table(show_lines=False, header_style="bold")
+        t.add_column("UID", style="cyan", no_wrap=True)
+        t.add_column("Name")
+        t.add_column("Size", justify="right", style="dim")
+        t.add_column("Mime", style="dim")
+        t.add_column("Status", justify="center")
+        for f in files:
+            status = "ready" if f.get("status") == 1 else f"#{f.get('status')}"
+            t.add_row(
+                f["uid"], f["name"], _hsize(f.get("size")),
+                f.get("mime") or "—", status,
+            )
+        console.print(t)
+
+
+@app.command()
+def upload(
+    path: Path = typer.Argument(..., exists=True, readable=True),
+    folder_id: Optional[int] = typer.Option(None, "--folder", "-f"),
+):
+    """Upload a local file."""
+    path = path.resolve()
+    if not path.is_file():
+        console.print("[red]not a file[/]")
+        raise typer.Exit(1)
+    with _client() as cli:
+        with path.open("rb") as f:
+            files = {"file": (path.name, f, "application/octet-stream")}
+            data = {"folder_id": str(folder_id)} if folder_id else {}
+            r = cli.post("/v2/files/upload", files=files, data=data)
+        out = _fail_if_bad(r, "upload")
+        f = out["file"]
+        console.print(f"[green]ok[/] {f['uid']} · {f['name']} · {_hsize(f['size'])}")
+
+
+@app.command()
+def download(
+    uid: str = typer.Argument(...),
+    out: Optional[Path] = typer.Option(None, "--out", "-o"),
+):
+    """Download a file by uid."""
+    with _client() as cli:
+        meta = _fail_if_bad(cli.get(f"/v2/files/{uid}"), "meta")
+        name = meta["file"]["name"]
+        target = (out or Path(name)).resolve()
+        target.parent.mkdir(parents=True, exist_ok=True)
+        with cli.stream("GET", f"/v2/files/{uid}/stream?mode=dl") as r:
+            if r.status_code != 200:
+                console.print(f"[red]error[/] HTTP {r.status_code}")
+                raise typer.Exit(1)
+            with target.open("wb") as fp:
+                for chunk in r.iter_bytes(chunk_size=65536):
+                    fp.write(chunk)
+    console.print(f"[green]ok[/] saved {target}")
+
+
+@app.command()
+def rm(uid: str = typer.Argument(...)):
+    """Soft-delete a file (moves to trash for 30 days)."""
+    with _client() as cli:
+        _fail_if_bad(cli.delete(f"/v2/files/{uid}"), "delete")
+        console.print(f"[green]ok[/] {uid} → trash")
+
+
+@app.command()
+def restore(uid: str = typer.Argument(...)):
+    """Restore a file from trash."""
+    with _client() as cli:
+        _fail_if_bad(cli.post(f"/v2/files/{uid}/restore"), "restore")
+        console.print(f"[green]ok[/] {uid} restored")
+
+
+@app.command()
+def mv(
+    uid: str = typer.Argument(...),
+    folder_id: int = typer.Argument(...),
+):
+    """Move a file to another folder."""
+    with _client() as cli:
+        _fail_if_bad(cli.patch(f"/v2/files/{uid}", json={"folder_id": folder_id}), "move")
+        console.print(f"[green]ok[/] {uid} → folder #{folder_id}")
+
+
+@app.command()
+def rename(
+    uid: str = typer.Argument(...),
+    name: str = typer.Argument(...),
+):
+    """Rename a file."""
+    with _client() as cli:
+        _fail_if_bad(cli.patch(f"/v2/files/{uid}", json={"name": name}), "rename")
+        console.print(f"[green]ok[/] renamed to {name}")
+
+
+@app.command()
+def mkdir(
+    name: str = typer.Argument(...),
+    parent: Optional[int] = typer.Option(None, "--parent", "-p"),
+):
+    """Create a folder."""
+    with _client() as cli:
+        body: dict = {"name": name}
+        if parent is not None:
+            body["parent_id"] = parent
+        data = _fail_if_bad(cli.post("/v2/folders", json=body), "mkdir")
+        f = data["folder"]
+        console.print(f"[green]ok[/] folder #{f['id']} · {f['name']}")
+
+
+@app.command()
+def share(
+    uid: str = typer.Argument(...),
+    role: str = typer.Option("viewer", "--role", "-r", help="viewer | commenter | editor"),
+    expires: Optional[str] = typer.Option(None, "--expires", help="ISO 8601 expiry"),
+    password: Optional[str] = typer.Option(None, "--password"),
+    max_uses: Optional[int] = typer.Option(None, "--max-uses"),
+):
+    """Create a public share link."""
+    with _client() as cli:
+        body: dict = {"role": role}
+        if expires:
+            body["expires_at"] = expires
+        if password:
+            body["password"] = password
+        if max_uses:
+            body["max_uses"] = max_uses
+        data = _fail_if_bad(cli.post(f"/v2/files/{uid}/share", json=body), "share")
+        cfg = _load()
+        base = cfg.get("base_url", DEFAULT_BASE)
+        url = f"{base}/v2/ui/s/{data['share']['token']}"
+        console.print(f"[green]share[/] {url}")
+
+
+tokens_app = typer.Typer(no_args_is_help=True, help="Manage API tokens")
+app.add_typer(tokens_app, name="tokens")
+
+
+@tokens_app.command("list")
+def tokens_list():
+    with _client() as cli:
+        data = _fail_if_bad(cli.get("/v2/tokens"), "tokens")
+        t = Table(header_style="bold")
+        t.add_column("Name")
+        t.add_column("Prefix", style="cyan")
+        t.add_column("Scopes", style="yellow")
+        t.add_column("Last used", style="dim")
+        for row in data.get("tokens", []):
+            scopes = ",".join(row.get("scopes") or []) or "default"
+            t.add_row(
+                row["name"], row["prefix"] + "…",
+                scopes, row.get("last_used_at") or "never",
+            )
+        console.print(t)
+
+
+@tokens_app.command("create")
+def tokens_create(
+    name: str = typer.Argument(...),
+    scopes: Optional[str] = typer.Option(None, "--scopes", "-s", help="comma-separated scopes"),
+):
+    sc = [x.strip() for x in (scopes or "").split(",") if x.strip()]
+    with _client() as cli:
+        data = _fail_if_bad(cli.post("/v2/tokens", json={"name": name, "scopes": sc}), "create token")
+        console.print(f"[green]ok[/] {data['token']['name']}")
+        console.print(f"[bold yellow]token (shown once):[/] {data['token']['token']}")
+
+
+@tokens_app.command("revoke")
+def tokens_revoke(id: int = typer.Argument(...)):
+    with _client() as cli:
+        _fail_if_bad(cli.delete(f"/v2/tokens/{id}"), "revoke")
+        console.print(f"[green]ok[/] revoked #{id}")
+
+
+@app.command(name="migrate-self")
+def migrate_self(
+    legacy_token: str = typer.Argument(...),
+    base_url: str = typer.Option(DEFAULT_BASE, "--base-url", "-u"),
+):
+    """Migrate a legacy account into v2 (no auth required)."""
+    with httpx.Client(base_url=base_url, timeout=60) as cli:
+        r = cli.post("/v2/migrate/legacy/self", json={"legacy_token": legacy_token})
+        data = _fail_if_bad(r, "migrate")
+        console.print(
+            f"[green]ok[/] migrated={data.get('migrated_count', 0)} "
+            f"already={data.get('already')} stub={data.get('stub')} "
+            f"cloud2_user_id={data.get('cloud2_user_id')}"
+        )
+        console.print(f"login: {base_url}{data['login_url']}")
+
+
+def main():
+    app()
+
+
+if __name__ == "__main__":
+    main()

cloud_tc-0.1.0.dist-info/METADATA

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: cloud-tc
+Version: 0.1.0
+Summary: Terminal client for OnlySq Cloud 2.0 — talks to https://cloud.onlysq.ru via REST
+Author-email: OnlySq <contact@onlysq.ru>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xOnlySq/cloud-tc
+Project-URL: Repository, https://github.com/xOnlySq/cloud-tc
+Project-URL: Issues, https://github.com/xOnlySq/cloud-tc/issues
+Project-URL: Service, https://cloud.onlysq.ru
+Project-URL: Documentation, https://cloud.onlysq.ru/docs
+Keywords: onlysq,cloud,telegram,cli,storage,drive
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+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 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: System :: Archiving
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Dynamic: license-file
+
+# cloud-tc
+
+Terminal client for **OnlySq Cloud 2.0** (`https://cloud.onlysq.ru`). Talks to the public v2 REST API — no Telegram, no Postgres on your machine, just `httpx` + `typer` + `rich`.
+
+## Install
+
+From PyPI (when published):
+
+```bash
+pip install cloud-tc
+```
+
+Straight from git:
+
+```bash
+pip install git+https://github.com/xOnlySq/cloud-tc.git
+```
+
+Or for a local checkout (with `-e` for editable):
+
+```bash
+git clone https://github.com/xOnlySq/cloud-tc.git
+cd cloud-tc
+pip install -e .
+```
+
+Both `tc` and `cloud-tc` console scripts are installed.
+
+## Quick start
+
+1. Create an API token in the web UI: `https://cloud.onlysq.ru/v2/ui/settings` → "new token".
+2. Log in locally:
+
+   ```bash
+   tc login --token tck_xxxxxxxxxxxxxxxxxxxx
+   ```
+
+   The token is stored in `~/.cloud-tc/config.json` (0600).
+
+3. Use it:
+
+   ```bash
+   tc me
+   tc quota
+   tc ls
+   tc upload ./photo.jpg
+   tc share <uid> --role viewer
+   ```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `tc login --token tck_…` | Save and verify an API token |
+| `tc logout` | Remove local config |
+| `tc info` | Show local config |
+| `tc version` | Print package version |
+| `tc me` | Show current user profile |
+| `tc quota` | Show used / total quota |
+| `tc ls [FOLDER_ID]` | List files |
+| `tc upload PATH [-f FOLDER]` | Upload a local file |
+| `tc download UID [-o PATH]` | Download a file |
+| `tc rm UID` | Move to trash |
+| `tc restore UID` | Restore from trash |
+| `tc mv UID FOLDER_ID` | Move file to another folder |
+| `tc rename UID NEW_NAME` | Rename |
+| `tc mkdir NAME [-p PARENT_ID]` | Create folder |
+| `tc share UID [-r ROLE] [--password] [--expires] [--max-uses]` | Create a share link |
+| `tc tokens list / create NAME / revoke ID` | Manage API tokens |
+| `tc migrate-self LEGACY_TOKEN` | Move a legacy account to v2 (no auth required) |
+
+## Configuration
+
+You can override the server with environment variables (useful for self-hosted instances):
+
+```bash
+export TC_BASE_URL="https://cloud.example.com"
+export TC_TOKEN="tck_..."
+tc ls
+```
+
+`TC_TOKEN` overrides the saved token if set. `TC_BASE_URL` overrides the configured base URL.
+
+Config file: `~/.cloud-tc/config.json` — just `{ "token": "...", "base_url": "..." }`.
+
+## Examples
+
+Upload everything from a directory into a folder:
+
+```bash
+for f in *.jpg; do tc upload "$f" -f 42; done
+```
+
+Pipe a file through `tc upload` (Linux):
+
+```bash
+tc upload /dev/stdin <<< "hello"   # named pipe trick, see issues for binary
+```
+
+Quick public link for a file:
+
+```bash
+UID=$(tc upload ./report.pdf | awk '{print $2}')
+tc share "$UID" --role viewer
+```
+
+Batch-migrate one legacy token from any script:
+
+```bash
+tc migrate-self USERS_LEGACY_TOKEN
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Related
+
+- Cloud UI: <https://cloud.onlysq.ru>
+- REST API docs: <https://cloud.onlysq.ru/docs> (see "Cloud 2.0" group)
+- Service / issues: <https://github.com/xOnlySq/cloud-tc/issues>

cloud_tc-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cloud_tc/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+cloud_tc/cli.py,sha256=fnp3StiulQpXjkS3bNq0-3vK_flrFQ-NKz9Ion7IQyM,13921
+cloud_tc-0.1.0.dist-info/licenses/LICENSE,sha256=zSAyimKavmIorc8acq_9EuFMQ6pRDb-LzIWcBQ7uAB8,1063
+cloud_tc-0.1.0.dist-info/METADATA,sha256=zC9SKYyIcAvdjFMbArgCT3pThReWcRKjWsMbeuNbmLs,4395
+cloud_tc-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cloud_tc-0.1.0.dist-info/entry_points.txt,sha256=7H7z8Rib5sCJnPQV0RPKsYlyTVtcLHKVHao4Imwa-OE,68
+cloud_tc-0.1.0.dist-info/top_level.txt,sha256=RB6q8HPa54yUqL7MBo3yCnMEhjuYuSbJivF2-lCR-eQ,9
+cloud_tc-0.1.0.dist-info/RECORD,,

cloud_tc-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
+

cloud_tc-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cloud-tc = cloud_tc.cli:app
+tc = cloud_tc.cli:app

cloud_tc-0.1.0.dist-info/licenses/LICENSE

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

cloud_tc-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cloud_tc