Locale en_CA

faker.providers.address

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

Bases: Provider

address() → str

示例:

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

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'48764 Howard Forge Apt. 421\nVanessaside, SK M6E 8C9'
'5938 Ramos Pike Suite 080\nLake Marytown, PE N2K4N4'
'711 Golden Overpass\nWest Andreaville, ON Y5J8Y2'
'342 Lori Bypass Suite 711\nEast Sandra, BC X4L4X7'
'5159 Tom Roads Suite 330\nDavebury, NT N2S 3B4'

administrative_unit() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Nova Scotia'
'Yukon Territory'
'Nova Scotia'
'Alberta'
'Newfoundland and Labrador'

building_number() → str

示例:

‘791’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'6048'
'6475'
'382'
'2194'
'924'

city() → str

示例:

‘Sashabury’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Changchester'
'West Tammyfort'
'Hullport'
'Howardborough'
'West Donald'

city_prefix() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_prefix()
...
'Port'
'South'
'Port'
'South'
'North'

city_suffix() → str

示例:

‘town’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'furt'
'chester'
'ton'
'view'
'haven'

country() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Tanzania'
'Hungary'
'Senegal'
'Tuvalu'
'Italy'

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

示例:

>>> 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

示例:

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

current_country_code() → str

示例:

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

postal_code_letter() → str

Returns a random letter from the list of allowable letters in a canadian postal code

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postal_code_letter()
...
'R'
'S'
'B'
'L'
'X'

postalcode() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postalcode()
...
'S9B8L7'
'V9P3J5'
'E3L 5Y2'
'N2V 6Y7'
'J8Y9V5'

postalcode_in_province(province_abbr: str | None = None) → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postalcode_in_province()
...
'B8L7X5'
'X5X3G2'
'C2M6E8'
'M4S 9N8'
'X2Y7A1'

postcode() → str

Returns a random postcode

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'S9B8L7'
'V9P3J5'
'E3L 5Y2'
'N2V 6Y7'
'J8Y9V5'

postcode_in_province(province_abbr: str | None = None) → str

Returns a random postcode within the provided province abbreviation

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode_in_province()
...
'B8L7X5'
'X5X3G2'
'C2M6E8'
'M4S 9N8'
'X2Y7A1'

province() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province()
...
'Nova Scotia'
'Yukon Territory'
'Nova Scotia'
'Alberta'
'Newfoundland and Labrador'

province_abbr() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.province_abbr()
...
'NS'
'YT'
'NS'
'AB'
'NL'

secondary_address() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'Suite 604'
'Suite 647'
'Suite 938'
'Apt. 421'
'Suite 892'

street_address() → str

示例:

‘791 Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'0487 Hull Village Suite 759'
'242 Christine Glen'
'1157 Michael Island'
'778 Brown Plaza'
'60975 Jessica Squares'

street_name() → str

示例:

‘Crist Parks’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Chang Manor'
'Jonathan Pass'
'Sullivan Tunnel'
'Faulkner Knolls'
'William Haven'

street_suffix() → str

示例:

‘Avenue’

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'Vista'
'Lights'
'Trace'
'Manor'
'Canyon'

faker.providers.automotive

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

Bases: Provider

Implement automotive provider for en_CA locale.

来源

• https://www.revolvy.com/main/index.php?s=Canadian%20licence%20plate%20designs%20and%20serial%20formats

license_plate() → str

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'048 7YN'
'759 3ZJ'
'E19 JEY'
'892 411'
'PRDL 659'

vin() → str

生成车辆识别码。

示例:

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

faker.providers.barcode

class faker.providers.barcode.en_CA.Provider(generator: Any)

Bases: Provider

Implement barcode provider for en_CA locale.

Canada uses UPC as well, so there are similarities between this and the en_US implementation.

来源

• https://gs1.org/standards/id-keys/company-prefix

• https://www.nationwidebarcode.com/upc-country-codes/

ean(length: int = 13, prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = ()) → str

生成指定 length 长度的 EAN 条形码。

length 的值只能是 8 或 13（默认值），分别创建 EAN-8 或 EAN-13 条形码。

如果指定了 prefixes 的值，则结果将以 prefixes 中的某个序列开头。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=13)
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(length=8)
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'

ean13(prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = (), leading_zero: bool | None = None) → str

生成 EAN-13 条形码。

If leading_zero is True, the leftmost digit of the barcode will be set to 0. If False, the leftmost digit cannot be 0. If None (default), the leftmost digit can be any digit.

If a value for prefixes is specified, the result will begin with one of the sequences in prefixes and will ignore leading_zero.

This method uses the standard barcode provider’s ean13() under the hood with the prefixes argument set to the correct value to attain the behavior described above.

注意

EAN-13 barcode that starts with a zero can be converted to UPC-A by dropping the leading zero. This may cause problems with readers that treat all of these code as UPC-A codes and drop the first digit when reading it.

You can set the argument prefixes ( or leading_zero for convenience) explicitly to avoid or to force the generated barcode to start with a zero. You can also generate actual UPC-A barcode with EnUsBarcodeProvider.upc_a().

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13()
...
'6604876475937'
'8242194892418'
'1578156593879'
'7840801609759'
'3513933287112'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=False)
...
'7048764759386'
'5194892411572'
'6593877840809'
'7975351393329'
'2587148418587'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=True)
...
'0604876475933'
'0219489241150'
'0156593877847'
'0016097535134'
'0287115871484'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'

ean8(prefixes: Tuple[int | str | Tuple[int | str, ...], ...] = ()) → str

生成 EAN-8 条形码。

This method uses ean() under the hood with the length argument explicitly set to 8.

如果指定了 prefixes 的值，则结果将以 prefixes 中的某个序列开头。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8()
...
'66048763'
'47593824'
'42194897'
'24115780'
'15659385'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('00', ))
...
'00048767'
'00938242'
'00489249'
'00781565'
'00877848'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('45', '49'))
...
'49048766'
'45938245'
'45489242'
'49781564'
'45877841'

localized_ean(length: int = 13) → str

生成指定 length 长度的本地化 EAN 条形码。

length 的值只能是 8 或 13（默认值），分别创建 EAN-8 或 EAN-13 条形码。

This method uses the standard barcode provider’s ean() under the hood with the prefixes argument explicitly set to local_prefixes of a localized barcode provider implementation.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean()
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=13)
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean(length=8)
...
'75048761'
'06593827'
'06948924'
'07578151'
'06387785'

localized_ean13() → str

生成本地化 EAN-13 条形码。

This method uses localized_ean() under the hood with the length argument explicitly set to 13.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean13()
...
'0804876475937'
'7521948924119'
'7581565938777'
'0908016097536'
'0839332871152'

localized_ean8() → str

生成本地化 EAN-8 条形码。

This method uses localized_ean() under the hood with the length argument explicitly set to 8.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.localized_ean8()
...
'75048761'
'06593827'
'06948924'
'07578151'
'06387785'

upc_a(upc_ae_mode: bool = False, base: str | None = None, number_system_digit: int | None = None) → str

Generate a 12-digit UPC-A barcode.

The value of upc_ae_mode controls how barcodes will be generated. If False (default), barcodes are not guaranteed to have a UPC-E equivalent. In this mode, the method uses EnUsBarcodeProvider.ean13() under the hood, and the values of base and number_system_digit will be ignored.

If upc_ae_mode is True, the resulting barcodes are guaranteed to have a UPC-E equivalent, and the values of base and number_system_digit will be used to control what is generated.

Under this mode, base is expected to have a 6-digit string value. If any other value is supplied, a random 6-digit string will be used instead. As for number_system_digit, the expected value is a 0 or a 1. If any other value is provided, this method will randomly choose from the two.

Important

When upc_ae_mode is enabled, you might encounter instances where different values of base (e.g. '120003' and '120004') produce the same UPC-A barcode. This is normal, and the reason lies within the whole conversion process. To learn more about this and what base and number_system_digit actually represent, please refer to EnUsBarcodeProvider.upc_e().

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a()
...
'604876475933'
'219489241150'
'156593877847'
'016097535134'
'287115871484'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, number_system_digit=0)
...
'066048000075'
'064700000593'
'082421000098'
'048100009240'
'015781000057'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, number_system_digit=1)
...
'166048000072'
'164700000590'
'182421000095'
'148100009247'
'115781000054'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='123456', number_system_digit=0)
...
'012345000065'
'012345000065'
'012345000065'
'012345000065'
'012345000065'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='120003', number_system_digit=0)
...
'012000000003'
'012000000003'
'012000000003'
'012000000003'
'012000000003'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_a(upc_ae_mode=True, base='120004', number_system_digit=0)
...
'012000000003'
'012000000003'
'012000000003'
'012000000003'
'012000000003'

upc_e(base: str | None = None, number_system_digit: int | None = None, safe_mode: bool = True) → str

Generate an 8-digit UPC-E barcode.

UPC-E barcodes can be expressed in 6, 7, or 8-digit formats, but this method uses the 8 digit format, since it is trivial to convert to the other two formats. The first digit (starting from the left) is controlled by number_system_digit, and it can only be a 0 or a 1. The last digit is the check digit that is inherited from the UPC-E barcode’s UPC-A equivalent. The middle six digits are collectively referred to as the base (for a lack of a better term).

On that note, this method uses base and number_system_digit to first generate a UPC-A barcode for the check digit, and what happens next depends on the value of safe_mode. The argument safe_mode exists, because there are some UPC-E values that share the same UPC-A equivalent. For example, any UPC-E barcode of the form abc0000d, abc0003d, and abc0004d share the same UPC-A value abc00000000d, but that UPC-A value will only convert to abc0000d because of (a) how UPC-E is just a zero-suppressed version of UPC-A and (b) the rules around the conversion.

If safe_mode is True (default), this method performs another set of conversions to guarantee that the UPC-E barcodes generated can be converted to UPC-A, and that UPC-A barcode can be converted back to the original UPC-E barcode. Using the example above, even if the bases 120003 or 120004 are used, the resulting UPC-E barcode will always use the base 120000.

If safe_mode is False, then the number_system_digit, base, and the computed check digit will just be concatenated together to produce the UPC-E barcode, and attempting to convert the barcode to UPC-A and back again to UPC-E will exhibit the behavior described above.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e()
...
'16604872'
'04759386'
'04219484'
'04115786'
'15659385'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456')
...
'11234562'
'11234562'
'01234565'
'11234562'
'11234562'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456', number_system_digit=0)
...
'01234565'
'01234565'
'01234565'
'01234565'
'01234565'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='123456', number_system_digit=1)
...
'11234562'
'11234562'
'11234562'
'11234562'
'11234562'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120000', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120003', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120004', number_system_digit=0)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120000', number_system_digit=0, safe_mode=False)
...
'01200003'
'01200003'
'01200003'
'01200003'
'01200003'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120003', number_system_digit=0, safe_mode=False)
...
'01200033'
'01200033'
'01200033'
'01200033'
'01200033'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.upc_e(base='120004', number_system_digit=0, safe_mode=False)
...
'01200043'
'01200043'
'01200043'
'01200043'
'01200043'

faker.providers.currency

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

Bases: Provider

cryptocurrency() → Tuple[str, str]

示例:

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

cryptocurrency_code() → str

示例:

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

cryptocurrency_name() → str

示例:

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

currency() → Tuple[str, str]

示例:

>>> 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

示例:

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

currency_name() → str

示例:

>>> 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

示例:

$

示例:

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

pricetag()

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'$\xa07,604.87'
'$\xa0975.93'
'$\xa054.21'
'$\xa089,241.15'
'$\xa091,565.93'

faker.providers.phone_number

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

基类: Provider

country_calling_code() → str

示例:

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

msisdn() → str

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

示例:

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

phone_number() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'+1 (460) 487-6475'
'(624) 219-4892 x411'
'181-565-9387 x784'
'(401) 609-7535 x139'
'(528) 711-5871'

faker.providers.ssn

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

Bases: Provider

ssn() → str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'640 146 171'
'774 564 306'
'127 764 306'
'173 201 831'
'388 220 535'