pocklo 0.2.0__tar.gz

pocklo-0.2.0/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: pocklo
+Version: 0.2.0
+Summary: Command-line client for the Pocklo file workspace
+Project-URL: Homepage, https://pocklo.jyonn.space/
+Project-URL: Documentation, https://pocklo.jyonn.space/cli
+Project-URL: Source, https://github.com/pocklo-app/pocklo-cli
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: qiniu<8,>=7.13
+Requires-Dist: rich<14,>=13.9
+Requires-Dist: requests<3,>=2.32
+
+# Pocklo CLI · 小兜
+
+`pocklo` is the command-line client for the Pocklo file workspace. It supports:
+
+- SSO-based login by exchanging an authorization `code` for the backend JWT token
+- Listing remote directories
+- Switching into a remote working directory with `cd`
+- Uploading a local file into a remote directory
+- Uploading a local directory recursively while recreating its folder structure remotely
+- Resumable multipart uploads with real remote-part progress
+
+## Install
+
+```bash
+python3 -m pip install pocklo
+```
+
+For local development:
+
+```bash
+pip install -e .
+```
+
+## Commands
+
+Print the SSO authorization URL:
+
+```bash
+pocklo login --print-url
+```
+
+Interactive login:
+
+```bash
+pocklo login
+```
+
+You can also paste the full callback URL directly:
+
+```bash
+pocklo login --code 'https://pocklo.jyonn.space/oauth/qtb/callback?code=...'
+```
+
+Show the authenticated user:
+
+```bash
+pocklo whoami
+```
+
+Change into a remote directory:
+
+```bash
+pocklo cd @Ab12Cd
+pocklo cd Projects
+pocklo cd ../Archive
+```
+
+Print the current remote directory:
+
+```bash
+pocklo pwd
+```
+
+List the current remote directory:
+
+```bash
+pocklo ls
+```
+
+List the remote root directory explicitly:
+
+```bash
+pocklo ls /
+```
+
+List a nested remote directory by relative path:
+
+```bash
+pocklo ls Photos/2024
+```
+
+List a remote resource directly by resource ID:
+
+```bash
+pocklo ls id:Ab12Cd
+```
+
+The shorter `@资源ID` form works too:
+
+```bash
+pocklo ls @Ab12Cd
+```
+
+Upload a local file into a remote directory:
+
+```bash
+pocklo upload ./report.pdf
+```
+
+Upload a local directory recursively. The local directory name is created or reused under the target remote directory:
+
+```bash
+pocklo upload ./albums
+```
+
+Only upload selected extensions:
+
+```bash
+pocklo upload ./albums /Photos --include-ext jpg --include-ext png
+```
+
+Exclude specific extensions:
+
+```bash
+pocklo upload ./albums /Photos --exclude-ext tmp --exclude-ext log
+```
+
+You can combine both flags. `--exclude-ext` takes precedence when both match the same file.
+
+Create a directory under the remote root:
+
+```bash
+pocklo mkdir Projects
+pocklo cd Projects
+pocklo mkdir 2026
+```
+
+Create a directory under a specific remote folder:
+
+```bash
+pocklo mkdir 2026 /Photos
+pocklo mkdir Archive @Ab12Cd
+```
+
+Rename a remote resource:
+
+```bash
+pocklo rename /Photos/old-name.jpg new-name.jpg
+```
+
+Move a remote resource into another remote directory:
+
+```bash
+pocklo mv new-name.jpg ../Archive
+```
+
+Delete a remote file:
+
+```bash
+pocklo rm new-name.jpg
+```
+
+Delete a non-empty remote directory recursively:
+
+```bash
+pocklo rm --recursive Archive
+```
+
+Download a remote file to the current directory:
+
+```bash
+pocklo download report.pdf
+```
+
+Download a remote file into a chosen local path:
+
+```bash
+pocklo download @Ab12Cd ./downloads/report.pdf
+```
+
+Download a remote directory recursively:
+
+```bash
+pocklo download @Ab12Cd ./downloads/Archive
+```
+
+Create a remote link resource:
+
+```bash
+pocklo link Search https://www.google.com
+```
+
+## State File
+
+The CLI stores the backend JWT token and the last fetched user payload in:
+
+```text
+~/.config/pocklo-cli/state.json
+```
+
+On first use, Pocklo imports existing login state and the remote working directory from `~/.config/htx-cli` or `~/.config/disk-cli` when present. Existing upload resume records remain in their configured directory. `DISK_*` environment variables are still read as fallbacks. Use `--config` to point to a different state file.
+
+Multipart upload resume records are stored under:
+
+```text
+~/.config/pocklo-cli/upload-records/
+```

pocklo-0.2.0/README.md

@@ -0,0 +1,197 @@
+# Pocklo CLI · 小兜
+
+`pocklo` is the command-line client for the Pocklo file workspace. It supports:
+
+- SSO-based login by exchanging an authorization `code` for the backend JWT token
+- Listing remote directories
+- Switching into a remote working directory with `cd`
+- Uploading a local file into a remote directory
+- Uploading a local directory recursively while recreating its folder structure remotely
+- Resumable multipart uploads with real remote-part progress
+
+## Install
+
+```bash
+python3 -m pip install pocklo
+```
+
+For local development:
+
+```bash
+pip install -e .
+```
+
+## Commands
+
+Print the SSO authorization URL:
+
+```bash
+pocklo login --print-url
+```
+
+Interactive login:
+
+```bash
+pocklo login
+```
+
+You can also paste the full callback URL directly:
+
+```bash
+pocklo login --code 'https://pocklo.jyonn.space/oauth/qtb/callback?code=...'
+```
+
+Show the authenticated user:
+
+```bash
+pocklo whoami
+```
+
+Change into a remote directory:
+
+```bash
+pocklo cd @Ab12Cd
+pocklo cd Projects
+pocklo cd ../Archive
+```
+
+Print the current remote directory:
+
+```bash
+pocklo pwd
+```
+
+List the current remote directory:
+
+```bash
+pocklo ls
+```
+
+List the remote root directory explicitly:
+
+```bash
+pocklo ls /
+```
+
+List a nested remote directory by relative path:
+
+```bash
+pocklo ls Photos/2024
+```
+
+List a remote resource directly by resource ID:
+
+```bash
+pocklo ls id:Ab12Cd
+```
+
+The shorter `@资源ID` form works too:
+
+```bash
+pocklo ls @Ab12Cd
+```
+
+Upload a local file into a remote directory:
+
+```bash
+pocklo upload ./report.pdf
+```
+
+Upload a local directory recursively. The local directory name is created or reused under the target remote directory:
+
+```bash
+pocklo upload ./albums
+```
+
+Only upload selected extensions:
+
+```bash
+pocklo upload ./albums /Photos --include-ext jpg --include-ext png
+```
+
+Exclude specific extensions:
+
+```bash
+pocklo upload ./albums /Photos --exclude-ext tmp --exclude-ext log
+```
+
+You can combine both flags. `--exclude-ext` takes precedence when both match the same file.
+
+Create a directory under the remote root:
+
+```bash
+pocklo mkdir Projects
+pocklo cd Projects
+pocklo mkdir 2026
+```
+
+Create a directory under a specific remote folder:
+
+```bash
+pocklo mkdir 2026 /Photos
+pocklo mkdir Archive @Ab12Cd
+```
+
+Rename a remote resource:
+
+```bash
+pocklo rename /Photos/old-name.jpg new-name.jpg
+```
+
+Move a remote resource into another remote directory:
+
+```bash
+pocklo mv new-name.jpg ../Archive
+```
+
+Delete a remote file:
+
+```bash
+pocklo rm new-name.jpg
+```
+
+Delete a non-empty remote directory recursively:
+
+```bash
+pocklo rm --recursive Archive
+```
+
+Download a remote file to the current directory:
+
+```bash
+pocklo download report.pdf
+```
+
+Download a remote file into a chosen local path:
+
+```bash
+pocklo download @Ab12Cd ./downloads/report.pdf
+```
+
+Download a remote directory recursively:
+
+```bash
+pocklo download @Ab12Cd ./downloads/Archive
+```
+
+Create a remote link resource:
+
+```bash
+pocklo link Search https://www.google.com
+```
+
+## State File
+
+The CLI stores the backend JWT token and the last fetched user payload in:
+
+```text
+~/.config/pocklo-cli/state.json
+```
+
+On first use, Pocklo imports existing login state and the remote working directory from `~/.config/htx-cli` or `~/.config/disk-cli` when present. Existing upload resume records remain in their configured directory. `DISK_*` environment variables are still read as fallbacks. Use `--config` to point to a different state file.
+
+Multipart upload resume records are stored under:
+
+```text
+~/.config/pocklo-cli/upload-records/
+```

pocklo-0.2.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pocklo"
+version = "0.2.0"
+description = "Command-line client for the Pocklo file workspace"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+  "qiniu>=7.13,<8",
+  "rich>=13.9,<14",
+  "requests>=2.32,<3",
+]
+
+[project.scripts]
+pocklo = "pocklo_cli.cli:main"
+
+[project.urls]
+Homepage = "https://pocklo.jyonn.space/"
+Documentation = "https://pocklo.jyonn.space/cli"
+Source = "https://github.com/pocklo-app/pocklo-cli"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

pocklo-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pocklo-0.2.0/src/pocklo.egg-info/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: pocklo
+Version: 0.2.0
+Summary: Command-line client for the Pocklo file workspace
+Project-URL: Homepage, https://pocklo.jyonn.space/
+Project-URL: Documentation, https://pocklo.jyonn.space/cli
+Project-URL: Source, https://github.com/pocklo-app/pocklo-cli
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: qiniu<8,>=7.13
+Requires-Dist: rich<14,>=13.9
+Requires-Dist: requests<3,>=2.32
+
+# Pocklo CLI · 小兜
+
+`pocklo` is the command-line client for the Pocklo file workspace. It supports:
+
+- SSO-based login by exchanging an authorization `code` for the backend JWT token
+- Listing remote directories
+- Switching into a remote working directory with `cd`
+- Uploading a local file into a remote directory
+- Uploading a local directory recursively while recreating its folder structure remotely
+- Resumable multipart uploads with real remote-part progress
+
+## Install
+
+```bash
+python3 -m pip install pocklo
+```
+
+For local development:
+
+```bash
+pip install -e .
+```
+
+## Commands
+
+Print the SSO authorization URL:
+
+```bash
+pocklo login --print-url
+```
+
+Interactive login:
+
+```bash
+pocklo login
+```
+
+You can also paste the full callback URL directly:
+
+```bash
+pocklo login --code 'https://pocklo.jyonn.space/oauth/qtb/callback?code=...'
+```
+
+Show the authenticated user:
+
+```bash
+pocklo whoami
+```
+
+Change into a remote directory:
+
+```bash
+pocklo cd @Ab12Cd
+pocklo cd Projects
+pocklo cd ../Archive
+```
+
+Print the current remote directory:
+
+```bash
+pocklo pwd
+```
+
+List the current remote directory:
+
+```bash
+pocklo ls
+```
+
+List the remote root directory explicitly:
+
+```bash
+pocklo ls /
+```
+
+List a nested remote directory by relative path:
+
+```bash
+pocklo ls Photos/2024
+```
+
+List a remote resource directly by resource ID:
+
+```bash
+pocklo ls id:Ab12Cd
+```
+
+The shorter `@资源ID` form works too:
+
+```bash
+pocklo ls @Ab12Cd
+```
+
+Upload a local file into a remote directory:
+
+```bash
+pocklo upload ./report.pdf
+```
+
+Upload a local directory recursively. The local directory name is created or reused under the target remote directory:
+
+```bash
+pocklo upload ./albums
+```
+
+Only upload selected extensions:
+
+```bash
+pocklo upload ./albums /Photos --include-ext jpg --include-ext png
+```
+
+Exclude specific extensions:
+
+```bash
+pocklo upload ./albums /Photos --exclude-ext tmp --exclude-ext log
+```
+
+You can combine both flags. `--exclude-ext` takes precedence when both match the same file.
+
+Create a directory under the remote root:
+
+```bash
+pocklo mkdir Projects
+pocklo cd Projects
+pocklo mkdir 2026
+```
+
+Create a directory under a specific remote folder:
+
+```bash
+pocklo mkdir 2026 /Photos
+pocklo mkdir Archive @Ab12Cd
+```
+
+Rename a remote resource:
+
+```bash
+pocklo rename /Photos/old-name.jpg new-name.jpg
+```
+
+Move a remote resource into another remote directory:
+
+```bash
+pocklo mv new-name.jpg ../Archive
+```
+
+Delete a remote file:
+
+```bash
+pocklo rm new-name.jpg
+```
+
+Delete a non-empty remote directory recursively:
+
+```bash
+pocklo rm --recursive Archive
+```
+
+Download a remote file to the current directory:
+
+```bash
+pocklo download report.pdf
+```
+
+Download a remote file into a chosen local path:
+
+```bash
+pocklo download @Ab12Cd ./downloads/report.pdf
+```
+
+Download a remote directory recursively:
+
+```bash
+pocklo download @Ab12Cd ./downloads/Archive
+```
+
+Create a remote link resource:
+
+```bash
+pocklo link Search https://www.google.com
+```
+
+## State File
+
+The CLI stores the backend JWT token and the last fetched user payload in:
+
+```text
+~/.config/pocklo-cli/state.json
+```
+
+On first use, Pocklo imports existing login state and the remote working directory from `~/.config/htx-cli` or `~/.config/disk-cli` when present. Existing upload resume records remain in their configured directory. `DISK_*` environment variables are still read as fallbacks. Use `--config` to point to a different state file.
+
+Multipart upload resume records are stored under:
+
+```text
+~/.config/pocklo-cli/upload-records/
+```

pocklo-0.2.0/src/pocklo.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/pocklo.egg-info/PKG-INFO
+src/pocklo.egg-info/SOURCES.txt
+src/pocklo.egg-info/dependency_links.txt
+src/pocklo.egg-info/entry_points.txt
+src/pocklo.egg-info/requires.txt
+src/pocklo.egg-info/top_level.txt
+src/pocklo_cli/__init__.py
+src/pocklo_cli/__main__.py
+src/pocklo_cli/api.py
+src/pocklo_cli/cli.py
+src/pocklo_cli/config.py

pocklo-0.2.0/src/pocklo.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pocklo-0.2.0/src/pocklo.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pocklo = pocklo_cli.cli:main

pocklo-0.2.0/src/pocklo.egg-info/requires.txt

@@ -0,0 +1,3 @@
+qiniu<8,>=7.13
+rich<14,>=13.9
+requests<3,>=2.32

pocklo-0.2.0/src/pocklo.egg-info/top_level.txt

@@ -0,0 +1 @@
+pocklo_cli

pocklo-0.2.0/src/pocklo_cli/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.2.0"

pocklo-0.2.0/src/pocklo_cli/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())