Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Generates random data for your tests.

Project Description


FauxFactory generates random data for your automated tests easily!

There are times when you’re writing tests for your application when you need to pass random, non-specific data to the areas you are testing. For these scenarios when all you need is a random string, numbers, dates, times, email address, IP, etc, then FauxFactory can help!

The full documentation is available on ReadTheDocs. It can also be generated locally:

pip install -r requirements-optional.txt
make docs-html


FauxFactory is written and maintained by Og Maciel and various contributors.

Development Lead


Release History

2.0.7 (2015-05-28)

  • Updated the gen_ipaddr method to allow the generation of IP addresses that start with a valid range prefix. (048715d, @mfalesni)

2.0.6 (2015-02-24)

  • Added support for Python 2.6.
  • Cleaned up the MANIFEST file.

2.0.5 (2015-02-16)

  • Improved the unicode letters generator to avoid returning control characters and other non-letter characters.

2.0.4 (2014-12-19)

  • Altered gen_integer to properly check for long() on Python 2.

2.0.3 (2014-12-17)

  • Dropped the class-wide FauxFactory deprecation warning.
  • Refactored the deprecated decorator function to comply with pylint and flake8.
  • Make gen_netmask verify function arguments.
  • Make gen_netmask raise a ValueError if min_cidr is less than 0 or max_cidr is greater than 32. Add tests for this boundary checking code.
  • Improvements to constants and documentation.

2.0.2 (2014-10-06)

  • Added new netmask random generator.

2.0.1 (2014-09-30)

  • Added a default length of 10 to all string generator functions.
  • Display deprecation warnings if FauxFactory and any of its functions are used, instructing the user to use the newer functions instead.

2.0.0 (2014-09-23)

  • All generators are now stand-alone functions and can be imported directly from fauxfactory. For example, from fauxfactory import gen_date
  • Renamed all generator functions to use the prefix “gen_” instead of “generate_”. For example, generate_date is now gen_date.
  • Backwards compatibility with version 1.x.
  • Polished documentation.

1.0.1 (2014-09-18)

  • Updated generate_string to also accept html strings.

1.0.0 (2014-09-17)

  • Added new method generate_html
  • Added new makefile

0.3.1 (2014-07-10)

  • Check for sys.maxunicode when generating utf8 characters.

0.3.0 (2014-06-15)

  • FauxFactory is now Python 3 compatible
  • Added new method generate_utf8

0.2.1 (2014-05-09)

  • Fixed issue that prevented strings longer than the full length of LOREM_IPSUM_TEXT from being generated (Github Issue #16).

0.2.0 (2014-05-08)

  • Added new ‘Lorem Ipsum’ generator.
  • Changed license from LGPL3+ to Apache 2.0

0.1.3 (2014-04-16)

  • Updated character range for CJK generator to avoid generating ‘tofu’ characters.
  • Added Contributors section to README.
  • New documentation (@faustovaz)


  • Fixed generate_string function (@faustovaz)

0.1.2 (2014-03-19)


  • Generators for email, url and IP should return a unicode string.

0.1.1 (2014-03-17)

  • Fixed formatting of README for better display on Pypi.

0.1.0 (2014-03-17)

  • Initial Release.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(29.8 kB) Copy SHA256 Hash SHA256
2.7 Wheel May 28, 2015
(28.2 kB) Copy SHA256 Hash SHA256
Source May 28, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting