api | ||
assets | ||
captcha | ||
cmd/fastpastebin | ||
config | ||
context | ||
database | ||
examples | ||
pagination | ||
pastes | ||
vendor | ||
.gitignore | ||
fileb0x.yml | ||
Gopkg.lock | ||
Gopkg.toml | ||
LICENSE | ||
README.md |
Fast Pastebin
Easy-to-use-and-install pastebin software written in Go. No bells or whistles, no websockets and even NO JAVASCRIPT!(*)
(*) Except fontawesome, because it's awesome :).
Current functionality.
- Paste text.
- View pastes.
- Syntax highlighting.
Caveats.
- No links at lines numbers. See https://github.com/alecthomas/chroma/issues/132
Installation and updating
Just issue:
go get -u -v github.com/pztrn/fastpastebin/cmd/fastpastebin
This command can be used to update Fast Paste Bin.
Configuration.
Take a look at example configuration file which contains all supported options and their descriptions.
Configuration file position is irrelevant, there is no hardcoded paths where
Fast Paste Bin looking for it's configuration. Use -config
CLI parameter
or FASTPASTEBIN_CONFIG
environment variable to specify path.
Developing
Developers should install https://github.com/UnnoTed/fileb0x/ which is used as replacement to go-bindata for embedding assets into binary. After changing assets they should be recompiled into Go code. At repository root execute this command and you'll be fine:
fileb0x fileb0x.yml
Also if you're changed list of assets (by creating or deleting them) be sure
to fix files list if fileb0x.yml
file!
The rest is default - use linters, formatters, etc. VSCode with Go plugin is recommended for developing as it will perform most of linting-formatting actions automagically. Try to follow https://github.com/golang/go/wiki/CodeReviewComments with few exceptions:
-
Imports should be organized in 3 groups: stdlib, local, other. See https://github.com/pztrn/fastpastebin/blob/master/pastes/api_http.go for example.
-
We're not forcing any limits on line length for code, only for comments, they should be 72-76 chars long.
ToDo
This is a ToDo list which isn't sorted by any parameter at all. Just a list of tasks you can help with.
- Pastes expiration. It saves time to database but isn't blocking access.
- User CP.
- Files uploading.
- Passwords for pastes and files.
- Pastes forking and revisioning (like git or github gists).
- Possibility to copy-paste-edit WISYWIG content.
- CLI client for pastes and files uploading.