An open API service indexing awesome lists of open source software.

https://github.com/keda87/chuck-norris-python

Python wrapper for "The Internet Chuck Norris Database" http://www.icndb.com/api/
https://github.com/keda87/chuck-norris-python

chuck-norris-python hacktoberfest icndb icndb-python python python-wrapper

Last synced: 3 months ago
JSON representation

Python wrapper for "The Internet Chuck Norris Database" http://www.icndb.com/api/

Awesome Lists containing this project

README

        

# chuck-norris-python
[![Build Status](https://travis-ci.org/Keda87/chuck-norris-python.svg?branch=master)](https://travis-ci.org/Keda87/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:
```python
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)
```