README.md

chuck-norris-python

Python wrapper for "The Internet Chuck Norris Database" http://www.icndb.com/api/ and compatible with python 2 & 3.

Installation:

$ pip install chuck-norris-python

Example usage:

from chuck import ChuckNorris

cn = ChuckNorris()

# Get random jokes.
data = cn.random()
print(data.id)
print(data.joke)
print(data.categories)

# Get multiple random jokes.
data = cn.random(total=5)
for i in data:
    print(i.id)
    print(i.joke)
    print(i.categories)

# Get random jokes with manipulate actor name (first name or last name).
data = cn.random(first_name='John')
data = cn.random(last_name='Doe')
data = cn.random(first_name='John', last_name='Doe')
print(data.id)
print(data.joke)
print(data.categories)

# Get random jokes filter by categories (must be an iterable).
data = cn.random(categories=['nerdy', 'geeks'])
print(data.id)
print(data.joke)
print(data.categories)

# Get random jokes filter exclude by categories (must be an iterable).
data = cn.random(exclude_categories=['nerdy'])
print(data.id)
print(data.joke)
print(data.categories)

# Get jokes by specific ID.
data = cn.get_jokes_by_id(15)
print(data.id)
print(data.joke)
print(data.categories)

# Get total jokes count.
total = cn.get_jokes_count()
print(total)

# Get all jokes categories.
categories = cn.get_jokes_categories()
for i in categories:
    print(i)

# Get entire jokes data.
jokes = cn.get_all_jokes()
for i in jokes:
    print(i.id)
    print(i.joke)
    print(i.categories)