gload

A command line client for the Gemini protocol, inspired by cURL by Daniel Stenberg et al, and gemget by makeworld. => gemini://geminiprotocol.net/ Gemini protocol => https://curl.se/ cURL => https://github.com/makew0rld/gemget makew0rld/gemget

Note: This project is a stopgap until Gemini support can be merged into the cURL project properly. Once cURL has support, it is recommended to use that instead of this project for important tasks.

Install

This crate is available as a CLI binary and a library crate on both crates.io and our own package registry. Add it to your project like so:

To use gload CLI:

# via crates.io
cargo install gload

# via git.avg.name
cargo install --index sparse+https://git.average.name/api/packages/AverageHelper/cargo/ gload

# from source
cargo install --path .

=> https://www.rust-lang.org/tools/install Be sure to install cargo

On Atomic Fedora flavors, you may need to append --root /var/home/username/.cargo

To use gload as a library:

# via crates.io
cargo add gload

# or via git.avg.name
cargo add --index sparse+https://git.average.name/api/packages/AverageHelper/cargo/ gload

Note: crates.io does not allow packages to be published with dependencies on code published outside of crates.io. Only use our package registry if you intend to self-publish. => https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#specifying-dependencies-from-other-registriesSee The Cargo Book for details.

Usage

# Request a webpage
gload gemini://example.com

# Print the response header as well as the response body
gload -i gemini://example.com

# Print ONLY the response header
gload -I gemini://example.com

# Follow up to five redirects
gload -L gemini://example.com

# Follow up to three redirects
gload -L --max-redirs 3 gemini://example.com

# Error if there are any redirects
gload -L --max-redirs 0 gemini://example.com

# Error on code 40 or higher
gload -f gemini://example.com

# Save to a file
gload gemini://example.com -o file.gmi

For more information use gload --help.

Contributing

=> https://git.average.name/AverageHelper/gload/issues/new Contributions are welcome in the form of Pull Requests and Issues!

This software is licensed under the BSD-3-Clause license. See the LICENSE file for more details.