Cowsapi

Runs an HTTP API that exposes cowsay operations. Make cows say things, just like you always wanted to - over the internets!

Features

Make cows say things!
Supports both text and images of cows!

Preqrequisites

You need some software installed in order to run cowsapi successfully. Here are instructions for install stuff on OSX:

brew install ImageMagick ghostscript

Installation

To install cowsapi:

gem install cowsapi

Usage

To launch cowsapi:

port=9292 cowsapi

This will launch cowsapi on port 9292.

API Guide

List cows:

curl -O http://localhost

Make a cow say stuff:

curl -O http://localhost/somecow/stuff%20to%20say

Get a an image of a cow saying stuff:

curl -o curl -O http://sheax0r.ca/cow/stuff?format\=png > cowstuff.png

Extra stuff

You can also make your docker-cowsay container run cowsay directly, rather than launching an api, like so:

docker run -t cowsay i can haz cows?

_________________
< i can haz cows? >
 -----------------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

Contributing

Fork it ( https://github.com/[my-github-username]/cowsapi/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

cowsapi

Development

Runtime