README
¶
go-resumable
It's a Go library providing multiple simultaneous and resumable uploads.
Library is designed to introduce fault-tolerance into the upload of large files throught HTTP. This is done by splitting each file into small chunks; whenever the upload of a chunk fails, uploading is retried until the procedure completes. This allows uploads to automatically resume uploading after a network connection is lost either locally or to the server. Additionally, it allows users to pause, resume and even recover uploads without losing state.
Demo
In this demo upload is paused for 2 seconds after initial second, then it uploads till 100%.
Please check here for full code sample.
Installation
$ go get -v https://github.com/bleenco/go-resumable
Usage
import (
"net/http"
"github.com/bleenco/go-resumable"
)
func main() {
httpClient := &http.Client{}
url := "http://example.com/upload"
filePath := "/path/to/file/to/upload.zip"
chunkSize := int(1 * (1 << 20)) // 1MB
client := resumable.New(url, filePath, httpClient, chunkSize)
client.Init()
client.Start()
resumable.WG.Wait() // this is important
}
Licence
MIT
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var DefaultWG sync.WaitGroup
WG exports wait group, so we can wait for it
var FileStorage = fileStorage{
Path: "./files",
TempPath: ".tmp",
}
FileStorage settings. When finished uploading with success files are stored inside Path config. While uploading temporary files are stored inside TempPath directory.
Functions ¶
func HTTPHandler ¶
func HTTPHandler(w http.ResponseWriter, r *http.Request)
HTTPHandler is main request/response handler for HTTP server.
Types ¶
type CalculateTransferredSize ¶
type CalculateTransferredSize func(body string, partSize int, status UploadStatus) (int64, error)
type Resumable ¶
type Resumable struct {
Status UploadStatus
// contains filtered or unexported fields
}
Resumable structure
Source Files
Directories