Add US County Provider#2383
Conversation
|
@joke2k If you like this idea and it is approved for Faker, I would also look into adding other countries and various levels of administrative regions, as they differ from one country to the next, such as states and districts for |
|
I'm worried this level of detail, multiplied for each country, would make the size of the package huge. We're already at 2MB as it is. If we really want to go down that road, we should explore solutions to ship data in a compressed format. |
|
Yes, I definitely understand the size concern. Do you think this would be better suited as an external provider? Also, for other countries with significantly smaller administrative datasets, would you generally prefer those to live in an external provider as well, or would they be reasonable candidates for inclusion in Faker itself? For example, there are around 400 districts for the 16 "states" in Germany, compared to over 3,000 counties in the 50 states for the United States (not including territories). I am almost finished with the de_DE version and I would appreciate your guidance. Thank you! |
2 participants
What does this change
Adds U.S. county support to the
en_USaddress provider:county()county_by_state()county_with_state()Includes counties and county equivalents such as Louisiana parishes and Alaska boroughs.
What was wrong
Faker’s
en_USaddress provider currently has states, cities, ZIP codes, and street addresses, but no way to generate county names.How this fixes it
Adds county data and provider methods for generating counties, optionally by state.
Data source: U.S. Census Bureau ANSI/FIPS county reference data
AI Assistance Disclosure (REQUIRED)
I used ChatGPT for help with Git/GitHub workflow, pull request setup, and repository navigation. I reviewed and verified the code myself.
Checklist
make lintNote:make lintrequirespython3.11locally; I ran Ruff on the changed Python files, and all checks passed.