📦 rain - 超快下载 http 资源

Release

rain 一款 golang 包，可以让你快速实现 http 协议的资源下载，为此 rain 拥有一些方便的特性，比如：多协程、断点续传、自动重命名、限速等。

🚀 安装

使用 go get 安装 rain

go get -u github.com/rock-rabbit/rain

✨ 特性

  • 多协程分块下载
  • 断点下载
  • 限速下载
  • 文件自动重命名
  • 文件名非法字符过滤
  • 磁盘缓冲区
  • 下载进度和状态监听
  • 可自定义的命令行进度条
  • 运行时修改配置
  • 非阻塞下载

当前测试覆盖： coverage: 81.2% of statements

🛠️ 使用方法

简单使用方法

package main

import (
    "fmt"
    "github.com/rock-rabbit/rain"
)

func main() {
    uri := "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4"
    ctl, err := rain.New(uri, rain.WithOutdir("./tmp"), rain.WithBar()).Run()
    if err != nil {
        panic(err)
    }
    fmt.Printf("下载完成：%s\n", ctl.Outpath())
}

监听下载

type EventExtend struct{}

// Change 下载进度
func (ee *EventExtend) Change(stat *rain.EventExtend) {
    fmt.Println("change", stat.Progress)
}

// Error 错误
func (ee *EventExtend) Error(stat *rain.EventExtend) {
    fmt.Println("error", stat.Error)
}

// Close 执行 Close
func (ee *EventExtend) Close(stat *rain.EventExtend) {
    fmt.Println("close")
}

// Finish 成功下载
func (ee *EventExtend) Finish(stat *rain.EventExtend) {
    fmt.Println("finish", stat.Progress)
}

var _ rain.ProgressEventExtend = &EventExtend{}

func main() {
    uri := "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4"
    ctl, err := rain.New(uri, rain.WithEventExtend(&EventExtend{})).Run()
    if err != nil {
        panic(err)
    }
    fmt.Printf("下载完成：%s\n", ctl.Outpath())
}

非阻塞下载

func main() {
    uri := "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4"
    ctl, err := rain.New(uri, rain.WithOutdir("./tmp"), rain.WithBar()).Start()
    if err != nil {
        panic(err)
    }

    // ... 其他逻辑

    _, err = ctl.Run()
    if err != nil {
        panic(err)
    }
    fmt.Printf("下载完成：%s\n", ctl.Outpath())
}

暂停下载

func main() {
    uri := "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4"
    ctl, err := rain.New(uri, rain.WithOutdir("./tmp"), rain.WithBar()).Start()
    if err != nil {
        panic(err)
    }

    go func() {
        time.Sleep(time.Second * 2)
        // 暂停下载
        ctl.Close()
    }()

    err = ctl.Wait()
    if err != nil {
        panic(err)
    }

    // 继续下载
    _, err = ctl.Run()
    if err != nil {
        panic(err)
    }

    fmt.Printf("下载完成：%s\n", ctl.Outpath())
}

…
有很多参数可以自行去查看使用。

🎨 项目

以下项目使用到了 rain :