Skip to content

Commit 867b08e

Browse files
committed
more samples
1 parent 5acc936 commit 867b08e

File tree

5 files changed

+77
-2
lines changed

5 files changed

+77
-2
lines changed

faker/providers/address/it_IT/__init__.py

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17619,23 +17619,41 @@ class Provider(AddressProvider):
1761917619
secondary_address_formats = ("Appartamento @#", "Piano #")
1762017620

1762117621
def postcode_city_province(self) -> str:
17622+
"""
17623+
:sample:
17624+
"""
1762217625
cap = self.postcode()
1762317626
rand_city_prov: List[str] = self.random_element(self.cap_city_province[cap])
1762417627
return cap + ", " + rand_city_prov[0] + " (" + rand_city_prov[1] + ")"
1762517628

1762617629
def city(self) -> str:
17630+
"""
17631+
:sample:
17632+
"""
1762717633
return self.random_element(self.cities)
1762817634

1762917635
def city_prefix(self) -> str:
17636+
"""
17637+
:sample:
17638+
"""
1763017639
return self.random_element(self.city_prefixes)
1763117640

1763217641
def secondary_address(self) -> str:
17642+
"""
17643+
:sample:
17644+
"""
1763317645
return self.numerify(self.random_element(self.secondary_address_formats))
1763417646

1763517647
def administrative_unit(self) -> str:
17648+
"""
17649+
:sample:
17650+
"""
1763617651
return self.random_element(self.states)
1763717652

1763817653
state = administrative_unit
1763917654

1764017655
def state_abbr(self) -> str:
17656+
"""
17657+
:sample:
17658+
"""
1764117659
return self.random_element(self.states_abbr)

faker/providers/address/ja_JP/__init__.py

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -643,4 +643,7 @@ def postcode(self) -> str:
643643
)
644644

645645
def zipcode(self) -> str:
646+
"""
647+
:example: '101-1212'
648+
"""
646649
return self.postcode()

faker/providers/address/uk_UA/__init__.py

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2154,25 +2154,47 @@ class Provider(AddressProvider):
21542154
]
21552155

21562156
def city_prefix(self) -> str:
2157+
"""
2158+
:sample:
2159+
"""
21572160
return self.random_element(self.city_prefixes)
21582161

21592162
def city_name(self) -> str:
2163+
"""
2164+
:sample:
2165+
"""
21602166
return self.random_element(self.city_names)
21612167

21622168
def postcode(self) -> str:
2163-
"""The code consists of five digits (01000-99999)"""
2169+
"""
2170+
The code consists of five digits (01000-99999)
2171+
2172+
:sample:
2173+
"""
21642174
return f"{self.generator.random.randrange(1000, 99999):05}"
21652175

21662176
def street_prefix(self) -> str:
2177+
"""
2178+
:sample:
2179+
"""
21672180
return self.random_element(self.street_prefixes)
21682181

21692182
def street_name(self) -> str:
2183+
"""
2184+
:sample:
2185+
"""
21702186
return self.random_element(self.street_titles)
21712187

21722188
def street_title(self) -> str:
2189+
"""
2190+
:sample:
2191+
"""
21732192
prefix = self.street_prefix()
21742193
street = self.street_name()
21752194
return prefix + " " + street
21762195

21772196
def region(self) -> str:
2197+
"""
2198+
:sample:
2199+
"""
21782200
return self.random_element(self.region_names)

faker/providers/address/zu_ZA/__init__.py

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -176,28 +176,55 @@ class Provider(AddressProvider):
176176
)
177177

178178
def secondary_address(self) -> str:
179+
"""
180+
:sample:
181+
"""
179182
return self.numerify(self.random_element(self.secondary_address_formats))
180183

181184
def building_number(self) -> str:
185+
"""
186+
:sample:
187+
"""
182188
return self.numerify(self.random_element(self.building_number_formats))
183189

184190
def street_name(self) -> str:
191+
"""
192+
:sample:
193+
"""
185194
return self.random_element(self.street_names)
186195

187196
def street_suffix(self) -> str:
197+
"""
198+
:sample:
199+
"""
188200
return self.random_element(self.street_suffixes)
189201

190202
def city_name(self) -> str:
203+
"""
204+
:sample:
205+
"""
191206
return self.random_element(self.cities)
192207

193208
def city_name_suffix(self) -> str:
209+
"""
210+
:sample:
211+
"""
194212
return self.random_element(self.city_suffixes)
195213

196214
def section_number(self) -> str:
215+
"""
216+
:sample:
217+
"""
197218
return self.numerify(self.random_element(self.section_formats))
198219

199220
def province(self) -> str:
221+
"""
222+
:sample:
223+
"""
200224
return self.random_element(self.provinces)
201225

202226
def administrative_unit(self) -> str:
227+
"""
228+
:sample:
229+
"""
203230
return self.random_element(self.provinces)

faker/proxy.pyi

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3868,7 +3868,12 @@ class Faker:
38683868
...
38693869

38703870
def middle_name(self) -> str: ...
3871-
def postcode_city_province(self) -> str: ...
3871+
def postcode_city_province(self) -> str:
3872+
"""
3873+
:sample:
3874+
"""
3875+
...
3876+
38723877
@staticmethod
38733878
def is_leap_year(year: int) -> bool:
38743879
"""

0 commit comments

Comments
 (0)