1 I’d like to announce ‘com.omarpolo/gemini’: a new clojure library to make Gemini requests.
2 
3 => https://github.com/omar-polo/gemini com.omarpolo/gemini: A Clojure library to make Gemini requests
4 
5 It’s also available on clojars, so go download it! :D
6 
7 ## background
8 
9 I needed something to ping antenna when I publish things on this blog.  The site is assembled using some clojure scripts (not the most idiomatic clojure you’d read, but it works) and I’m already shelling out to rsync for the upload.  To ping antenna I wanted to do something natively.
10 
11 Gemini is a simple protocol, isn’t it?  Writing something from scratch should be simple, right?
12 
13 ## the making of
14 
15 It wasn’t simple, at least for me.  I kinda get sleepy when I have to dig into the Java stdlib to learn how to do things.  And I don’t know how to do networking at all in java, so there was a lot that I needed to learn.
16 
17 I ended up writing a Java class, not because it’s required but because it’s easier.  It exposes a really simple and barebone APIs to make Gemini requests and then wrote a more idiomatic (I hope) clojure wrapper around.
18 
19 Speaking of Java, disabling the certificate validation wasn’t exactly straightforward (you need to provide your own X509ExtendedTrustManager) and quite surprisingly it doesn’t do SNI by default.
20 
21 The magic spell to force a SSLSocket to do SNI is to
22 
23 ```
24 var params = new SSLParameters();
25 params.setServerNames(Collections.singletonList(new SNIHostName(host)))
26 
27 /* … */
28 
29 var socket = …;
30 socket.setSSLParameters(params);
31 ```
32 
33 I was able to contribute back the same trick to jgemini, a Java graphical Gemini browser.
34 
35 => https://github.com/kevinboone/jgemini jgemini: A Java-based graphical browser for the Gemini protocol
36 
37 
38 ## The API
39 
40 The main function is ‘fetch’.  It takes a map and return a map.  So clojure-ish.
41 
42 The feature list is pretty short honestly:
43 
44 * can use a gemini server as proxy
45 * can follow redirects
46 
47 and there’s a major drawback: the ‘close’ function must be called to clean things up.  There’s a ‘with-request’ macro (similar to ‘with-open’) that should help.
48 
49 It’s easy to stream a request since I’m exporting the BufferedReader to clojure clients, you can just read from it.  In combo with my gemtext library, it’s possible to stream text/gemini!
50 
51 => https://github.com/omar-polo/gemtext  com.omarpolo/gemtext: text/gemini for clojure/clojurescript
52 
53 
54 ## The future
55 
56 Gemini is simple, so there isn’t very much more to do.  I planning to provide a function to control the certificates, so that one can implement TOFU on top of this library, but that’s that.
57 
58 I’m still not completely happy of the provided APIs, but they doesn’t seem too bad and I don’t have a clue on how to improve them.  I’m open to suggestions thought ;)