4 releases
0.2.1 | Nov 9, 2021 |
---|---|
0.2.0 | Oct 17, 2021 |
0.1.1 | Oct 11, 2021 |
0.1.0 | Oct 6, 2021 |
#26 in #gemini
71KB
1K
SLoC
gmi
gmi
(pronounced as "Jee Mee" or however you'd like) is a simple to use, lightweight Rust library for interfacing with the Gemini protocol as a client. It was created out of frustration with exsisting libraries bringing in multiple other dependencies that I personally saw as unnecessary. It is NOT meant to be used as a library to run as a server.
This library is split into three main parts:
gemtext
: A Gemtext parserprotocol
: A collection of the various data structures that are used by the gemini protocol.request
: A module for actually making requests to gemini servers. This can be disabled by disabling the feature flagnet
.url
: A simple implementation of a subset of the URL RFC implementing only what is needed by Gemini.
Focuses
- Lightweight
- Small external dependencies
- Simple interface
Features:
- Gemini TLS support
- Gemini Response parsing
- Gemtext parsing
- Client certificates
- Trust On First Use (TOFU)
- Mercury support
Simple Example:
use gmi::url::Url;
use gmi::request;
fn main() {
let url = Url::from_str("gemini://gemini.circumlunar.space").unwrap();
let resp = request::make_request(&url).unwrap();
println!("{}", string::from_utf8_lossy(&resp.data));
}
Alternatives
gemini
is a bit of a heavier, but more feature complete library for interfacing with the Gemini protocol. It can be used for both a server and a client, unlike gmi
which can only be used as a client (for now (; )
Dependencies
~0–9.5MB
~99K SLoC