Skip to content
Python class for generating random user data using https://randomuser.me API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
.gitignore
LICENSE
MANIFEST.in
README.rst
randomuser.py
setup.cfg
setup.py
update-gh-pages.sh
update-pypi.sh

README.rst

Python Random User Generator

PyPI PyPI - License GitHub

Python class for generating random user data using randomuser.me API.

Basic Usage

from randomuser import RandomUser

# Generate a single user
user = RandomUser()

# Generate a list of 10 random users
user_list = RandomUser.generate_users(10)

Both RandomUser() and RandomUser.generate_users() can optionally accept a dictionary of parameter names to desired values using the get_params optional parameter:

# Generate a random female user
user = RandomUser({'gender': 'female'})

# Generate a list of 10 random users from Canada
user_list = RandomUser.generate_users(10, {'nat': 'ca'})

For more information on what parameters can be specified, see the randomuser.me documentation.

Method Overview

For details on the RandomUser class and optional parameters for these methods, see the documentation.

Getter Methods

  • get_cell()
  • get_city()
  • get_dob()
  • get_email()
  • get_first_name()
  • get_full_name()
  • get_gender()
  • get_id()
  • get_id_number()
  • get_id_type()
  • get_info()
  • get_last_name()
  • get_login_md5()
  • get_login_salt()
  • get_login_sha1()
  • get_login_sha256()
  • get_nat()
  • get_password()
  • get_phone()
  • get_picture()
  • get_postcode()
  • get_registered()
  • get_state()
  • get_street()
  • get_username()
  • get_zipcode()
You can’t perform that action at this time.