Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wantguns/bin
highly opinionated, minimal pastebin
https://github.com/wantguns/bin
file-upload pastebin rocket rust self-hosted
Last synced: 30 days ago
JSON representation
highly opinionated, minimal pastebin
- Host: GitHub
- URL: https://github.com/wantguns/bin
- Owner: wantguns
- License: lgpl-3.0
- Created: 2020-12-29T23:01:40.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-09T16:09:36.000Z (7 months ago)
- Last Synced: 2024-09-26T07:21:42.638Z (about 1 month ago)
- Topics: file-upload, pastebin, rocket, rust, self-hosted
- Language: Rust
- Homepage: https://basedbin.fly.dev
- Size: 8.91 MB
- Stars: 210
- Watchers: 4
- Forks: 20
- Open Issues: 14
-
Metadata Files:
- Readme: readme.md
- License: copying
Awesome Lists containing this project
- awesome-starred - wantguns/bin - highly opinionated, minimal pastebin (self-hosted)
README
# Bin
A minimal pastebin which also accepts binary files like Images, PDFs and ships
multiple clients.It does not require you to host a SQL server and everything is self-contained in
a statically linked binary (the docker image runs on scratch !), which makes it
extremely easy to deploy.Try it out on: https://basedbin.fly.dev
## Clients
### Web
You can paste
- Normal Text
- Paste Images from clipboard:
![clipboard-paste](.github/files/image_clipboard.gif)- Files by drag and drop:
![drag_n_drop](.github/files/drag_n_drop.gif)### CLI
[![cli-usage](https://asciinema.org/a/khcEtveMAbjqJccySdmWuPe1l.svg)](https://asciinema.org/a/khcEtveMAbjqJccySdmWuPe1l)
#### Installation
Get the client from [this repository](contrib/cli/client) or from my deployed paste:
```bash
curl -o pst https://bin.wantguns.dev/client
chmod +x pst
```or manually copy the following at a file in your path.
```bash
#!/bin/bash# Change the url accordingly
URL="https://basedbin.fly.dev"FILEPATH="$1"
FILENAME=$(basename -- "$FILEPATH")
EXTENSION="${FILENAME##*.}"RESPONSE=$(curl --data-binary @${FILEPATH:-/dev/stdin} --url $URL)
PASTELINK="$URL$RESPONSE"[ -z "$EXTENSION" ] && \
echo "$PASTELINK" || \
echo "$PASTELINK.$EXTENSION"
```You have the option to remove the `/client` description / help in the
landing page. To show the `/client` description, run the `bin` binary
with either `BIN_CLIENT_DESC` env variable or a `-c` flag. More on
arguments later#### Usage
It just works.
```bash
$ pst somefile.txt
$ cat someimage.png | pst
```### (Neo)Vim
#### Installation
1. Install the CLI client
2. Append this to your init.vim / vimrc```vim
nnoremap p :!pst %
```
#### UsageUse ` + p` paste.
## Server Deployment
Currently, builds for the following target triples are shipped:
- x86_64-unknown-linux-gnu (amd64)
- aarch64-unknown-linux-gnu (arm64)The builds shipped are statically linked, so you don't even need a libc to run
the binary !
The docker manifest labelled
[`wantguns/bin:latest`](https://hub.docker.com/layers/wantguns/bin/latest/images/sha256-34c19b59d098bd1420fc48f6b1f01dc250d3d8787a3786f5425efb4e74cc17f2?context=repo)
includes the images for both amd64 and arm64 images.### Docker
```bash
$ docker run -p 6162:6162 wantguns/bin
```### Docker Compose
```yaml
version: '3.3'
services:
pastebin:
image: wantguns/bin
container_name: pastebin
ports:
- 127.0.0.1:6163:6163
environment:
- BIN_PORT=6163 # Defaults to 6162
- BIN_LIMITS={form="16 MiB"}
- BIN_CLIENT_DESC=placeholder
volumes:
- ./upload:/upload # upload folder will have your pastes
```### Manual
- Grab a copy of the binary from GH releases
OR
- Build on your own:
```bash
# A statically linked build
$ cargo build --release
```- Execute the binary as is, no extra shenanigans needed:
```bash
$ ./bin
```#### Usage
```txt
USAGE:
bin [OPTIONS]OPTIONS:
-a, --address
Address on which the webserver runs [default: 127.0.0.1]-b, --binary-upload-limit
Binary uploads file size limit (in MiB) [default: 100]-c, --client-desc
Include client description [env: CLIENT_DESC=]-h, --help
Print help information-p, --port
Port on which the webserver runs [default: 6162]-u, --upload
Path to the uploads folder [default: ./upload]-V, --version
Print version information
```#### Configuration
This pastebin utilizes a custom configuration provider from Rocket. Apart from
the essential arguments, you can also use environment variables, which have the
highest preference in order.Everything from the [official Rocket
doc](https://rocket.rs/v0.5/guide/configuration/#overview) is supported,
just that you have to prefix the env variable with "BIN_":
```txt
BIN_PORT=6163
BIN_ADDRESS=0.0.0.0
BIN_LIMITS={form="16 MiB"}
BIN_WORKERS=8
BIN_IDENT=false
...
```## API
`GET /`
Get raw pastes`GET /p/`
Get highlighted pastes`GET /p/. `
Get syntax highlighted pastes.
E.g. https://basedbin.fly.dev/p/foobaz.cpp should return a C++ syntax
highlighted paste`POST /`
Post binary data## Design Decisions
This pastebin:
- does not use a database. It lacks non-essential features like
password-protection / automatic deletion as a result of which, it can do
completely fine with flat filesystems. As an upside (opinionated), it makes
deploying it easier.
- uses server sided highlighting, which ensures that everything stays light and
snappy at the client side.
- uses very minimal frontend because a pastebin does not need it. It focuses
(or atleast tries to) on getting things done in minimum amount of clicks.## Hacking
- If you want to ensure your pushed refs will pass CI, add the prepush script
to your Git hooks:```bash
$ cp -a tools/prepush .git/hooks/pre-push
```Alternately, just run `./tools/prepush` yourself before pushing.
- The Cargo configuration for this project is set for statically compiled
builds. You can check out the [config file](.cargo/config.toml) to know more.
- Read the [buildci](.github/workflows/buildci.yml) to know how the project is
statically compiled for two architectures.