2
2
Fork 0

Initial implementation.

This commit is contained in:
Solderpunk 2019-08-16 23:35:09 +03:00
parent e0733bff51
commit e52909723f
3 changed files with 258 additions and 3 deletions

View File

@ -1,4 +1,4 @@
Copyright (c) <year> <owner> . All rights reserved.
Copyright (c) 2019 solderpunk@sdf.org. All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

View File

@ -1,3 +1,20 @@
# gegobi
# GeGoBi
Gemini-Gopher bi-hosting tool
GeGoBi is a tool to facilitate easy Gemini-Gopher bi-hosting. You
point it at your pre-existing Gopherhole directory (/var/gopher by
default) and it will serve the same content, unchanged, via Gemini.
GeGoBi understands Gophernicus-style gophermap files, and will
translate them into Geminimaps. Links to non-gopher resources using
the h itemtype hack with "URL:" paths are translated correctly.
Directory listings will be generated for directories without gophermap
files.
Support for geomyidae-style .gph files is planned.
Run `gegobi.py --help` for usage. The only compulsory option is
`--host`, which tells GeGoBi the hostname of your server. Since
Gemini requests include a full URL, not just a path/selector, servers
need to know their own host to distinguish requests for their own
content from proxy requests (GeGoBi refuses any and all proxy
requests).

238
gegobi.py Executable file
View File

@ -0,0 +1,238 @@
#!/usr/bin/env python3
import argparse
import time
import mimetypes
import os
import shlex
import subprocess
import socket
import socketserver
import ssl
import tempfile
import urllib.parse
HOST = "localhost"
def _format_filesize(size):
if size < 1024:
return "{:5.1f} B".format(size)
elif size < 1024**2:
return "{:5.1f} KiB".format(size / 1024.0)
elif size < 1024**3:
return "{:5.1f} MiB".format(size / 1024.0**2)
class GegobiHandler(socketserver.BaseRequestHandler):
def __init__(self, *args, **kwargs):
socketserver.BaseRequestHandler.__init__(self, *args, **kwargs)
def setup(self):
"""
Wrap socket in SSL session.
"""
self.request = context.wrap_socket(self.request, server_side=True)
def handle(self):
# Parse request URL, make sure it's for a Gopher resource
self.parse_request()
if self.request_scheme != "gemini" or self.request_host not in ("localost", self.server.args.host):
self.send_gemini_header(50, "This server does not proxy requests.")
return
# Resolve path to filesystem
local_path = os.path.join(self.server.args.base, urllib.parse.unquote(self.request_path))
print(local_path)
# Handle not founds
if not os.path.exists(local_path):
self.send_gemini_header(51, "Not found.")
return
if ".." in local_path or local_path.endswith(".pem"):
self.send_gemini_header(51, "Not found.")
return
# Handle directories
if os.path.isdir(local_path):
gophermap = os.path.join(local_path, "gophermap")
if self.request_path and not self.request_path.endswith("/"):
# Redirect to add trailing slash so relative URLs work
self.send_gemini_header(31, self.request_url+"/")
elif os.path.exists(gophermap):
self.handle_gophermap(gophermap)
else:
self.generate_directory_listing(local_path)
# Handle files
else:
self.handle_file(local_path)
# Clean up
self.request.close()
def _send(self, string):
self.request.send(string.encode("UTF-8"))
def send_gemini_header(self, status, meta):
"""
Send a Gemini header, and close the connection if the status code does
not indicate success.
"""
self._send("{} {}\r\n".format(status, meta))
if status / 10 != 2:
self.request.close()
def parse_request(self):
"""
Read a URL from the Gemini client and parse it up into parts,
including separating out the Gopher item type.
"""
requested_url = self.request.recv(1024).decode("UTF-8").strip()
if "://" not in requested_url:
requested_url = "gemini://" + requested_url
self.request_url = requested_url
parsed = urllib.parse.urlparse(requested_url)
print(parsed)
self.request_scheme = parsed.scheme
self.request_host = parsed.hostname
self.request_port = parsed.port or 1965
self.request_path = parsed.path[1:] if parsed.path.startswith("/") else parsed.path
self.request_query = parsed.query
def handle_gophermap(self, filename):
"""
"""
self.send_gemini_header(20, "text/gemini")
with open(filename, "r") as fp:
for line in fp:
if "\t" in line:
itemtype = line[0]
parts = line[1:].strip().split("\t")
if itemtype == "i":
self._send(parts[0])
else:
if len(parts) == 2:
# Relative link to same server
name, link = parts
if itemtype == "h" and link.startswith("URL:"):
link = link[4:]
elif len(parts) == 4:
# External gopher link
name, path, host, port = parts
if port == "70":
netloc = host
else:
netloc = host + ":" + port
link = urllib.parse.urlunparse(("gopher", netloc, path, "", "", ""))
self._send("=> %s %s\r\n" % (link, name))
else:
self._send(line)
def generate_directory_listing(self, directory):
self.send_gemini_header(20, "text/gemini")
self._send("[/{}]\r\n".format(self.request_path))
self._send("\r\n")
if directory != BASE:
up = self._get_up_url()
self._send("=> %s %s\r\n" % (urllib.parse.quote(up), ".."))
for f in os.listdir(directory):
stat = os.stat(os.path.join(directory,f))
label = f.ljust(32)
label += time.ctime(stat.st_mtime).ljust(30)
label += _format_filesize(stat.st_size)
self._send("=> %s %s\r\n" % (urllib.parse.quote(f), label))
def _get_up_url(self):
# You'd think this would be simple...
path_to_split = "/" + self.request_path
if path_to_split.endswith("/"):
path_to_split = path_to_split[0:-1]
up, _ = os.path.split(path_to_split)
print(self.request_path, up)
return up
path_bits = list(os.path.split(self.request_path))
print(path_bits)
while not path_bits[-1]:
path_bits.pop()
print(path_bits)
path_bits.pop()
print(path_bits)
if not path_bits:
return "/"
else:
return os.path.join(*path_bits)
def gopher_link_to_gemini_link(self, line):
"""
Convert one line of a Gopher menu to one line of a Geminimap.
"""
# Code below pinched from VF-1
# Split on tabs. Strip final element after splitting,
# since if we split first we loose empty elements.
parts = line.split("\t")
parts[-1] = parts[-1].strip()
# Discard Gopher+ noise
if parts[-1] == "+":
parts = parts[:-1]
# Attempt to assign variables. This may fail.
# It's up to the caller to catch the Exception.
print(parts)
name, path, host, port = parts
itemtype = name[0]
name = name[1:]
port = int(port)
if itemtype == "h" and path.startswith("URL:"):
url = path[4:]
else:
url = "gopher://%s%s/%s%s" % (
host,
"" if port == 70 else ":%d" % port,
itemtype,
path
)
print(line, url)
return "=> {} {}\r\n".format(url, name)
def handle_file(self, filename):
"""
"""
# Detect MIME type
out = subprocess.check_output(
shlex.split("file --brief --mime-type %s" % filename)
)
mimetype = out.decode("UTF-8").strip()
self.send_gemini_header(20, mimetype)
with open(filename,"rb") as fp:
self.request.send(fp.read())
if __name__ == "__main__":
parser = argparse.ArgumentParser(description=
"""GeGoBi is a tool to easily serve existing Gopher content via the
Gemini protocol as well, resulting in "Gemini-Gopher bi-hosting"
(or "GeGoBi").""")
parser.add_argument('--base', type=str, nargs="?", default="/var/gopher",
help='Gopherhole base directory.')
parser.add_argument('--cert', type=str, nargs="?", default="cert.pem",
help='TLS certificate file.')
parser.add_argument('--host', type=str,
help='Hostname of Gemini server.')
parser.add_argument('--key', type=str, nargs="?", default="key.pem",
help='TLS private key file.')
parser.add_argument('--local', action="store_true",
help='Serve only on 127.0.0.1.')
parser.add_argument('--port', type=int, nargs="?", default=1965,
help='TCP port to serve on.')
args = parser.parse_args()
print(args)
context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
context.load_cert_chain(certfile=args.cert, keyfile=args.key)
socketserver.ThreadingTCPServer.allow_reuse_address = 1
gegobi = socketserver.ThreadingTCPServer(("localhost" if args.local else "",
args.port), GegobiHandler)
gegobi.args = args
try:
gegobi.serve_forever()
except KeyboardInterrupt:
gegobi.shutdown()
gegobi.server_close()