go-gemini is a library that provides an easy interface to create client and servers that speak the Gemini protocol.
Spec version supported: v0.14.3, November 29th 2020
This version of the library was forked from ~yotam/go-gemini to add additional features, as well as update it to support newer specs. At the time of forking, it had not seen any new commit for 5 months, and was based on v0.9.2. If there are any future upstream updates, I will make an effort to include them.
The server part of this library has been removed. I don't use it and don't want to maintain it.
This is mostly a personal library. You might want to check out go-gemini (no relation) for more features.
This fork of the library improves on the original in several ways, some listed above already.
- Client supports self-signed certs sent by the server, but still has other checks like expiry date and hostname
- The original library could only work with self-signed certs by disabling all security.
- Invalid status code numbers raise an error
- Set default port and scheme for client requests
- Raise error when META strings are too long in the response header
- Supports new status code updates
- If
SSLKEYLOGFILEis set, session keys are written to the file in NSS format. This is useful for debugging TLS connections (but breaks security, so don't use unless necessary). - Support proxies
- Support client certs
- Add connection/header timeouts, and read timeouts
- Add proxy functionality
- And more!
This library only works with Go 1.12 and higher.
If you want relatively reliable code, use the latest tag, not the latest commit. Code in the latest master might be untested/buggy. The API might change between tags since it is still v0.
This library is under the ISC License, see the LICENSE file for details. Portions of this library's code are taken from Go, and are under a different license, which can be found in LICENSE-GO. Those files are marked accordingly in their comments.