Stanislav N. aka pztrn
aeec85086e
All checks were successful
continuous-integration/drone/push Build is passing
|
||
---|---|---|
assets | ||
cmd/fastpastebin | ||
docker | ||
domains | ||
examples | ||
internal | ||
systemd | ||
.drone.yml | ||
.gitignore | ||
.gitlab-ci.yml | ||
.golangci.yml | ||
.markdownlint.json | ||
builder.sh | ||
CHANGELOG.md | ||
docker-compose.yml | ||
Dockerfile | ||
go.mod | ||
go.sum | ||
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!
Please, use my gitea for bug reporting. All other places are mirrors!
Also, join Matrix room for near-realtime chat. Also there is a mailing list if you prefer to ask asynchronously.
Current functionality
- Create and view public and private pastes.
- Syntax highlighting.
- Pastes expiration.
- Passwords for pastes.
- Multiple storage backends. Currently:
flatfiles
,mysql
andpostgresql
.
Caveats
- Not known at this moment.
Installation and updating
Just issue:
CGO_ENABLED=0 go install go.dev.pztrn.name/fastpastebin/cmd/fastpastebin@VERSION
Replace VERSION
with a tag of your choice.
This command can be used to update Fast Paste Bin.
Also Fast Paste Bin is dockerized, see here for instructions.
Compose file with resources limits, as used by me:
---
version: "2.4"
services:
fastpastebin:
restart: always
image: code.pztrn.name/apps/fastpastebin:0.4.1
volumes:
- "./fastpastebin.yaml:/app/fastpastebin.yaml"
ports:
- "25544:25544"
cpus: 2
mem_limit: 1G
memswap_limit: 0
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 FASTPASTEBIN_CONFIG
environment variable to specify path.
Developing
Branching, versions, etc
There is a develop
branch which represents current development state. All new commits (by me) and merge requests (by others) should go to that branch.
Branch master
represents "latest version" state and always stable.
Code
Use linters, formatters, etc. VSCode with Go plugin is recommended for developing as it will perform most of linting-formatting actions automagically.
Also, Sublime Text with LSP-gopls will also work just fine.
Try to follow Go's code review comments with few exceptions:
- 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.
- User CP.
- Files uploading.
- Passwords for files.
- Pastes forking and revisioning (like git or github gists).
- Possibility to copy-paste-edit WYSIWYG content.
- CLI client for pastes and files uploading.