random-cat is a amazing modul to get cat images. This Project won't be posible without the great Cat API (http://thecatapi.com).

Go and visit http://thecatapi.com

Python 2 and 3 compatible

Install through pip.

$ pip install random-cat

or get from source

$ git clone https://github.com/gravmatt/random-cat
$ cd random-cat
$ python setup.py install

The cat module has just one function getCat() with three optional arguments.

directory - default is the current directory

filename - default is a unique id

format - default is png. optional png, jpg and gif is available

import cat

# cat.getCat(directory=None, filename=None, format='png')

cat.getCat(directory='/users/tor', filename='cat', format='gif')

# /users/tor/cat.gif

The function return the image name (absolute path if directory is specified) of the image.

You can also request an image on the terminal.

$ randomcat [format] [file]

# Example:

$ randomcat gif /users/tor/cat.gif

The two arguments format and file are optional.

You can select the formats png, jpg or gif.

The command return the filename/absolute path of the image to the standard output (stdout).

The MIT License (MIT)