pansh 3.1.0__tar.gz

pansh-3.1.0/.gitignore

@@ -0,0 +1,10 @@
+.idea/
+__pycache__/
+*.pyc
+Doc/
+.tmp*
+.pytest_cache/
+.pytest-tmp/
+pytest-cache-files-*/
+dist/
+build/

pansh-3.1.0/LICENSE

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

pansh-3.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: pansh
+Version: 3.1.0
+Summary: AnyShare / 北航网盘 CLI with Typer, Rich, and asyncio
+Author: LZR
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: platformdirs>=4.2.0
+Requires-Dist: prompt-toolkit>=3.0.43
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.1
+Requires-Dist: rsa>=4.9
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pansh
+
+AnyShare / 北航网盘命令行工具，支持：
+
+- `pip install .` / `pip install -e .`
+- `pansh` / `python -m pansh`
+- Typer 单次命令与交互式 shell
+- Rich 进度条、实时速率、平均速率、ETA、状态
+- 多文件、`glob`、`regex` 上传下载
+- `platformdirs` 用户配置目录
+- YAML 设置文件和 JSON 凭据缓存
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+安装后可直接使用：
+
+```bash
+pansh --help
+python -m pansh --help
+pansh --version
+```
+
+## 配置目录
+
+默认配置目录使用 `platformdirs.user_config_dir("pansh")`。
+
+典型文件布局：
+
+```text
+settings.yaml
+auth.json
+```
+
+支持环境变量覆盖配置文件路径：
+
+```bash
+pansh_CONFIG=/path/to/settings.yaml
+```
+
+首次运行会自动生成内置默认 `settings.yaml` 模板。
+
+## 常用命令
+
+```bash
+pansh ls home
+pansh stat home/file.pdf
+pansh whoami --json
+pansh quota --json
+```
+
+### 上传
+
+```bash
+pansh upload a.txt b.txt c.txt home/test -y
+pansh upload --glob "*.pdf" --glob "*.docx" home/test -y
+pansh upload --regex ".*\\.(pdf|docx)$" ./docs home/test --recursive -y
+pansh upload src1 src2 src3 --exclude "*.tmp" home/test -y
+```
+
+### 下载
+
+```bash
+pansh download home/a.pdf home/b.pdf ./downloads -y
+pansh download --glob "*.zip" ./downloads -y
+pansh download --regex ".*2026.*\\.pdf$" home/docs ./downloads --recursive -y
+pansh download --search --regex ".*报告.*" --range home/docs ./downloads -y
+```
+
+### 输出模式
+
+```bash
+pansh ls home --plain
+pansh ls home --json
+pansh find 报告 --json
+```
+
+## Shell
+
+```bash
+pansh
+pansh shell
+```
+
+交互模式内置命令：
+
+- `cd`, `pwd`
+- `lcd`, `lpwd`, `lls`
+- `!<cmd>` 执行本地 shell 命令
+- 其余命令复用同一套 CLI 实现
+
+## 进阶命令
+
+```bash
+pansh revisions home/file.docx
+pansh restore-revision home/file.docx REVISION_ID
+```

pansh-3.1.0/README.md

@@ -0,0 +1,100 @@
+# pansh
+
+AnyShare / 北航网盘命令行工具，支持：
+
+- `pip install .` / `pip install -e .`
+- `pansh` / `python -m pansh`
+- Typer 单次命令与交互式 shell
+- Rich 进度条、实时速率、平均速率、ETA、状态
+- 多文件、`glob`、`regex` 上传下载
+- `platformdirs` 用户配置目录
+- YAML 设置文件和 JSON 凭据缓存
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+安装后可直接使用：
+
+```bash
+pansh --help
+python -m pansh --help
+pansh --version
+```
+
+## 配置目录
+
+默认配置目录使用 `platformdirs.user_config_dir("pansh")`。
+
+典型文件布局：
+
+```text
+settings.yaml
+auth.json
+```
+
+支持环境变量覆盖配置文件路径：
+
+```bash
+pansh_CONFIG=/path/to/settings.yaml
+```
+
+首次运行会自动生成内置默认 `settings.yaml` 模板。
+
+## 常用命令
+
+```bash
+pansh ls home
+pansh stat home/file.pdf
+pansh whoami --json
+pansh quota --json
+```
+
+### 上传
+
+```bash
+pansh upload a.txt b.txt c.txt home/test -y
+pansh upload --glob "*.pdf" --glob "*.docx" home/test -y
+pansh upload --regex ".*\\.(pdf|docx)$" ./docs home/test --recursive -y
+pansh upload src1 src2 src3 --exclude "*.tmp" home/test -y
+```
+
+### 下载
+
+```bash
+pansh download home/a.pdf home/b.pdf ./downloads -y
+pansh download --glob "*.zip" ./downloads -y
+pansh download --regex ".*2026.*\\.pdf$" home/docs ./downloads --recursive -y
+pansh download --search --regex ".*报告.*" --range home/docs ./downloads -y
+```
+
+### 输出模式
+
+```bash
+pansh ls home --plain
+pansh ls home --json
+pansh find 报告 --json
+```
+
+## Shell
+
+```bash
+pansh
+pansh shell
+```
+
+交互模式内置命令：
+
+- `cd`, `pwd`
+- `lcd`, `lpwd`, `lls`
+- `!<cmd>` 执行本地 shell 命令
+- 其余命令复用同一套 CLI 实现
+
+## 进阶命令
+
+```bash
+pansh revisions home/file.docx
+pansh restore-revision home/file.docx REVISION_ID
+```

pansh-3.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["hatchling>=1.25.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pansh"
+dynamic = ["version"]
+description = "AnyShare / 北航网盘 CLI with Typer, Rich, and asyncio"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "LZR" }]
+dependencies = [
+  "httpx>=0.27.0",
+  "platformdirs>=4.2.0",
+  "prompt-toolkit>=3.0.43",
+  "pydantic>=2.7.0",
+  "pyyaml>=6.0",
+  "rich>=13.7.1",
+  "rsa>=4.9",
+  "typer>=0.12.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2.2",
+  "mypy>=1.10.0",
+  "pytest>=8.0.0",
+  "ruff>=0.4.0",
+  "twine>=6.2.0",
+]
+
+[project.scripts]
+pansh = "pansh.main:main"
+bhpan = "pansh.main:main"
+
+[tool.hatch.version]
+path = "src/pansh/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pansh"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/tests",
+  "/README.md",
+  "/pyproject.toml",
+  "/LICENSE",
+]
+
+[tool.pytest.ini_options]
+norecursedirs = [
+  ".venv",
+  ".pytest_cache",
+  ".pytest-tmp",
+  ".tmp",
+  ".tmp-settings",
+  "dist",
+  "build",
+  "pytest-cache-files-*",
+]

pansh-3.1.0/src/pansh/__init__.py

@@ -0,0 +1,5 @@
+"""pansh package."""
+
+from .version import __version__
+
+__all__ = ["__version__"]

pansh-3.1.0/src/pansh/__main__.py

@@ -0,0 +1,6 @@
+"""Module entry point for ``python -m pansh``."""
+
+from .main import main
+
+if __name__ == "__main__":
+    main()