cosctl 0.1.4

A simple command line tool for managing Tencent Cloud COS (Cloud Object Storage).

COS Cli

A simple command line tool for managing Tencent Cloud COS (Cloud Object Storage).

Install

Requires Python 3.10 or newer.

pip install cosctl

For development dependencies:

pip install -e .[dev]

Environment variables

export SECRET_ID=""
export SECRET_KEY=""
export BUCKET=""
export REGION="wuxi"
export DOMAIN=""

Required:

• SECRET_ID
• SECRET_KEY
• BUCKET (falls back to the first label of DOMAIN when not set, e.g. my-bucket.cos.ap-beijing.myqcloud.com yields my-bucket)

Optional:

• REGION (defaults to wuxi)
• DOMAIN

Usage

cosctl --help
cosctl --version
cosctl list
cosctl list logs/
cosctl upload ./local-file.txt remote-file.txt
cosctl upload ./local-file.txt remote-file.txt --tag env=prod --tag owner=team
cosctl get remote-file.txt ./downloaded.txt
cosctl delete remote-file.txt

Build

构建时会自动在基础版本后追加动态后缀：时间戳 + git 短哈希。 例如：0.1.1+20260402.123045.abc1234

make sync
make build

Test

pytest