[Python-modules-commits] [faker] 01/04: New upstream version 0.7.7
Hugo Lefeuvre
hle at moszumanska.debian.org
Fri Dec 23 18:01:56 UTC 2016
This is an automated email from the git hooks/post-receive script.
hle pushed a commit to branch master
in repository faker.
commit 22b81808fe94ecd784f91272fad5a42c969549fc
Author: Hugo Lefeuvre <hle at debian.org>
Date: Fri Dec 23 18:48:27 2016 +0100
New upstream version 0.7.7
---
.bumpversion.cfg | 2 +-
.gitignore | 4 +-
.travis.yml | 2 +-
CHANGELOG.rst | 112 +-
CONTRIBUTING.rst | 5 +-
Makefile | 7 +
README.rst | 182 +-
docs/coding_style.rst | 4 +-
docs/conf.py | 4 +-
docs/index.rst | 201 +--
faker/__init__.py | 2 +-
faker/cli.py | 30 +
faker/providers/__init__.py | 24 +-
faker/providers/address/en_AU/__init__.py | 4 +-
faker/providers/address/en_CA/__init__.py | 6 +-
faker/providers/address/en_GB/__init__.py | 27 +-
faker/providers/address/en_US/__init__.py | 70 +-
faker/providers/address/es/__init__.py | 84 +-
faker/providers/address/es_ES/__init__.py | 6 +-
faker/providers/address/es_MX/__init__.py | 82 +-
faker/providers/address/fa_IR/__init__.py | 59 +-
faker/providers/address/fi_FI/__init__.py | 206 +--
.../providers/address/{fr_FR => fr_CH}/__init__.py | 116 +-
faker/providers/address/fr_FR/__init__.py | 13 +-
faker/providers/address/hi_IN/__init__.py | 38 +-
faker/providers/address/it_IT/__init__.py | 41 +-
faker/providers/address/ja_JP/__init__.py | 14 +-
faker/providers/address/ko_KR/__init__.py | 386 ++++-
faker/providers/address/ne_NP/__init__.py | 145 +-
faker/providers/address/nl_BE/__init__.py | 801 +++++++++
faker/providers/address/no_NO/__init__.py | 18 +-
faker/providers/address/pl_PL/__init__.py | 769 ++-------
faker/providers/address/pt_BR/__init__.py | 84 +-
faker/providers/address/ru_RU/__init__.py | 267 +++
faker/providers/address/sl_SI/__init__.py | 908 +++++-----
faker/providers/address/uk_UA/__init__.py | 74 +
faker/providers/address/zh_CN/__init__.py | 96 +-
faker/providers/address/zh_TW/__init__.py | 1 -
faker/providers/barcode/__init__.py | 7 +-
faker/providers/color/__init__.py | 186 +-
faker/providers/color/uk_UA/__init__.py | 218 +++
faker/providers/company/fr_CH/__init__.py | 44 +
faker/providers/company/pt_BR/__init__.py | 29 +
faker/providers/company/ru_RU/__init__.py | 21 +
faker/providers/credit_card/__init__.py | 29 +-
faker/providers/currency/__init__.py | 4 +-
faker/providers/date_time/__init__.py | 26 +-
faker/providers/file/__init__.py | 43 +-
faker/providers/internet/__init__.py | 46 +-
faker/providers/internet/fr_CH/__init__.py | 21 +
faker/providers/internet/fr_FR/__init__.py | 8 +
faker/providers/internet/ru_RU/__init__.py | 41 +
faker/providers/internet/uk_UA/__init__.py | 27 +
faker/providers/internet/zh_CN/__init__.py | 18 +
faker/providers/job/__init__.py | 1271 +++++++-------
faker/providers/job/fr_CH/__init__.py | 838 +++++++++
faker/providers/job/hr_HR/__init__.py | 292 ++++
faker/providers/job/zh_TW/__init__.py | 483 ++++++
faker/providers/misc/__init__.py | 70 +-
faker/providers/person/__init__.py | 1 -
faker/providers/person/de_AT/__init__.py | 4 +-
faker/providers/person/de_DE/__init__.py | 2 +-
faker/providers/person/dk_DK/__init__.py | 4 +-
faker/providers/person/en/__init__.py | 2 +-
faker/providers/person/en_GB/__init__.py | 593 +++++++
faker/providers/person/en_US/__init__.py | 1779 +++++++++++++++++++-
faker/providers/person/fa_IR/__init__.py | 17 +-
faker/providers/person/fr_CH/__init__.py | 87 +
faker/providers/person/ko_KR/__init__.py | 6 +-
faker/providers/person/pt_BR/__init__.py | 94 +-
faker/providers/person/ru_RU/__init__.py | 121 +-
faker/providers/person/uk_UA/__init__.py | 252 +--
faker/providers/person/zh_CN/__init__.py | 142 +-
faker/providers/phone_number/en_US/__init__.py | 2 +-
faker/providers/phone_number/fa_IR/__init__.py | 62 +-
faker/providers/phone_number/fr_CH/__init__.py | 37 +
faker/providers/phone_number/nl_BE/__init__.py | 25 +
faker/providers/phone_number/zh_TW/__init__.py | 11 +-
faker/providers/profile/__init__.py | 11 +-
faker/providers/python/__init__.py | 44 +-
faker/providers/ssn/__init__.py | 4 +-
faker/providers/ssn/en_CA/__init__.py | 41 +-
faker/providers/ssn/fr_CH/__init__.py | 35 +
faker/providers/ssn/hr_HR/__init__.py | 43 +
faker/providers/ssn/ko_KR/__init__.py | 4 -
faker/providers/ssn/nl_BE/__init__.py | 61 +
faker/providers/ssn/ru_RU/__init__.py | 6 +
faker/providers/ssn/sv_SE/__init__.py | 2 +-
faker/providers/ssn/uk_UA/__init__.py | 33 +-
faker/shims/__init__.py | 4 -
faker/shims/counter.py | 187 --
faker/tests/__init__.py | 162 +-
faker/tests/hr_HR/__init__.py | 26 +
faker/tests/no_NO/__init__.py | 18 +
faker/tests/pt_BR/__init__.py | 18 +-
faker/utils/datasets.py | 2 +-
readthedocs.yml | 5 +
setup.py | 18 +-
98 files changed, 9451 insertions(+), 3130 deletions(-)
diff --git a/.bumpversion.cfg b/.bumpversion.cfg
index 768efa1..b292a4c 100644
--- a/.bumpversion.cfg
+++ b/.bumpversion.cfg
@@ -1,5 +1,5 @@
[bumpversion]
-current_version = 0.5.7
+current_version = 0.7.7
files = setup.py faker/__init__.py docs/conf.py
commit = True
tag = True
diff --git a/.gitignore b/.gitignore
index cb61558..596fff7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,6 +14,7 @@ docs/locales/*.rst
docs/providers.rst
docs/providers/*.rst
eggs
+.eggs
parts
var
sdist
@@ -39,4 +40,5 @@ nosetests.xml
.pydevproject
.idea
.projectile
-.ropeproject
\ No newline at end of file
+.ropeproject
+.DS_Store
diff --git a/.travis.yml b/.travis.yml
index db65dbe..de57747 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,10 +4,10 @@ branches:
only:
- master
python:
- - 2.6
- 2.7
- 3.3
- 3.4
+ - 3.5
- "pypy"
- "pypy3"
install:
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index c5228e6..351a61e 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -1,28 +1,114 @@
+
Changelog
=========
-`0.5.7 - 07-March-2016 <http://github.com/joke2k/faker/compare/v0.5.6...v0.5.7>`__
+`0.7.7 - 20-December-2016 <https://github.com/joke2k/faker/compare/v0.7.6...v0.7.7>`__
+--------------------------------------------------------------------------------------
+
+* Fix no_NO postcodes. Thanks @kdeldycke.
+* Fix fa_IR city generator. Thanks @kdeldycke.
+
+`0.7.6 - 19-December-2016 <https://github.com/joke2k/faker/compare/v0.7.5...v0.7.6>`__
+--------------------------------------------------------------------------------------
+
+* Fix packaging issue with `docs` directory. Thanks @wyattanderson.
+
+`0.7.5 - 16-December-2016 <https://github.com/joke2k/faker/compare/v0.7.4...v0.7.5>`__
+--------------------------------------------------------------------------------------
+
+* Deprecate ``facke-factory`` package on PyPI.
+
+`0.7.4 - 16-December-2016 <https://github.com/joke2k/faker/compare/v0.7.3...v0.7.4>`__
+--------------------------------------------------------------------------------------
+
+* Add Ukrainian ``address`` provider. Thanks @illia-v.
+* Add Ukrainian ``internet`` provider. Thanks @illia-v.
+* Middle name support for ``person.ru_RU`` provider. Thanks @zeal18.
+* Add ``address``, ``company``, ``internet`` ans ``SSN`` provider for ``ru_RU``. Thanks @zeal18.
+* Improved ``address.pl_PL`` provider. Thanks @pkisztelinski.
+* Add date and time object providers. Thanks @jtojnar.
+* Refactor Korean address methods. Thanks @item4.
+* Add provider for locale `nl_BE` (address, phone, ssn). Thanks @vema.
+* Add additional job titles. Thanks @wontonst.
+* Add Ukrainian color provider. Thanks @illia-v.
+* Add support to brazilian company IDs (CNPJ). Thanks @lamenezes.
+* Improve the Internet provider. Thanks at illia-v.
+* Improve the Ukrainian person provider. Thanks @illia-v.
+* Improve some SSN providers. Thanks @illia-v.
+* Improve code samples in `README.rst` and `docs/index.rst`. Thanks @illia-v.
+* Improve the method `locale`. Thanks @illia-v.
+* Fix `pyfloat`. Thanks @illia-v.
+* Allow left/right_digits=0 for pyfloat. Thanks @mnalt.
+* update fa_IR person names and phone numbers. Thanks @aminalaee.
+
+`0.7.3 - 16-September-2016 <https://github.com/joke2k/faker/compare/v0.6.0...v0.7.3>`__
+--------------------------------------------------------------------------------------
+
+* ``date_time_this_century`` now returns ``datetime`` s outside the current decade. Thanks @JarUrb.
+* Add support for localized jobs for ``hr_HR``. Thanks @mislavcimpersak.
+* Adding support for Croatian ``hr_HR`` ssn (oib). Thanks @mislavcimpersak.
+* Rename PyPI package to ``Faker``.
+
+`0.6.0 - 09-August-2016 <https://github.com/joke2k/faker/compare/v0.5.11...v0.6.0>`__
+------------------------------------------------------------------------------------
+
+* Dropped Python 2.6 support
+
+
+`0.5.11 - 09-August-2016 <https://github.com/joke2k/faker/compare/v0.5.10...v0.5.11>`__
+--------------------------------------------------------------------------------------
+
+* Add optional parameter `sex` to `profile` and `simple_profile`. Thanks @navyad.
+* Fix whitespace in dk_DK provider last_names/last_name. Thanks @iAndriy.
+* Fix utf8 coding issue with ``address/fi_FI`` provider. Thanks @delneg.
+* ! Latest version to support Python 2.6
+
+`0.5.10 - 01-August-2016 <https://github.com/joke2k/faker/compare/v0.5.9...v0.5.10>`__
+-------------------------------------------------------------------------------------
+
+* Fix random_sample_unique. Thanks @cecedille1.
+
+`0.5.9 - 08-July-2016 <https://github.com/joke2k/faker/compare/v0.5.8...v0.5.9>`__
+---------------------------------------------------------------------------------
+
+* Add more ``pt_BR`` names. Thanks @cuducos.
+* Added ``en_GB`` names. Thanks @jonny5532.
+* Add romanized internet provider for ``zh_CN``.
+* Add ``fr_CH`` providers. Thanks @gfavre.
+
+`0.5.8 - 28-June-2016 <https://github.com/joke2k/faker/compare/v0.5.7...v0.5.8>`__
+---------------------------------------------------------------------------------
+
+* Improve CLI output and help. Thanks @cbaines.
+* Update ``en_US`` anmes to be more realistic. Thanks @dethpickle.
+* Modify pystr provider to accept a minimum number of characters. Thanks @tamarbuta.
+* Add `job` Provider for ``zh_TW``. Thanks @weihanglo.
+* Modify ``zh_TW`` phone number for a more valid format. Thanks @weihanglo.
+* Reduce the maximum value of start timestamps. Thanks @cbaines.
+* Add `random_sample` and `random_sample_unique`. Thanks @bengolder.
+
+`0.5.7 - 07-March-2016 <https://github.com/joke2k/faker/compare/v0.5.6...v0.5.7>`__
----------------------------------------------------------------------------------
* Repackage to resolve PyPI issue.
-`0.5.6 - 07-March-2016 <http://github.com/joke2k/faker/compare/v0.5.5...v0.5.6>`__
+`0.5.6 - 07-March-2016 <https://github.com/joke2k/faker/compare/v0.5.5...v0.5.6>`__
----------------------------------------------------------------------------------
* Add date handling for datetime functions. Thanks @rpkilby.
* Discern male and female first names in pt_BR. Thanks @gabrielusvicente.
-`0.5.5 - 29-February-2016 <http://github.com/joke2k/faker/compare/v0.5.4...v0.5.5>`__
+`0.5.5 - 29-February-2016 <https://github.com/joke2k/faker/compare/v0.5.4...v0.5.5>`__
--------------------------------------------------------------------------------------
* Specify help text for command line. Thanks @cbaines.
-`0.5.4 - 29-February-2016 <http://github.com/joke2k/faker/compare/v0.5.3...v0.5.4>`__
+`0.5.4 - 29-February-2016 <https://github.com/joke2k/faker/compare/v0.5.3...v0.5.4>`__
--------------------------------------------------------------------------------------
* Expose Provider's random instance. Thank @gsingers for the suggestion.
* Make sure required characters are in the password. Thanks @craig552uk.
-* Add `internet` and `jobs` Providers for `fa_IR`. Thanks @hamidfzm.
+* Add ``internet`` and ``job`` Providers for ``fa_IR``. Thanks @hamidfzm.
* Correct Poland phone numbers. Thanks @fizista.
* Fix brittly tests due to seconds elapsed in-between comparison
* Allow unicode in emails and domains. Thanks @zdelagrange for the report.
@@ -46,9 +132,9 @@ Changelog
* Check that randomly produced language codes are parseable as locale by the
factory constructor. Thanks @kdeldycke.
* Fix chinese random language code. Thanks @kdeldycke.
-* Remove duplicate words from Lorem provider. Thanks @jeffwidman.
+* Remove duplicate words from Lorem provider. Thanks @jeffwidman.
-`0.5.3 - 21-September-2015 <http://github.com/joke2k/faker/compare/v0.5.2...v0.5.3>`__
+`0.5.3 - 21-September-2015 <https://github.com/joke2k/faker/compare/v0.5.2...v0.5.3>`__
--------------------------------------------------------------------------------------
* Added ``company_vat`` to company ``fi_FI`` provider. Thanks @kivipe.
@@ -68,7 +154,7 @@ Changelog
* Fixed provider's example formatting in documentation.
* Added en_AU provider. Thanks @xfxf.
-`0.5.2 - 11-June-2015 <http://github.com/joke2k/faker/compare/v0.5.1...v0.5.2>`__
+`0.5.2 - 11-June-2015 <https://github.com/joke2k/faker/compare/v0.5.1...v0.5.2>`__
---------------------------------------------------------------------------------
* Added ``uuid4`` to ``misc`` provider. Thanks Jared Culp.
@@ -78,7 +164,7 @@ Changelog
* Added ``country_code`` to `address`` provider. Thanks @elad101 and Tobin Brown.
-`0.5.1 - 21-May-2015 <http://github.com/joke2k/faker/compare/v0.5...v0.5.1>`__
+`0.5.1 - 21-May-2015 <https://github.com/joke2k/faker/compare/v0.5...v0.5.1>`__
------------------------------------------------------------------------------
* Fixed egg installation. Thanks David R. MacIver, @kecaps
@@ -101,7 +187,7 @@ Changelog
* Added ``sk_SK`` localized providers. Thanks @viktormaruna.
* Removed ``miscelleneous`` provider. It is superceded by the ``misc`` provider.
-`0.5.0 - 16-Feb-2015 <http://github.com/joke2k/faker/compare/v0.4.2...v0.5>`__
+`0.5.0 - 16-Feb-2015 <https://github.com/joke2k/faker/compare/v0.4.2...v0.5>`__
------------------------------------------------------------------------------
* Localized providers
@@ -116,12 +202,12 @@ Changelog
* Added ``ne_NP`` provider. Thanks Sudip Kafle.
* Added provider for Austrian ``de_AT``. Thanks Bernhard Essl.
-`0.4.2 - 20-Aug-2014 <http://github.com/joke2k/faker/compare/v0.4.1...v0.4.2>`__
+`0.4.2 - 20-Aug-2014 <https://github.com/joke2k/faker/compare/v0.4.1...v0.4.2>`__
--------------------------------------------------------------------------------
* Fixed setup
-`0.4.1 - 20-Aug-2014 <http://github.com/joke2k/faker/compare/v0.4...v0.4.1>`__
+`0.4.1 - 20-Aug-2014 <https://github.com/joke2k/faker/compare/v0.4...v0.4.1>`__
------------------------------------------------------------------------------
* Added MAC address provider. Thanks Sébastien Béal.
@@ -134,7 +220,7 @@ Changelog
* Fixed ``date_time_ad`` on 32bit Linux. Thanks @mdxs.
* Fixed ``domain_word`` to output slugified strings.
-`0.4 - 30-Mar-2014 <http://github.com/joke2k/faker/compare/v0.3.2...v0.4>`__
+`0.4 - 30-Mar-2014 <https://github.com/joke2k/faker/compare/v0.3.2...v0.4>`__
----------------------------------------------------------------------------
* Modified en_US ``person.py`` to ouput female and male names. Thanks Adrian Klaver.
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index cb17d80..facb1d2 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -54,7 +54,6 @@ Submitting Changes
Additional Resources
====================
-- `General GitHub documentation <http://help.github.com/>`__
+- `General GitHub documentation <https://help.github.com>`__
- `GitHub pull request
- documentation <http://help.github.com/send-pull-requests/>`__
-
+ documentation <https://help.github.com/articles/about-pull-requests>`__
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..6d3d4f2
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,7 @@
+test:
+ coverage run --source=faker setup.py test
+
+release:
+ rm -rf dist
+ python setup.py sdist bdist_wheel
+ twine upload dist/*
diff --git a/README.rst b/README.rst
index 2596713..f45b48b 100644
--- a/README.rst
+++ b/README.rst
@@ -15,7 +15,7 @@ Faker is heavily inspired by `PHP Faker`_, `Perl Faker`_, and by `Ruby Faker`_.
----
-|pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+|pypi| |unix_build| |windows_build| |coverage| |license|
----
@@ -28,7 +28,9 @@ Install with pip:
.. code:: bash
- pip install fake-factory
+ pip install Faker
+
+*Note: this package was previously called* ``fake-factory``.
Use ``faker.Factory.create()`` to create and initialize a faker
generator, which can generate data by accessing properties named after
@@ -36,31 +38,30 @@ the type of data you want.
.. code:: python
+ from faker import Factory
+ fake = Factory.create()
- from faker import Factory
- fake = Factory.create()
-
- # OR
- from faker import Faker
- fake = Faker()
+ # OR
+ from faker import Faker
+ fake = Faker()
- fake.name()
- # 'Lucy Cechtelar'
+ fake.name()
+ # 'Lucy Cechtelar'
- fake.address()
- # "426 Jordy Lodge
- # Cartwrightshire, SC 88120-6700"
+ fake.address()
+ # "426 Jordy Lodge
+ # Cartwrightshire, SC 88120-6700"
- fake.text()
- # Sint velit eveniet. Rerum atque repellat voluptatem quia rerum. Numquam excepturi
- # beatae sint laudantium consequatur. Magni occaecati itaque sint et sit tempore. Nesciunt
- # amet quidem. Iusto deleniti cum autem ad quia aperiam.
- # A consectetur quos aliquam. In iste aliquid et aut similique suscipit. Consequatur qui
- # quaerat iste minus hic expedita. Consequuntur error magni et laboriosam. Aut aspernatur
- # voluptatem sit aliquam. Dolores voluptatum est.
- # Aut molestias et maxime. Fugit autem facilis quos vero. Eius quibusdam possimus est.
- # Ea quaerat et quisquam. Deleniti sunt quam. Adipisci consequatur id in occaecati.
- # Et sint et. Ut ducimus quod nemo ab voluptatum.
+ fake.text()
+ # Sint velit eveniet. Rerum atque repellat voluptatem quia rerum. Numquam excepturi
+ # beatae sint laudantium consequatur. Magni occaecati itaque sint et sit tempore. Nesciunt
+ # amet quidem. Iusto deleniti cum autem ad quia aperiam.
+ # A consectetur quos aliquam. In iste aliquid et aut similique suscipit. Consequatur qui
+ # quaerat iste minus hic expedita. Consequuntur error magni et laboriosam. Aut aspernatur
+ # voluptatem sit aliquam. Dolores voluptatum est.
+ # Aut molestias et maxime. Fugit autem facilis quos vero. Eius quibusdam possimus est.
+ # Ea quaerat et quisquam. Deleniti sunt quam. Adipisci consequatur id in occaecati.
+ # Et sint et. Ut ducimus quod nemo ab voluptatum.
Each call to method ``fake.name()`` yields a different (random) result.
This is because faker forwards ``faker.Generator.method_name()`` calls
@@ -68,20 +69,19 @@ to ``faker.Generator.format(method_name)``.
.. code:: python
-
- for _ in range(0,10):
+ for _ in range(0, 10):
print fake.name()
- # Adaline Reichel
- # Dr. Santa Prosacco DVM
- # Noemy Vandervort V
- # Lexi O'Conner
- # Gracie Weber
- # Roscoe Johns
- # Emmett Lebsack
- # Keegan Thiel
- # Wellington Koelpin II
- # Ms. Karley Kiehn V
+ # Adaline Reichel
+ # Dr. Santa Prosacco DVM
+ # Noemy Vandervort V
+ # Lexi O'Conner
+ # Gracie Weber
+ # Roscoe Johns
+ # Emmett Lebsack
+ # Keegan Thiel
+ # Wellington Koelpin II
+ # Ms. Karley Kiehn V
Providers
---------
@@ -90,7 +90,7 @@ Each of the generator properties (like ``name``, ``address``, and
``lorem``) are called "fake". A faker generator has many of them,
packaged in "providers".
-Check the `extended docs`_ for a list of `bundled providers`_ and a list of
+Check the `extended docs`_ for a list of `bundled providers`_ and a list of
`community providers`_.
Localization
@@ -104,7 +104,7 @@ default en\_US locale.
from faker import Factory
fake = Factory.create('it_IT')
- for _ in range(0,10):
+ for _ in range(0, 10):
print fake.name()
> Elda Palumbo
@@ -125,39 +125,40 @@ provider for your own locale and submit a Pull Request (PR).
Included localized providers:
-- `bg\_BG <http://fake-factory.readthedocs.org/en/master/locales/bg_BG.html>`__ - Bulgarian
-- `cs\_CZ <http://fake-factory.readthedocs.org/en/master/locales/cs_CZ.html>`__ - Czech
-- `de\_DE <http://fake-factory.readthedocs.org/en/master/locales/de_DE.html>`__ - German
-- `dk\_DK <http://fake-factory.readthedocs.org/en/master/locales/dk_DK.html>`__ - Danish
-- `el\_GR <http://fake-factory.readthedocs.org/en/master/locales/el_GR.html>`__ - Greek
-- `en\_AU <http://fake-factory.readthedocs.org/en/master/locales/en_AU.html>`__ - English (Australia)
-- `en\_CA <http://fake-factory.readthedocs.org/en/master/locales/en_CA.html>`__ - English (Canada)
-- `en\_GB <http://fake-factory.readthedocs.org/en/master/locales/en_GB.html>`__ - English (Great Britain)
-- `en\_US <http://fake-factory.readthedocs.org/en/master/locales/en_US.html>`__ - English (United States)
-- `es\_ES <http://fake-factory.readthedocs.org/en/master/locales/es_ES.html>`__ - Spanish (Spain)
-- `es\_MX <http://fake-factory.readthedocs.org/en/master/locales/es_MX.html>`__ - Spanish (Mexico)
-- `fa\_IR <http://fake-factory.readthedocs.org/en/master/locales/fa_IR.html>`__ - Persian (Iran)
-- `fi\_FI <http://fake-factory.readthedocs.org/en/master/locales/fi_FI.html>`__ - Finnish
-- `fr\_FR <http://fake-factory.readthedocs.org/en/master/locales/fr_FR.html>`__ - French
-- `hi\_IN <http://fake-factory.readthedocs.org/en/master/locales/hi_IN.html>`__ - Hindi
-- `hr\_HR <http://fake-factory.readthedocs.org/en/master/locales/hr_HR.html>`__ - Croatian
-- `it\_IT <http://fake-factory.readthedocs.org/en/master/locales/it_IT.html>`__ - Italian
-- `ja\_JP <http://fake-factory.readthedocs.org/en/master/locales/ja_JP.html>`__ - Japanese
-- `ko\_KR <http://fake-factory.readthedocs.org/en/master/locales/ko_KR.html>`__ - Korean
-- `lt\_LT <http://fake-factory.readthedocs.org/en/master/locales/lt_LT.html>`__ - Lithuanian
-- `lv\_LV <http://fake-factory.readthedocs.org/en/master/locales/lv_LV.html>`__ - Latvian
-- `ne\_NP <http://fake-factory.readthedocs.org/en/master/locales/ne_NP.html>`__ - Nepali
-- `nl\_NL <http://fake-factory.readthedocs.org/en/master/locales/nl_NL.html>`__ - Dutch (Netherlands)
-- `no\_NO <http://fake-factory.readthedocs.org/en/master/locales/no_NO.html>`__ - Norwegian
-- `pl\_PL <http://fake-factory.readthedocs.org/en/master/locales/pl_PL.html>`__ - Polish
-- `pt\_BR <http://fake-factory.readthedocs.org/en/master/locales/pt_BR.html>`__ - Portuguese (Brazil)
-- `pt\_PT <http://fake-factory.readthedocs.org/en/master/locales/pt_PT.html>`__ - Portuguese (Portugal)
-- `ru\_RU <http://fake-factory.readthedocs.org/en/master/locales/ru_RU.html>`__ - Russian
-- `sl\_SI <http://fake-factory.readthedocs.org/en/master/locales/sl_SI.html>`__ - Slovene
-- `sv\_SE <http://fake-factory.readthedocs.org/en/master/locales/sv_SE.html>`__ - Swedish
-- `tr\_TR <http://fake-factory.readthedocs.org/en/master/locales/tr_TR.html>`__ - Turkish
-- `zh\_CN <http://fake-factory.readthedocs.org/en/master/locales/zh_CN.html>`__ - Chinese (China)
-- `zh\_TW <http://fake-factory.readthedocs.org/en/master/locales/zh_TW.html>`__ - Chinese (Taiwan)
+- `bg\_BG <https://faker.readthedocs.io/en/master/locales/bg_BG.html>`__ - Bulgarian
+- `cs\_CZ <https://faker.readthedocs.io/en/master/locales/cs_CZ.html>`__ - Czech
+- `de\_DE <https://faker.readthedocs.io/en/master/locales/de_DE.html>`__ - German
+- `dk\_DK <https://faker.readthedocs.io/en/master/locales/dk_DK.html>`__ - Danish
+- `el\_GR <https://faker.readthedocs.io/en/master/locales/el_GR.html>`__ - Greek
+- `en\_AU <https://faker.readthedocs.io/en/master/locales/en_AU.html>`__ - English (Australia)
+- `en\_CA <https://faker.readthedocs.io/en/master/locales/en_CA.html>`__ - English (Canada)
+- `en\_GB <https://faker.readthedocs.io/en/master/locales/en_GB.html>`__ - English (Great Britain)
+- `en\_US <https://faker.readthedocs.io/en/master/locales/en_US.html>`__ - English (United States)
+- `es\_ES <https://faker.readthedocs.io/en/master/locales/es_ES.html>`__ - Spanish (Spain)
+- `es\_MX <https://faker.readthedocs.io/en/master/locales/es_MX.html>`__ - Spanish (Mexico)
+- `fa\_IR <https://faker.readthedocs.io/en/master/locales/fa_IR.html>`__ - Persian (Iran)
+- `fi\_FI <https://faker.readthedocs.io/en/master/locales/fi_FI.html>`__ - Finnish
+- `fr\_FR <https://faker.readthedocs.io/en/master/locales/fr_FR.html>`__ - French
+- `hi\_IN <https://faker.readthedocs.io/en/master/locales/hi_IN.html>`__ - Hindi
+- `hr\_HR <https://faker.readthedocs.io/en/master/locales/hr_HR.html>`__ - Croatian
+- `it\_IT <https://faker.readthedocs.io/en/master/locales/it_IT.html>`__ - Italian
+- `ja\_JP <https://faker.readthedocs.io/en/master/locales/ja_JP.html>`__ - Japanese
+- `ko\_KR <https://faker.readthedocs.io/en/master/locales/ko_KR.html>`__ - Korean
+- `lt\_LT <https://faker.readthedocs.io/en/master/locales/lt_LT.html>`__ - Lithuanian
+- `lv\_LV <https://faker.readthedocs.io/en/master/locales/lv_LV.html>`__ - Latvian
+- `ne\_NP <https://faker.readthedocs.io/en/master/locales/ne_NP.html>`__ - Nepali
+- `nl\_NL <https://faker.readthedocs.io/en/master/locales/nl_NL.html>`__ - Dutch (Netherlands)
+- `no\_NO <https://faker.readthedocs.io/en/master/locales/no_NO.html>`__ - Norwegian
+- `pl\_PL <https://faker.readthedocs.io/en/master/locales/pl_PL.html>`__ - Polish
+- `pt\_BR <https://faker.readthedocs.io/en/master/locales/pt_BR.html>`__ - Portuguese (Brazil)
+- `pt\_PT <https://faker.readthedocs.io/en/master/locales/pt_PT.html>`__ - Portuguese (Portugal)
+- `ru\_RU <https://faker.readthedocs.io/en/master/locales/ru_RU.html>`__ - Russian
+- `sl\_SI <https://faker.readthedocs.io/en/master/locales/sl_SI.html>`__ - Slovene
+- `sv\_SE <https://faker.readthedocs.io/en/master/locales/sv_SE.html>`__ - Swedish
+- `tr\_TR <https://faker.readthedocs.io/en/master/locales/tr_TR.html>`__ - Turkish
+- `uk\_UA <https://faker.readthedocs.io/en/master/locales/uk_UA.html>`__ - Ukrainian
+- `zh\_CN <https://faker.readthedocs.io/en/master/locales/zh_CN.html>`__ - Chinese (China)
+- `zh\_TW <https://faker.readthedocs.io/en/master/locales/zh_TW.html>`__ - Chinese (Taiwan)
Command line usage
------------------
@@ -191,7 +192,7 @@ Where:
- ``-s SEP``: will generate the specified separator after each
generated output
-- ``-i {my.custom_provider other.custom_provider}`` list of additional custom providers to use.
+- ``-i {my.custom_provider other.custom_provider}`` list of additional custom providers to use.
Note that is the import path of the module containing your Provider class, not the custom Provider class itself.
- ``fake``: is the name of the fake to generate an output for, such as
@@ -215,12 +216,9 @@ Examples:
{'ssn': u'628-10-1085', 'birthdate': '2008-03-29'}
$ faker -r=3 -s=";" name
- Willam Kertzmann
- ;
- Josiah Maggio
- ;
- Gayla Schmitt
- ;
+ Willam Kertzmann;
+ Josiah Maggio;
+ Gayla Schmitt;
How to create a Provider
------------------------
@@ -251,17 +249,17 @@ How to use with factory-boy
.. code:: python
import factory
- from faker import Factory as FakerFactory
+ from faker import Faker
from myapp.models import Book
- faker = FakerFactory.create()
+ fake = Faker()
class Book(factory.Factory):
FACTORY_FOR = Book
- title = factory.LazyAttribute(lambda x: faker.sentence(nb_words=4))
- author_name = factory.LazyAttribute(lambda x: faker.name())
+ title = factory.LazyAttribute(lambda x: fake.sentence(nb_words=4))
+ author_name = factory.LazyAttribute(lambda x: fake.name())
Accessing the `random` instance
-------------------------------
@@ -299,7 +297,7 @@ The code above is equivalent to the following:
from faker import Faker
fake = Faker()
- faker.random.seed(4321)
+ fake.random.seed(4321)
print fake.name()
> Margaret Boehm
@@ -355,17 +353,17 @@ Credits
.. _PHP Faker: https://github.com/fzaninotto/Faker
.. _Perl Faker: http://search.cpan.org/~jasonk/Data-Faker-0.07/
.. _Ruby Faker: http://faker.rubyforge.org/
-.. _Distribute: http://pypi.python.org/pypi/distribute
+.. _Distribute: https://pypi.python.org/pypi/distribute
.. _Buildout: http://www.buildout.org/
-.. _modern-package-template: http://pypi.python.org/pypi/modern-package-template
-.. _extended docs: http://fake-factory.readthedocs.org/en/latest/
-.. _bundled providers: http://fake-factory.readthedocs.org/en/latest/providers.html
-.. _community providers: http://fake-factory.readthedocs.org/en/latest/communityproviders.html
+.. _modern-package-template: https://pypi.python.org/pypi/modern-package-template
+.. _extended docs: https://faker.readthedocs.io/en/latest/
+.. _bundled providers: https://faker.readthedocs.io/en/latest/providers.html
+.. _community providers: https://faker.readthedocs.io/en/latest/communityproviders.html
.. _LICENSE: https://github.com/joke2k/faker/blob/master/LICENSE.txt
.. _CONTRIBUTING: https://github.com/joke2k/faker/blob/master/CONTRIBUTING.rst
-.. |pypi| image:: https://img.shields.io/pypi/v/fake-factory.svg?style=flat-square&label=version
- :target: https://pypi.python.org/pypi/fake-factory
+.. |pypi| image:: https://img.shields.io/pypi/v/Faker.svg?style=flat-square&label=version
+ :target: https://pypi.python.org/pypi/Faker
:alt: Latest version released on PyPi
.. |coverage| image:: https://img.shields.io/coveralls/joke2k/faker/master.svg?style=flat-square
@@ -376,14 +374,10 @@ Credits
:target: http://travis-ci.org/joke2k/faker
:alt: Build status of the master branch on Mac/Linux
-.. |windows_build| image:: https://img.shields.io/appveyor/ci/joke2k/faker.svg?style=flat-square&label=windows%20build
+.. |windows_build| image:: https://img.shields.io/appveyor/ci/joke2k/faker/master.svg?style=flat-square&label=windows%20build
:target: https://ci.appveyor.com/project/joke2k/faker
:alt: Build status of the master branch on Windows
-.. |downloads| image:: https://img.shields.io/pypi/dm/fake-factory.svg?style=flat-square
- :target: https://pypi.python.org/pypi/fake-factory
- :alt: Monthly downloads
-
.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
:target: https://raw.githubusercontent.com/joke2k/faker/master/LICENSE.txt
:alt: Package license
diff --git a/docs/coding_style.rst b/docs/coding_style.rst
index de18021..6d200db 100644
--- a/docs/coding_style.rst
+++ b/docs/coding_style.rst
@@ -26,5 +26,5 @@ Name Lists
When you have long lists of names, please order them alphabetically. Keep the lines length as close as possible to 80 characters, without exceeding the limit.
-.. _`pep 8`: http://legacy.python.org/dev/peps/pep-0008/
-.. _`pep 263`: http://legacy.python.org/dev/peps/pep-0263/
+.. _`pep 8`: https://python.org/dev/peps/pep-0008
+.. _`pep 263`: https://python.org/dev/peps/pep-0263
diff --git a/docs/conf.py b/docs/conf.py
index f913ced..e514a28 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -54,9 +54,9 @@ copyright = u'2014, Daniele Faraglia'
# built documents.
#
# The short X.Y version.
-version = '0.5.7'
+version = '0.7.7'
# The full version, including alpha/beta/rc tags.
-release = '0.5.7'
+release = '0.7.7'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
diff --git a/docs/index.rst b/docs/index.rst
index f34dada..5b07a8f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -14,16 +14,16 @@ Welcome to Faker's documentation!
_| _| _| _| _| _| _|
_| _|_|_| _| _| _|_|_| _|
+*Faker* is a Python package that generates fake data for you. Whether
+you need to bootstrap your database, create good-looking XML documents,
+fill-in your persistence to stress test it, or anonymize data taken from
+a production service, Faker is for you.
-*Faker* is a Python package that generates fake data for you. Whether you need to bootstrap your database,
-create good-looking XML documents, fill-in your persistence to stress test it, or anonymize data taken from a production service,
-Faker is for you.
-
-Faker is heavily inspired by PHP's `Faker <https://github.com/fzaninotto/Faker>`_, Perl's `Data::Faker <http://search.cpan.org/~jasonk/Data-Faker-0.07/>`_, and by ruby's `Faker <http://faker.rubyforge.org/>`_.
+Faker is heavily inspired by `PHP Faker`_, `Perl Faker`_, and by `Ruby Faker`_.
----
-|pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+|pypi| |unix_build| |windows_build| |coverage| |license|
----
@@ -34,7 +34,8 @@ Install with pip:
.. code:: bash
- pip install fake-factory
+ pip install Faker
+
Use ``faker.Factory.create()`` to create and initialize a faker
generator, which can generate data by accessing properties named after
@@ -42,31 +43,30 @@ the type of data you want.
.. code:: python
+ from faker import Factory
+ fake = Factory.create()
- from faker import Factory
- fake = Factory.create()
-
- # OR
- from faker import Faker
- fake = Faker()
+ # OR
+ from faker import Faker
+ fake = Faker()
- fake.name()
- # 'Lucy Cechtelar'
+ fake.name()
+ # 'Lucy Cechtelar'
- fake.address()
- # "426 Jordy Lodge
- # Cartwrightshire, SC 88120-6700"
+ fake.address()
+ # "426 Jordy Lodge
+ # Cartwrightshire, SC 88120-6700"
- fake.text()
- # Sint velit eveniet. Rerum atque repellat voluptatem quia rerum. Numquam excepturi
- # beatae sint laudantium consequatur. Magni occaecati itaque sint et sit tempore. Nesciunt
- # amet quidem. Iusto deleniti cum autem ad quia aperiam.
- # A consectetur quos aliquam. In iste aliquid et aut similique suscipit. Consequatur qui
- # quaerat iste minus hic expedita. Consequuntur error magni et laboriosam. Aut aspernatur
- # voluptatem sit aliquam. Dolores voluptatum est.
- # Aut molestias et maxime. Fugit autem facilis quos vero. Eius quibusdam possimus est.
- # Ea quaerat et quisquam. Deleniti sunt quam. Adipisci consequatur id in occaecati.
- # Et sint et. Ut ducimus quod nemo ab voluptatum.
+ fake.text()
+ # Sint velit eveniet. Rerum atque repellat voluptatem quia rerum. Numquam excepturi
+ # beatae sint laudantium consequatur. Magni occaecati itaque sint et sit tempore. Nesciunt
+ # amet quidem. Iusto deleniti cum autem ad quia aperiam.
+ # A consectetur quos aliquam. In iste aliquid et aut similique suscipit. Consequatur qui
+ # quaerat iste minus hic expedita. Consequuntur error magni et laboriosam. Aut aspernatur
+ # voluptatem sit aliquam. Dolores voluptatum est.
+ # Aut molestias et maxime. Fugit autem facilis quos vero. Eius quibusdam possimus est.
+ # Ea quaerat et quisquam. Deleniti sunt quam. Adipisci consequatur id in occaecati.
+ # Et sint et. Ut ducimus quod nemo ab voluptatum.
Each call to method ``fake.name()`` yields a different (random) result.
This is because faker forwards ``faker.Generator.method_name()`` calls
@@ -74,20 +74,19 @@ to ``faker.Generator.format(method_name)``.
.. code:: python
-
- for _ in range(0,10):
+ for _ in range(0, 10):
print fake.name()
- # Adaline Reichel
- # Dr. Santa Prosacco DVM
- # Noemy Vandervort V
- # Lexi O'Conner
- # Gracie Weber
- # Roscoe Johns
- # Emmett Lebsack
- # Keegan Thiel
- # Wellington Koelpin II
- # Ms. Karley Kiehn V
+ # Adaline Reichel
+ # Dr. Santa Prosacco DVM
+ # Noemy Vandervort V
+ # Lexi O'Conner
+ # Gracie Weber
+ # Roscoe Johns
+ # Emmett Lebsack
+ # Keegan Thiel
+ # Wellington Koelpin II
+ # Ms. Karley Kiehn V
Providers
---------
@@ -110,7 +109,7 @@ default en\_US locale.
from faker import Factory
fake = Factory.create('it_IT')
- for _ in range(0,10):
+ for _ in range(0, 10):
print fake.name()
> Elda Palumbo
@@ -131,38 +130,40 @@ provider for your own locale and submit a Pull Request (PR).
Included localized providers:
-- `bg\_BG <http://fake-factory.readthedocs.org/en/master/locales/bg_BG.html>`__ - Bulgarian
-- `cs\_CZ <http://fake-factory.readthedocs.org/en/master/locales/cs_CZ.html>`__ - Czech
-- `de\_DE <http://fake-factory.readthedocs.org/en/master/locales/de_DE.html>`__ - German
-- `dk\_DK <http://fake-factory.readthedocs.org/en/master/locales/dk_DK.html>`__ - Danish
-- `el\_GR <http://fake-factory.readthedocs.org/en/master/locales/el_GR.html>`__ - Greek
-- `en\_AU <http://fake-factory.readthedocs.org/en/master/locales/en_AU.html>`__ - English (Australia)
-- `en\_CA <http://fake-factory.readthedocs.org/en/master/locales/en_CA.html>`__ - English (Canada)
-- `en\_GB <http://fake-factory.readthedocs.org/en/master/locales/en_GB.html>`__ - English (Great Britain)
-- `en\_US <http://fake-factory.readthedocs.org/en/master/locales/en_US.html>`__ - English (United States)
-- `es\_ES <http://fake-factory.readthedocs.org/en/master/locales/es_ES.html>`__ - Spanish (Spain)
-- `es\_MX <http://fake-factory.readthedocs.org/en/master/locales/es_MX.html>`__ - Spanish (Mexico)
-- `fa\_IR <http://fake-factory.readthedocs.org/en/master/locales/fa_IR.html>`__ - Persian (Iran)
-- `fi\_FI <http://fake-factory.readthedocs.org/en/master/locales/fi_FI.html>`__ - Finnish
-- `fr\_FR <http://fake-factory.readthedocs.org/en/master/locales/fr_FR.html>`__ - French
-- `hi\_IN <http://fake-factory.readthedocs.org/en/master/locales/hi_IN.html>`__ - Hindi
-- `it\_IT <http://fake-factory.readthedocs.org/en/master/locales/it_IT.html>`__ - Italian
-- `ko\_KR <http://fake-factory.readthedocs.org/en/master/locales/ko_KR.html>`__ - Korean
-- `lt\_LT <http://fake-factory.readthedocs.org/en/master/locales/lt_LT.html>`__ - Lithuanian
-- `lv\_LV <http://fake-factory.readthedocs.org/en/master/locales/lv_LV.html>`__ - Latvian
-- `ne\_NP <http://fake-factory.readthedocs.org/en/master/locales/ne_NP.html>`__ - Nepali
-- `nl\_NL <http://fake-factory.readthedocs.org/en/master/locales/nl_NL.html>`__ - Dutch (Netherlands)
-- `no\_NO <http://fake-factory.readthedocs.org/en/master/locales/no_NO.html>`__ - Norwegian
-- `pl\_PL <http://fake-factory.readthedocs.org/en/master/locales/pl_PL.html>`__ - Polish
-- `pt\_BR <http://fake-factory.readthedocs.org/en/master/locales/pt_BR.html>`__ - Portuguese (Brazil)
-- `pt\_PT <http://fake-factory.readthedocs.org/en/master/locales/pt_PT.html>`__ - Portuguese (Portugal)
-- `ru\_RU <http://fake-factory.readthedocs.org/en/master/locales/ru_RU.html>`__ - Russian
-- `sk\_SK <http://fake-factory.readthedocs.org/en/master/locales/sk_SK.html>`__ - Slovak
-- `sl\_SI <http://fake-factory.readthedocs.org/en/master/locales/sl_SI.html>`__ - Slovene
-- `sv\_SE <http://fake-factory.readthedocs.org/en/master/locales/sv_SE.html>`__ - Swedish
-- `tr\_TR <http://fake-factory.readthedocs.org/en/master/locales/tr_TR.html>`__ - Turkish
-- `zh\_CN <http://fake-factory.readthedocs.org/en/master/locales/zh_CN.html>`__ - Chinese (China)
-- `zh\_TW <http://fake-factory.readthedocs.org/en/master/locales/zh_TW.html>`__ - Chinese (Taiwan)
+- `bg\_BG <https://faker.readthedocs.io/en/master/locales/bg_BG.html>`__ - Bulgarian
+- `cs\_CZ <https://faker.readthedocs.io/en/master/locales/cs_CZ.html>`__ - Czech
+- `de\_DE <https://faker.readthedocs.io/en/master/locales/de_DE.html>`__ - German
+- `dk\_DK <https://faker.readthedocs.io/en/master/locales/dk_DK.html>`__ - Danish
+- `el\_GR <https://faker.readthedocs.io/en/master/locales/el_GR.html>`__ - Greek
+- `en\_AU <https://faker.readthedocs.io/en/master/locales/en_AU.html>`__ - English (Australia)
+- `en\_CA <https://faker.readthedocs.io/en/master/locales/en_CA.html>`__ - English (Canada)
+- `en\_GB <https://faker.readthedocs.io/en/master/locales/en_GB.html>`__ - English (Great Britain)
+- `en\_US <https://faker.readthedocs.io/en/master/locales/en_US.html>`__ - English (United States)
+- `es\_ES <https://faker.readthedocs.io/en/master/locales/es_ES.html>`__ - Spanish (Spain)
+- `es\_MX <https://faker.readthedocs.io/en/master/locales/es_MX.html>`__ - Spanish (Mexico)
+- `fa\_IR <https://faker.readthedocs.io/en/master/locales/fa_IR.html>`__ - Persian (Iran)
+- `fi\_FI <https://faker.readthedocs.io/en/master/locales/fi_FI.html>`__ - Finnish
+- `fr\_FR <https://faker.readthedocs.io/en/master/locales/fr_FR.html>`__ - French
+- `hi\_IN <https://faker.readthedocs.io/en/master/locales/hi_IN.html>`__ - Hindi
+- `hr\_HR <https://faker.readthedocs.io/en/master/locales/hr_HR.html>`__ - Croatian
+- `it\_IT <https://faker.readthedocs.io/en/master/locales/it_IT.html>`__ - Italian
+- `ja\_JP <https://faker.readthedocs.io/en/master/locales/ja_JP.html>`__ - Japanese
+- `ko\_KR <https://faker.readthedocs.io/en/master/locales/ko_KR.html>`__ - Korean
+- `lt\_LT <https://faker.readthedocs.io/en/master/locales/lt_LT.html>`__ - Lithuanian
+- `lv\_LV <https://faker.readthedocs.io/en/master/locales/lv_LV.html>`__ - Latvian
+- `ne\_NP <https://faker.readthedocs.io/en/master/locales/ne_NP.html>`__ - Nepali
+- `nl\_NL <https://faker.readthedocs.io/en/master/locales/nl_NL.html>`__ - Dutch (Netherlands)
+- `no\_NO <https://faker.readthedocs.io/en/master/locales/no_NO.html>`__ - Norwegian
+- `pl\_PL <https://faker.readthedocs.io/en/master/locales/pl_PL.html>`__ - Polish
+- `pt\_BR <https://faker.readthedocs.io/en/master/locales/pt_BR.html>`__ - Portuguese (Brazil)
+- `pt\_PT <https://faker.readthedocs.io/en/master/locales/pt_PT.html>`__ - Portuguese (Portugal)
+- `ru\_RU <https://faker.readthedocs.io/en/master/locales/ru_RU.html>`__ - Russian
+- `sl\_SI <https://faker.readthedocs.io/en/master/locales/sl_SI.html>`__ - Slovene
+- `sv\_SE <https://faker.readthedocs.io/en/master/locales/sv_SE.html>`__ - Swedish
+- `tr\_TR <https://faker.readthedocs.io/en/master/locales/tr_TR.html>`__ - Turkish
+- `uk\_UA <https://faker.readthedocs.io/en/master/locales/uk_UA.html>`__ - Ukrainian
+- `zh\_CN <https://faker.readthedocs.io/en/master/locales/zh_CN.html>`__ - Chinese (China)
+- `zh\_TW <https://faker.readthedocs.io/en/master/locales/zh_TW.html>`__ - Chinese (Taiwan)
Command line usage
------------------
@@ -174,7 +175,8 @@ When installed, you can invoke faker from the command-line:
faker [-h] [--version] [-o output]
[-l {bg_BG,cs_CZ,...,zh_CN,zh_TW}]
[-r REPEAT] [-s SEP]
- [fake [fake ...]]
+ [-i {module.containing.custom_provider othermodule.containing.custom_provider}]
+ [fake] [fake argument [fake argument ...]]
Where:
@@ -195,12 +197,13 @@ Where:
- ``-s SEP``: will generate the specified separator after each
generated output
+- ``-i {my.custom_provider other.custom_provider}`` list of additional custom providers to use.
+ Note that is the import path of the module containing your Provider class, not the custom Provider class itself.
+
- ``fake``: is the name of the fake to generate an output for, such as
``name``, ``address``, or ``text``
-- ``[fake ...]``: is an optional comma-separated list of field names to
- pass to the fake, such as ``ssn,birthday`` when the ``profile`` fake
- is used
+- ``[fake argument ...]``: optional arguments to pass to the fake (e.g. the profile fake takes an optional list of comma separated field names as the first argument)
Examples:
@@ -218,12 +221,9 @@ Examples:
{'ssn': u'628-10-1085', 'birthdate': '2008-03-29'}
$ faker -r=3 -s=";" name
- Willam Kertzmann
- ;
- Josiah Maggio
- ;
- Gayla Schmitt
- ;
+ Willam Kertzmann;
+ Josiah Maggio;
+ Gayla Schmitt;
How to create a Provider
------------------------
@@ -254,17 +254,17 @@ How to use with factory-boy
.. code:: python
import factory
- from faker import Factory as FakerFactory
+ from faker import Faker
from myapp.models import Book
- faker = FakerFactory.create()
+ fake = Faker()
class Book(factory.Factory):
FACTORY_FOR = Book
- title = factory.LazyAttribute(lambda x: faker.sentence(nb_words=4))
- author_name = factory.LazyAttribute(lambda x: faker.name())
+ title = factory.LazyAttribute(lambda x: fake.sentence(nb_words=4))
+ author_name = factory.LazyAttribute(lambda x: fake.name())
Accessing the `random` instance
-------------------------------
@@ -302,7 +302,7 @@ The code above is equivalent to the following:
from faker import Faker
fake = Faker()
- faker.random.seed(4321)
+ fake.random.seed(4321)
print fake.name()
> Margaret Boehm
@@ -310,6 +310,12 @@ The code above is equivalent to the following:
Tests
-----
+Installing dependencies:
+
+.. code:: bash
+
+ $ pip install -r faker/tests/requirements.txt
+
Run tests:
.. code:: bash
@@ -352,15 +358,17 @@ Credits
.. _PHP Faker: https://github.com/fzaninotto/Faker
.. _Perl Faker: http://search.cpan.org/~jasonk/Data-Faker-0.07/
.. _Ruby Faker: http://faker.rubyforge.org/
-.. _Distribute: http://pypi.python.org/pypi/distribute
+.. _Distribute: https://pypi.python.org/pypi/distribute
.. _Buildout: http://www.buildout.org/
-.. _modern-package-template: http://pypi.python.org/pypi/modern-package-template
-.. _extended docs: http://fake-factory.readthedocs.org/en/latest/
+.. _modern-package-template: https://pypi.python.org/pypi/modern-package-template
+.. _extended docs: https://faker.readthedocs.io/en/latest/
+.. _bundled providers: https://faker.readthedocs.io/en/latest/providers.html
+.. _community providers: https://faker.readthedocs.io/en/latest/communityproviders.html
.. _LICENSE: https://github.com/joke2k/faker/blob/master/LICENSE.txt
.. _CONTRIBUTING: https://github.com/joke2k/faker/blob/master/CONTRIBUTING.rst
-.. |pypi| image:: https://img.shields.io/pypi/v/fake-factory.svg?style=flat-square&label=version
- :target: https://pypi.python.org/pypi/fake-factory
... 13674 lines suppressed ...
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/faker.git
More information about the Python-modules-commits
mailing list