Metadata-Version: 2.0
Name: coscmd
Version: 1.4.10
Summary: simple command for cos
Home-page: https://www.qcloud.com/
Author: lewzylu
Author-email: 327874225@qq.com
License: MIT
Platform: UNKNOWN
Requires-Dist: argparse (==1.4.0)
Requires-Dist: requests (==2.12.4)

COSCMD使用文档
========

更新
--------

1.4.10 fix bug
1.4.9 ignore etag
1.4.8 fix nitts
1.4.7 fix bug about encoding
1.4.6 支持cos协议下载方式

依赖
--------

操作系统为linux, python版本为2.7，系统安装有pip（可通过yum/apt来安装，包名为python-pip）。


安装
--------

在该项目根目录下执行如下命令安装:

.. code::

 pip install coscmd


使用方法
--------

工具的使用前需要配置！你可以直接编辑~/.cos.conf，也可以通过如下命令来配置。


配置参数
^^^^^^^^

.. code::

 coscmd config -a youraccessid -s yoursecretkey -u appid -b bucketname -r region -m max_thread -p parts_size


请将参数替换为您的真实id/key/appid/bucket和园区代号,园区(region)为cn-south或者cn-north。

max_thread为多线程上传时的最大线程数(默认为5)

parts_size为分块上传的单块大小(单位为M)(默认为1M)


上传文件(夹)
^^^^^^^^

使用如下命令上传文件：

.. code::

 coscmd upload localpath cospath 

请将参数替换为您所需要的本地文件路径(localpath)，以及cos上存储的路径(cospath)。

如果本地文件路径是一个文件夹，则会将文件夹以cospath的名字上传


下载文件
^^^^^^^^

使用如下命令上传文件：

.. code::

 coscmd download localpath cospath 

请将参数替换为您所需要的本地存储路径(localpath)，以及需要下载的cos上文件的路径(cospath)。


删除文件
^^^^^^^^

使用如下命令删除文件：

.. code::

 coscmd delete cospath 

请将参数替换为您所需要删除的cos上文件的路径(cospath)。


新建bucket
^^^^^^^^

使用如下命令新建bucket：

.. code::

 coscmd createbucket

输入以下命令会根据在conf设置的信息新建一个对应的bucket


删除bucket
^^^^^^^^

使用如下命令创建bucket：

.. code::

 coscmd deletebucket

输入以下命令会根据在conf设置的信息删除对应的bucket


遍历bucket
^^^^^^^^

使用如下命令遍历bucket中的文件：

.. code::

 coscmd listbucket

输入以下命令会根据在conf设置的信息查看对应的bucket内的文件信息
而且会在当前目录下生成一个名为tmp.xml的文件，包含该bucket下所有文件的信息。


简单示例
^^^^^^^^

.. code::

 设置属性
 coscmd config -a AKKTZbAo6WhgcBqVl3213ID15IsskiBQ0 -s cii213fdfaWuIz12pThGGlWRW -u 1252448703 -b uploadtest -r cn-south -m 10 -p 5

 上传文件
 coscmd upload file1 file2

 上传文件夹
 coscmd upload folder1 folder2

 下载文件
 coscmd download file1 file2

 删除文件
 coscmd delete file1

 新建bucket
 coscmd createbucket

 删除bucket
 coscmd deletebucket

 遍历bucket
 coscmd listbucket


注意事项
^^^^^^^^

配置项建议：

#. max_thread <= 10
#. parts_size <= 10

暂时不支持的功能：

#. 不能删除和下载文件夹
#. 不能删除非空bucket




