Skip to main content

Modul/Command Line Tool to get dog images

Project description


random-dog is a module for getting dog images, it uses dogAPI: The module creation was inspired by random-cat module (

Python 2 and 3 compatible


Install through pip.

$ pip install random-dog

or get from source

$ git clone
$ cd random-dog
$ python install


The dog module has just one function getDog() with two optional arguments.


directory - default is the current directory

filename - default is a unique id

import dog

# dog.getDog(directory=None, filename=None)

dog.getDog(directory='/users/tor', filename='dog')

# /users/tor/dog.jpg

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.

$ randomdog [file]

# Example:

$ randomdog /users/tor/dog.jpg

The argument file is optional.

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


The MIT License (MIT)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for random-dog, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size random_dog-1.0.2-py2-none-any.whl (3.8 kB) File type Wheel Python version py2 Upload date Hashes View hashes
Filename, size random_dog-1.0.2-py3-none-any.whl (3.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page