go-chucknorris

README

go-chucknorris

go-chucknorris is a Go API and CLI tool for the hand curated Chuck Norris facts at https://api.chucknorris.io/.

Installation

Install go-chucknorris using go get.

$ go get -v github.com/dnaeon/go-chucknorris

Or by cloning the repo and using make(1).

$ git clone https://github.com/dnaeon/go-chucknorris
$ cd go-chucknorris && make install

Usage

Example usage of retrieving a random joke.

$ go-chucknorris joke
If Chuck Norris wants your opinion, he'll beat it into you.

Listing all joke categories.

$ go-chucknorris categories

Searching for jokes.

$ go-chucknorris search --query "agent smith"
Found 1 joke(s) matching the given query.

Chuck Norris once interrogated agent Smith.

API

Check out the API documentation at GoDoc.

License

This project is Open Source and licensed under the BSD License.