fastpastebin/README.md
Stanislav N. aka pztrn 5fc6d3a181
Some checks failed
continuous-integration/drone/push Build is failing
Application superstructure (or supersingleton, if you want).
Got rid of context thing which misleads due to existance of stdlib's
context package.

Also fixed golangci-lint configuration.

Fixes #20.
2022-08-19 21:52:49 +05:00

2.8 KiB

Fast Pastebin

Build Status

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.

Current functionality

  • Create and view public and private pastes.
  • Syntax highlighting.
  • Pastes expiration.
  • Passwords for pastes.
  • Multiple storage backends. Currently: flatfiles, mysql and postgresql.

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.