# simple-qiniu-upload

> A simple library that helps to upload static resource file to qiniu bucket for cdn use.

Latest version **0.2.0** (published 2020-01-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install simple-qiniu-upload
pnpm add simple-qiniu-upload
yarn add simple-qiniu-upload
bun add simple-qiniu-upload
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2020-01-17 |
| First published | 2019-12-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 18.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | liuyunzhuge |
| Maintainers | liuyunzhuge |
| Keywords | simple-qiniu-upload |

## Links

- npm: https://www.npmjs.com/package/simple-qiniu-upload
- Repository: https://github.com/liuyunzhuge/simple-qiniu-upload
- Homepage: https://github.com/liuyunzhuge/simple-qiniu-upload#readme
- Issues: https://github.com/liuyunzhuge/simple-qiniu-upload/issues
- npm.io page: https://npm.io/package/simple-qiniu-upload

## Dependencies (5)

- [glob](https://npm.io/package/glob.md) ^7.1.6
- [chalk](https://npm.io/package/chalk.md) ^3.0.0
- [qiniu](https://npm.io/package/qiniu.md) ^7.2.2
- [dotenv](https://npm.io/package/dotenv.md) ^8.2.0
- [single-line-log](https://npm.io/package/single-line-log.md) ^1.1.2

## Recent versions

- 0.2.0 (latest) — 2020-01-17
- 0.1.9 — 2019-12-28
- 0.1.8 — 2019-12-27
- 0.1.7 — 2019-12-27
- 0.1.6 — 2019-12-27
- 0.1.5 — 2019-12-27
- 0.1.4 — 2019-12-27
- 0.1.3 — 2019-12-26
- 0.1.2 — 2019-12-26
- 0.1.1 — 2019-12-26
- 0.1.0 — 2019-12-26

## README

[![npm](https://img.shields.io/npm/dm/simple-qiniu-upload.svg)](https://www.npmjs.com/package/simple-qiniu-upload)
[![npm](https://img.shields.io/npm/v/simple-qiniu-upload.svg)](https://www.npmjs.com/package/simple-qiniu-upload)
[![npm](https://img.shields.io/npm/l/simple-qiniu-upload.svg)](https://www.npmjs.com/package/simple-qiniu-upload)

# simple-qiniu-upload
一个简单的工具，把静态资源发布到七牛的CDN空间。

因为想把vue项目的中的静态资源，通过vue-cli-service的命令发布到七牛的cdn，所以就先做这个工具。核心目标就是把一个文件夹内指定的文件集合，全部上传到七牛特定的某个存储空间，考虑到上传会有出错的情况，所以需要支持覆盖式上传，然后还要考虑对七牛相关的密钥进行保护处理；最后希望上传过程就是一个异步处理过程，在上传完毕时，能够看到一个整体的上传统计结果(成功多少个，失败多少个)，以及失败的明细情况。

## 用法

* 安装
    ```
    npm install simple-qiniu-uploda --save-dev
    ```

* 定义一个`.qiniu`配置文件
    ```
    accessKey=
    secretKey=
    ```    
    这个文件用来在本地定义七牛的AK和SK，最好加入到`.gitignore`，避免这样的信息传递到代码仓库。

* 编写上传任务
    
    编写一个`upload.js`：
    ```js
    const Uploader = require('./src/index')

    new Uploader({
        envFile: '.qiniu', //定义ak sk的本地配置文件名
        base: 'dist', // 定义上传的基准目录
        output: 'qiniu-upload.json', // 定义上传结束后导出上传明细的文件名
        glob: 'dist/**', // 定义要上传的文件集，glob格式
        globIgnore: [
            'dist/!(static)/**'
        ], // 定义哪些文件不上传，glob格式
        bucket: 'static', // 定义要上传到的七牛空间名
        overrides: false, // 是否覆盖
        parallelCount: 2, // 并行上传任务数
        zone: Uploader.zone.z0 // 定义七牛的zone，每个空间都属于不同的zone，需要提前指定这个
    }).start()
    ```
    然后运行：
    ```js
    node upload
    ```
    最后就会在控制台看到上传的进度和上传的结果：
    ```
    [simple-qiniu-upload] config:
    [simple-qiniu-upload]       cwd: D:\code\simple-qiniu-upload
    [simple-qiniu-upload]       envFile: .qiniu
    [simple-qiniu-upload]       base: dist
    [simple-qiniu-upload]       output: qiniu-upload.json
    [simple-qiniu-upload]       bucket: static
    [simple-qiniu-upload]       overrides: false
    [simple-qiniu-upload] total files: 5, uploading:0, success:5, fail:0
    ```
    
## options

* accessKey
    * `{String}`
    * `default`: `''`
    * `description`: 七牛的AK，推荐在`envFile`中配置，比较安全。但是在此处指定的AK优先级比`envFile`中的高，这样当你不想启用`envFile`的时候有用，比如把AK配置到vue的`.env`相关环境变量的文件中。

* secretKey
    * `{String}`
    * `default`: `''`
    * `description`: 七牛的SK，推荐在`envFile`中配置，比较安全。但是在此处指定的SK优先级比`envFile`中的高，这样当你不想启用`envFile`的时候有用，比如把SK配置到vue的`.env`相关环境变量的文件中。

* cwd
    * `{String}`
    * `default`: `process.cwd()`
    * `description`: 工作目录。内部一些文件和目录的位置，都是相对这个值去处理的。

* envFile
    * `{String|mixed}`
    * `default`: `.qiniu`
    * `description`: 环境变量的配置文件，可用来配置AK和SK。设置为falsy值时，将禁用环境变量配置的特性。

* glob
    * `{String}`
    * `default`: `dist/**`
    * `description`: 按照[node-glob](https://github.com/isaacs/node-glob)开发的`glob`格式的字符串，用来查找待上传的文件列表。默认值是`dist/**`，因为这个工具目标是给vue用的，所以默认值跟`vue`关联比较紧密。`dist/**`表示要上传的文件范围就是`dist/`目录下的所有文件，包含子孙目录。

* globIgnore
    * `{String|Array}`
    * `default`: `[
        'dist/!(static)/**'
    ]`
    * `description`: 按照[node-glob](https://github.com/isaacs/node-glob)开发的`glob`格式的字符串，用来排除不想上传的文件。也可以是一个数组，指定多个排除的`glob`串。建议自行配置。

* base
    * `{String}`
    * `default`: `dist`
    * `description`: 上传的基准目录。假如有一个文件`dist/static/js/app.js`，因为`base`是`dist`，所以这个文件将会按照`static/js/app.js`这个形式，作为七牛的key，进行上传。

* output:
    * `{String}`
    * `default`: `'qiniu-upload.json`
    * `description`: 指定上传结束后存储上传明细的导出文件。

* bucket:
    * `{String}`
    * `default`: `''`
    * `description`: 指定七牛的bucket。

* overrides:
    * `{Boolean}`
    * `default`: `false`
    * `description`: 指定是否进行覆盖上传。建议保留为false，因为根据七牛对于覆盖上传的说明，同名文件，只要etag相同，如果`overrides`配置为false，也能上传成功；但是`overrides`为false时，如果同名文件etag不同，则会导致上传失败，所以`overrides`对于文件有一定的保护作用。

* zone:
    * `{Uploader.zone}`
    * `default`: `Uploader.zone.z0`
    * `description`: 指定七牛的zone。 有`z0 z1 z2 na0`可选。

* parallelCount:
    * `{Number}`
    * `default`: `2`
    * `description`: 设置并行上传数。

## todo

* 按照前缀进行文件的批量删除

---
_Source: https://npm.io/package/simple-qiniu-upload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
