| Name | provinces-and-cities JSON |
| Version |
1.0.3
JSON |
| download |
| home_page | https://github.com/mohammad-prb/provinces-and-cities-pypi |
| Summary | Package of countries provinces and cities. |
| upload_time | 2025-01-06 16:33:09 |
| maintainer | None |
| docs_url | None |
| author | Mohammad Pourbehzad |
| requires_python | >=3.6 |
| license | Copyright (c) 2018 The Python Packaging Authority Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
provinces
province
cities
city
iran
germany
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Countries Provinces and Cities
This project provides data for provinces/states and cities of various countries. Currently, the following countries are included:
- **Iran**: Detailed list of provinces and cities.
- **Germany**: Comprehensive list of federal states (Bundesländer) and their cities.
If you use languages other than Python and need these lists, you can access the **JSON** and **MySQL** Information through this [repository](https://github.com/mohammad-prb/provinces-and-cities).
## Install
```bash
pip install provinces-and-cities
```
## How to Use
```python
from provinces_and_cities import Iran
Iran.main # all provinces and main cities
Iran.all # all provinces and all cities
```
### Examlpe of data
```python
Iran.main[7] = {
"id": 8,
"name": "تهران",
"tel_prefix": "021",
"cities": [
"اسلامشهر",
"بومهن",
"پاكدشت",
"تهران",
"چهاردانگه",
"دماوند",
"رودهن",
"ري",
"شريف آباد",
"شهر رباط كريم",
"شهر شهريار",
"فشم",
"فيروزكوه",
"قدس",
"كهريزك",
"لواسان بزرگ",
"ملارد",
"ورامين"
]
}
```
## Future Plans
The project is designed to be scalable, and we plan to add data for other countries in the future. If you have suggestions for specific countries, feel free to contribute or create an issue.
## Contributions
We welcome contributions to expand this project. If you'd like to add data for a new country or improve existing data, please create a pull request.
## Support
If this project was helpful, please consider giving it a **star**. Your support helps us grow!
Raw data
{
"_id": null,
"home_page": "https://github.com/mohammad-prb/provinces-and-cities-pypi",
"name": "provinces-and-cities",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "provinces, province, cities, city, iran, germany",
"author": "Mohammad Pourbehzad",
"author_email": "Mohammad Pourbehzad <pspipm27@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a4/f2/9b4e01baffc30b41ce1aa32c9997c73dcd2a2ef6dc1d9497ec879ca652e7/provinces_and_cities-1.0.3.tar.gz",
"platform": null,
"description": "# Countries Provinces and Cities\n\nThis project provides data for provinces/states and cities of various countries. Currently, the following countries are included:\n\n- **Iran**: Detailed list of provinces and cities.\n- **Germany**: Comprehensive list of federal states (Bundesl\u00e4nder) and their cities.\n\nIf you use languages other than Python and need these lists, you can access the **JSON** and **MySQL** Information through this [repository](https://github.com/mohammad-prb/provinces-and-cities).\n\n## Install\n```bash\npip install provinces-and-cities\n```\n\n## How to Use\n```python\nfrom provinces_and_cities import Iran\n\nIran.main # all provinces and main cities\nIran.all # all provinces and all cities\n```\n\n### Examlpe of data\n```python\nIran.main[7] = {\n \"id\": 8,\n \"name\": \"\u062a\u0647\u0631\u0627\u0646\",\n \"tel_prefix\": \"021\",\n \"cities\": [\n \"\u0627\u0633\u0644\u0627\u0645\u0634\u0647\u0631\",\n \"\u0628\u0648\u0645\u0647\u0646\",\n \"\u067e\u0627\u0643\u062f\u0634\u062a\",\n \"\u062a\u0647\u0631\u0627\u0646\",\n \"\u0686\u0647\u0627\u0631\u062f\u0627\u0646\u06af\u0647\",\n \"\u062f\u0645\u0627\u0648\u0646\u062f\",\n \"\u0631\u0648\u062f\u0647\u0646\",\n \"\u0631\u064a\",\n \"\u0634\u0631\u064a\u0641 \u0622\u0628\u0627\u062f\",\n \"\u0634\u0647\u0631 \u0631\u0628\u0627\u0637 \u0643\u0631\u064a\u0645\",\n \"\u0634\u0647\u0631 \u0634\u0647\u0631\u064a\u0627\u0631\",\n \"\u0641\u0634\u0645\",\n \"\u0641\u064a\u0631\u0648\u0632\u0643\u0648\u0647\",\n \"\u0642\u062f\u0633\",\n \"\u0643\u0647\u0631\u064a\u0632\u0643\",\n \"\u0644\u0648\u0627\u0633\u0627\u0646 \u0628\u0632\u0631\u06af\",\n \"\u0645\u0644\u0627\u0631\u062f\",\n \"\u0648\u0631\u0627\u0645\u064a\u0646\"\n ]\n}\n```\n\n## Future Plans\nThe project is designed to be scalable, and we plan to add data for other countries in the future. If you have suggestions for specific countries, feel free to contribute or create an issue.\n\n## Contributions\nWe welcome contributions to expand this project. If you'd like to add data for a new country or improve existing data, please create a pull request.\n\n## Support\nIf this project was helpful, please consider giving it a **star**. Your support helps us grow!\n",
"bugtrack_url": null,
"license": "Copyright (c) 2018 The Python Packaging Authority Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "Package of countries provinces and cities.",
"version": "1.0.3",
"project_urls": {
"Homepage": "https://github.com/mohammad-prb/provinces-and-cities-pypi",
"Issues": "https://github.com/mohammad-prb/provinces-and-cities-pypi/issues",
"Repository": "https://github.com/mohammad-prb/provinces-and-cities-pypi.git"
},
"split_keywords": [
"provinces",
" province",
" cities",
" city",
" iran",
" germany"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2906a6572f7b21c4abff0ecd4569f87f4b42f5588e3c385b63a9e9d709d24879",
"md5": "4341b593a368c289f1919310c2207acf",
"sha256": "efa86b1f5b29407b88548584fad2c62a531dc1a4ec7ca6ee1e0b21669363bc9d"
},
"downloads": -1,
"filename": "provinces_and_cities-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4341b593a368c289f1919310c2207acf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 15873,
"upload_time": "2025-01-06T16:33:07",
"upload_time_iso_8601": "2025-01-06T16:33:07.694571Z",
"url": "https://files.pythonhosted.org/packages/29/06/a6572f7b21c4abff0ecd4569f87f4b42f5588e3c385b63a9e9d709d24879/provinces_and_cities-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a4f29b4e01baffc30b41ce1aa32c9997c73dcd2a2ef6dc1d9497ec879ca652e7",
"md5": "4b15f99d15c1b3ffec6ab47583b1c6f2",
"sha256": "9c815f0c618d6a68166195fed254ff21aa99508e89f7236e1e5a0a17db7de20c"
},
"downloads": -1,
"filename": "provinces_and_cities-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "4b15f99d15c1b3ffec6ab47583b1c6f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 17177,
"upload_time": "2025-01-06T16:33:09",
"upload_time_iso_8601": "2025-01-06T16:33:09.135973Z",
"url": "https://files.pythonhosted.org/packages/a4/f2/9b4e01baffc30b41ce1aa32c9997c73dcd2a2ef6dc1d9497ec879ca652e7/provinces_and_cities-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-06 16:33:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mohammad-prb",
"github_project": "provinces-and-cities-pypi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "provinces-and-cities"
}
