Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pgollangi/fastget
⚡ A CLI tool and Go library to ultra fast download files over HTTP(S)
https://github.com/pgollangi/fastget
cli command-line commnad fastget go go-library golang
Last synced: 2 months ago
JSON representation
⚡ A CLI tool and Go library to ultra fast download files over HTTP(S)
- Host: GitHub
- URL: https://github.com/pgollangi/fastget
- Owner: pgollangi
- License: mit
- Created: 2020-08-21T17:30:28.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-21T17:20:15.000Z (10 months ago)
- Last Synced: 2024-08-03T23:30:38.945Z (5 months ago)
- Topics: cli, command-line, commnad, fastget, go, go-library, golang
- Language: Go
- Homepage: https://pgollangi.github.io/fastget
- Size: 3.81 MB
- Stars: 43
- Watchers: 4
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-golang-repositories - fastget
README
[](https://goreportcard.com/report/github.com/pgollangi/fastget)
[](https://pkg.go.dev/github.com/pgollangi/fastget)
[](https://codeclimate.com/github/pgollangi/fastget/maintainability)
[](https://codeclimate.com/github/pgollangi/fastget/trends/technical_debt)
# FastGet
A CLI tool as well as go library to ultrafast download files over HTTP(s).
> DISCLAIMER: FastGet performance heavily reliant on the network and CPU performance of the client machine. More importantly HTTP(s) endpoint must allow partial requests presenting `Accept-Ranges` and accepting `Range` headers.
## Demo
## Usage
`fastget` available as Commnad-Line tool and Go library.
### Commnad-Line
```sh
fastget [options]
```
#### Examples
```sh
$ fastget http://speedtest.tele2.net/10MB.zip
Download started..
3.50 MB / 3.50 MB 100 % [===========================================================================| 0s ] 267.59 KB/s
3.50 MB / 3.50 MB 100 % [===========================================================================| 0s ] 165.65 KB/s
3.50 MB / 3.50 MB 100 % [===========================================================================| 0s ] 116.10 KB/s
Download finished in 3s. File: E:\10MB.zip
```
Read the [documentation](https://pgollangi.github.io/fastget) for more information on the CLI usage.
### Go Library
Here is a simple example that finds fastest hosts:
```go
fg, err := fastget.NewFastGetter("http://speedtest.tele2.net/10MB.zip")
if err != nil {
panic(err)
}
result, err := fg.Get()
if err != nil {
panic(err)
}
file := result.OutputFile
elapsedTime := result.ElapsedTime
```
Read the [API documentation](https://pkg.go.dev/github.com/pgollangi/fastget) for more information on the library usage.
## Installation
Download suitable binary for your OS at the [releases page](https://github.com/pgollangi/fastget/releases/latest).
### Bash Install
You can install or update `fastget` with:
```
curl -s https://raw.githubusercontent.com/pgollangi/fastget/master/scripts/install.sh | sudo bash
```
Installs into `/usr/local/bin`
### Scoop
```sh
scoop bucket add pgollangi-bucket https://github.com/pgollangi/scoop-bucket.git
scoop install fastget
```
Updating:
```
scoop update fastget
```
### Homebrew
```sh
brew install pgollangi/tap/fastget
```
Updating:
```
brew upgrade fastget
```
### Go
```sh
$ go get github.com/pgollangi/fastget/cmd/fastget
$ fastget
```
### Manual
1. Download and install binary from the [latest release](https://github.com/pgollangi/fastget/releases/latest).
2. Recommended: add `fastget` executable to your $PATH.
## Building from source
`fastget` CLI is written in the [Go programming language](https://golang.org/), so to build the CLI yourself, you first need to have Go installed and configured on your machine.
### Install Go
To download and install `Go`, please refer to the [Go documentation](https://golang.org/doc/install). Please download `Go 1.14.x` or above.
### Clone this repository
```sh
$ git clone https://gitlab.com/pgollangi/fastget.git
$ cd fastget
```
### Build
```sh
$ go build cmd/fastget/main.go
$ fastget
```
## Contributing
Thanks for considering contributing to this project!
Please read the [Contributions](.github/CONTRIBUTING.md) and [Code of conduct](.github/CODE_OF_CONDUCT.md).
Feel free to open an issue or submit a pull request!
## License
Copyright © [Prasanna Kumar](https://pgollangi.github.io/)
`fastget` is open-sourced software licensed under the [MIT](LICENSE) license.
## Author
Built with ❤ by [Prasanna Kumar](https://pgollangi.github.io/tabs/about/)