gravmatt / random-cat

Modul to get random cat images

random-cat

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

Big Thanks to the great Cat API

Go and visit http://thecatapi.com

Python 2 and 3 compatible

Installation

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

Usage

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

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.

Command Line

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).

Licence

The MIT License (MIT)

random-cat's Issues

HTTP Error 403: Forbidden

Traceback (most recent call last):
  File "/Users/icebunny08/Documents/a_test.py", line 3, in <module>
    cat.getCat(directory="~/Downloads", filename="cat", format='png')
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/cat/__init__.py", line 41, in getCat
    download(downloadlink, savefile)
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 247, in urlretrieve
    with contextlib.closing(urlopen(url, data)) as fp:
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 222, in urlopen
    return opener.open(url, data, timeout)
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 531, in open
    response = meth(req, response)
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 640, in http_response
    response = self.parent.error(
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 569, in error
    return self._call_chain(*args)
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 502, in _call_chain
    result = func(*args)
  File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/urllib/request.py", line 649, in http_error_default
    raise HTTPError(req.full_url, code, msg, hdrs, fp)
urllib.error.HTTPError: HTTP Error 403: Forbidden