stow/oh-my-zsh/.oh-my-zsh/plugins/sprunge/README.md

   1 # Sprunge plugin
   2
   3 This plugin uploads data and fetch URL from the pastebin http://sprunge.us
   4
   5 To enable it, add 'sprunge' to your plugins:
   6
   7 ```zsh
   8 plugins=(... sprunge)
   9 ```
  10
  11 ## Usage
  12
  13 | Command                      | Description                               |
  14 |------------------------------|-------------------------------------------|
  15 | `sprunge filename.txt`       | Uploads filename.txt                      |
  16 | `sprunge "this is a string"` | Uploads plain text                        |
  17 | `sprunge < filename.txt`     | Redirects filename.txt content to sprunge |
  18 | `echo data \| sprunge`       | Any piped data will be uploaded           |
  19
  20 Once sprunge has processed the input it will give you a unique HTTP address:
  21
  22 ```console
  23 $ sprunge "hello"
  24 http://sprunge.us/XxjnKz
  25 ```
  26
  27 ## Notes
  28
  29 - Sprunge accepts piped data, stdin redirection, text strings as input or filenames.
  30   Only one of these can be used at a time.
  31 - Argument precedence goes as follows: stdin > piped input > text strings.
  32 - If a filename is misspelled or doesn't have the necessary path description, it will NOT
  33   generate an error, but instead treat it as a text string.
  34
  35 ## Credits
  36
  37 - Original code: [shellperson.net](https://web.archive.org/web/20190910065842/https://www.shellperson.net/sprunge-pastebin-script/).
  38 - Adapted by: Matt Parnell (@ilikenwf).