#gemini #protocols #smolnet

gmi

A rust library to use the gemini protocol with an aim to be lightweight

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

#30 in #gemini

LGPL-3.0-or-later

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 parser
  • protocol: 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 flag net.
  • 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
~103K SLoC