Emi/kochab
Emi/kochab
1
1
Fork 0
Code Issues Pull requests Releases Activity
An ergonomic and elegant framework for creating Gemini servers and SCGI apps without needless bloat
204 commits 3 branches 0 tags 408 KiB
Rust 100%
Go to file
Emi Tatsuo d8d15d8f72
Add tolerance for REMOTE_ADDR without a port
2020-12-03 08:32:06 -05:00
examples Fix ratelimiting example 2020-12-01 17:13:54 -05:00
public Rebrand as kochab 2020-11-25 00:42:09 -05:00
src Add tolerance for REMOTE_ADDR without a port 2020-12-03 08:32:06 -05:00
.gemgit Add .gemgit 2020-12-03 04:35:20 -05:00
.gitignore Added ./data to .gitignore 2020-12-01 15:15:30 -05:00
Cargo.toml Support base64 encoded certificate hashes, remove ring as mandatory dep for scgi_srv 2020-12-03 08:10:50 -05:00
CHANGELOG.md Rebrand as kochab 2020-11-25 00:42:09 -05:00
LICENSE.md Add licenses 2020-11-25 00:53:34 -05:00
LICENSE_NORTHSTAR.md Add licenses 2020-11-25 00:53:34 -05:00
molly-brown.conf Completely reworked request handling to be able to serve SCGI 2020-12-01 02:31:08 -05:00
README.md Fix branch name in README example 2020-12-02 19:18:22 -05:00

README.md 

      *.          ,.-*,,..
    .`  `.   .,-'`       ````--*,,,..
  .`      ;*`                       ```''-o
 *      ,' __              __          __
  `.  ,'  / /______  _____/ /_  ____ _/ /_
    ⭐   / //_/ __ \/ ___/ __ \/ __ `/ __ \
        / ,< / /_/ / /__/ / / / /_/ / /_/ /
       /_/|_|\____/\___/_/ /_/\__,_/_.___/

kochab

Kochab is an extension & a fork of the Gemini SDK northstar. Where northstar creates an efficient and flexible foundation for Gemini projects, kochab seeks to be as ergonomic and intuitive as possible, making it possible to get straight into getting your ideas into geminispace, with no worrying about needing to build the tools to get there.

Usage

It is currently only possible to use kochab through it's git repo, although it may wind up on crates.rs someday.

kochab = { git = "https://gitlab.com/Alch_Emi/kochab.git", branch = "stable" }

Generating a key & certificate

By default, kochab enables the certgen feature, which will automatically generate a certificate for you. All you need to do is run the program once and follow the prompts printed to stdout. You can override this behavior by disabling the feature, or by using the methods in the Builder.

If you want to generate a certificate manually, it's recommended that you temporarily enable the certgen feature to do it, and then disable it once you're done, although you can also use the openssl client tool if you wish