ggemini

Glib/Gio-oriented network API for Gemini protocol

Important

Project in development!

GGemini (or G-Gemini) library written as the client extension for Yoda, it also could be useful for other GTK-based applications dependent of glib / gio (2.66+) backend.

Requirements

Debian

sudo apt install libglib2.0-dev

Fedora

sudo dnf install glib2-devel

Install

cargo add ggemini

Usage

• Documentation

Example

use gio::*;
use glib::*;

use ggemini::client::{
    connection::{request::{Mode, Request}, Response},
    Client,
};

fn main() -> ExitCode {
    Client::new().request_async(
        Request::Gemini { // or `Request::Titan`
            uri: Uri::parse("gemini://geminiprotocol.net/", UriFlags::NONE).unwrap(),
            mode: Mode::HeaderOnly // handle content separately (based on MIME)
        },
        Priority::DEFAULT,
        Cancellable::new(),
        None, // optional `GTlsCertificate`
        |result| match result {
            Ok((response, _connection)) => match response {
                Response::Success(success) => match success {
                    Success::Default(default) => match default.header.mime().unwrap().as_str() {
                        "text/gemini" => todo!(),
                        _ => todo!(),
                    }
                },
                _ => todo!(),
            },
            Err(_) => todo!(),
        },
    );
    ExitCode::SUCCESS
}

Other crates

• ggemtext - Glib-oriented Gemtext API