Indexed by TopGit from live GitHub metadata: joke2k/django-faker has 257 stars, written primarily in Python. Django-faker uses fake-factory to generate test data for Django models and templates
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
In django application `settings.py`::
INSTALLED_APPS = (
# ...
'django_faker',
)
FAKER_LOCALE = None # settings.LANGUAGE_CODE is loaded
FAKER_PROVIDERS = None # faker.DEFAULT_PROVIDERS is loaded (all)
Populating Django Models
Django-faker provides an adapter for Django Models, for easy population of test databases.
To populate with Model instances, create a new Populator class,
then list the class and number of all of Models that must be generated. To launch the actual data population,
call execute() method.
Here is an example showing how to populate 5 Game and 10 Player objects::
from django_faker import Faker
# this Populator is only a function thats return a django_faker.populator.Populator instance
# correctly initialized with a faker.generator.Generator instance, configured as above
populator = Faker.getPopulator()
from myapp.models import Game, Player
populator.addEntity(Game,5)
populator.addEntity(Player,10)
insertedPks = populator.execute()
The populator uses name and column type guessers to populate each column with relevant data.
For instance, Django-faker populates a column named first_name using the firstName formatter, and a column with
a datetime instance using the dateTime.
The resulting entities are therefore coherent. If Django-faker misinterprets a column name, you can still specify a custom
function to be used for populating a particular column, using the third argument to addEntity()::
Of course, Django-faker does not populate autoincremented primary keys.
In addition, django_faker.populator.Populator.execute() returns the list of inserted PKs, indexed by class::
In the previous example, the Player and Game models share a relationship. Since Game entities are populated first,
Faker is smart enough to relate the populated Player entities to one of populated Game entities.
Template tags and filter
Django-faker offers a useful template tags and filters for interact with `PyFaker`_::
{% fake 'name' as myname %}{% fake 'dateTimeBetween' '-10d' as mydate %}
{{ myname|title }} - {{ mydate|date:"M Y" }}
{% load fakers %}
<?xml version="1.0" encoding="UTF-8"?>
<contacts>
{% fake 'randomInt' 10 20 as times %}
{% for i in 10|get_range %}
<contact firstName="{% fakestr 'firstName' %}" lastName="{% fakestr 'lastName' %}" email="{% fakestr 'email' %}"/>
<phone number="{% fakestr 'phoneNumber' %}"/>
{% if 'boolean'|fake:25 %}
<birth date="{{ 'dateTimeThisCentury'|fake|date:"D d M Y" }}" place="{% fakestr 'city' %}"/>
{% endif %}
<address>
<street>{% fakestr 'streetAddress' %}</street>
<city>{% fakestr 'city' %}</city>
<postcode>{% fakestr 'postcode' %}</postcode>
<state>{% fakestr 'state' %}</state>
</address>
<company name="{% fakestr 'company' %}" catchPhrase="{% fakestr 'catchPhrase' %}">
{% if 'boolean'|fake:25 %}
<offer>{% fakestr 'bs' %}</offer>
{% endif %}
{% if 'boolean'|fake:33 %}
<director name="{% fakestr 'name' %}" />
{% endif %}
</company>
{% if 'boolean'|fake:15 %}
<details>
<![CDATA[
{% fakestr 'text' 500 %}
]]>
</details>
{% endif %}
</contact>
{% endfor %}
</contacts>
Page preview
~~~~~~~~~~~~
Open `url.py` in your main application and add this url::
urlpatterns = patterns('',
...
url(r'', include('django_faker.urls')),
...
)
http://127.0.0.1:8000/preview/ shows a faked browser windows, useful for screenshots.
Running the Tests
-----------------
Run django tests in a django environment:
$ python runtests.py
or if you have 'django_faker' in INSTALLED_APPS:
$ python manage.py test django_faker
Changelog
---------
`0.3dev <http://github.com/joke2k/django-faker/compare/v0.2...master>`__
------------------------------------------------------------------------
- fake-factory package was renamed to Faker, requires a minimum version of 0.7.3
`0.2 - 23-January-2013 <http://github.com/joke2k/django-faker/compare/v0.1...v0.2>`__
-------------------------------------------------------------------------------------
- Add requirements
- Fake browser preview
0.1 - 01-December-2012
----------------------
- Add django Model instance generator
- Add django template tag and filter
.. _Faker: https://www.github.com/joke2k/faker/
.. |pypi| image:: https://img.shields.io/pypi/v/django-faker.svg?style=flat-square&label=version
:target: https://pypi.python.org/pypi/django-faker
:alt: Latest version released on PyPi
.. |coverage| image:: https://img.shields.io/coveralls/joke2k/django-faker/master.svg?style=flat-square
:target: https://coveralls.io/r/joke2k/django-faker?branch=master
:alt: Test coverage
.. |unix_build| image:: https://img.shields.io/travis/joke2k/django-faker/master.svg?style=flat-square&label=unix%20build
:target: http://travis-ci.org/joke2k/django-faker
:alt: Build status of the master branch on Mac/Linux
.. |windows_build| image:: https://img.shields.io/appveyor/ci/joke2k/django-faker.svg?style=flat-square&label=windows%20build
:target: https://ci.appveyor.com/project/joke2k/django-faker
:alt: Build status of the master branch on Windows
.. |downloads| image:: https://img.shields.io/pypi/dm/django-faker.svg?style=flat-square
:target: https://pypi.python.org/pypi/django-faker
:alt: Monthly downloads
.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
:target: https://raw.githubusercontent.com/joke2k/django-faker/master/LICENSE.txt
:alt: Package license
TopGit's last sync did not record any GitHub topics for joke2k/django-faker. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on joke2k/django-faker?
The most recent commit recorded on joke2k/django-faker was 3.6 years ago, based on the GitHub push timestamp. The repository has 50 forks — one of the better signals of community interest.
How many stars does joke2k/django-faker have?
joke2k/django-faker has 257 GitHub stars — refresh the page for the live number, or check github.com/joke2k/django-faker. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is joke2k/django-faker?
joke2k/django-faker (joke2k/django-faker) is a Python project on GitHub. From the project's own README: Django-faker uses fake-factory to generate test data for Django models and templates
What language is joke2k/django-faker written in?
joke2k/django-faker is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
Read full README in the tab above.
Curious whether django-faker is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about django-faker.
/django-faker