File Coverage

blib/lib/Data/Faker/StreetAddress.pm
Criterion Covered Total %
statement 18 18 100.0
branch n/a
condition n/a
subroutine 6 6 100.0
pod n/a
total 24 24 100.0


line stmt bran cond sub pod time code
1             package Data::Faker::StreetAddress;
2 2     2   7 use vars qw($VERSION); $VERSION = '0.10_04';
  2     2   3  
  2         91  
  2         8  
  2         2  
  2         77  
3 2     2   6 use base 'Data::Faker';
  2     2   2  
  2         127  
  2         7  
  2         2  
  2         49  
4 2     2   406 use Data::Faker::Name;
  2     2   3  
  2         9  
  2         5  
  2         2  
  2         8  
5              
6             =head1 NAME
7              
8             Data::Faker::StreetAddress - Data::Faker plugin
9              
10             =head1 SYNOPSIS AND USAGE
11              
12             See L
13              
14             =head1 DATA PROVIDERS
15              
16             =over 4
17              
18             =item us_zip_code
19              
20             Return a random zip or zip+4 zip code in the US zip code format. Note that
21             this is not necessarily a valid zip code, just a 5 or 9 digit number in the
22             correct format.
23              
24             =cut
25              
26             __PACKAGE__->register_plugin(
27             us_zip_code => ['#####','#####-####'],
28             );
29              
30             =item us_state
31              
32             Return a random US state name.
33              
34             =cut
35              
36              
37             __PACKAGE__->register_plugin(
38             us_state => [
39             qw{
40             Alabama Alaska Arizona Arkansas California Colorado Connecticut
41             Delaware Florida Georgia Hawaii Idaho Illinois Indiana Iowa Kansas
42             Kentucky Louisiana Maine Maryland Massachusetts Michigan Minnesota
43             Mississippi Missouri Montana Nebraska Nevada Ohio Oklahoma Oregon
44             Pennsylvania Tennessee Texas Utah Vermont Virginia Wisconsin
45             Wyoming Washington
46             },
47             'New Hampshire', 'New Jersey', 'New Mexico', 'New York',
48             'North Carolina', 'North Dakota', 'Rhode Island', 'South Carolina',
49             'South Dakota', 'West Virginia',
50             ],
51             );
52              
53             =item us_state_abbr
54              
55             Return a random US state abbreviation. (Includes US Territories and AE, AA,
56             AP military designations.)
57              
58             From the USPS list at http://www.usps.com/ncsc/lookups/usps_abbreviations.html
59             =cut
60              
61             __PACKAGE__->register_plugin(
62             us_state_abbr => [qw(
63             AL AK AS AZ AR CA CO CT DE DC FM FL GA GU HI ID IL IN IA KS KY
64             LA ME MH MD MA MI MN MS MO MT NE NV NH NJ NM NY NC ND MP OH OK
65             OR PW PA PR RI SC SD TN TX UT VT VI VA WA WV WI WY AE AA AP
66             )],
67             );
68              
69             =item street_suffix
70              
71             Return a random street suffix (Drive, Street, Road, etc.)
72              
73             From the USPS list at http://www.usps.com/ncsc/lookups/usps_abbreviations.html
74              
75             =cut
76              
77             __PACKAGE__->register_plugin(
78             street_suffix => [qw(
79             Alley Avenue Branch Bridge Brook Brooks Burg Burgs Bypass Camp Canyon
80             Cape Causeway Center Centers Circle Circles Cliff Cliffs Club Common
81             Corner Corners Course Court Courts Cove Coves Creek Crescent Crest
82             Crossing Crossroad Curve Dale Dam Divide Drive Drive Drives Estate
83             Estates Expressway Extension Extensions Fall Falls Ferry Field Fields
84             Flat Flats Ford Fords Forest Forge Forges Fork Forks Fort Freeway
85             Garden Gardens Gateway Glen Glens Green Greens Grove Groves Harbor
86             Harbors Haven Heights Highway Hill Hills Hollow Inlet Inlet Island
87             Island Islands Islands Isle Isle Junction Junctions Key Keys Knoll
88             Knolls Lake Lakes Land Landing Lane Light Lights Loaf Lock Locks Locks
89             Lodge Lodge Loop Mall Manor Manors Meadow Meadows Mews Mill Mills
90             Mission Mission Motorway Mount Mountain Mountain Mountains Mountains
91             Neck Orchard Oval Overpass Park Parks Parkway Parkways Pass Passage
92             Path Pike Pine Pines Place Plain Plains Plains Plaza Plaza Point Points
93             Port Port Ports Ports Prairie Prairie Radial Ramp Ranch Rapid Rapids
94             Rest Ridge Ridges River Road Road Roads Roads Route Row Rue Run Shoal
95             Shoals Shore Shores Skyway Spring Springs Springs Spur Spurs Square
96             Square Squares Squares Station Station Stravenue Stravenue Stream
97             Stream Street Street Streets Summit Summit Terrace Throughway Trace
98             Track Trafficway Trail Trail Tunnel Tunnel Turnpike Turnpike Underpass
99             Union Unions Valley Valleys Via Viaduct View Views Village Village
100             Villages Ville Vista Vista Walk Walks Wall Way Ways Well Wells
101             )],
102             );
103              
104             =item street_name
105              
106             Return a fake street name.
107              
108             =cut
109              
110              
111             __PACKAGE__->register_plugin(
112             street_name => [
113             '$last_name $street_suffix',
114             '$first_name $street_suffix',
115             ],
116             );
117              
118             =item street_address
119              
120             Return a fake street address.
121              
122             =cut
123              
124             __PACKAGE__->register_plugin(
125             street_address => [
126             '##### $street_name',
127             '##### $street_name',
128             '##### $street_name',
129             '##### $street_name',
130             '##### $street_name Apt. ###',
131             '##### $street_name Suite ###',
132             '##### $street_name \####',
133             '##### $secondary_unit_designator',
134             ],
135             );
136              
137             =item secondary_unit_designator
138              
139             Return a random secondary unit designator, with a range if needed (secondary
140             unit designators are things like apartment number, building number, suite,
141             penthouse, etc that differentiate different units with a common address.)
142              
143             =cut
144              
145             __PACKAGE__->register_plugin(
146             secondary_unit_designator => [
147             'Apartment $secondary_unit_number',
148             'Building $secondary_unit_number',
149             'Department $secondary_unit_number',
150             'Floor #', 'Floor ##', 'Floor ###',
151             'Floor \##', 'Floor \###', 'Floor \####',
152             'Hangar $secondary_unit_number',
153             'Lot $secondary_unit_number',
154             'Pier $secondary_unit_number',
155             'Room $secondary_unit_number',
156             'Slip $secondary_unit_number',
157             'Space $secondary_unit_number',
158             'Stop $secondary_unit_number',
159             'Suite $secondary_unit_number',
160             'Trailer $secondary_unit_number',
161             'Unit $secondary_unit_number',
162             'Basement','Front','Lobby','Lower','Office',
163             'Penthouse','Rear','Side','Upper',
164             ],
165             );
166              
167             =item secondary_unit_number
168              
169             Return a random secondary unit number, for the secondary unit designators that
170             take ranges.
171              
172             =cut
173              
174             __PACKAGE__->register_plugin(
175             secondary_unit_number => [
176             ('A' .. 'Z'), '###','\####','##','\###','#','\##',
177             '#-A','\##-A','#-B','\##-B','#-C','\##-C','#-D','\##-D','#-E','\##-E',
178             '#-F','\##-F','#-G','\##-G','#-H','\##-H','#-I','\##-I','#-J','\##-J',
179             ],
180             );
181              
182             =item city
183              
184             Return a random city, taken from a list of larger cities in several U.S. states.
185              
186             =cut
187              
188             __PACKAGE__->register_plugin(
189             city => [
190             'Agoura Hills',
191             'Akron',
192             'Alameda',
193             'Alhambra',
194             'Aliso Viejo',
195             'Anaheim',
196             'Anchorage',
197             'Apple Valley',
198             'Arcadia',
199             'Artesia',
200             'Ashland',
201             'Athens',
202             'Atwater',
203             'Auburn',
204             'Avalon',
205             'Azusa',
206             'Bakersfield',
207             'Baldwin Park',
208             'Barrow',
209             'Bell Gardens',
210             'Bell',
211             'Bellflower',
212             'Bentonville',
213             'Berkeley',
214             'Bessemer',
215             'Beverly Hills',
216             'Birmingham',
217             'Bloomington',
218             'Blythe',
219             'Bowling Green',
220             'Bradbury',
221             'Brea',
222             'Buena Park',
223             'Burbank',
224             'Burlingame',
225             'Calabasas',
226             'Canton',
227             'Carson',
228             'Cerritos',
229             'Chandler',
230             'Chico',
231             'Chino Hills',
232             'Chino',
233             'Chula Vista',
234             'Cincinnati',
235             'Citrus Heights',
236             'City of Industry',
237             'Claremont',
238             'Cleveland',
239             'Columbus',
240             'Commerce',
241             'Compton',
242             'Concord',
243             'Corona',
244             'Costa Mesa',
245             'Covina',
246             'Covington',
247             'Crown Point',
248             'Cudahy',
249             'Culver City',
250             'Cypress',
251             'Daly City',
252             'Dana Point',
253             'Danville',
254             'Dayton',
255             'Decatur',
256             'Delta Junction',
257             'Demopolis',
258             'Diamond Bar',
259             'Dothan',
260             'Downey',
261             'Duarte',
262             'El Cerrito',
263             'El Monte',
264             'El Segundo',
265             'Elkhart',
266             'Escondido',
267             'Eufaula',
268             'Eureka',
269             'Evansville',
270             'Fairbanks',
271             'Fairfield',
272             'Fayetteville',
273             'Flagstaff',
274             'Florence',
275             'Florence',
276             'Fontana',
277             'Forrest City',
278             'Fort Smith',
279             'Fort Wayne',
280             'Fountain Valley',
281             'Frankfort',
282             'Fremont',
283             'Fresno',
284             'Fullerton',
285             'Gadsden',
286             'Garden Grove',
287             'Gardena',
288             'Gary',
289             'Gilbert',
290             'Glendale',
291             'Glendale',
292             'Glendora',
293             'Gulf Shores',
294             'Half Moon Bay',
295             'Hamilton',
296             'Hammond',
297             'Hawaiian Gardens',
298             'Hawthorne',
299             'Hayward',
300             'Hermosa Beach',
301             'Hidden Hills',
302             'Hollister',
303             'Hollywood',
304             'Homer',
305             'Hoover',
306             'Hope',
307             'Hopkinsville',
308             'Hot Springs',
309             'Huntington Beach',
310             'Huntington Park',
311             'Huntsville',
312             'Indianapolis',
313             'Indio',
314             'Inglewood',
315             'Irvine',
316             'Irwindale',
317             'Jasper',
318             'Jeffersontown',
319             'Jonesboro',
320             'Juneau',
321             'Kent',
322             'Ketchikan',
323             'Kettering',
324             'Kokomo',
325             'La CaƱada Flintridge',
326             'La Habra Heights',
327             'La Habra',
328             'La Jolla',
329             'La Mirada',
330             'La Palma',
331             'La Puente',
332             'La Verne',
333             'Lafayette',
334             'Laguna Beach',
335             'Laguna Hills',
336             'Laguna Niguel',
337             'Laguna Woods',
338             'Lake Forest',
339             'Lakewood',
340             'Lakewood',
341             'Lancaster',
342             'Lawndale',
343             'Lexington',
344             'Lima',
345             'Little Rock',
346             'Lodi',
347             'Lomita',
348             'Long Beach',
349             'Los Alamitos',
350             'Los Angeles',
351             'Louisville',
352             'Lynwood',
353             'Malibu',
354             'Manhattan Beach',
355             'Marana',
356             'Maywood',
357             'Mentor',
358             'Mentor-on-the-Lake',
359             'Merced',
360             'Mesa',
361             'Michigan City',
362             'Middletown',
363             'Mission Viejo',
364             'Mobile',
365             'Modesto',
366             'Monrovia',
367             'Montebello',
368             'Monterey Park',
369             'Monterey',
370             'Montgomery',
371             'Moraga',
372             'Moreno Valley',
373             'Muncie',
374             'Murray',
375             'Murrieta',
376             'Nenana',
377             'Newport Beach',
378             'Nogales',
379             'Nome',
380             'North Little Rock',
381             'North Pole',
382             'Norwalk',
383             'Oakland',
384             'Ontario',
385             'Orange',
386             'Oro Valley',
387             'Owensboro',
388             'Oxford',
389             'Oxnard',
390             'Paducah',
391             'Palm Springs',
392             'Palmdale',
393             'Palo Alto',
394             'Palos Verdes Estates',
395             'Paramount',
396             'Parma',
397             'Pasadena',
398             'Peoria',
399             'Phenix City',
400             'Phoenix',
401             'Pico Rivera',
402             'Pine Bluff',
403             'Placentia',
404             'Pomona',
405             'Prescott',
406             'Rancho Cordova',
407             'Rancho Cucamonga',
408             'Rancho Palos Verdes',
409             'Rancho Santa Margarita',
410             'Redding',
411             'Redlands',
412             'Redondo Beach',
413             'Rialto',
414             'Richmond',
415             'Riverside',
416             'Rohnert Park',
417             'Rolling Hills Estates',
418             'Rolling Hills',
419             'Rosemead',
420             'Roseville',
421             'Sacramento',
422             'Sahuarita',
423             'Salinas',
424             'San Bernardino',
425             'San Clemente',
426             'San Diego',
427             'San Dimas',
428             'San Fernando',
429             'San Francisco',
430             'San Gabriel',
431             'San Jose',
432             'San Juan Capistrano',
433             'San Luis Obispo',
434             'San Marino',
435             'San Mateo',
436             'San Rafael',
437             'Santa Ana',
438             'Santa Barbara',
439             'Santa Clara',
440             'Santa Clarita',
441             'Santa Cruz',
442             'Santa Fe Springs',
443             'Santa Monica',
444             'Santa Rosa',
445             'Scottsdale',
446             'Seal Beach',
447             'Selma',
448             'Seward',
449             'Sierra Madre',
450             'Sierra Vista',
451             'Signal Hill',
452             'Simi Valley',
453             'Sitka',
454             'Sonoma',
455             'South Bend',
456             'South El Monte',
457             'South Gate',
458             'South Pasadena',
459             'Springdale',
460             'Springfield',
461             'Stanton',
462             'Steubenville',
463             'Stockton',
464             'Sunnyvale',
465             'Sutter Creek',
466             'Temecula',
467             'Tempe',
468             'Temple City',
469             'Terre Haute',
470             'Texarkana',
471             'Thousand Oaks',
472             'Tok',
473             'Toledo',
474             'Torrance',
475             'Troy',
476             'Tucson',
477             'Tuscaloosa',
478             'Tuskegee',
479             'Tustin',
480             'Two Rivers',
481             'Union City',
482             'Valdez',
483             'Valencia',
484             'Vallejo',
485             'Valparaiso',
486             'Ventura',
487             'Vernon',
488             'Villa Park',
489             'Vincennes',
490             'Visalia',
491             'Walnut',
492             'West Covina',
493             'West Hollywood',
494             'West Lafayette',
495             'West Memphis',
496             'Westlake Village',
497             'Westminster',
498             'Whittier',
499             'Wynne',
500             'Yorba Linda',
501             'Youngstown',
502             'Yuma',
503             'Zanesville',
504             ],
505             );
506              
507             =back
508              
509             =head1 SEE ALSO
510              
511             L
512              
513             =head1 AUTHOR
514              
515             Jason Kohles, Eemail@jasonkohles.comE
516              
517             =head1 COPYRIGHT AND LICENSE
518              
519             Copyright 2004-2005 by Jason Kohles
520              
521             This library is free software; you can redistribute it and/or modify
522             it under the same terms as Perl itself.
523              
524             =cut
525              
526             1;