[Python-modules-commits] [fake-factory] 01/13: Import fake-factory_0.5.3.orig.tar.gz

Christopher Baines cbaines-guest at moszumanska.debian.org
Sun Feb 7 21:14:25 UTC 2016


This is an automated email from the git hooks/post-receive script.

cbaines-guest pushed a commit to branch master
in repository fake-factory.

commit e61f45f8cefe1d94551e01fc8ed2a2da047408cd
Author: Christopher Baines <mail at cbaines.net>
Date:   Sun Feb 7 20:39:27 2016 +0000

    Import fake-factory_0.5.3.orig.tar.gz
---
 .bumpversion.cfg                               |    5 +
 .coveragerc                                    |    2 +
 .gitignore                                     |   42 +
 .travis.yml                                    |   20 +
 CHANGELOG.rst                                  |  135 +
 CONTRIBUTING.rst                               |   60 +
 LICENSE.txt                                    |   19 +
 MANIFEST.in                                    |    3 +
 README.rst                                     |  361 ++
 appveyor.yml                                   |   18 +
 circle.yml                                     |    3 +
 docs/Makefile                                  |  177 +
 docs/coding_style.rst                          |   30 +
 docs/conf.py                                   |  261 ++
 docs/index.rst                                 |  379 ++
 docs/locales/.happygit                         |    1 +
 docs/make.bat                                  |  242 ++
 docs/providers/.happygit                       |    1 +
 faker/__init__.py                              |    6 +
 faker/__main__.py                              |    5 +
 faker/build_docs.py                            |  118 +
 faker/cli.py                                   |  180 +
 faker/config.py                                |   13 +
 faker/documentor.py                            |   98 +
 faker/factory.py                               |   87 +
 faker/generator.py                             |   87 +
 faker/providers/__init__.py                    |  179 +
 faker/providers/address/__init__.py            |  108 +
 faker/providers/address/cs_CZ/__init__.py      |  190 +
 faker/providers/address/de_DE/__init__.py      |  191 +
 faker/providers/address/el_GR/__init__.py      | 4724 ++++++++++++++++++++++++
 faker/providers/address/en/__init__.py         |   54 +
 faker/providers/address/en_AU/__init__.py      |  109 +
 faker/providers/address/en_CA/__init__.py      |  119 +
 faker/providers/address/en_GB/__init__.py      |  118 +
 faker/providers/address/en_US/__init__.py      |  169 +
 faker/providers/address/es/__init__.py         |   57 +
 faker/providers/address/es_ES/__init__.py      |   58 +
 faker/providers/address/es_MX/__init__.py      |  118 +
 faker/providers/address/fa_IR/__init__.py      |   47 +
 faker/providers/address/fi_FI/__init__.py      |  148 +
 faker/providers/address/fr_FR/__init__.py      |  150 +
 faker/providers/address/hi_IN/__init__.py      |   55 +
 faker/providers/address/it_IT/__init__.py      |  121 +
 faker/providers/address/ja_JP/__init__.py      |  144 +
 faker/providers/address/ko_KR/__init__.py      |   70 +
 faker/providers/address/nl_NL/__init__.py      |  592 +++
 faker/providers/address/no_NO/__init__.py      |   37 +
 faker/providers/address/pl_PL/__init__.py      |  621 ++++
 faker/providers/address/pt_BR/__init__.py      |  245 ++
 faker/providers/address/pt_PT/__init__.py      |  132 +
 faker/providers/address/sk_SK/__init__.py      | 1162 ++++++
 faker/providers/address/sl_SI/__init__.py      |  514 +++
 faker/providers/address/sv_SE/__init__.py      |  113 +
 faker/providers/address/zh_CN/__init__.py      |   69 +
 faker/providers/address/zh_TW/__init__.py      |   94 +
 faker/providers/barcode/__init__.py            |   28 +
 faker/providers/barcode/en_US/__init__.py      |    5 +
 faker/providers/color/__init__.py              |   84 +
 faker/providers/color/en_US/__init__.py        |    5 +
 faker/providers/company/__init__.py            |   27 +
 faker/providers/company/bg_BG/__init__.py      |   23 +
 faker/providers/company/cs_CZ/__init__.py      |   14 +
 faker/providers/company/de_DE/__init__.py      |   20 +
 faker/providers/company/en_US/__init__.py      |  117 +
 faker/providers/company/es_MX/__init__.py      |  170 +
 faker/providers/company/fa_IR/__init__.py      | 1065 ++++++
 faker/providers/company/fi_FI/__init__.py      |   53 +
 faker/providers/company/fr_FR/__init__.py      |  119 +
 faker/providers/company/it_IT/__init__.py      |   96 +
 faker/providers/company/ja_JP/__init__.py      |   15 +
 faker/providers/company/ko_KR/__init__.py      |   96 +
 faker/providers/company/no_NO/__init__.py      |   18 +
 faker/providers/company/pt_BR/__init__.py      |   64 +
 faker/providers/company/pt_PT/__init__.py      |   37 +
 faker/providers/company/sk_SK/__init__.py      |   14 +
 faker/providers/company/sl_SI/__init__.py      |   13 +
 faker/providers/company/sv_SE/__init__.py      |   16 +
 faker/providers/company/zh_CN/__init__.py      |   27 +
 faker/providers/company/zh_TW/__init__.py      |   40 +
 faker/providers/credit_card/__init__.py        |  122 +
 faker/providers/credit_card/en_US/__init__.py  |    5 +
 faker/providers/currency/__init__.py           |  175 +
 faker/providers/currency/en_US/__init__.py     |    5 +
 faker/providers/date_time/__init__.py          |  483 +++
 faker/providers/date_time/en_US/__init__.py    |    5 +
 faker/providers/file/__init__.py               |  186 +
 faker/providers/file/en_US/__init__.py         |    5 +
 faker/providers/internet/__init__.py           |  154 +
 faker/providers/internet/bg_BG/__init__.py     |   43 +
 faker/providers/internet/cs_CZ/__init__.py     |   27 +
 faker/providers/internet/de_AT/__init__.py     |   19 +
 faker/providers/internet/de_DE/__init__.py     |   19 +
 faker/providers/internet/el_GR/__init__.py     |   80 +
 faker/providers/internet/en_AU/__init__.py     |   12 +
 faker/providers/internet/en_US/__init__.py     |    7 +
 faker/providers/internet/fi_FI/__init__.py     |   13 +
 faker/providers/internet/fr_FR/__init__.py     |   11 +
 faker/providers/internet/ko_KR/__init__.py     |   11 +
 faker/providers/internet/no_NO/__init__.py     |   19 +
 faker/providers/internet/pt_BR/__init__.py     |    9 +
 faker/providers/internet/pt_PT/__init__.py     |    9 +
 faker/providers/internet/sk_SK/__init__.py     |   27 +
 faker/providers/internet/sl_SI/__init__.py     |   36 +
 faker/providers/internet/sv_SE/__init__.py     |   19 +
 faker/providers/job/__init__.py                |  635 ++++
 faker/providers/job/en_US/__init__.py          |    5 +
 faker/providers/job/pl_PL/__init__.py          |  226 ++
 faker/providers/job/ru_RU/__init__.py          |  547 +++
 faker/providers/job/uk_UA/__init__.py          |   65 +
 faker/providers/lorem/__init__.py              |  129 +
 faker/providers/lorem/el_GR/__init__.py        |   75 +
 faker/providers/lorem/la/__init__.py           |   46 +
 faker/providers/lorem/ru_RU/__init__.py        |   46 +
 faker/providers/misc/__init__.py               |  100 +
 faker/providers/misc/en_US/__init__.py         |    5 +
 faker/providers/person/__init__.py             |  109 +
 faker/providers/person/bg_BG/__init__.py       |  212 ++
 faker/providers/person/cs_CZ/__init__.py       |   77 +
 faker/providers/person/de_AT/__init__.py       |   61 +
 faker/providers/person/de_DE/__init__.py       |  469 +++
 faker/providers/person/dk_DK/__init__.py       |  125 +
 faker/providers/person/el_GR/__init__.py       |  438 +++
 faker/providers/person/en/__init__.py          | 1165 ++++++
 faker/providers/person/en_US/__init__.py       |    5 +
 faker/providers/person/es_ES/__init__.py       |  225 ++
 faker/providers/person/es_MX/__init__.py       |  175 +
 faker/providers/person/fa_IR/__init__.py       |   82 +
 faker/providers/person/fi_FI/__init__.py       |  201 +
 faker/providers/person/fr_FR/__init__.py       |   89 +
 faker/providers/person/hi_IN/__init__.py       |   29 +
 faker/providers/person/it_IT/__init__.py       |  101 +
 faker/providers/person/ja_JP/__init__.py       |  111 +
 faker/providers/person/ko_KR/__init__.py       |   33 +
 faker/providers/person/lt_LT/__init__.py       |   54 +
 faker/providers/person/lv_LV/__init__.py       |   57 +
 faker/providers/person/ne_NP/__init__.py       |  254 ++
 faker/providers/person/nl_NL/__init__.py       |  316 ++
 faker/providers/person/no_NO/__init__.py       |  354 ++
 faker/providers/person/pl_PL/__init__.py       |  528 +++
 faker/providers/person/pt_BR/__init__.py       |   70 +
 faker/providers/person/pt_PT/__init__.py       |   75 +
 faker/providers/person/ru_RU/__init__.py       |  213 ++
 faker/providers/person/sl_SI/__init__.py       |   93 +
 faker/providers/person/sv_SE/__init__.py       |  157 +
 faker/providers/person/tr_TR/__init__.py       |  278 ++
 faker/providers/person/uk_UA/__init__.py       |  147 +
 faker/providers/person/zh_CN/__init__.py       |   52 +
 faker/providers/person/zh_TW/__init__.py       |   72 +
 faker/providers/phone_number/__init__.py       |   11 +
 faker/providers/phone_number/bg_BG/__init__.py |   19 +
 faker/providers/phone_number/cs_CZ/__init__.py |   42 +
 faker/providers/phone_number/de_DE/__init__.py |   20 +
 faker/providers/phone_number/dk_DK/__init__.py |   19 +
 faker/providers/phone_number/el_GR/__init__.py |   28 +
 faker/providers/phone_number/en_AU/__init__.py |   46 +
 faker/providers/phone_number/en_CA/__init__.py |   16 +
 faker/providers/phone_number/en_GB/__init__.py |   17 +
 faker/providers/phone_number/en_US/__init__.py |   31 +
 faker/providers/phone_number/es_ES/__init__.py |   13 +
 faker/providers/phone_number/es_MX/__init__.py |   31 +
 faker/providers/phone_number/fa_IR/__init__.py |   25 +
 faker/providers/phone_number/fi_FI/__init__.py |   13 +
 faker/providers/phone_number/fr_FR/__init__.py |   39 +
 faker/providers/phone_number/hi_IN/__init__.py |   12 +
 faker/providers/phone_number/it_IT/__init__.py |   14 +
 faker/providers/phone_number/ja_JP/__init__.py |   12 +
 faker/providers/phone_number/ko_KR/__init__.py |   32 +
 faker/providers/phone_number/lt_LT/__init__.py |   10 +
 faker/providers/phone_number/lv_LV/__init__.py |   10 +
 faker/providers/phone_number/ne_NP/__init__.py |   12 +
 faker/providers/phone_number/nl_NL/__init__.py |   25 +
 faker/providers/phone_number/no_NO/__init__.py |   17 +
 faker/providers/phone_number/pl_PL/__init__.py |   12 +
 faker/providers/phone_number/pt_BR/__init__.py |   73 +
 faker/providers/phone_number/pt_PT/__init__.py |   42 +
 faker/providers/phone_number/ru_RU/__init__.py |   11 +
 faker/providers/phone_number/sk_SK/__init__.py |   17 +
 faker/providers/phone_number/sl_SI/__init__.py |   18 +
 faker/providers/phone_number/sv_SE/__init__.py |   19 +
 faker/providers/phone_number/tr_TR/__init__.py |   16 +
 faker/providers/phone_number/uk_UA/__init__.py |   16 +
 faker/providers/phone_number/zh_CN/__init__.py |   15 +
 faker/providers/phone_number/zh_TW/__init__.py |   13 +
 faker/providers/profile/__init__.py            |   53 +
 faker/providers/profile/en_US/__init__.py      |    5 +
 faker/providers/python/__init__.py             |  124 +
 faker/providers/python/en_US/__init__.py       |    5 +
 faker/providers/ssn/__init__.py                |   13 +
 faker/providers/ssn/en_CA/__init__.py          |   39 +
 faker/providers/ssn/en_US/__init__.py          |   20 +
 faker/providers/ssn/fi_FI/__init__.py          |   46 +
 faker/providers/ssn/it_IT/__init__.py          |   37 +
 faker/providers/ssn/ko_KR/__init__.py          |   12 +
 faker/providers/ssn/nl_NL/__init__.py          |   41 +
 faker/providers/ssn/pt_BR/__init__.py          |   43 +
 faker/providers/ssn/sv_SE/__init__.py          |   47 +
 faker/providers/ssn/uk_UA/__init__.py          |   17 +
 faker/providers/ssn/zh_TW/__init__.py          |   11 +
 faker/providers/user_agent/__init__.py         |  178 +
 faker/providers/user_agent/en_US/__init__.py   |    5 +
 faker/shims/__init__.py                        |    4 +
 faker/shims/counter.py                         |  187 +
 faker/tests/__init__.py                        |  399 ++
 faker/tests/en_GB/__init__.py                  |   19 +
 faker/tests/ja_JP/__init__.py                  |  144 +
 faker/tests/mymodule/__init__.py               |    1 +
 faker/tests/mymodule/en_US/__init__.py         |    7 +
 faker/tests/pt_BR/__init__.py                  |   26 +
 faker/tests/random_state.json                  |    1 +
 faker/tests/requirements.txt                   |    2 +
 faker/utils/__init__.py                        |   11 +
 faker/utils/datasets.py                        |   24 +
 faker/utils/datetime_safe.py                   |  105 +
 faker/utils/decorators.py                      |   19 +
 faker/utils/distribution.py                    |   26 +
 faker/utils/loading.py                         |   31 +
 faker/utils/text.py                            |   27 +
 setup.cfg                                      |    2 +
 setup.py                                       |   60 +
 220 files changed, 27391 insertions(+)

diff --git a/.bumpversion.cfg b/.bumpversion.cfg
new file mode 100644
index 0000000..72605dc
--- /dev/null
+++ b/.bumpversion.cfg
@@ -0,0 +1,5 @@
+[bumpversion]
+current_version = 0.5.3
+files = setup.py faker/__init__.py docs/conf.py
+commit = True
+tag = True
diff --git a/.coveragerc b/.coveragerc
new file mode 100644
index 0000000..4b891c9
--- /dev/null
+++ b/.coveragerc
@@ -0,0 +1,2 @@
+[paths]
+source = faker/
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..cb61558
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,42 @@
+*.py[cod]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+docs/_build
+docs/locales.rst
+docs/locales/*.rst
+docs/providers.rst
+docs/providers/*.rst
+eggs
+parts
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+nosetests.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+.idea
+.projectile
+.ropeproject
\ No newline at end of file
diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..db65dbe
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,20 @@
+language: python
+sudo: false
+branches:
+  only:
+    - master
+python:
+  - 2.6
+  - 2.7
+  - 3.3
+  - 3.4
+  - "pypy"
+  - "pypy3"
+install:
+  - pip install -e .
+  - pip install -r faker/tests/requirements.txt
+  - pip install coveralls
+script:
+  - coverage run --source=faker setup.py test
+after_success:
+  - coveralls
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
new file mode 100644
index 0000000..56d4246
--- /dev/null
+++ b/CHANGELOG.rst
@@ -0,0 +1,135 @@
+Changelog
+=========
+
+`0.5.3 - 21-September-2015 <http://github.com/joke2k/faker/compare/v0.5.2...v0.5.3>`__
+--------------------------------------------------------------------------------------
+
+* Added ``company_vat`` to company ``fi_FI`` provider. Thanks @kivipe.
+* Seed a Random instance instead of the module. Thanks Amy Hanlon.
+* Fixed en_GB postcodes to be more realistic. Thanks @mapleoin for the report.
+* Fixed support for Python 3 in the python provider. Thanks @derekjamescurtis.
+* Fixed U.S. SSN generation. Thanks @jschaf.
+* Use environment markers for wheels. Thanks @RonnyPfannschmidt
+* Fixed Python3 issue in ``pyiterable`` and ``pystruct`` providers. Thanks @derekjamescurtis.
+* Fixed ``en_GB`` postcodes to be more realistic. Thanks @mapleoin.
+* Fixed and improved performance of credit card number provider. Thanks @0x000.
+* Added Brazilian SSN, aka CPF. Thanks @ericchaves.
+* Added female and male names for ``fa_IR``. Thanks @afshinrodgar.
+* Fixed issues with Decimal objects as input to geo_coordinate. Thanks @davy.
+* Fixed bug for ``center`` set to ``None`` in geo_coordinate. Thanks @davy.
+* Fixed deprecated image URL placeholder services.
+* 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>`__
+---------------------------------------------------------------------------------
+
+* Added ``uuid4`` to ``misc`` provider. Thanks Jared Culp.
+* Fixed ``jcb15`` and ``jcb16`` in ``credit_card`` provider. Thanks Rodrigo Braz.
+* Fixed CVV and CID code generation in `credit_card` provider. Thanks Kevin Stone.
+* Added ``--include`` flag to command line tool. Thanks Flavio Curella.
+* 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>`__
+------------------------------------------------------------------------------
+
+* Fixed egg installation. Thanks David R. MacIver, @kecaps
+* Updated person names for ``ru_RU``. Thanks @mousebaiker.
+* Updated ko_KR locale. Thanks Lee Yeonjae.
+* Fixed installation to install importlib on Python 2.6. Thanks Guillaume Thomas.
+* Improved tests. Thanks Aarni Koskela, @kecaps, @kaushal.
+* Made Person ``prefixes``/``suffixes`` always return strings. Thanks Aarni Koskela.
+* ``pl_PL`` jobs added. Thanks Dariusz Choruży.
+* Added ``ja_JP`` provider. Thanks Tatsuji Tsuchiya, Masato Ohba.
+* Localized remaining providers for consistency. Thanks Flavio Curella.
+* List of providers in compiled on runtime and is not hardcoded anymore. Thanks Flavio Curella.
+* Fixed State names in ``en_US``. Thanks Greg Meece.
+* Added ``time_delta`` method to ``date_time`` provider. Thanks Tobin Brown.
+* Added filename and file extension methods to ``file`` provider. Thanks Tobin Brown.
+* Added Finnish ssn (HETU) provider. Thanks @kivipe.
+* Fixed person names for ``pl_PL``. Thanks Marek Bleschke.
+* Added ``sv_SE`` locale providers. Thanks Tome Cvitan.
+* ``pt_BR`` Provider: Added ``catch_phrase`` to Company provider and fixed names in Person Provider. Thanks Marcelo Fonseca Tambalo. 
+* 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>`__
+------------------------------------------------------------------------------
+
+* Localized providers
+* Updated ``ko_KR`` provider. Thanks Lee Yeonjae.
+* Added ``pt_PT`` provider. Thanks João Delgado.
+* Fixed mispellings for ``en_US`` company provider. Thanks Greg Meece.
+* Added currency provider. Thanks Wiktor Ślęczka
+* Ensure choice_distribution always uses floats. Thanks Katy Lavallee.
+* Added ``uk_UA`` provider. Thanks Cyril Tarasenko.
+* Fixed encoding issues with README, CHANGELOG and setup.py. Thanks Sven-Hendrik Haase.
+* Added Turkish person names and phone number patterns. Thanks Murat Çorlu.
+* 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>`__
+--------------------------------------------------------------------------------
+
+* Fixed setup
+
+`0.4.1 - 20-Aug-2014 <http://github.com/joke2k/faker/compare/v0.4...v0.4.1>`__
+------------------------------------------------------------------------------
+
+* Added MAC address provider. Thanks Sébastien Béal.
+* Added ``lt_LT`` and ``lv_LV`` localized providers. Thanks Edgar Gavrik.
+* Added ``nl_NL`` localized providers. Thanks @LolkeAB, @mdxs.
+* Added ``bg_BG`` localized providers. Thanks Bret B.
+* Added ``sl_SI``. Thanks to @janezkranjc
+* Added distribution feature. Thanks to @fcurella
+* Relative date time. Thanks to @soobrosa
+* 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>`__
+----------------------------------------------------------------------------
+
+* Modified en_US ``person.py`` to ouput female and male names. Thanks Adrian Klaver.
+* Added SSN provider for ``en_US`` and ``en_CA``. Thanks Scott (@milliquet).
+* Added ``hi_IN`` localized provider. Thanks Pratik Kabra.
+* Refactoring of command line
+
+0.3.2 - 11-Nov-2013
+-------------------
+
+* New provider: Credit card generator
+* Improved Documentor
+
+
+0.3.1
+-----
+
+* FIX setup.py
+
+
+0.3 - 18-Oct-2013
+-----------------
+
+* PEP8 style conversion (old camelCased methods are deprecated!)
+* New language: ``pt_BR`` (thanks to @rvnovaes)
+* all localized provider now uses ``from __future__ import unicode_literals``
+* documentor prints localized provider after all defaults
+* FIX tests for python 2.6
+
+
+0.2 - 01-Dec-2012
+-----------------
+
+* New providers: ``Python``, ``File``
+* Providers imported with ``__import__``
+* Module is runnable with ``python -m faker [name] [*args]``
+* Rewrite fake generator system (allow autocompletation)
+* New language: French
+* Rewrite module ``__main__`` and new Documentor class
+
+0.1 - 13-Nov-2012
+-----------------
+
+* First release
+
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 0000000..cb17d80
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,60 @@
+How to contribute
+=================
+
+We love pull requests. Here's a quick guide:
+
+Getting Started
+---------------
+
+-  Make sure you have a `GitHub account <https://github.com/signup/free>`__
+-  Submit a ticket for your issue, assuming one does not already exist.
+-  Clearly describe the issue including steps to reproduce when it is a bug.
+-  Make sure you fill in the earliest version that you know has the issue.
+-  Fork the repository on GitHub
+
+Making Changes
+--------------
+
+-  Create a topic branch from where you want to base your work.
+-  This is usually the master branch.
+-  Only target release branches if you are certain your fix must be on
+   that branch.
+-  To quickly create a topic branch based on master;
+   ``git branch fix/master/my_contribution master`` then checkout
+   the new branch with ``git checkout fix/master/my_contribution``.
+   Please avoid working directly on the ``master`` branch.
+-  Make commits of logical units.
+-  Check for unnecessary whitespace with ``git diff --check`` before
+   committing.
+-  Make sure your commit messages are in the proper format.
+
+::
+
+        Make the example in CONTRIBUTING imperative and concrete
+
+        Without this patch applied the example commit message in the CONTRIBUTING
+        document is not a concrete example.  This is a problem because the
+        contributor is left to imagine what the commit message should look like
+        based on a description rather than an example.  This patch fixes the
+        problem by making the example concrete and imperative.
+
+        The first line is a real life imperative statement with a ticket number
+        from our issue tracker.  The body describes the behavior without the patch,
+        why this is a problem, and how the patch fixes the problem when applied.
+
+-  Make sure you have added the necessary tests for your changes.
+-  Run *all* the tests to assure nothing else was accidentally broken.
+
+Submitting Changes
+------------------
+
+-  Push your changes to a topic branch in your fork of the repository.
+-  Submit a pull request to the repository.
+
+Additional Resources
+====================
+
+-  `General GitHub documentation <http://help.github.com/>`__
+-  `GitHub pull request
+   documentation <http://help.github.com/send-pull-requests/>`__
+
diff --git a/LICENSE.txt b/LICENSE.txt
new file mode 100644
index 0000000..8ed0d56
--- /dev/null
+++ b/LICENSE.txt
@@ -0,0 +1,19 @@
+Copyright (c) 2012 Daniele Faraglia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/MANIFEST.in b/MANIFEST.in
new file mode 100644
index 0000000..7cb9744
--- /dev/null
+++ b/MANIFEST.in
@@ -0,0 +1,3 @@
+include *.rst
+include *.md
+include *.txt
\ No newline at end of file
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..d9a136f
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,361 @@
+::
+
+    _|_|_|_|          _|
+    _|        _|_|_|  _|  _|      _|_|    _|  _|_|
+    _|_|_|  _|    _|  _|_|      _|_|_|_|  _|_|
+    _|      _|    _|  _|  _|    _|        _|
+    _|        _|_|_|  _|    _|    _|_|_|  _|
+
+*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 Faker`_, `Perl Faker`_, and by `Ruby Faker`_.
+
+----
+
+|pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+
+----
+
+For more details, see the `extended docs`_.
+
+Basic Usage
+-----------
+
+Install with pip:
+
+.. code:: bash
+
+    pip install fake-factory
+
+Use ``faker.Factory.create()`` to create and initialize a faker
+generator, which can generate data by accessing properties named after
+the type of data you want.
+
+.. code:: python
+
+
+        from faker import Factory
+        fake = Factory.create()
+
+        # OR
+        from faker import Faker
+        fake = Faker()
+
+        fake.name()
+        # 'Lucy Cechtelar'
+
+        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.
+
+Each call to method ``fake.name()`` yields a different (random) result.
+This is because faker forwards ``faker.Generator.method_name()`` calls
+to ``faker.Generator.format(method_name)``.
+
+.. code:: python
+
+
+    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
+
+Providers
+---------
+
+Each of the generator properties (like ``name``, ``address``, and
+``lorem``) are called "fake". A faker generator has many of them,
+packaged in "providers". Here is a list of the bundled formatters in the
+default locale.
+
+Localization
+------------
+
+``faker.Factory`` can take a locale as an argument, to return localized
+data. If no localized provider is found, the factory falls back to the
+default en\_US locale.
+
+.. code:: python
+
+    from faker import Factory
+    fake = Factory.create('it_IT')
+    for _ in range(0,10):
+        print fake.name()
+
+    > Elda Palumbo
+    > Pacifico Giordano
+    > Sig. Avide Guerra
+    > Yago Amato
+    > Eustachio Messina
+    > Dott. Violante Lombardo
+    > Sig. Alighieri Monti
+    > Costanzo Costa
+    > Nazzareno Barbieri
+    > Max Coppola
+
+You can check available Faker locales in the source code, under the
+providers package. The localization of Faker is an ongoing process, for
+which we need your help. Please don't hesitate to create a localized
+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
+-  `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)
+
+Command line usage
+------------------
+
+When installed, you can invoke faker from the command-line:
+
+.. code:: bash
+
+    faker [-h] [--version] [-o output]
+          [-l {bg_BG,cs_CZ,...,zh_CN,zh_TW}]
+          [-r REPEAT] [-s SEP]
+          [-i {module.containing.custom_provider othermodule.containing.custom_provider}]
+          [fake [fake ...]]
+
+Where:
+
+-  ``faker``: is the script when installed in your environment, in
+   development you could use ``python -m faker`` instead
+
+-  ``-h``, ``--help``: shows a help message
+
+-  ``--version``: shows the program's version number
+
+-  ``-o FILENAME``: redirects the output to the specified filename
+
+-  ``-l {bg_BG,cs_CZ,...,zh_CN,zh_TW}``: allows use of a localized
+   provider
+
+-  ``-r REPEAT``: will generate a specified number of outputs
+
+-  ``-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
+
+Examples:
+
+.. code:: bash
+
+    $ faker address
+    968 Bahringer Garden Apt. 722
+    Kristinaland, NJ 09890
+
+    $ faker -l de_DE address
+    Samira-Niemeier-Allee 56
+    94812 Biedenkopf
+
+    $ faker profile ssn,birthdate
+    {'ssn': u'628-10-1085', 'birthdate': '2008-03-29'}
+
+    $ faker -r=3 -s=";" name
+    Willam Kertzmann
+    ;
+    Josiah Maggio
+    ;
+    Gayla Schmitt
+    ;
+
+How to create a Provider
+------------------------
+
+.. code:: python
+
+    from faker import Faker
+    fake = Faker()
+
+    # first, import a similar Provider or use the default one
+    from faker.providers import BaseProvider
+
+    # create new provider class
+    class MyProvider(BaseProvider):
+        def foo(self):
+            return 'bar'
+
+    # then add new provider to faker instance
+    fake.add_provider(MyProvider)
+
+    # now you can use:
+    fake.foo()
+    > 'bar'
+
+How to use with factory-boy
+---------------------------
+
+.. code:: python
+
+    import factory
+    from faker import Factory as FakerFactory
+    from myapp.models import Book
+
+    faker = FakerFactory.create()
+
+
+    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())
+
+Seeding the Generator
+---------------------
+
+When using Faker for unit testing, you will often want to generate the same
+data set. The generator offers a  ``seed()`` method, which seeds the random
+number generator. Calling the same script twice with the same seed produces the
+same results.
+
+.. code:: python
+
+    from faker import Faker
+    fake = Faker()
+    fake.seed(4321)
+
+    print fake.name()
+    > Margaret Boehm
+
+Tests
+-----
+Installing dependencies:
+
+.. code:: bash
+
+    $ pip install -r faker/tests/requirements.txt
+
+Run tests:
+
+.. code:: bash
+
+    $ python setup.py test
+
+or
+
+.. code:: bash
+
+    $ python -m unittest -v faker.tests
+
+Write documentation for providers:
+
+.. code:: bash
+
+    $ python -m faker > docs.txt
+
+
+Contribute
+----------
+
+Please see `CONTRIBUTING`_.
+
+License
+-------
+
+Faker is released under the MIT License. See the bundled `LICENSE`_ file for details.
+
+Credits
+-------
+
+-  `FZaninotto`_ / `PHP Faker`_
+-  `Distribute`_
+-  `Buildout`_
+-  `modern-package-template`_
+
+
+.. _FZaninotto: https://github.com/fzaninotto
+.. _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
+.. _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/
+.. _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
+    :alt: Latest version released on PyPi
+
+.. |coverage| image:: https://img.shields.io/coveralls/joke2k/faker/master.svg?style=flat-square
+    :target: https://coveralls.io/r/joke2k/faker?branch=master
+    :alt: Test coverage
+
+.. |unix_build| image:: https://img.shields.io/travis/joke2k/faker/master.svg?style=flat-square&label=unix%20build
+    :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
+    :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/appveyor.yml b/appveyor.yml
new file mode 100644
index 0000000..a7a2023
--- /dev/null
+++ b/appveyor.yml
@@ -0,0 +1,18 @@
+# https://ci.appveyor.com/project/joke2k/faker
+build: false
+environment:
+  PYTHONIOENCODING: "utf-8"
+  matrix:
+    - PYTHON: "C:/Python27"
+    - PYTHON: "C:/Python34"
+init:
+  - "ECHO %PYTHON%"
+  - ps: "ls C:/Python*"
+install:
+  - ps: (new-object net.webclient).DownloadFile('https://raw.github.com/pypa/pip/master/contrib/get-pip.py', 'C:/get-pip.py')
+  - "%PYTHON%/python.exe C:/get-pip.py"
+  - "%PYTHON%/Scripts/pip.exe install -e ."
+  - "%PYTHON%/Scripts/pip.exe install -r faker/tests/requirements.txt"
+test_script:
+  - "%PYTHON%/Scripts/pip.exe --version"
+  - "%PYTHON%/python.exe setup.py test"
diff --git a/circle.yml b/circle.yml
new file mode 100644
index 0000000..d600526
--- /dev/null
+++ b/circle.yml
@@ -0,0 +1,3 @@
+dependencies:
+  pre:
+    - pip install -r faker/tests/requirements.txt
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..e1d917a
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,177 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
... 27970 lines suppressed ...

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/fake-factory.git



More information about the Python-modules-commits mailing list