1
0
mirror of https://tildegit.org/tomasino/pb.git synced 2024-12-23 11:35:09 +01:00
tomasino-pb/README.md

88 lines
1.8 KiB
Markdown
Raw Normal View History

pb ![calver](https://img.shields.io/badge/calver-2020.09.05-22bfda.svg?style=flat-square) ![status](https://img.shields.io/badge/status-working-green.svg?style=flat-square) ![license](https://img.shields.io/badge/license-GPL3-blue.svg?style=flat-square)
2018-08-15 05:28:59 +02:00
------
**pb** is a helper utility for using 0x0 pastebin services
2018-08-15 06:00:46 +02:00
pb provides an easy-to-use interface for uploading images or piping output to a 0x0
pastebin service. While it comes pre-configured with a specific pastebin, the service
endpoint can be overridden.
2018-08-15 06:03:30 +02:00
## Usage Examples
2018-08-15 05:28:59 +02:00
2018-10-10 02:48:48 +02:00
Upload 'scores.txt' to the pastebin
2018-08-15 05:28:59 +02:00
```bash
2018-08-15 06:00:46 +02:00
pb scores.txt
2018-08-15 06:03:30 +02:00
```
2018-10-10 02:48:48 +02:00
Upload piped output to the pastebin
2018-08-15 06:00:46 +02:00
2018-08-15 06:03:30 +02:00
```bash
2018-08-15 06:00:46 +02:00
echo 'Secret info' | pb
2018-08-15 06:03:30 +02:00
```
2018-08-15 05:28:59 +02:00
2018-10-10 02:48:48 +02:00
Upload a list of javascript files to the pastebin individually
2018-08-15 06:03:30 +02:00
```bash
2018-08-15 06:00:46 +02:00
find . -type f -name '*.js' -print | pb -f
```
2018-08-15 05:28:59 +02:00
2018-10-10 02:48:48 +02:00
Upload a file to a different pastebin endpoint
2018-08-15 06:03:30 +02:00
```bash
pb -s http://0x0.st scores.txt
```
2018-10-10 02:48:48 +02:00
Shorten a URL
2018-08-15 06:03:30 +02:00
2018-10-10 02:21:18 +02:00
```bash
pb -u https://google.com
```
2018-08-15 06:00:46 +02:00
### Options
```bash
2018-10-10 02:21:18 +02:00
-h Show this help
-v Show current version number
2018-08-15 05:28:59 +02:00
-f Explicitly interpret stdin as filename
-c Pretty color output
2018-10-10 02:21:18 +02:00
-u Shorten URL
-s server_address Use alternative pastebin server address
2018-08-15 05:28:59 +02:00
```
2018-08-15 05:43:31 +02:00
### Install
2020-06-11 00:53:17 +02:00
On GNU systems:
```sh
sudo make install
```
2018-08-15 05:43:31 +02:00
2020-06-11 00:53:17 +02:00
On BSD systems:
2020-07-05 14:31:10 +02:00
The man-path `/usr/local/share/man` is not indexed by default on openbsd. Using the `/usr` prefix works around this issue.
2020-06-11 00:53:17 +02:00
```sh
2020-07-05 14:31:10 +02:00
doas make PREFIX=/usr install
2020-06-11 00:53:17 +02:00
```
2018-08-15 05:43:31 +02:00
### Uninstall
```sh
sudo make uninstall
```
On BSD systems:
```sh
2020-07-05 14:31:10 +02:00
doas make PREFIX=/usr uninstall
```
2018-08-15 05:43:31 +02:00
2018-08-15 05:28:59 +02:00
## Contributing
Pull requests are welcome. For major changes, please open an issue first to
discuss what you would like to change.
## License
[GPL3](LICENSE)