cowboy/examples/rest_pastebin/README.asciidoc

= REST pastebin example

To try this example, you need GNU `make` and `git` in your PATH.

To build and run the example, use the following command:

[source,bash]
$ make run

Then point your browser to http://localhost:8080

== Usage

To upload something to the paste application, you can use `curl`:

[source,bash]
$ <command> | curl -i --data-urlencode paste@- localhost:8080

Or, to upload the file `my_file`:

[source,bash]
curl -i --data-urlencode paste@my_file localhost:8080

The URL of your data will be in the location header. Alternately, you can visit
http://localhost:8080 with your favorite web browser and submit your paste via
the form.

Code that has been pasted can be highlighted with ?lang=<language> option if
you have http://www.andre-simon.de/doku/highlight/en/highlight.html[highlight]
installed (although `pygments` or any other should work just fine).

This will show the contents of the HTML file:

[source,bash]
curl -i --data-urlencode paste@priv/index.html localhost:8080
curl <url from location header>

If your terminal supports color sequences and `highlight` is installed,
the following command will show the same contents but with HTML syntax
highlighting.

[source,bash]
curl <url from location header>?lang=html

If you open the same URL in your web browser and your web browser tells
Cowboy that it prefers HTML files, you will see the file highlighted
with special HTML markup and CSS. Firefox is known to work.