# guile-pastebin

Minimalist pastebin written in Guile Scheme.

## Usage

Ensure Guile 3.0.9 (or later) is installed and execute the command:

```
./run pastebin data
```

Then navigate a web browser at `http://localhost:8080`.

The full `pastebin` command synopsis is as follows:

```
pastebin [OPTIONS] <DATA_DIR>
```

`DATA_DIR` is a writable filesystem location to store pastes.

Supported `OPTIONS` are following:

* `--addr`: IPv4 address to listen on (default: `127.0.0.1`).
* `--port`: port number to run pastebin on (default: `8080`).
* `--css-url`: URL of a CSS file (default: no stylesheet).

## API

- `/` -- show top 5 paste list
- `/post` -- create paste
  - method: POST only
  - type: `multipart/form-data`
  - fields
    - `text` -- the paste content
    - `showUrl=1` -- to show the raw URL after paste
- `/raw/<ID>` -- get paste content
  - method: GET only

## Paste a file from command line

Paste a text file from command line and get a URL back:
`curl -F "text=<helloworld.cs" -F showUrl=1 http://localhost:8080/post`

Notice the double-quotes around the parameters because `<` means IO
redirection in sh.

## Acknowledgement

This software was initially developed by Li Ian-Xue (b4283) at
<https://github.com/b4284/guile-pastebin>.

It is currently occasionally maintained by Evgeny Pisemsky at
<https://repo.pisemsky.site/guile-pastebin>.

## Copying

SPDX-FileCopyrightText: 2021 Li Ian-Xue (b4283) <b4283@pm.me>

SPDX-FileCopyrightText: 2025 Evgeny Pisemsky <mail@pisemsky.site>

SPDX-License-Identifier: GPL-3.0-only