gopher
gopher.cr 
An implementation of RFC 1437, the Gopher protocol.
This repository is 2 things:
- A library that implements the Gopher protocol
- An example server that serves Gopher requests
Gopher Protocol
The Gopher protocol consists of 2 phases: request & response.
Like its relative HTTP, clients makes a request for a URI to the server, and the server responds. Unlike HTTP, however, there are no headers, caching, MIME response types, keepalives, etc. This makes the protocol both simpler and less featureful.
Requests
A request to a gopher:// server consists of a single line, containing a URI (called a selector):
/1stuff/1and/1nonsense/0intro.txt\r\n
the server then resolves that request into a response, and renders it back to the client.
Responses
A Response can be one of 3 things:
- a menu of further choices a user can make
- a resource (a file, or a another server)
- an error
A copy of the RFC that describes the protocol is included in this repo
Using this library
To use this library, you need to:
- Create a
Serverobject - Provide it with
Resolver(s) that instruct it how to find content - Tell the server to listen for requests!
A good example for how this can be done exists in src/example.cr
If you're looking for a more turnkey solution, check out its sister project Port70.
Development
Testing on the application is built using the excellent minitest.cr.
Run tests with crystal spec.
gopher: github: anicholson/gopher.cr version: ~> 0.1.0
Authors
Dependencies 1
-
result
~> 0.3
{'github' => 'anicholson/result.cr', 'version' => '~> 0.3'}
Development Dependencies 1
-
minitest
~> 0.4.2
{'github' => 'ysbaddaden/minitest.cr', 'version' => '~> 0.4.2'}