aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7800c2f2a9107ad2ae0db7be7e649e98582e9f46 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
# go-gemini

`go-gemini` implements the [Gemini protocol](https://gemini.circumlunar.space) in
Go.

It aims to provide an interface similar to that of `net/http` to make it easy
to develop Gemini clients and servers.

## Usage

First generate TLS keys for your server to use.

```sh
openssl genrsa -out server.key 2048
openssl ecparam -genkey -name secp384r1 -out server.key
openssl req -new -x509 -sha256 -key server.key -out server.crt -days 3650
```

Next, import and use `go-gemini`. Here is a simple server:

```go
import (
	"git.sr.ht/~adnano/go-gemini"
)

func main() {
	config := &tls.Config{}
	cert, err := tls.LoadX509KeyPair("server.crt", "server.key")
	if err != nil {
		log.Fatal(err)
	}
	config.Certificates = append(config.Certificates, cert)

	mux := &gemini.Mux{}
	mux.HandleFunc("/", func(url *url.URL) *gemini.Response {
		return &gemini.Response{
			Status: gemini.StatusSuccess,
			Meta:   "text/gemini",
			Body:   []byte("You requested " + url.String()),
		}
	})

	server := gemini.Server{
		TLSConfig: config,
		Handler:   mux,
	}
	server.ListenAndServe()
}
```

And a simple client:

```go
import (
	"git.sr.ht/~adnano/go-gemini"
)

var client gemini.Client

func makeRequest(url string) {
	resp, err := client.Get(url)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("Status code:", resp.Status)
	fmt.Println("Meta:", resp.Meta)

	switch resp.Status / 10 {
	case gemini.StatusClassInput:
		scanner := bufio.NewScanner(os.Stdin)
		fmt.Printf("%s: ", resp.Meta)
		scanner.Scan()
		query := scanner.Text()
		makeRequest(url + "?" + query)
		return
	case gemini.StatusClassSuccess:
		fmt.Print("Body:\n", string(resp.Body))
	case gemini.StatusClassRedirect:
		log.Print("Redirecting to ", resp.Meta)
		makeRequest(resp.Meta)
		return
	case gemini.StatusClassTemporaryFailure:
		log.Fatal("Temporary failure")
	case gemini.StatusClassPermanentFailure:
		log.Fatal("Permanent failure")
	case gemini.StatusClassClientCertificateRequired:
		log.Fatal("Client certificate required")
	default:
		log.Fatal("Protocol error: invalid status code")
	}
}

func main() {
	if len(os.Args) < 2 {
		log.Fatalf("usage: %s gemini://...", os.Args[0])
	}
	makeRequest(os.Args[1])
}
```