deppa

command module
v0.0.0-...-16ab6cc Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 12, 2021 License: AGPL-3.0 Imports: 13 Imported by: 0

README

deppa
-----

deppa (出っ歯), jap. "bucktooth"
is a server implementation of the gopher protocol.
it is very lightweight and can handle a lot of traffic on low-end hardware (1-4MiB RAM Usage, almost no CPU time!).

you can even run it on a Raspberry Pi Zero and it can handle a TON of traffic, although you should consider more powerful hardware when serving more than ~12k concurrent active users.

it converts markdown files in a directory to gopher responses on-the-fly.

.md will be served as directory listings, .txt will be served as plaintext (NOTE: please use DOS line endings, deppa will not convert anything!).
trailing slash is interpreted as directory listing and generated on-the-fly (or index.ext, if present).
gobj files should be executable, if they are, they will be executed and their output will be sent to the client (use format "text file" because deppa will not add any types to the output. if your program does tho, you can use any type you want to)
gm files are just plain old gophermap files.
other extensions will be piped to the sender but without a ".\r\n" at the end, so use it for binary files (or just put the dot at the end yourself :) )

links and images must be on single lines or else they will be ignored and sent as plain text.

magic strings follow the file system hierachy, leading slash is ignored and use of .. sends an error.
magic files: .reverse will reverse your directory listings, index.extension will replace any directory listings, .header will be sent before any content in this directory, .footer will be sent after any content in the directory
.header and .footer must be in plain text format

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL