Metadata-Version: 2.4
Name: se-ossutil
Version: 0.2.0
Summary: Aliyun OSS CLI with interactive shell, multipart upload and download
Author: se
License-Expression: MIT
Project-URL: Homepage, https://github.com/se/se_ossutil
Project-URL: Repository, https://github.com/se/se_ossutil
Keywords: oss,aliyun,cli,upload,download
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Archiving
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: oss2

# se_ossutil

阿里云 OSS 命令行工具，支持交互式 shell、分片上传/下载。

## 安装

```bash
pip install se-ossutil
# or
pip install -i https://pypi.org/simple se-ossutil
```

## 使用

```bash
# 登录（自动识别团队 seen-e-model / seen-e-system 与用户名）
se_ossutil login

# 退出登录（删除本地配置）
se_ossutil logout

# 未登录时提示登录；已登录时显示帮助
se_ossutil

# 交互 shell（启动后进入用户主目录）
se_ossutil shell

# 非交互 cli（适合 AI agent；默认在用户主目录下）
se_ossutil cli ls
se_ossutil cli ls test/
se_ossutil cli pwd
se_ossutil cli whoami
se_ossutil cli mkdir demo/
se_ossutil cli rm -f demo/

# 上传 / 下载
se_ossutil upload ./local.mp4 oss://bucket/prefix/
se_ossutil download oss://bucket/prefix/file.mp4 ./local.mp4
```

## Shell / cli 命令

- `ls [path]` — 列出目录
- `cd <path>` — 切换目录（仅交互 shell）
- `pwd [path]` — 显示完整 OSS 路径
- `whoami` — 显示当前用户（`team/username`）
- `mkdir <dir>` — 创建目录
- `rm [-f] <name>` — 删除（交互 shell 默认需确认；`cli` 必须加 `-f`）
- `exit` / `quit` — 退出（仅交互 shell）

默认仅在自己的主目录（`{team}/{username}/`）下有完整权限，其余目录通常仅有读权限。

## 依赖

- Python >= 3.10
- oss2

## 开发与发版

- [CHANGELOG.md](CHANGELOG.md) — 版本变更记录
- [RELEASE.md](RELEASE.md) — PyPI 发版步骤
