
Language en_US
===============

``faker.providers.address``
---------------------------

::

	fake.longitude()
	# Decimal('167.621522')

	fake.building_number()
	# u'7828'

	fake.street_address()
	# u'1826 Felicia Rue'

	fake.postalcode_plus4()
	# u'25029-7333'

	fake.city_prefix()
	# u'East'

	fake.military_ship()
	# u'USS'

	fake.country_code()
	# u'VN'

	fake.city()
	# u'Watsicastad'

	fake.zipcode_plus4()
	# u'59496-6541'

	fake.state_abbr()
	# u'GA'

	fake.latitude()
	# Decimal('-44.030651')

	fake.street_suffix()
	# u'Extension'

	fake.city_suffix()
	# u'mouth'

	fake.military_dpo()
	# u'Unit 7372 Box 8428'

	fake.country()
	# u'Belgium'

	fake.secondary_address()
	# u'Suite 151'

	fake.geo_coordinate(center=None, radius=0.001)
	# Decimal('-167.037195')

	fake.postalcode()
	# u'51914'

	fake.address()
	# u'5658 Margarito Fork\nElisashire, MS 16919'

	fake.state()
	# u'Michigan'

	fake.military_state()
	# u'AA'

	fake.street_name()
	# u'Gutmann Courts'

	fake.zipcode()
	# u'63542'

	fake.postcode()
	# u'14342-4699'

	fake.military_apo()
	# u'PSC 8616, Box 1831'

``faker.providers.barcode``
---------------------------

::

	fake.ean(length=13)
	# u'2023017158777'

	fake.ean13()
	# u'8228472090363'

	fake.ean8()
	# u'51136321'

``faker.providers.color``
-------------------------

::

	fake.rgb_css_color()
	# u'rgb(67,40,121)'

	fake.color_name()
	# u'DarkBlue'

	fake.rgb_color_list()
	# (172, 126, 39)

	fake.rgb_color()
	# u'251,1,91'

	fake.safe_hex_color()
	# u'#22ff00'

	fake.safe_color_name()
	# u'white'

	fake.hex_color()
	# u'#c7c7a3'

``faker.providers.company``
---------------------------

::

	fake.company()
	# u'Terry, Eichmann and Kreiger'

	fake.company_suffix()
	# u'Ltd'

	fake.catch_phrase()
	# u'Compatible non-volatile task-force'

	fake.bs()
	# u'embrace global communities'

``faker.providers.credit_card``
-------------------------------

::

	fake.credit_card_security_code(card_type=None)
	# u'631'

	fake.credit_card_provider(card_type=None)
	# u'JCB 16 digit'

	fake.credit_card_full(card_type=None)
	# u'JCB 16 digit\nArietta Durgan\n3112921689300271 08/23\nCVC: 903\n'

	fake.credit_card_expire(start="now", end="+10y", date_format="%m/%y")
	# '07/22'

	fake.credit_card_number(card_type=None)
	# u'30272109713130'

``faker.providers.currency``
----------------------------

::

	fake.currency_code()
	# 'IMP'

``faker.providers.date_time``
-----------------------------

::

	fake.date_time_ad()
	# datetime.datetime(15, 2, 8, 13, 44, 1)

	fake.month()
	# '07'

	fake.am_pm()
	# 'AM'

	fake.timezone()
	# u'Africa/Kinshasa'

	fake.iso8601()
	# '1990-12-24T04:46:54'

	fake.date_time()
	# datetime(2003, 11, 24, 4, 50, 31)

	fake.month_name()
	# 'March'

	fake.date_time_this_year(before_now=True, after_now=False)
	# datetime(2015, 10, 29, 19, 54, 26)

	fake.unix_time()
	# 1198995053

	fake.day_of_week()
	# 'Monday'

	fake.day_of_month()
	# '05'

	fake.time(pattern="%H:%M:%S")
	# '04:36:51'

	fake.date_time_between(start_date="-30y", end_date="now")
	# datetime(1992, 4, 25, 0, 59, 8)

	fake.date_time_this_month(before_now=True, after_now=False)
	# datetime(2015, 11, 4, 21, 14, 31)

	fake.year()
	# '1997'

	fake.date_time_between_dates(datetime_start=None, datetime_end=None)
	# datetime(2015, 11, 5, 8, 51, 51)

	fake.date_time_this_century(before_now=True, after_now=False)
	# datetime(2014, 9, 29, 17, 24, 49)

	fake.date_time_this_decade(before_now=True, after_now=False)
	# datetime(2013, 7, 16, 22, 57, 48)

	fake.century()
	# u'XII'

	fake.date(pattern="%Y-%m-%d")
	# '2010-05-21'

	fake.time_delta()
	# datetime.timedelta(9405, 81663)

``faker.providers.file``
------------------------

::

	fake.mime_type(category=None)
	# u'audio/webm'

	fake.file_name(category=None, extension=None)
	# u'voluptatem.mp4'

	fake.file_extension(category=None)
	# u'bmp'

``faker.providers.internet``
----------------------------

::

	fake.ipv4()
	# u'131.3.162.60'

	fake.url()
	# u'http://goodwinyost.com/'

	fake.company_email()
	# u'fay.jamir@langworth.org'

	fake.uri()
	# u'http://www.lakinvolkman.org/posts/category/tags/login/'

	fake.domain_word(*args, **kwargs)
	# u'schaden'

	fake.image_url(width=None, height=None)
	# u'http://www.lorempixel.com/370/429'

	fake.tld()
	# u'info'

	fake.free_email()
	# u'alondra.botsford@gmail.com'

	fake.slug(*args, **kwargs)
	# u'numquam-aut-et'

	fake.free_email_domain()
	# u'hotmail.com'

	fake.domain_name()
	# u'heathcote.org'

	fake.uri_extension()
	# u'.php'

	fake.ipv6()
	# u'd974:10f4:0825:69cf:b69a:196d:cd3a:7ddd'

	fake.safe_email()
	# u'corwin.manson@example.net'

	fake.user_name(*args, **kwargs)
	# u'xferry'

	fake.uri_path(deep=None)
	# u'explore/categories/categories'

	fake.email()
	# u'tarah.kris@kuhic.com'

	fake.uri_page()
	# u'main'

	fake.mac_address()
	# u'65:e5:fb:d5:a3:fd'

``faker.providers.job``
-----------------------

::

	fake.job()
	# 'Therapist, nutritional'

``faker.providers.lorem``
-------------------------

::

	fake.text(max_nb_chars=200)
	# u'Nam ut quaerat similique iure voluptatem. Adipisci ullam velit voluptatem rerum dolorem qui sit. Architecto eius eligendi aut ut. Eaque architecto officia eaque quos omnis et.'

	fake.sentence(nb_words=6, variable_nb_words=True)
	# u'Praesentium ab rerum praesentium explicabo ea.'

	fake.word()
	# u'maxime'

	fake.paragraphs(nb=3)
	# [   u'Ad quae reiciendis omnis sed nulla consequuntur. At quos aut molestiae asperiores. Ut assumenda mollitia impedit.',
	#     u'Inventore expedita dolorum eligendi sed quo. Sit quisquam est aliquam.',
	#     u'Quod minima accusamus at possimus. Nisi praesentium consectetur voluptatibus qui. Asperiores vel dignissimos amet.']

	fake.words(nb=3)
	# [u'dolores', u'molestiae', u'expedita']

	fake.paragraph(nb_sentences=3, variable_nb_sentences=True)
	# u'Ut autem voluptas nam consequatur eum possimus. Reiciendis molestiae tempora quo optio atque recusandae. Facere accusamus excepturi distinctio et ut assumenda qui. Quis optio harum dicta est.'

	fake.sentences(nb=3)
	# [   u'Sequi illum in et quia sunt fugit repudiandae.',
	#     u'Debitis et quaerat quibusdam vel.',
	#     u'Maxime asperiores corrupti delectus quo provident ipsam voluptatem.']

``faker.providers.misc``
------------------------

::

	fake.password(length=10, special_chars=True, digits=True, upper_case=True, lower_case=True)
	# u'#@jlsdNd&n'

	fake.locale()
	# u'ru_TR'

	fake.md5(raw_output=False)
	# 'c5e06f1ee6cee9b74a27c8a297459bd8'

	fake.sha1(raw_output=False)
	# '1f2d9c8f75e618f7490f7c99cb5b78619823c2b8'

	fake.null_boolean()
	# None

	fake.sha256(raw_output=False)
	# '56b705bc1fe0f2465c199c7e82ab9a23b3a0ed048d9b3e653e2f6be34346c474'

	fake.uuid4()
	# 'e8ef3472-25f0-4a1d-b35a-56bfc98eb190'

	fake.language_code()
	# u'fr'

	fake.boolean(chance_of_getting_true=50)
	# False

``faker.providers.person``
--------------------------

::

	fake.last_name_male()
	# u'Hauck'

	fake.name_female()
	# u'Alwilda Moore'

	fake.prefix_male()
	# u'Mr.'

	fake.prefix()
	# u'Mrs.'

	fake.name()
	# u'Dr. Rinda Casper'

	fake.suffix_female()
	# u'MD'

	fake.name_male()
	# u'Mervin Wintheiser'

	fake.first_name()
	# u'Rashawn'

	fake.suffix_male()
	# u'MD'

	fake.suffix()
	# u'DVM'

	fake.first_name_male()
	# u'Schley'

	fake.first_name_female()
	# u'Caitlyn'

	fake.last_name_female()
	# u'Bartoletti'

	fake.last_name()
	# u'McLaughlin'

	fake.prefix_female()
	# u'Dr.'

``faker.providers.phone_number``
--------------------------------

::

	fake.phone_number()
	# u'03838323735'

``faker.providers.profile``
---------------------------

::

	fake.simple_profile()
	# {   'address': u'7705 Chandra Squares\nNew Irahaven, WY 70907-8675',
	#     'birthdate': '1982-12-15',
	#     'mail': u'ivor.gerhold@hotmail.com',
	#     'name': u'Macy Wisozk',
	#     'sex': 'M',
	#     'username': u'skye.schamberger'}

	fake.profile(fields=None)
	# {   'address': u'575 Mante Circles\nWest Myrlburgh, KS 20168',
	#     'birthdate': '2011-10-02',
	#     'blood_group': 'A+',
	#     'company': u'Rodriguez, Wisozk and Gibson',
	#     'current_location': (Decimal('-14.2657495'), Decimal('-47.730958')),
	#     'job': 'Town planner',
	#     'mail': u'pink.marvin@gmail.com',
	#     'name': u'Algie Kemmer',
	#     'residence': u'865 Carey Fords Suite 679\nLake Cosmofurt, WI 32972',
	#     'sex': 'F',
	#     'ssn': u'876-09-2905',
	#     'username': u'debert',
	#     'website': [   u'http://www.corwin.com/',
	#                    u'http://cole.com/',
	#                    u'http://www.johnson.com/']}

``faker.providers.python``
--------------------------

::

	fake.pyiterable(nb_elements=10, variable_nb_elements=True, *value_types)
	# (   u'Eum provident vero.',
	#     5641718864602.0,
	#     8453,
	#     u'http://zemlak.com/explore/homepage.htm',
	#     datetime(1985, 1, 14, 10, 16, 11),
	#     u'jjaskolski@koelpin.com',
	#     u'Facilis ullam optio.',
	#     u'Dicta ut.',
	#     1658,
	#     u'Sed dicta nostrum.',
	#     u'Et debitis beatae.')

	fake.pystr(max_chars=20)
	# u'Aut aliquid sunt.'

	fake.pyfloat(left_digits=None, right_digits=None, positive=False)
	# -294017419301.6

	fake.pystruct(count=10, *value_types)
	# (   [   Decimal('-48195490516.0'),
	#         u'Architecto.',
	#         u'At soluta ut.',
	#         u'Ex eum doloremque.',
	#         u'In consequatur.',
	#         u'Qui quaerat unde.',
	#         569989906287326.0,
	#         u'Ab necessitatibus.',
	#         -79191.1,
	#         u'Ut sit explicabo.'],
	#     {   u'aliquid': u'leia09@yahoo.com',
	#         u'eos': u'Corrupti adipisci.',
	#         u'labore': 1968461250.229,
	#         u'libero': u'http://www.larkin.com/homepage/',
	#         u'omnis': u'http://pollichkeebler.biz/register.asp',
	#         u'perspiciatis': u'Dolores numquam id.',
	#         u'quam': u'Sint veniam et.',
	#         u'sit': u'Harum est.',
	#         u'voluptates': u'Illum ea nesciunt.',
	#         u'voluptatum': u'lucretia85@gmail.com'},
	#     {   u'debitis': {   9: u'jbahringer@gmail.com',
	#                         10: [2296, u'Quod consequatur ex.', 1594],
	#                         11: {   9: u'Consequatur impedit.',
	#                                 10: u'Non suscipit.',
	#                                 11: [   8682,
	#                                         datetime(2009, 11, 25, 0, 15, 7)]}},
	#         u'ea': {   2: datetime(2003, 12, 14, 7, 49, 10),
	#                    3: [   u'bridger.mckenzie@schaden.com',
	#                           u'Nisi itaque animi.',
	#                           u'Iure porro qui sint.'],
	#                    4: {   2: datetime(1998, 7, 7, 16, 55, 13),
	#                           3: u'Ab dolor et soluta.',
	#                           4: [   u'http://www.simonis.com/register/',
	#                                  u'Error veritatis eos.']}},
	#         u'enim': {   0: u'http://www.blanda.com/post/',
	#                      1: [   datetime(1980, 12, 14, 21, 22, 29),
	#                             u'Quia et non.',
	#                             u'olene.roob@hotmail.com'],
	#                      2: {   0: 853,
	#                             1: 82571614.4,
	#                             2: [   u'http://mohrblick.info/category.htm',
	#                                    u'Eligendi est culpa.']}},
	#         u'eum': {   1: 2122,
	#                     2: [   u'Adipisci et.',
	#                            u'Quis doloremque.',
	#                            u'http://pollich.info/home.html'],
	#                     3: {   1: 5190,
	#                            2: u'Rerum officiis quos.',
	#                            3: [   datetime(2003, 8, 1, 0, 38, 33),
	#                                   u'Praesentium enim.']}},
	#         u'fugiat': {   3: datetime(1989, 9, 28, 10, 43, 8),
	#                        4: [   datetime(1974, 9, 22, 5, 50, 4),
	#                               u'Velit soluta.',
	#                               639826346719.2],
	#                        5: {   3: 6805,
	#                               4: u'romaguera.loriann@bosco.com',
	#                               5: [u'Quaerat labore.', 5572]}},
	#         u'hic': {   4: u'http://www.ferrykuvalis.com/homepage/',
	#                     5: [   u'Odio odio sapiente.',
	#                            Decimal('68702787.82'),
	#                            datetime(2010, 4, 14, 13, 42, 18)],
	#                     6: {   4: datetime(2001, 2, 27, 10, 8, 48),
	#                            5: -8325.39,
	#                            6: [6452, 464]}},
	#         u'qui': {   8: u'Ipsam corrupti eum.',
	#                     9: [   u'http://www.johns.info/explore/app/main/',
	#                            Decimal('5818513830.58'),
	#                            u'http://lemkemoore.com/register.html'],
	#                     10: {   8: u'Ipsa nulla est.',
	#                             9: datetime(2013, 3, 15, 11, 26, 42),
	#                             10: [u'Officiis qui eum.', 7262]}},
	#         u'quia': {   6: u'Dolores quas aut.',
	#                      7: [731, u'Quidem pariatur.', u'Accusamus voluptas.'],
	#                      8: {   6: 2759, 7: 7057, 8: [u'Dolores corporis.', 4417]}},
	#         u'recusandae': {   5: 842627463.24,
	#                            6: [   Decimal('297418177.0'),
	#                                   -119485.56779638,
	#                                   u'Qui nihil sunt.'],
	#                            7: {   5: Decimal('6.97375289024E+12'),
	#                                   6: -335854.1,
	#                                   7: [   u'Laborum qui ab iste.',
	#                                          u'http://www.lakin.com/search.html']}},
	#         u'rerum': {   7: datetime(2001, 5, 11, 20, 40, 26),
	#                       8: [   datetime(1987, 7, 24, 7, 59, 32),
	#                              u'qveum@luettgen.org',
	#                              datetime(2010, 8, 17, 20, 49, 34)],
	#                       9: {   7: 5257,
	#                              8: u'Quae minus aut.',
	#                              9: [   datetime(2010, 5, 16, 12, 38, 47),
	#                                     datetime(2007, 5, 8, 8, 38, 23)]}}})

	fake.pydecimal(left_digits=None, right_digits=None, positive=False)
	# Decimal('1.23696206064E+13')

	fake.pylist(nb_elements=10, variable_nb_elements=True, *value_types)
	# [   u'http://www.bednarharris.info/register.php',
	#     datetime(1991, 12, 2, 21, 31, 57),
	#     u'Asperiores quas.',
	#     u'Amet sunt in magni.',
	#     5274,
	#     8533,
	#     u'http://bashirian.org/main/',
	#     74833201840.4,
	#     u'Qui quia non.',
	#     87722812476820.0,
	#     3951,
	#     u'Iusto atque officia.',
	#     u'http://kovacek.biz/blog/homepage.htm']

	fake.pytuple(nb_elements=10, variable_nb_elements=True, *value_types)
	# (   u'Voluptatem tempora.',
	#     23112334.554,
	#     u'http://crooks.net/home.php',
	#     527.9,
	#     -44067.642149076,
	#     1904,
	#     u'Et dolorum quis.',
	#     u'wolf.dianne@gmail.com',
	#     Decimal('91269101720.4'),
	#     u'Ad occaecati et sed.',
	#     u'Sit voluptas.')

	fake.pybool()
	# False

	fake.pyset(nb_elements=10, variable_nb_elements=True, *value_types)
	# set([u'Voluptate maiores.', u'Eos nihil aut.', -655.10183649, 2276, datetime(1986, 6, 12, 23, 27, 4), Decimal('269436.424'), u'Reprehenderit quo.', -9379625965581.63, 632031.9, datetime(1974, 3, 25, 2, 27, 46), datetime(1986, 7, 26, 9, 14, 2), datetime(1999, 1, 18, 21, 19, 35), u'Laboriosam sunt in.'])

	fake.pydict(nb_elements=10, variable_nb_elements=True, *value_types)
	# {   u'deleniti': u'Consequatur non.',
	#     u'dolores': 97306183861372.0,
	#     u'ea': 24982257.554798,
	#     u'esse': -35144541800.7,
	#     u'maiores': 439,
	#     u'molestiae': u'http://www.rutherford.com/tag/tags/category/search.php',
	#     u'quas': 2360,
	#     u'vero': u'Non nisi doloribus.'}

	fake.pyint()
	# 8023

``faker.providers.ssn``
-----------------------

::

	fake.ssn()
	# u'069-01-0677'

``faker.providers.user_agent``
------------------------------

::

	fake.mac_processor()
	# u'U; PPC'

	fake.firefox()
	# u'Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_7_0; rv:1.9.3.20) Gecko/2014-02-02 03:40:30 Firefox/8.0'

	fake.linux_platform_token()
	# u'X11; Linux x86_64'

	fake.opera()
	# u'Opera/9.92.(Windows NT 6.0; sl-SI) Presto/2.9.169 Version/11.00'

	fake.windows_platform_token()
	# u'Windows 98; Win 9x 4.90'

	fake.internet_explorer()
	# u'Mozilla/5.0 (compatible; MSIE 5.0; Windows NT 6.1; Trident/5.0)'

	fake.user_agent()
	# u'Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_5_7) AppleWebKit/5352 (KHTML, like Gecko) Chrome/13.0.872.0 Safari/5352'

	fake.chrome()
	# u'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_7_7) AppleWebKit/5360 (KHTML, like Gecko) Chrome/15.0.857.0 Safari/5360'

	fake.linux_processor()
	# u'x86_64'

	fake.mac_platform_token()
	# u'Macintosh; PPC Mac OS X 10_8_5'

	fake.safari()
	# u'Mozilla/5.0 (Windows; U; Windows 98; Win 9x 4.90) AppleWebKit/531.17.2 (KHTML, like Gecko) Version/5.0.3 Safari/531.17.2'
