# Locale pl_PL

## `faker.providers.address`

class faker.providers.address.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  address() → str
    Example:

      ‘791 Crist Parks, Sashabury, IL 86039-9874’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.address()
        ...
        'ul. Wschodnia 76/47\n46-598 Stargard Szczeciński'
        'ul. Okulickiego 94\n69-723 Łowicz'
        'ul. Kaliska 57\n72-104 Skierniewice'
        'pl. Szczęśliwa 87\n57-887 Dzierżoniów'
        'plac Brzozowa 60\n79-506 Zawiercie'

  administrative_unit() → str
    Example:

      ‘Wielkopolskie’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.administrative_unit()
        ...
        'Świętokrzyskie'
        'Warmińsko - mazurskie'
        'Kujawsko - pomorskie'
        'Podkarpackie'
        'Zachodniopomorskie'

  building_number() → str
    Example:

      ‘791’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number()
        ...
        '604'
        '76/47'
        '938'
        '42'
        '94'

  city() → str

    Randomly returns a street name :example: ‘Konin’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city()
        ...
        'Kutno'
        'Lubartów'
        'Szczecinek'
        'Białystok'
        'Kędzierzyn-Koźle'

  city_suffix() → str
    Example:

      ‘town’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city_suffix()
        ...
        'Ville'
        'Ville'
        'Ville'
        'Ville'
        'Ville'

  country() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country()
        ...
        'Maldives'
        'Palestine'
        'Kingdom of the Netherlands'
        'Barbados'
        'Israel'

  country_code(representation: str = 'alpha-2') → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_code()
        ...
        'MV'
        'PS'
        'NL'
        'BB'
        'IL'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_code(representation='alpha-2')
        ...
        'MV'
        'PS'
        'NL'
        'BB'
        'IL'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_code(representation='alpha-3')
        ...
        'MDV'
        'PSE'
        'NLD'
        'BRB'
        'ISR'

  current_country() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.current_country()
        ...
        'Poland'
        'Poland'
        'Poland'
        'Poland'
        'Poland'

  current_country_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.current_country_code()
        ...
        'PL'
        'PL'
        'PL'
        'PL'
        'PL'

  postalcode() → str
    Example:

      ‘62-200’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postalcode()
        ...
        '50-777'
        '54-042'
        '34-989'
        '66-498'
        '52-941'

  postcode() → str
    Example:

      ‘62-200’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '50-777'
        '54-042'
        '34-989'
        '66-498'
        '52-941'

  region() → str
    Example:

      ‘Wielkopolskie’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.region()
        ...
        'Świętokrzyskie'
        'Warmińsko - mazurskie'
        'Kujawsko - pomorskie'
        'Podkarpackie'
        'Zachodniopomorskie'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        'al. Mickiewicza 876'
        'al. Władysława Łokietka 38/24'
        'ulica Wieniawskiego 892'
        'ul. Kaliska 57'
        'aleja Fredry 938'

  street_name() → str

    Randomly returns a street name :example: ‘Wróblewskiego’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        'Kasprowicza'
        'Zapolskiej'
        'Willowa'
        'Mickiewicza'
        'Wschodnia'

  street_prefix() → str

    Randomly returns a street prefix :example: ‘aleja’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_prefix()
        ...
        'aleja'
        'aleja'
        'ulica'
        'aleja'
        'plac'

  street_prefix_short() → str

    Randomly returns an abbreviation of the street prefix. :example: ‘al.’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_prefix_short()
        ...
        'al.'
        'al.'
        'ul.'
        'al.'
        'pl.'

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_suffix()
        ...
        'Street'
        'Street'
        'Street'
        'Street'
        'Street'

  zipcode() → str
    Example:

      ‘62-200’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.zipcode()
        ...
        '50-777'
        '54-042'
        '34-989'
        '66-498'
        '52-941'

## `faker.providers.automotive`

class faker.providers.automotive.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  Implement automotive provider for `pl_PL` locale.

  Sources:

  - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Poland

  license_plate() → str

    Generate a license plate.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate()
        ...
        'MYN 876BI'
        'JPL 3824S'
        'YD 489TZ'
        'JD 578XC'
        'LN 9387K'

  license_plate_regex_formats() → List[str]

    Return a regex for matching license plates.

    Warning

    This is technically not a method that generates fake data, and it should not be part of the public API. User should refrain from using this method.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate_regex_formats()
        ...
        ['[A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z] [0-9][A-Z][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [A-Z][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z][A-Z] [0-9][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][0-9]', '[A-Z][A-Z][A-Z] [0-9][A-Z][A-Z][0-9]', '[A-Z][A-Z][A-Z] [A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]']
        ['[A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z] [0-9][A-Z][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [A-Z][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z][A-Z] [0-9][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][0-9]', '[A-Z][A-Z][A-Z] [0-9][A-Z][A-Z][0-9]', '[A-Z][A-Z][A-Z] [A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]']
        ['[A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z] [0-9][A-Z][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [A-Z][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z][A-Z] [0-9][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][0-9]', '[A-Z][A-Z][A-Z] [0-9][A-Z][A-Z][0-9]', '[A-Z][A-Z][A-Z] [A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]']
        ['[A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z] [0-9][A-Z][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [A-Z][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z][A-Z] [0-9][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][0-9]', '[A-Z][A-Z][A-Z] [0-9][A-Z][A-Z][0-9]', '[A-Z][A-Z][A-Z] [A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]']
        ['[A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z] [0-9][A-Z][0-9][0-9][0-9]', '[A-Z][A-Z] [0-9][A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [A-Z][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][A-Z]', '[A-Z][A-Z][A-Z] [0-9][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][A-Z][0-9]', '[A-Z][A-Z][A-Z] [0-9][A-Z][A-Z][0-9]', '[A-Z][A-Z][A-Z] [A-Z][A-Z][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][0-9]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][0-9][A-Z]', '[A-Z][A-Z][A-Z] [0-9][0-9][0-9][A-Z][A-Z]']

  vin() → str

    Generate vin number.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.vin()
        ...
        'RT3GZYSK4Z9J97593'
        '7G0K75MX5LDXV8156'
        'G416S1YM2EF0V3513'
        '66LZY7KJ7DJV61858'
        'RLFJBCB3669039471'

## `faker.providers.bank`

class faker.providers.bank.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  Implement bank provider for `pl_PL` locale.

  aba() → str

    Generate an ABA routing transit number.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.aba()
        ...
        '076048766'
        '057593829'
        '052194896'
        '034115783'
        '025659384'

  bank() → str

    Generate a bank name.

  bank_country() → str

    Generate the bank provider’s ISO 3166-1 alpha-2 country code.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bank_country()
        ...
        'PL'
        'PL'
        'PL'
        'PL'
        'PL'

  bban() → str

    Generate a Basic Bank Account Number (BBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bban()
        ...
        '660487647593824219489241'
        '157815659387784080160975'
        '351393328711587148418583'
        '989471965934232094711220'
        '186848339694775159179533'

  iban() → str

    Generate an International Bank Account Number (IBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iban()
        ...
        'PL30660487647593824219489241'
        'PL14157815659387784080160975'
        'PL20351393328711587148418583'
        'PL26989471965934232094711220'
        'PL33186848339694775159179533'

  swift(length: int | None = None, primary: bool = False, use_dataset: bool = False) → str

    Generate a SWIFT code.

    SWIFT codes, reading from left to right, are composed of a 4 alphabet character bank code, a 2 alphabet character country code, a 2 alphanumeric location code, and an optional 3 alphanumeric branch code. This means SWIFT codes can only have 8 or 11 characters, so the value of `length` can only be `None` or the integers `8` or `11`. If the value is `None`, then a value of `8` or `11` will randomly be assigned.

    Because all 8-digit SWIFT codes already refer to the primary branch or office, the `primary` argument only has an effect if the value of `length` is `11`. If `primary` is `True` and `length` is `11`, the 11-digit SWIFT codes generated will always end in `'XXX'` to denote that they belong to primary branches/offices.

    For extra authenticity, localized providers may opt to include SWIFT bank codes, location codes, and branch codes used in their respective locales. If `use_dataset` is `True`, this method will generate SWIFT codes based on those locale-specific codes if included. If those codes were not included, then it will behave as if `use_dataset` were `False`, and in that mode, all those codes will just be randomly generated as per the specification.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift()
        ...
        'YNBIPL65ZT4'
        'SGQEPLSIGQ8'
        'JDXCPLV4'
        'LNKTPLN9'
        'OQIBPL9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8)
        ...
        'MYNBPLQ6'
        'PMZJPL4W'
        'SGQEPLSI'
        'YDTZPLQ8'
        'WZTEPLTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8, use_dataset=True)
        ...
        'MYNBPLQ6'
        'PMZJPL4W'
        'SGQEPLSI'
        'YDTZPLQ8'
        'WZTEPLTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11)
        ...
        'MYNBPLQ65ZT'
        'PLSGPL6ISIG'
        'TZIRPLJTGEV'
        'PRDLPL1UN94'
        'OQIBPL9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True)
        ...
        'MYNBPLQ6XXX'
        'PMZJPL4WXXX'
        'SGQEPLSIXXX'
        'YDTZPLQ8XXX'
        'WZTEPLTGXXX'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, use_dataset=True)
        ...
        'MYNBPLQ65ZT'
        'PLSGPL6ISIG'
        'TZIRPLJTGEV'
        'PRDLPL1UN94'
        'OQIBPL9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True, use_dataset=True)
        ...
        'MYNBPLQ6XXX'
        'PMZJPL4WXXX'
        'SGQEPLSIXXX'
        'YDTZPLQ8XXX'
        'WZTEPLTGXXX'

  swift11(primary: bool = False, use_dataset: bool = False) → str

    Generate an 11-digit SWIFT code.

    This method uses `swift()` under the hood with the `length` argument set to `11`. If `primary` is set to `True`, the SWIFT code will always end with `'XXX'`. All 11-digit SWIFT codes use this convention to refer to the primary branch/office.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift11()
        ...
        'MYNBPLQ65ZT'
        'PLSGPL6ISIG'
        'TZIRPLJTGEV'
        'PRDLPL1UN94'
        'OQIBPL9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift11(use_dataset=True)
        ...
        'MYNBPLQ65ZT'
        'PLSGPL6ISIG'
        'TZIRPLJTGEV'
        'PRDLPL1UN94'
        'OQIBPL9AFZA'

  swift8(use_dataset: bool = False) → str

    Generate an 8-digit SWIFT code.

    This method uses `swift()` under the hood with the `length` argument set to `8` and with the `primary` argument omitted. All 8-digit SWIFT codes already refer to the primary branch/office.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift8()
        ...
        'MYNBPLQ6'
        'PMZJPL4W'
        'SGQEPLSI'
        'YDTZPLQ8'
        'WZTEPLTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift8(use_dataset=True)
        ...
        'MYNBPLQ6'
        'PMZJPL4W'
        'SGQEPLSI'
        'YDTZPLQ8'
        'WZTEPLTG'

## `faker.providers.company`

class faker.providers.company.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  bs() → str
    Example:

      ‘integrate extensible convergence’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bs()
        ...
        'iterate integrated e-markets'
        'integrate back-end mindshare'
        'synthesize wireless content'
        'syndicate synergistic applications'
        'productize killer mindshare'

  catch_phrase() → str
    Example:

      ‘Robust full-range hub’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.catch_phrase()
        ...
        'Networked well-modulated instruction set'
        'Balanced empowering migration'
        'Pre-emptive impactful toolset'
        'Innovative mission-critical help-desk'
        'Reduced didactic middleware'

  company() → str
    Example:

      ‘Acme Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company()
        ...
        'Gabinety Kolman Sp.j.'
        'Bek s.c.'
        'Fundacja Gosik i syn s.c.'
        'Fundacja Gabara'
        'Spółdzielnia Andrejczuk-Sławik Sp. z o.o. Sp.k.'

  company_prefix() → str

    :example ‘Grupa’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_prefix()
        ...
        'Gabinety'
        'Fundacja'
        'Gabinety'
        'Fundacja'
        'Grupa'

  company_suffix() → str
    Example:

      ‘Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_suffix()
        ...
        'i syn s.c.'
        'Sp.j.'
        'i syn s.c.'
        'Sp.j.'
        'Sp. z o.o.'

  company_vat() → str

    Returns 10 character tax identification number, Polish: Numer identyfikacji podatkowej.

    https://pl.wikipedia.org/wiki/NIP

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_vat()
        ...
        '7714876475'
        '6769387788'
        '5190160978'
        '6461393325'
        '9821587146'

  local_regon() → str

    Returns 14 character Polish National Business Registry Number, local entity number.

    https://pl.wikipedia.org/wiki/REGON

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.local_regon()
        ...
        '49604876147596'
        '27824219948929'
        '39115781056590'
        '81387784008018'
        '93609753251392'

  regon() → str

    Returns 9 character Polish National Business Registry Number, Polish: Rejestr Gospodarki Narodowej - REGON.

    https://pl.wikipedia.org/wiki/REGON

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.regon()
        ...
        '496048761'
        '397593825'
        '372194898'
        '194115787'
        '135659384'

## `faker.providers.currency`

class faker.providers.currency.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  cryptocurrency() → Tuple[str, str]
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.cryptocurrency()
        ...
        ('XRP', 'Ripple')
        ('STC', 'SwiftCoin')
        ('BC', 'BlackCoin')
        ('NXT', 'Nxt')
        ('IOTA', 'IOTA')

  cryptocurrency_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.cryptocurrency_code()
        ...
        'XRP'
        'STC'
        'BC'
        'NXT'
        'IOTA'

  cryptocurrency_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.cryptocurrency_name()
        ...
        'Ripple'
        'SwiftCoin'
        'BlackCoin'
        'Nxt'
        'IOTA'

  currency() → Tuple[str, str]
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.currency()
        ...
        ('MWK', 'Malawian kwacha')
        ('NZD', 'New Zealand dollar')
        ('BAM', 'Bosnia and Herzegovina convertible mark')
        ('IRR', 'Iranian rial')
        ('SPL', 'Seborga luigino')

  currency_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.currency_code()
        ...
        'MWK'
        'NZD'
        'BAM'
        'IRR'
        'SPL'

  currency_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.currency_name()
        ...
        'Malawian kwacha'
        'New Zealand dollar'
        'Bosnia and Herzegovina convertible mark'
        'Iranian rial'
        'Seborga luigino'

  currency_symbol(code: str | None = None) → str
    Example:

      $

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.currency_symbol()
        ...
        '$'
        '$'
        'KM'
        'kr'
        'L'

  pricetag() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.pricetag()
        ...
        '7.604,87\xa0zł'
        '975,93\xa0zł'
        '54,21\xa0zł'
        '89.241,15\xa0zł'
        '91.565,93\xa0zł'

## `faker.providers.date_time`

class faker.providers.date_time.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  am_pm() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.am_pm()
        ...
        'AM'
        'AM'
        'PM'
        'AM'
        'AM'

  century() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.century()
        ...
        'XIII'
        'XIV'
        'II'
        'IX'
        'XVII'

  date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) → str

    Get a date string between January 1, 1970 and now.

    Parameters:

      - pattern – Format of the date (year-month-day by default)

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date()
        ...
        '2017-04-10'
        '2012-06-07'
        '1993-07-18'
        '1984-06-30'
        '1998-08-16'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date(pattern='%m/%d/%Y')
        ...
        '04/10/2017'
        '06/07/2012'
        '07/18/1993'
        '06/30/1984'
        '08/16/1998'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date(end_datetime='+1w')
        ...
        '2017-04-15'
        '2012-06-12'
        '1993-07-21'
        '1984-07-01'
        '1998-08-19'

  date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') → date

    Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

    Parameters:

      - start_date – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"today"`

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between()
        ...
        datetime.date(2021, 4, 25)
        datetime.date(2018, 9, 20)
        datetime.date(2008, 8, 6)
        datetime.date(2003, 10, 1)
        datetime.date(2011, 4, 27)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between(start_date='-1w')
        ...
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 20)
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 21)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between(start_date="-1y", end_date="+1w")
        ...
        datetime.date(2025, 11, 3)
        datetime.date(2025, 10, 2)
        datetime.date(2025, 5, 29)
        datetime.date(2025, 3, 30)
        datetime.date(2025, 7, 2)

  date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

    Get a random date between the two given dates.

    Parameters:

      - date_start – A `DateParseType`. Defaults to the UNIX epoch

      - date_end – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between_dates()
        ...
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)
        datetime.date(2025, 12, 25)

  date_object(end_datetime: datetime | None = None) → date

    Get a date object between January 1, 1970 and now

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_object()
        ...
        datetime.date(2017, 4, 10)
        datetime.date(2012, 6, 7)
        datetime.date(1993, 7, 18)
        datetime.date(1984, 6, 30)
        datetime.date(1998, 8, 16)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_object(end_datetime='+1w')
        ...
        datetime.date(2017, 4, 15)
        datetime.date(2012, 6, 12)
        datetime.date(1993, 7, 21)
        datetime.date(1984, 7, 1)
        datetime.date(1998, 8, 19)

  date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date

    Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.

    Parameters:

      - tzinfo – Defaults to None.

      - minimum_age – Defaults to `0`.

      - maximum_age – Defaults to `115`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth()
        ...
        datetime.date(2007, 12, 8)
        datetime.date(1997, 11, 26)
        datetime.date(1958, 10, 8)
        datetime.date(1940, 1, 7)
        datetime.date(1969, 4, 16)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
        ...
        datetime.date(1992, 9, 17)
        datetime.date(1990, 11, 24)
        datetime.date(1983, 10, 24)
        datetime.date(1980, 6, 1)
        datetime.date(1985, 9, 19)

  date_this_century(before_today: bool = True, after_today: bool = False) → date

    Gets a Date object for the current century.

    Parameters:

      - before_today – include days in current century before today. Defaults to True

      - after_today – include days in current century after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_century()
        ...
        datetime.date(2021, 12, 9)
        datetime.date(2019, 9, 10)
        datetime.date(2010, 12, 5)
        datetime.date(2006, 9, 23)
        datetime.date(2013, 4, 13)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_century(before_today=False, after_today=True)
        ...
        datetime.date(2088, 6, 25)
        datetime.date(2082, 1, 31)
        datetime.date(2057, 2, 10)
        datetime.date(2045, 2, 22)
        datetime.date(2063, 10, 29)

  date_this_decade(before_today: bool = True, after_today: bool = False) → date

    Gets a Date object for the decade year.

    Parameters:

      - before_today – include days in current decade before today. Defaults to True

      - after_today – include days in current decade after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_decade()
        ...
        datetime.date(2025, 1, 19)
        datetime.date(2024, 7, 14)
        datetime.date(2022, 7, 7)
        datetime.date(2021, 7, 19)
        datetime.date(2023, 1, 22)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_decade(before_today=False, after_today=True)
        ...
        datetime.date(2029, 5, 17)
        datetime.date(2029, 1, 10)
        datetime.date(2027, 9, 3)
        datetime.date(2027, 1, 9)
        datetime.date(2028, 1, 14)

  date_this_month(before_today: bool = True, after_today: bool = False) → date

    Gets a Date object for the current month.

    Parameters:

      - before_today – include days in current month before today. Defaults to True

      - after_today – include days in current month after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_month()
        ...
        datetime.date(2025, 12, 21)
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 11)
        datetime.date(2025, 12, 7)
        datetime.date(2025, 12, 13)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_month(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

  date_this_year(before_today: bool = True, after_today: bool = False) → date

    Gets a Date object for the current year.

    Parameters:

      - before_today – include days in current year before today. Defaults to True

      - after_today – include days in current year after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year()
        ...
        datetime.date(2025, 10, 30)
        datetime.date(2025, 9, 29)
        datetime.date(2025, 5, 31)
        datetime.date(2025, 4, 3)
        datetime.date(2025, 7, 3)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

  date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) → datetime

    Get a datetime object for a date between January 1, 1970 and a specified end_datetime

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time()
        ...
        datetime.datetime(2017, 4, 10, 2, 4, 9, 588933)
        datetime.datetime(2012, 6, 7, 1, 35, 52, 209247)
        datetime.datetime(1993, 7, 18, 12, 33, 11, 629939)
        datetime.datetime(1984, 6, 30, 3, 6, 59, 526187)
        datetime.datetime(1998, 8, 16, 3, 37, 13, 997472)

  date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → datetime

    Get a datetime object for a date between January 1, 0001 and now

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

      - start_datetime – A `DateParseType`. Defaults to UNIX timestamp `-62135596800`,

    equivalent to 0001-01-01 00:00:00 UTC

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_ad()
        ...
        datetime.datetime(1710, 12, 10, 4, 39, 5, 58792)
        datetime.datetime(1535, 11, 6, 1, 42, 6, 92613)
        datetime.datetime(852, 8, 25, 14, 56, 3, 673935)
        datetime.datetime(525, 4, 21, 5, 13, 40, 496040)
        datetime.datetime(1036, 4, 28, 12, 2, 54, 989674)

  date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) → datetime

    Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

    Parameters:

      - start_date – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"now"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between()
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 12, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 58, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 39, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 15, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 11, 171082)

  date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) → datetime

    Get a random datetime between the two given datetimes.

    Parameters:

      - datetime_start – A `DateParseType`. Defaults to the UNIX epoch

      - datetime_end – A `DateParseType`. Defaults to the current date and time

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates()
        ...
        datetime.datetime(2025, 12, 25, 5, 28, 29)
        datetime.datetime(2025, 12, 25, 5, 28, 29)
        datetime.datetime(2025, 12, 25, 5, 28, 29)
        datetime.datetime(2025, 12, 25, 5, 28, 29)
        datetime.datetime(2025, 12, 25, 5, 28, 29)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 12, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 58, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 39, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 15, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 11, 171082)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 26, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 15, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 15, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 36, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 10, 405703)

  date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

    Gets a datetime object for the current century.

    Parameters:

      - before_now – include days in current century before today. Defaults to True

      - after_now – include days in current century after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century()
        ...
        datetime.datetime(2021, 12, 9, 18, 8, 37, 962314)
        datetime.datetime(2019, 9, 11, 3, 50, 39, 852587)
        datetime.datetime(2010, 12, 5, 7, 41, 8, 745406)
        datetime.datetime(2006, 9, 23, 4, 17, 47, 558443)
        datetime.datetime(2013, 4, 14, 2, 43, 46, 653575)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century(before_now=False, after_now=True)
        ...
        datetime.datetime(2088, 6, 25, 23, 31, 33, 206372)
        datetime.datetime(2082, 1, 31, 8, 27, 35, 770302)
        datetime.datetime(2057, 2, 10, 6, 50, 12, 177341)
        datetime.datetime(2045, 2, 22, 23, 36, 5, 346079)
        datetime.datetime(2063, 10, 29, 10, 9, 57, 52625)

  date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

    Gets a datetime object for the decade year.

    Parameters:

      - before_now – include days in current decade before today. Defaults to True

      - after_now – include days in current decade after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade()
        ...
        datetime.datetime(2025, 1, 19, 6, 6, 17, 528576)
        datetime.datetime(2024, 7, 14, 7, 16, 42, 528010)
        datetime.datetime(2022, 7, 8, 1, 4, 34, 360857)
        datetime.datetime(2021, 7, 19, 19, 0, 42, 777538)
        datetime.datetime(2023, 1, 22, 6, 2, 43, 712335)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade(before_now=False, after_now=True)
        ...
        datetime.datetime(2029, 5, 17, 15, 31, 20, 712278)
        datetime.datetime(2029, 1, 10, 17, 34, 28, 764486)
        datetime.datetime(2027, 9, 3, 12, 45, 0, 523710)
        datetime.datetime(2027, 1, 9, 6, 12, 43, 816527)
        datetime.datetime(2028, 1, 14, 15, 54, 23, 826248)

  date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

    Gets a datetime object for the current month.

    Parameters:

      - before_now – include days in current month before today. Defaults to True

      - after_now – include days in current month after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month()
        ...
        datetime.datetime(2025, 12, 21, 11, 0, 35, 861594)
        datetime.datetime(2025, 12, 19, 8, 43, 52, 773265)
        datetime.datetime(2025, 12, 11, 4, 33, 6, 275297)
        datetime.datetime(2025, 12, 7, 6, 33, 12, 763639)
        datetime.datetime(2025, 12, 13, 9, 17, 35, 975713)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 52, 625531)
        datetime.datetime(2025, 12, 30, 8, 39, 41, 299571)
        datetime.datetime(2025, 12, 28, 1, 49, 41, 646800)
        datetime.datetime(2025, 12, 26, 23, 33, 18, 860346)
        datetime.datetime(2025, 12, 28, 16, 34, 11, 238000)

  date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime

    Gets a datetime object for the current year.

    Parameters:

      - before_now – include days in current year before today. Defaults to True

      - after_now – include days in current year after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year()
        ...
        datetime.datetime(2025, 10, 30, 11, 53, 43, 884163)
        datetime.datetime(2025, 9, 29, 12, 29, 37, 751555)
        datetime.datetime(2025, 5, 31, 15, 51, 12, 726282)
        datetime.datetime(2025, 4, 3, 18, 1, 48, 776893)
        datetime.datetime(2025, 7, 3, 3, 40, 17, 375080)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 52, 625531)
        datetime.datetime(2025, 12, 30, 8, 39, 41, 299571)
        datetime.datetime(2025, 12, 28, 1, 49, 41, 646800)
        datetime.datetime(2025, 12, 26, 23, 33, 18, 860346)
        datetime.datetime(2025, 12, 28, 16, 34, 11, 238000)

  day_of_month() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.day_of_month()
        ...
        '10'
        '07'
        '18'
        '30'
        '16'

  day_of_week()
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.day_of_week()
        ...
        'wtorek'
        'piątek'
        'poniedziałek'
        'niedziela'
        'poniedziałek'

  future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date

    Get a Date object based on a random date between 1 day from now and a given date.

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date()
        ...
        datetime.date(2026, 1, 19)
        datetime.date(2026, 1, 16)
        datetime.date(2026, 1, 7)
        datetime.date(2026, 1, 2)
        datetime.date(2026, 1, 9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date(end_date='+1y')
        ...
        datetime.date(2026, 10, 29)
        datetime.date(2026, 9, 27)
        datetime.date(2026, 5, 28)
        datetime.date(2026, 3, 30)
        datetime.date(2026, 6, 30)

  future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) → datetime

    Get a datetime object based on a random date between 1 second form now and a given date.

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime()
        ...
        datetime.datetime(2026, 1, 19, 13, 27, 30, 594731)
        datetime.datetime(2026, 1, 16, 23, 12, 7, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 11, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 41, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 33, 566513)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime(end_date='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 26, 596785)
        datetime.datetime(2026, 9, 28, 1, 31, 16, 235670)
        datetime.datetime(2026, 5, 27, 20, 6, 15, 924810)
        datetime.datetime(2026, 3, 29, 19, 4, 37, 276056)
        datetime.datetime(2026, 6, 29, 23, 11, 10, 894428)

  iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

    Get an ISO 8601 string for a datetime between the UNIX epoch and now.

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

      - sep – separator between date and time, defaults to ‘T’

      - timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iso8601()
        ...
        '2017-04-10T02:04:09.588933'
        '2012-06-07T01:35:52.209247'
        '1993-07-18T12:33:11.629939'
        '1984-06-30T03:06:59.526187'
        '1998-08-16T03:37:13.997472'

  month() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.month()
        ...
        '04'
        '06'
        '07'
        '06'
        '08'

  month_name()
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.month_name()
        ...
        'kwiecień'
        'czerwiec'
        'lipiec'
        'czerwiec'
        'sierpień'

  past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → date

    Get a Date object based on a random date between a given date and 1 day ago.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_date()
        ...
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 16)
        datetime.date(2025, 12, 7)
        datetime.date(2025, 12, 2)
        datetime.date(2025, 12, 9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_date(start_date='-1y')
        ...
        datetime.date(2025, 10, 28)
        datetime.date(2025, 9, 26)
        datetime.date(2025, 5, 26)
        datetime.date(2025, 3, 28)
        datetime.date(2025, 6, 28)

  past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) → datetime

    Get a datetime object based on a random date between a given date and 1 second ago.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Example:

      datetime(‘1999-02-02 11:42:52’)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_datetime()
        ...
        datetime.datetime(2025, 12, 20, 13, 27, 29, 594731)
        datetime.datetime(2025, 12, 17, 23, 12, 6, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 10, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 40, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 32, 566513)

  pytimezone(*args: Any, **kwargs: Any) → tzinfo | None

    Generate a random timezone (see `faker.timezone` for any args) and return a Python object usable as a `tzinfo` for `datetime` or other fakers.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.pytimezone()
        ...
        zoneinfo.ZoneInfo(key='Indian/Maldives')
        zoneinfo.ZoneInfo(key='America/Barbados')
        zoneinfo.ZoneInfo(key='Europe/Stockholm')
        zoneinfo.ZoneInfo(key='Africa/Windhoek')
        zoneinfo.ZoneInfo(key='Asia/Qatar')

  time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) → str

    Get a time string (24h format by default)

    Parameters:

      - pattern – format

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time()
        ...
        '02:04:09'
        '01:35:52'
        '12:33:11'
        '03:06:59'
        '03:37:13'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time(pattern='%I:%M %p')
        ...
        '02:04 AM'
        '01:35 AM'
        '12:33 PM'
        '03:06 AM'
        '03:37 AM'

  time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

    Get a random timedelta object of duration between the current date and time and end_datetime

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_delta()
        ...
        datetime.timedelta(0)
        datetime.timedelta(0)
        datetime.timedelta(0)
        datetime.timedelta(0)
        datetime.timedelta(0)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_delta(end_datetime='+30h')
        ...
        datetime.timedelta(days=1, seconds=4797, microseconds=559965)
        datetime.timedelta(seconds=81859, microseconds=75518)
        datetime.timedelta(seconds=45421, microseconds=730730)
        datetime.timedelta(seconds=27963, microseconds=9032)
        datetime.timedelta(seconds=55217, microseconds=669908)

  time_object(end_datetime: date | datetime | timedelta | str | int | None = None) → time

    Get a time object

    Parameters:

      end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object()
        ...
        datetime.time(2, 4, 9, 588933)
        datetime.time(1, 35, 52, 209247)
        datetime.time(12, 33, 11, 629939)
        datetime.time(3, 6, 59, 526187)
        datetime.time(3, 37, 13, 997472)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 49, 507599)
        datetime.time(2, 21, 20, 845098)
        datetime.time(12, 58, 25, 687630)
        datetime.time(3, 22, 31, 626488)
        datetime.time(4, 7, 54, 586469)

  time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) → Iterator[Tuple[datetime, Any]]

    Returns a generator yielding tuples of `(<datetime>, <value>)`.

    The data points will start at `start_date`, and be at every time interval specified by `precision`.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - end_date – A `DateParseType`. Defaults to `"now"`

      - precision – A float representing the time interval between data points.

    Defaults to 1/30th of the time :param distrib: A callable that accepts a datetime object and returns a value. Defaults to a uniform distribution :param tzinfo: timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_series()
        ...
        <generator object Provider.time_series at 0x7d660507f1c0>
        <generator object Provider.time_series at 0x7d660507f1c0>
        <generator object Provider.time_series at 0x7d660507f1c0>
        <generator object Provider.time_series at 0x7d660507f1c0>
        <generator object Provider.time_series at 0x7d660507f1c0>

  timezone() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.timezone()
        ...
        'Indian/Maldives'
        'America/Barbados'
        'Europe/Stockholm'
        'Africa/Windhoek'
        'Asia/Qatar'

  unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → float

    Get a timestamp between January 1, 1970 and now, unless passed explicit `start_datetime` or end_datetime values.

    On Windows, the decimal part is always 0.

    Parameters:

      - end_datetime – A `DateParseType`. Defaults to the UNIX epoch

      - start_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.unix_time()
        ...
        1491789849.5889335
        1339032952.209247
        742998791.6299386
        457412819.52618665
        903238633.9974717

  year() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.year()
        ...
        '2017'
        '2012'
        '1993'
        '1984'
        '1998'

## `faker.providers.geo`

class faker.providers.geo.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  coordinate(center: float | None = None, radius: float | int = 0.001) → Decimal

    Optionally center the coord and pick a point within radius.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.coordinate()
        ...
        Decimal('26.826999')
        Decimal('45.792650')
        Decimal('-158.265114')
        Decimal('-40.995129')
        Decimal('94.488524')

  latitude() → Decimal
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.latitude()
        ...
        Decimal('13.4134995')
        Decimal('22.896325')
        Decimal('-79.132557')
        Decimal('-20.4975645')
        Decimal('47.244262')

  latlng() → Tuple[Decimal, Decimal]
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.latlng()
        ...
        (Decimal('13.4134995'), Decimal('45.792650'))
        (Decimal('-79.132557'), Decimal('-40.995129'))
        (Decimal('47.244262'), Decimal('80.880444'))
        (Decimal('18.6986795'), Decimal('-17.160223'))
        (Decimal('37.935520'), Decimal('12.226293'))

  local_latlng(country_code: str = 'US', coords_only: bool = False) → Tuple[str, ...] | None

    Returns a location known to exist on land in a country specified by country_code. Defaults to ‘en_US’. See the land_coords list for available locations/countries.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.local_latlng()
        ...
        None
        None
        None
        None
        None

  location_on_land(coords_only: bool = False) → Tuple[str, ...]

    Returns a random tuple specifying a coordinate set guaranteed to exist on land. Format is (latitude, longitude, place name, two-letter country code, timezone) Pass coords_only to return coordinates without metadata.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.location_on_land()
        ...
        ('50.09713', '18.54179', 'Rybnik', 'PL', 'Europe/Warsaw')
        ('50.13717', '18.96641', 'Tychy', 'PL', 'Europe/Warsaw')
        ('50.06143', '19.93658', 'Kraków', 'PL', 'Europe/Warsaw')
        ('50.87033', '20.62752', 'Kielce', 'PL', 'Europe/Warsaw')
        ('52.64817', '19.0678', 'Włocławek', 'PL', 'Europe/Warsaw')

  longitude() → Decimal
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.longitude()
        ...
        Decimal('26.826999')
        Decimal('45.792650')
        Decimal('-158.265114')
        Decimal('-40.995129')
        Decimal('94.488524')

## `faker.providers.internet`

class faker.providers.internet.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_company_email()
        ...
        'apacura@bek.pl'
        'tgosik@stowarzyszenie.com'
        'sebastian19@ppuh.com'
        'oskar15@ppuh.pl'
        'gabriel87@gabinety.com'

  ascii_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_email()
        ...
        'qszyc@yahoo.com'
        'tgosik@o2.pl'
        'dorotaslawik@gmail.com'
        'pawelaiwo@fpuh.org'
        'ostregakornel@ppuh.pl'

  ascii_free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_free_email()
        ...
        'apacura@onet.pl'
        'apolonia76@gmail.com'
        'lgabara@interia.pl'
        'ryszardgrabias@onet.pl'
        'ewelina92@gmail.com'

  ascii_safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_safe_email()
        ...
        'apacura@example.org'
        'apolonia76@example.com'
        'lgabara@example.org'
        'ryszardgrabias@example.org'
        'ewelina92@example.com'

  company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_email()
        ...
        'apacura@bek.pl'
        'tgosik@stowarzyszenie.com'
        'sebastian19@ppuh.com'
        'oskar15@ppuh.pl'
        'gabriel87@gabinety.com'

  dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) → str

    Generates a domain name by given date https://en.wikipedia.org/wiki/Domain_generation_algorithm

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.dga()
        ...
        'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.org'
        'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamohcpnldug.org'
        'iiulfpgbvqcdaehnqkbxmaqgkykorlxnwy.net'
        'cpyhexmtvewxpwiiaxtgdfajuhbsyaaykvgkgreki.com'
        'uqniukqjckmjabijnuqho.com'

  domain_name(levels: int = 1) → str

    Produce an Internet domain name with the specified number of subdomain levels.

        >>> domain_name()
        nichols-phillips.com
        >>> domain_name(2)
        williamson-hopkins.jackson.com

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_name()
        ...
        'gabinety.com'
        'ppuh.pl'
        'fundacja.net'
        'spoldzielnia.com'
        'gabinety.com'

  domain_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_word()
        ...
        'gabinety'
        'bek'
        'fundacja'
        'fundacja'
        'spoldzielnia'

  email(safe: bool = True, domain: str | None = None) → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.email()
        ...
        'apacura@example.org'
        'apolonia76@example.com'
        'lgabara@example.org'
        'ryszardgrabias@example.org'
        'ewelina92@example.com'

  free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email()
        ...
        'apacura@onet.pl'
        'apolonia76@gmail.com'
        'lgabara@interia.pl'
        'ryszardgrabias@onet.pl'
        'ewelina92@gmail.com'

  free_email_domain() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email_domain()
        ...
        'o2.pl'
        'o2.pl'
        'onet.pl'
        'gmail.com'
        'yahoo.com'

  hostname(levels: int = 1) → str

    Produce a hostname with specified number of subdomain levels.

        >>> hostname()
        db-01.nichols-phillips.com
        >>> hostname(0)
        laptop-56
        >>> hostname(2)
        web-12.williamson-hopkins.jackson.com

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.hostname()
        ...
        'web-66.bek.pl'
        'laptop-47.ppuh.net'
        'lt-24.niescioruk-grzelczyk.org'
        'lt-92.grupa.com'
        'web-57.grupa.net'

  http_method() → str

    Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.http_method()
        ...
        'OPTIONS'
        'OPTIONS'
        'GET'
        'DELETE'
        'PATCH'

  http_status_code(include_unassigned: bool = True) → int

    Returns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have

    > not yet been assigned or are unused

    Returns:

      a random three digit status code

    Return type:

      int

    Example:

      404

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.http_status_code()
        ...
        532
        297
        488
        555
        315

  iana_id() → str

    Returns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iana_id()
        ...
        '6463344'
        '7056021'
        '679216'
        '4343903'
        '8577767'

  image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) → str

    Returns URL to placeholder image Example: http://placehold.it/640x480

    Parameters:

      - width – Optional image width

      - height – Optional image height

      - placeholder_url – Optional template string of image URLs from custom placeholder service. String must contain `{width}` and `{height}` placeholders, eg: `https:/example.com/{width}/{height}`.

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.image_url()
        ...
        'https://picsum.photos/788/861'
        'https://dummyimage.com/530x995'
        'https://dummyimage.com/621x976'
        'https://dummyimage.com/447x285'
        'https://placekitten.com/286/194'

  ipv4(network: bool = False, address_class: str | None = None, private: str | None = None) → str

    Returns a random IPv4 address or network with a valid CIDR.

    Parameters:

      - network – Network address

      - address_class – IPv4 address class (a, b, or c)

      - private – Public or private

    Returns:

      IPv4

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ipv4()
        ...
        '171.174.170.81'
        '95.25.112.121'
        '51.105.121.194'
        '195.110.164.126'
        '141.250.247.54'

  ipv4_network_class() → str

    Returns a IPv4 network class ‘a’, ‘b’ or ‘c’.

    Returns:

      IPv4 network class

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ipv4_network_class()
        ...
        'b'
        'b'
        'a'
        'b'
        'c'

  ipv4_private(network: bool = False, address_class: str | None = None) → str

    Returns a private IPv4.

    Parameters:

      - network – Network address

      - address_class – IPv4 address class (a, b, or c)

    Returns:

      Private IPv4

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ipv4_private()
        ...
        '172.29.117.82'
        '10.248.203.131'
        '172.25.180.188'
        '172.22.253.123'
        '192.168.71.140'

  ipv4_public(network: bool = False, address_class: str | None = None) → str

    Returns a public IPv4 excluding private blocks.

    Parameters:

      - network – Network address

      - address_class – IPv4 address class (a, b, or c)

    Returns:

      Public IPv4

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ipv4_public()
        ...
        '166.186.169.69'
        '111.198.92.30'
        '168.155.75.206'
        '141.250.247.54'
        '212.120.204.37'

  ipv6(network: bool = False) → str

    Produce a random IPv6 address or network with a valid CIDR

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ipv6()
        ...
        'e3e7:682:c209:4cac:629f:6fbf:d82c:7cd'
        'f728:b4fa:4248:5e3a:a5d:2f35:6baa:9455'
        'eb11:67b3:67a9:c378:7c65:c1e6:82e2:e662'
        'f7c1:bd87:4da5:e709:d471:3d61:c8a7:639'
        'e443:df78:9558:867f:5ba9:1fb0:7a02:4204'

  mac_address(multicast: bool = False) → str

    Returns a random MAC address.

    Parameters:

      multicast – Multicast address

    Returns:

      MAC Address

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.mac_address()
        ...
        '66:c5:d7:14:84:f8'
        '48:9b:f4:b7:6f:47'
        '18:47:30:80:4b:9e'
        '6e:25:a9:f1:33:b5'
        '0e:a1:68:f4:e2:85'

  nic_handle(suffix: str = 'FAKE') → str

    Returns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.nic_handle()
        ...
        'ZYT1598-FAKE'
        'SIW493-FAKE'
        'UE59352-FAKE'
        'WBUN892-FAKE'
        'CHQD98-FAKE'

  nic_handles(count: int = 1, suffix: str = '????') → List[str]

    Returns NIC Handle ID list

    Return type:

      list[str]

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.nic_handles()
        ...
        ['ZYT1598-EWLN']
        ['WGNZ53-QITZ']
        ['UERV52-EJGW']
        ['CHQ498-DZJA']
        ['UU1864-TEMK']

  port_number(is_system: bool = False, is_user: bool = False, is_dynamic: bool = False) → int

    Returns a network port number https://tools.ietf.org/html/rfc6335

    Parameters:

      - is_system – System or well-known ports

      - is_user – User or registered ports

      - is_dynamic – Dynamic / private / ephemeral ports

    Return type:

      int

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.port_number()
        ...
        50494
        55125
        5306
        33936
        63691

  ripe_id() → str

    Returns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database

    Return type:

      str

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ripe_id()
        ...
        'ORG-ZYT1598-RIPE'
        'ORG-SIW493-RIPE'
        'ORG-UE59352-RIPE'
        'ORG-WBUN892-RIPE'
        'ORG-CHQD98-RIPE'

  safe_domain_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.safe_domain_name()
        ...
        'example.com'
        'example.com'
        'example.org'
        'example.com'
        'example.net'

  safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.safe_email()
        ...
        'apacura@example.org'
        'apolonia76@example.com'
        'lgabara@example.org'
        'ryszardgrabias@example.org'
        'ewelina92@example.com'

  slug(value: str | None = None) → str

    Django algorithm

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.slug()
        ...
        'three-image-son'
        'kitchen-amount'
        'much-mention'
        'why-step-themselves'
        'me-help-past-wait'

  tld() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.tld()
        ...
        'pl'
        'pl'
        'com'
        'org'
        'pl'

  uri(schemes: List[str] | None = None, deep: int | None = None) → str
    Parameters:

      - schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like “://domain.com/index.html”.

      - deep – an integer specifying how many path components the URI should have..

    Returns:

      a random url string.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.uri()
        ...
        'https://gabinety.pl/categorylogin.jsp'
        'https://www.fpuh.org/main/main/mainprivacy.htm'
        'http://www.fundacja.org/search/categories/categoryhomepage.htm'
        'http://www.chaberek.pl/exploreauthor.php'
        'http://fundacja.pl/list/wp-content/categoriesmain.html'

  uri_extension() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.uri_extension()
        ...
        '.php'
        '.php'
        '.html'
        '.htm'
        '.asp'

  uri_page() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.uri_page()
        ...
        'author'
        'category'
        'privacy'
        'category'
        'index'

  uri_path(deep: int | None = None) → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.uri_path()
        ...
        'posts/tag'
        'explore/tag'
        'explore/category'
        'blog'
        'category'

  url(schemes: List[str] | None = None) → str
    Parameters:

      schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like “://domain.com”.

    Returns:

      a random url string.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.url()
        ...
        'https://bek.pl/'
        'https://stowarzyszenie.com/'
        'https://www.pawela.org/'
        'http://korbut.pl/'
        'https://www.fundacja.net/'

  user_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.user_name()
        ...
        'apacura'
        'bekapolonia'
        'ypostawa'
        'malwina59'
        'dorotaslawik'

## `faker.providers.job`

class faker.providers.job.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  job() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job()
        ...
        'Żołnierz'
        'Kupiec'
        'Technik mechanik'
        'Listonosz'
        'Ankieter'

  job_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_female()
        ...
        'Żołnierz'
        'Kupiec'
        'Technik mechanik'
        'Listonosz'
        'Ankieter'

  job_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.job_male()
        ...
        'Żołnierz'
        'Kupiec'
        'Technik mechanik'
        'Listonosz'
        'Ankieter'

## `faker.providers.lorem`

class faker.providers.lorem.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  Implement lorem provider for `pl_PL` locale.

  Source: https://pl.wiktionary.org/wiki/Indeks%3APolski_-_Najpopularniejsze_s%C5%82owa_1-2000

  get_words_list(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → List[str]

    Get list of words.

    `ext_word_list` is a parameter that allows the user to provide a list of words to be used instead of the built-in word list. If `ext_word_list` is provided, then the value of `part_of_speech` is ignored.

    `part_of_speech` is a parameter that defines to what part of speech the returned word belongs. If `ext_word_list` is not `None`, then `part_of_speech` is ignored. If the value of `part_of_speech` does not correspond to an existent part of speech according to the set locale, then an exception is raised.

    Warning

    Depending on the length of a locale provider’s built-in word list or on the length of `ext_word_list` if provided, a large `nb` can exhaust said lists if `unique` is `True`, raising an exception.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.get_words_list(part_of_speech="abc", ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.get_words_list(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']
        ['abc', 'def', 'ghi', 'jkl']

  paragraph(nb_sentences: int = 3, variable_nb_sentences: bool = True, ext_word_list: Sequence[str] | None = None) → str

    Generate a paragraph.

    The `nb_sentences` argument controls how many sentences the paragraph will contain, and setting `variable_nb_sentences` to `False` will generate the exact amount, while setting it to `True` (default) will generate a random amount (+/-40%, minimum of 1) using `randomize_nb_elements()`.

    Under the hood, `sentences()` is used to generate the sentences, so the argument `ext_word_list` works in the same way here as it would in that method.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5)
        ...
        'Pierwszy narodowość wrzesień upadek nasiono zgadzać się. Płeć odważny jedyny angielski powieść skład. Zaburzenie wzór metr piosenka twarz. Dodatkowy diabeł skutek akcja. Pięćdziesiąt zdrowie tańczyć niemiecki.'
        'Dusza dlatego świat wyrok pustynia zawsze ćwiczenie. Być znowu ciotka źródło babcia po prostu prosty gęsty. Usuwać system doświadczenie szkoła rolnik. Bronić obchodzić wybitny ciasto dawać rozwój dokonać. Hasło badać umieć autobus zawód. Odmiana gmina pewien zawartość przed mierzyć.'
        'Oni spotkać wartość głos życie odnosić się zakończenie. Strumień parlament wiersz rasa pociąg polegać wódka. Kino przyjąć okrągły bezpośrednio kieszeń pomarańczowy. Karta obszar Słowacja warstwa.'
        'Bardzo spać metr strach tekst. Czwartek nauka film kolano jego spowodować. Piosenka zły leżeć znaleźć pokarm lubić szkoła. Np. dwa rozpocząć charakter.'
        'Walka kolej wywodzić się związać zmieniać gdzie uprawiać. Liczba pismo próbować ptak państwowy. Nauka spadać historia święto Egipt obywatelka wyrok wiatr.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
        ...
        'Studiować nóż zdanie róg stosunek dwanaście. Zgadzać Się rower sądowy ząb skóra. Powieść skład historyczny wesoły. Sowa jajko dodatkowy diabeł skutek akcja nauka płyn. Tańczyć niemiecki pół dusza dlatego świat wyrok pustynia.'
        'Choć egzamin szklanka profesor. Porządek śmiać się rozwój. Plaża samochód fotografia żółty usuwać system. Bieg odnosić się czynić proszę uznawać pracować termin. Maj polityk późno hasło.'
        'Kwiecień miejscowość ciało opieka odmiana gmina pewien zawartość. Opowiadać Białoruś suchy. Spotkać wartość głos życie. — sukienka późno zajmować. Obejmować burza mgła dać się dziać się jedenaście kino.'
        'Teatr kosztować ksiądz głupota korona karta obszar. Całkowity spór w celu Egipt piękny deszcz przerwa szczyt. Nauka film kolano jego. Przestać nocny piosenka zły leżeć znaleźć pokarm. Zajmować zabawa analiza np..'
        'Pójść rysunek czerwiec. Walka kolej wywodzić się związać zmieniać gdzie uprawiać. Liczba pismo próbować ptak państwowy. Nauka spadać historia święto Egipt obywatelka wyrok wiatr. Zapis oraz temu żaba rozmowa.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc. Ghi jkl ghi def. Def def ghi abc.'
        'Def ghi abc jkl jkl abc jkl. Abc def jkl abc def jkl abc ghi. Jkl abc ghi abc jkl. Jkl def def def abc def jkl. Jkl ghi ghi def ghi. Def abc abc jkl abc jkl.'
        'Abc ghi abc abc abc abc ghi. Ghi jkl ghi ghi abc abc ghi. Ghi def ghi jkl jkl jkl. Def abc ghi def.'
        'Abc def ghi def abc. Jkl abc abc ghi abc ghi. Ghi abc abc abc jkl abc abc. Abc abc jkl abc.'
        'Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Jkl def def ghi def jkl. Jkl def jkl abc abc. Jkl ghi def jkl. Jkl def ghi jkl ghi def abc def. Ghi abc ghi def ghi abc jkl jkl.'
        'Ghi def jkl ghi. Ghi jkl def. Ghi abc jkl abc jkl abc. Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.'
        'Ghi def abc jkl def abc abc jkl. Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def. Def jkl jkl jkl ghi jkl ghi.'
        'Def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl. Def def jkl abc.'
        'Abc jkl ghi. Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc. Jkl abc ghi jkl def.'

  paragraphs(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

    Generate a list of paragraphs.

    This method uses `paragraph()` under the hood to generate paragraphs, and the `nb` argument controls exactly how many sentences the list will contain. The `ext_word_list` argument works in exactly the same way as well.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraphs(nb=5)
        ...
        ['Pierwszy narodowość wrzesień upadek nasiono zgadzać się. Płeć odważny jedyny angielski powieść skład. Zaburzenie wzór metr piosenka twarz.', 'Diabeł skutek akcja nauka. Zdrowie tańczyć niemiecki pół dusza dlatego.', 'Pustynia zawsze ćwiczenie ogólny przejście kierowca porządek. Źródło babcia po prostu prosty gęsty ubranie.', 'Bieg odnosić się czynić proszę uznawać pracować termin. Maj polityk późno hasło.', 'Umieć autobus zawód pozbawić mysz drobny badanie. Przed mierzyć uprawiać oni. Wzdłuż sukienka użytkownik —. Strumień parlament wiersz rasa pociąg polegać wódka.']
        ['Obejmować teatr kosztować ksiądz głupota korona karta obszar. Całkowity spór w celu Egipt piękny deszcz przerwa szczyt. Nauka film kolano jego.', 'Piosenka zły leżeć znaleźć pokarm lubić szkoła. Np. dwa rozpocząć charakter. Klucz zniszczyć ptak wódka.', 'Zapomnieć znaczyć bo liczba pismo próbować. Dzięki państwo nauka spadać. Północ na przykład blisko sowa kapelusz.', 'Jedynie ! 1 wtedy. Zwrot dusza stanowić radość.', 'Klimat tytoń ciecz powód handel ilość ciąża. Widok jabłko gatunek powiat organizm przebywać grzyb. Zamykać dziać się sądowy półwysep główny.']
        ['Zgodny abugida dużo most tłuszcz określony. Rozmiar centrum cisza miód instytucja.', 'Określać jeżeli chcieć ponownie naczynie silny więcej. Odważny piątek w życie wojsko parlament używać. (…) pojemnik pieśń jaki niszczyć następować.', 'Zdrowie pracownik stacja i aktor atak. Wziąć przedsiębiorstwo znaczenie błąd. Pokój staw zaczynać podczas.', 'Krzesło grać ludzki zawodnik odkryć brzydki obszar. Włochy cecha nasz pomysł.', 'Wygrać inaczej wesoły nad płaszcz łuk. Naj- dokładny korzyść fala zamknąć samolot Słowacja. Noga niebieski odbywać się.']
        ['Cześć zapomnieć cały słońce. Księga słownik poruszać się wokół wolność pełny często żołnierz. Gospodarka broń znaczyć większość zawierać port postępowanie.', 'Leżeć grać literatura zostać lato przyszły. Zanim korzeń sól ryzyko. Mieszkanka matka Turcja ptak.', 'Chronić republika zgoda piasek.', 'Grecja budowa spadać kraina prezent. Mąż dziewczyna zatrzymać mocz czy gałąź. Brak mama zbiór wiele minuskuła. Przygotować imię określenie opinia Wielka Brytania.', 'Głupek nawet 8 wrażenie bawić się ziarno fotografia zapach. Rządzić Anglia klimat doświadczenie kartka język kościelny.']
        ['Tak nawet trzymać zdolny bieda z krwi i kości. Słowo matka bar państwo jedzenie nasz rok. Tytuł pole mięso skończyć oba pragnienie muzyk.', 'Spowodować spotkać umożliwiać. Bajka śmiech wybuch ogień zakładać wytwarzać pomóc 50. Ślub lekarz pytać część uzyskać Chrystus.', 'Otwór rozwój znowu para ciekawy handlowy otwarty. Świat kosztować jej prawie pokarm stary.', 'Umrzeć pamięć kilometr stacja zamykać powierzchnia następować.', 'Okazja ono sobie. Ciężar część wytwarzać zajmować się styl ksiądz ciecz. Liczyć słoń przeciwko poczta no.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraphs(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.', 'Jkl ghi def abc. Def ghi abc ghi def ghi.', 'Jkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.']
        ['Def def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.', 'Ghi abc abc abc jkl abc abc. Abc abc jkl abc. Def ghi abc ghi.', 'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.', 'Jkl abc abc ghi. Ghi def abc def.', 'Jkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.']
        ['Ghi jkl abc ghi ghi abc. Ghi def jkl ghi def.', 'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.', 'Def abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.', 'Jkl abc def ghi jkl ghi abc. Def abc abc ghi.', 'Jkl jkl jkl abc ghi ghi. Ghi jkl ghi def ghi abc ghi. Abc def def.']
        ['Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.', 'Abc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.', 'Def ghi def def.', 'Def def jkl def jkl. Abc abc jkl jkl abc ghi. Abc def abc abc jkl. Ghi abc def def jkl.', 'Jkl abc def ghi jkl def jkl def. Jkl ghi jkl ghi jkl abc ghi.']
        ['Abc abc def jkl jkl ghi. Abc abc jkl abc abc abc abc. Def abc abc ghi jkl ghi jkl.', 'Ghi ghi jkl. Jkl ghi jkl abc ghi ghi jkl def. Ghi abc jkl abc jkl ghi.', 'Ghi def def def jkl jkl def. Abc ghi abc def jkl abc.', 'Def def jkl ghi ghi abc jkl.', 'Ghi def abc. Jkl abc ghi abc def ghi ghi. Def jkl def jkl ghi.']

  sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) → str

    Generate a sentence.

    The `nb_words` argument controls how many words the sentence will contain, and setting `variable_nb_words` to `False` will generate the exact amount, while setting it to `True` (default) will generate a random amount (+/-40%, minimum of 1) using `randomize_nb_elements()`.

    Under the hood, `words()` is used to generate the words, so the argument `ext_word_list` works in the same way here as it would in that method.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10)
        ...
        'Studiować nóż zdanie róg stosunek dwanaście sen suchy płeć odważny.'
        'Skóra pani Rosja krzesło zaburzenie wzór metr piosenka twarz koniec zły późny.'
        'Akcja nauka płyn reakcja pojawiać się zapis krzew św. północ umożliwiać.'
        'Pustynia zawsze ćwiczenie ogólny przejście kierowca porządek śmiać się rozwój park plaża samochód fotografia.'
        'Ubranie zgadzać się usuwać bieg odnosić się czynić proszę uznawać.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10, variable_nb_words=False)
        ...
        'Procent studiować nóż zdanie róg stosunek dwanaście sen suchy płeć.'
        'Odważny jedyny angielski powieść skład historyczny wesoły głupek godność sowa.'
        'Jajko dodatkowy diabeł skutek akcja nauka płyn reakcja pojawiać się zapis.'
        'Krzew św. północ umożliwiać poruszać się za choć egzamin szklanka profesor.'
        'Być znowu ciotka źródło babcia po prostu prosty gęsty ubranie zgadzać się.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Jkl def def ghi def jkl def def ghi jkl.'
        'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
        'Def abc def ghi jkl jkl def jkl def jkl.'
        'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
        'Abc jkl jkl def abc def ghi jkl.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Jkl def def ghi def jkl def def ghi jkl.'
        'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
        'Def abc def ghi jkl jkl def jkl def jkl.'
        'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
        'Abc jkl jkl def abc def ghi jkl.'

  sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]

    Generate a list of sentences.

    This method uses `sentence()` under the hood to generate sentences, and the `nb` argument controls exactly how many sentences the list will contain. The `ext_word_list` argument works in exactly the same way as well.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentences()
        ...
        ['Studiować nóż zdanie róg stosunek dwanaście.', 'Zgadzać Się rower sądowy ząb skóra.', 'Powieść skład historyczny wesoły.']
        ['Sowa jajko dodatkowy diabeł skutek akcja nauka płyn.', 'Tańczyć niemiecki pół dusza dlatego świat wyrok pustynia.', 'Choć egzamin szklanka profesor.']
        ['Porządek śmiać się rozwój.', 'Plaża samochód fotografia żółty usuwać system.', 'Bieg odnosić się czynić proszę uznawać pracować termin.']
        ['Maj polityk późno hasło.', 'Kwiecień miejscowość ciało opieka odmiana gmina pewien zawartość.', 'Opowiadać Białoruś suchy.']
        ['Spotkać wartość głos życie.', '— sukienka późno zajmować.', 'Obejmować burza mgła dać się dziać się jedenaście kino.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentences(nb=5)
        ...
        ['Studiować nóż zdanie róg stosunek dwanaście.', 'Zgadzać Się rower sądowy ząb skóra.', 'Powieść skład historyczny wesoły.', 'Sowa jajko dodatkowy diabeł skutek akcja nauka płyn.', 'Tańczyć niemiecki pół dusza dlatego świat wyrok pustynia.']
        ['Choć egzamin szklanka profesor.', 'Porządek śmiać się rozwój.', 'Plaża samochód fotografia żółty usuwać system.', 'Bieg odnosić się czynić proszę uznawać pracować termin.', 'Maj polityk późno hasło.']
        ['Kwiecień miejscowość ciało opieka odmiana gmina pewien zawartość.', 'Opowiadać Białoruś suchy.', 'Spotkać wartość głos życie.', '— sukienka późno zajmować.', 'Obejmować burza mgła dać się dziać się jedenaście kino.']
        ['Teatr kosztować ksiądz głupota korona karta obszar.', 'Całkowity spór w celu Egipt piękny deszcz przerwa szczyt.', 'Nauka film kolano jego.', 'Przestać nocny piosenka zły leżeć znaleźć pokarm.', 'Zajmować zabawa analiza np..']
        ['Pójść rysunek czerwiec.', 'Walka kolej wywodzić się związać zmieniać gdzie uprawiać.', 'Liczba pismo próbować ptak państwowy.', 'Nauka spadać historia święto Egipt obywatelka wyrok wiatr.', 'Zapis oraz temu żaba rozmowa.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentences(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['Jkl def def ghi def jkl.', 'Jkl def jkl abc abc.', 'Jkl ghi def jkl.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi abc ghi def ghi abc jkl jkl.']
        ['Ghi def jkl ghi.', 'Ghi jkl def.', 'Ghi abc jkl abc jkl abc.', 'Def abc def ghi jkl abc ghi.', 'Ghi jkl ghi jkl.']
        ['Ghi def abc jkl def abc abc jkl.', 'Ghi ghi def.', 'Ghi abc abc abc.', 'Jkl jkl ghi def.', 'Def jkl jkl jkl ghi jkl ghi.']
        ['Def ghi ghi jkl def def abc.', 'Ghi jkl abc ghi abc abc jkl def.', 'Abc abc ghi abc.', 'Ghi jkl ghi abc abc abc jkl.', 'Def def jkl abc.']
        ['Abc jkl ghi.', 'Abc jkl jkl abc def abc def.', 'Abc def def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Jkl abc ghi jkl def.']

  text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → str

    Generate a text string.

    The `max_nb_chars` argument controls the approximate number of characters the text string will have, and depending on its value, this method may use either `words()`, `sentences()`, or `paragraphs()` for text generation. The `ext_word_list` argument works in exactly the same way it would in any of those methods.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(max_nb_chars=20)
        ...
        'Św. wysokość słoń.'
        'Fizyczny cały.'
        'Cichy zatoka.'
        'Skała hałas usuwać.'
        'Zima żołądek piasek.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(max_nb_chars=80)
        ...
        'Studiować nóż zdanie róg stosunek dwanaście.'
        'Powieść skład historyczny wesoły.'
        'Tańczyć niemiecki pół dusza dlatego świat wyrok pustynia.'
        'Porządek śmiać się rozwój. Plaża samochód fotografia żółty usuwać system.'
        'Maj polityk późno hasło.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(max_nb_chars=160)
        ...
        'Pierwszy narodowość wrzesień upadek nasiono zgadzać się. Płeć odważny jedyny angielski powieść skład. Zaburzenie wzór metr piosenka twarz.'
        'Pustynia zawsze ćwiczenie ogólny przejście kierowca porządek. Źródło babcia po prostu prosty gęsty ubranie.'
        'Obejmować teatr kosztować ksiądz głupota korona karta obszar. Całkowity spór w celu Egipt piękny deszcz przerwa szczyt. Nauka film kolano jego.'
        'Zapomnieć znaczyć bo liczba pismo próbować. Dzięki państwo nauka spadać. Północ na przykład blisko sowa kapelusz.'
        'Klimat tytoń ciecz powód handel ilość ciąża. Widok jabłko gatunek powiat organizm przebywać grzyb. Zamykać dziać się sądowy półwysep główny.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.\nJkl ghi def abc. Def ghi abc ghi def ghi.\nJkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.'
        'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.\nDef def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.'
        'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.\nJkl abc abc ghi. Ghi def abc def.\nJkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.'
        'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.\nDef abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.\nJkl abc def ghi jkl ghi abc. Def abc abc ghi.'
        'Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.\nAbc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.\nDef ghi def def.'

  texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → List[str]

    Generate a list of text strings.

    The `nb_texts` argument controls how many text strings the list will contain, and this method uses `text()` under the hood for text generation, so the two remaining arguments, `max_nb_chars` and `ext_word_list` will work in exactly the same way as well.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.texts(nb_texts=5)
        ...
        ['Pierwszy narodowość wrzesień upadek nasiono zgadzać się. Płeć odważny jedyny angielski powieść skład. Zaburzenie wzór metr piosenka twarz.', 'Pustynia zawsze ćwiczenie ogólny przejście kierowca porządek. Źródło babcia po prostu prosty gęsty ubranie.\nBieg odnosić się czynić proszę uznawać pracować termin. Maj polityk późno hasło.', 'Obejmować teatr kosztować ksiądz głupota korona karta obszar. Całkowity spór w celu Egipt piękny deszcz przerwa szczyt. Nauka film kolano jego.', 'Zapomnieć znaczyć bo liczba pismo próbować. Dzięki państwo nauka spadać. Północ na przykład blisko sowa kapelusz.\nJedynie ! 1 wtedy. Zwrot dusza stanowić radość.', 'Zgodny abugida dużo most tłuszcz określony. Rozmiar centrum cisza miód instytucja.']
        ['Zdrowie pracownik stacja i aktor atak. Wziąć przedsiębiorstwo znaczenie błąd. Pokój staw zaczynać podczas.\nKrzesło grać ludzki zawodnik odkryć brzydki obszar. Włochy cecha nasz pomysł.', 'Cześć zapomnieć cały słońce. Księga słownik poruszać się wokół wolność pełny często żołnierz. Gospodarka broń znaczyć większość zawierać port postępowanie.', 'Chronić republika zgoda piasek.\nGrecja budowa spadać kraina prezent. Mąż dziewczyna zatrzymać mocz czy gałąź. Brak mama zbiór wiele minuskuła. Przygotować imię określenie opinia Wielka Brytania.', 'Tak nawet trzymać zdolny bieda z krwi i kości. Słowo matka bar państwo jedzenie nasz rok. Tytuł pole mięso skończyć oba pragnienie muzyk.', 'Otwór rozwój znowu para ciekawy handlowy otwarty. Świat kosztować jej prawie pokarm stary.\nUmrzeć pamięć kilometr stacja zamykać powierzchnia następować.']
        ['Zero podstawowy leżeć plemię postawić jedynie jej kij. Kieszeń róża pomysł godność republika. Dobry czterdzieści pomieszczenie wziąć stanowisko.', 'Rząd Kraków cesarz tylko. Fizyczny możliwy wiosna tani karta piec grzyb. Szukać rodzaj wśród język.\nZiemia wojenny samolot ostry zamykać inaczej. Sukces wokół opisać uznawać.', 'Liczny pewien niewolnik zwykle przechodzić trwać paliwo. Cierpienie urodzenie w celu wciąż.\nWalczyć nowy główny związany pochodzić kilka. Większość możliwy rodzinny autor złoto włoski.', 'Waluta obwód nieszczęście oddać punkt instrument stanowić. Poziom bok ser dopiero ci Szwajcaria zobaczyć.', 'Jakby ogólny wyrób królewski pięćdziesiąt igła w postaci. Panować tak nagły tkanina wyjść. Pożar jakby wypowiedź młody koncert zjawisko ważny.']
        ['Publiczny Austria każdy gniew duży radość. Starać Się zrozumieć przyszły.\nMieć cały gniew Piotr pozostawać mi. Materiał los krew płyn obserwować.', 'Dom pieśń igła metoda miecz sport.\nNos siebie bar wywołać Boże Narodzenie przyjechać przyczyna mężczyzna. Daleki szef kwiecień wizyta papieros artykuł cena.', 'Słaby rasa wziąć odnosić się ubogi usta. Substancja zbudować wybitny tamten wejść. 900 naj- ta wniosek wiek odpowiedź bycie.\nZrozumieć zwolennik nic podczas koniec epoka.', 'Budzić odwaga mocno miejski dziura. Trudny brak dwanaście koniec dawno. Niemcy wioska gorączka mieć zakładać.', 'Wspólny dziura chrześcijaństwo wzdłuż region uważać. Tam ogień zajęcie wiosna. Pociąg główny muzyka wejść przedsiębiorstwo.']
        ['Znajdować plaża zawartość przejście. Kwestia osiem składać śmiech pojazd kilometr.\n900 dwadzieścia swój telewizja oraz. Powierzchnia dwa jakość miejsce u jednak - gdy.', 'Jakby podatek znaczny analiza metr w czasie.\nChmura odpowiadać nie noga. Ćwiczenie mi itp. kamień śmiać się tu go. Pojęcie obywatelka spokojny robotnik.', 'Gdyby lew dokument. Napisać 60 zamek. Robić organizacja wątpliwość polityczny kalendarz nieszczęście bułgarski.', 'Starać Się doskonały pokryć robić trwać palić. Własność stały tor Czechy zaburzenie.\nCiepło dział śpiewać co.', 'Zamknąć przeciw pomarańcza niewielki tor. Ziemski przeszkoda region powoli.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.texts(nb_texts=5, max_nb_chars=50)
        ...
        ['Studiować nóż zdanie róg stosunek dwanaście.', 'Powieść skład historyczny wesoły.', 'Choć egzamin szklanka profesor.', 'Plaża samochód fotografia żółty usuwać system.', 'Maj polityk późno hasło.']
        ['Opowiadać Białoruś suchy.', '— sukienka późno zajmować.', 'Nauka film kolano jego.', 'Zajmować zabawa analiza np..', 'Liczba pismo próbować ptak państwowy.']
        ['Zapis oraz temu żaba rozmowa.', 'Klimat tytoń ciecz powód handel ilość ciąża.', 'Zamykać dziać się sądowy półwysep główny.', 'Określony piwo bieg ogólny zamykać klimat.', 'Znać stolica mebel.']
        ['Następować zakład spotkać zdrowie.', 'Brak ciecz zawodowy lód zrozumieć.', 'Włochy cecha nasz pomysł.', 'Noga niebieski odbywać się.', 'Piłka cichy śmierć dziewczyna opłata.']
        ['Obiad wybrzeże skała rząd czynnik.', 'Wizyta promień zanim korzeń sól ryzyko.', 'Występować bać się stopa.', 'Dach święto stolica zapalenie.', 'Wydać ludzki kosztować gorączka.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.texts(nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['Jkl def def ghi def jkl. Jkl def jkl abc abc.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi def jkl ghi. Ghi jkl def.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def.']
        ['Def ghi ghi jkl def def abc.', 'Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl.', 'Abc jkl ghi. Abc jkl jkl abc def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Abc jkl ghi abc ghi. Jkl jkl ghi def ghi abc ghi.']
        ['Ghi ghi jkl jkl abc. Def def ghi abc abc.', 'Def ghi def. Abc abc ghi.', 'Abc jkl jkl def ghi jkl jkl. Jkl def ghi def.', 'Abc ghi jkl def jkl. Def jkl ghi abc.', 'Def abc abc ghi. Def def ghi jkl jkl jkl ghi.']
        ['Abc def def. Ghi def ghi abc abc jkl.', 'Def jkl ghi. Def def def abc jkl.', 'Ghi jkl jkl ghi def jkl. Abc abc ghi abc.', 'Jkl ghi abc abc abc jkl ghi. Def def abc jkl.', 'Def def ghi jkl. Ghi abc def def jkl.']
        ['Jkl def jkl def def def. Ghi jkl abc ghi ghi.', 'Def ghi def jkl ghi jkl abc abc.', 'Jkl ghi jkl ghi ghi ghi jkl.', 'Ghi abc jkl abc jkl ghi. Ghi def abc jkl jkl.', 'Def jkl abc abc def. Jkl ghi abc ghi jkl def abc.']

  word(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → str

    Generate a word.

    This method uses `words()` under the hood with the `nb` argument set to `1` to generate the result.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.word()
        ...
        'św.'
        'wysokość'
        'słoń'
        'pałac'
        'fizyczny'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.word(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        'jkl'
        'jkl'
        'abc'
        'ghi'
        'jkl'

  words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) → List[str]

    Generate a tuple of words.

    The `nb` argument controls the number of words in the resulting list, and if `ext_word_list` is provided, words from that list will be used instead of those from the locale provider’s built-in word list.

    if `word_list` is not provided, the method will use a default value of None, which will result in the method calling the `get_words_list` method to get the word list. If `word_list` is provided, the method will use the provided list.

    If `unique` is `True`, this method will return a list containing unique words. Under the hood, `random_sample()` will be used for sampling without replacement. If `unique` is `False`, `random_choices()` is used instead, and the list returned may contain duplicates.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.words()
        ...
        ['procent', 'studiować', 'nóż']
        ['zdanie', 'róg', 'stosunek']
        ['dwanaście', 'sen', 'suchy']
        ['płeć', 'odważny', 'jedyny']
        ['angielski', 'powieść', 'skład']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.words(nb=5)
        ...
        ['procent', 'studiować', 'nóż', 'zdanie', 'róg']
        ['stosunek', 'dwanaście', 'sen', 'suchy', 'płeć']
        ['odważny', 'jedyny', 'angielski', 'powieść', 'skład']
        ['historyczny', 'wesoły', 'głupek', 'godność', 'sowa']
        ['jajko', 'dodatkowy', 'diabeł', 'skutek', 'akcja']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.words(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
        ...
        ['jkl', 'jkl', 'def', 'def', 'ghi']
        ['def', 'jkl', 'def', 'def', 'ghi']
        ['jkl', 'ghi', 'def', 'jkl', 'ghi']
        ['def', 'jkl', 'jkl', 'jkl', 'jkl']
        ['def', 'ghi', 'jkl', 'ghi', 'def']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.words(nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True)
        ...
        ['jkl', 'def', 'abc', 'ghi']
        ['jkl', 'def', 'ghi', 'abc']
        ['ghi', 'jkl', 'abc', 'def']
        ['ghi', 'abc', 'jkl', 'def']
        ['def', 'jkl', 'abc', 'ghi']

## `faker.providers.person`

class faker.providers.person.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  first_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name()
        ...
        'Ernest'
        'Sandra'
        'Maciej'
        'Robert'
        'Apolonia'

  first_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_female()
        ...
        'Ada'
        'Elżbieta'
        'Anastazja'
        'Blanka'
        'Agnieszka'

  first_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_male()
        ...
        'Eryk'
        'Fryderyk'
        'Nikodem'
        'Michał'
        'Adrian'

  first_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_nonbinary()
        ...
        'Ernest'
        'Sandra'
        'Maciej'
        'Robert'
        'Apolonia'

  identity_card_number() → str

    Returns 9 character Polish Identity Card Number, Polish: Numer Dowodu Osobistego.

    The card number consists of 3 letters followed by 6 digits (for example, ABA300000), of which the first digit (at position 3) is the check digit.

    https://en.wikipedia.org/wiki/Polish_identity_card

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.identity_card_number()
        ...
        'YWA104876'
        'YTE659382'
        'SIW319489'
        'JTG415781'
        'WBU793877'

  language_name() → str

    Generate a random i18n language name (e.g. English).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.language_name()
        ...
        'Luba-Katanga'
        'Malay'
        'Aymara'
        'Interlingue'
        'Quechua'

  last_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name()
        ...
        'Wiercigroch'
        'Majewicz'
        'Pacura'
        'Kolman'
        'Dębosz'

  last_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_female()
        ...
        'Wiercigroch'
        'Majewicz'
        'Pacura'
        'Kolman'
        'Dębosz'

  last_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_male()
        ...
        'Wiercigroch'
        'Majewicz'
        'Pacura'
        'Kolman'
        'Dębosz'

  last_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_nonbinary()
        ...
        'Wiercigroch'
        'Majewicz'
        'Pacura'
        'Kolman'
        'Dębosz'

  name() → str
    Example:

      ‘John Doe’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name()
        ...
        'Sandra Szyc'
        'Apolonia Sędek'
        'Emil Sutor'
        'pani Eliza Sławik'
        'Sebastian Nieścioruk'

  name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_female()
        ...
        'Sandra Szyc'
        'Apolonia Sędek'
        'Emil Sutor'
        'pani Eliza Sławik'
        'Sebastian Nieścioruk'

  name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_male()
        ...
        'Sandra Szyc'
        'Apolonia Sędek'
        'Emil Sutor'
        'pani Eliza Sławik'
        'Sebastian Nieścioruk'

  name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_nonbinary()
        ...
        'Sandra Szyc'
        'Apolonia Sędek'
        'Emil Sutor'
        'pani Eliza Sławik'
        'Sebastian Nieścioruk'

  nip() → str

    Returns 10 digit of Number of tax identification. Polish: Numer identyfikacji podatkowej (NIP).

    https://pl.wikipedia.org/wiki/NIP list of codes http://www.algorytm.org/numery-identyfikacyjne/nip.html

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.nip()
        ...
        '5616058763'
        '6655838247'
        '2089489246'
        '2131579154'
        '4789397783'

  pesel(date_of_birth: datetime | None = None, sex: str | None = None) → str

    Returns 11 characters of Universal Electronic System for Registration of the Population. Polish: Powszechny Elektroniczny System Ewidencji Ludności.

    PESEL has 11 digits which identifies just one person. pesel_date: if person was born in

    > - 1900-1999 - month field number is not modified

    > - 2000–2099 – month field number is increased by 20

    > - 2100–2199 – month + 40

    > - 2200–2299 – month + 60

    > - 1800–1899 – month + 80

    > - outside range 1800-2299 function will raise ValueError

    pesel_sex: last digit identifies person’s sex. Even for females, odd for males.

    https://en.wikipedia.org/wiki/PESEL

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.pesel()
        ...
        '07320860486'
        '66050847594'
        '13253138248'
        '26031119483'
        '23322692412'

  pesel_compute_check_digit(pesel: str) → int
  prefix() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix()
        ...
        'pani'
        'pan'
        'pani'
        'pani'
        'pani'

  prefix_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_female()
        ...
        'pani'
        'pani'
        'pani'
        'pani'
        'pani'

  prefix_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_male()
        ...
        'pan'
        'pan'
        'pan'
        'pan'
        'pan'

  prefix_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_nonbinary()
        ...
        'pani'
        'pan'
        'pani'
        'pani'
        'pani'

  pwz_doctor() → str

    Function generates an identification number for medical doctors Polish: Prawo Wykonywania Zawodu (PWZ)

    https://www.nil.org.pl/rejestry/centralny-rejestr-lekarzy/zasady-weryfikowania-nr-prawa-wykonywania-zawodu

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.pwz_doctor()
        ...
        '6660487'
        '8647593'
        '3824219'
        '4489241'
        '6157816'

  pwz_doctor_compute_check_digit(x: Sequence[int]) → int
  pwz_nurse(kind: str = 'nurse') → str

    Function generates an identification number for nurses and midwives Polish: Prawo Wykonywania Zawodu (PWZ)

    http://arch.nipip.pl/index.php/prawo/uchwaly/naczelnych-rad/w-roku-2015/posiedzenie-15-17-grudnia/3664-uchwala- nr-381-vi-2015-w-sprawie-trybu-postepowania-dotyczacego-stwierdzania-i-przyznawania-prawa-wykonywania-zawodu-pi elegniarki-i-zawodu-poloznej-oraz-sposobu-prowadzenia-rejestru-pielegniarek-i-rejestru-poloznych-przez-okregowe -rady-pielegniarek-i-polo

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.pwz_nurse()
        ...
        '2560487P'
        '2647593P'
        '3324219P'
        '1789241P'
        '0557815P'

  suffix() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.suffix()
        ...
        ''
        ''
        ''
        ''
        ''

  suffix_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.suffix_female()
        ...
        ''
        ''
        ''
        ''
        ''

  suffix_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.suffix_male()
        ...
        ''
        ''
        ''
        ''
        ''

  suffix_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.suffix_nonbinary()
        ...
        ''
        ''
        ''
        ''
        ''

## `faker.providers.phone_number`

class faker.providers.phone_number.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  country_calling_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_calling_code()
        ...
        '+687'
        '+595'
        '+880'
        '+964'
        '+41'

  msisdn() → str

    https://en.wikipedia.org/wiki/MSISDN

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.msisdn()
        ...
        '6048764759382'
        '2194892411578'
        '5659387784080'
        '6097535139332'
        '1158714841858'

  phone_number() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.phone_number()
        ...
        '+48 22 660 48 76'
        '+48 32 475 93 82'
        '782 194 892'
        '781 157 815'
        '+48 515 938 778'

## `faker.providers.ssn`

class faker.providers.ssn.pl_PL.Provider(generator: Any)

  Bases: `Provider`

  ssn() → str

    Returns 11 character Polish national identity code (Public Electronic Census System, Polish: Powszechny Elektroniczny System Ewidencji Ludności - PESEL).

    It has the form YYMMDDZZZXQ, where YYMMDD is the date of birth (with century encoded in month field), ZZZ is the personal identification number, X denotes sex (even for females, odd for males) and Q is a parity number.

    https://en.wikipedia.org/wiki/National_identification_number#Poland

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ssn()
        ...
        '17241060487'
        '97031547594'
        '19320138243'
        '77102819483'
        '25210792411'

  vat_id() → str

    http://ec.europa.eu/taxation_customs/vies/faq.html#item_11 :return: A random Polish VAT ID

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.vat_id()
        ...
        'PL6048764759'
        'PL8242194892'
        'PL1157815659'
        'PL8778408016'
        'PL9753513933'