# Country Database
<div align="center">
[](https://github.com/sivakumar-mahalingam/country-db/blob/main/LICENSE)
[](https://pypi.org/project/country-db/)
<a href="https://github.com/sivakumar-mahalingam/country-db/" target="_blank">
<img src="https://raw.githubusercontent.com/sivakumar-mahalingam/country-db/main/docs/images/country-db-banner.png" target="_blank" />
</a>
A comprehensive repository of global country details, including country codes, ISD codes, currency codes, and more.
</div>
## ️✨Features
### 🌐Country Codes
- Alpha2Code
- Alpha3Code
- NumericCode
_**Source:** [ISO 3166 - 1](https://en.wikipedia.org/wiki/ISO_3166-1)_
### 🌍Region Details
- Continent
- Capital
_**Source:** [Wikipedia](https://en.wikipedia.org/wiki/List_of_national_capitals)_
- RegionName
- RegionCode
- SubRegionName
- SubRegionCode
- IntermediateRegionName
- IntermediateRegionCode
_**Source:** [UN M49](https://unstats.un.org/unsd/methodology/m49/overview/)_
### 🔗TLD
- TopLevelDomain
_**Source:** [IANA](https://www.iana.org/domains/root/db)_
### ☎️Calling Codes
- CallingCode
_**Source:** [ITU](https://www.itu.int/en/ITU-T/Pages/default.aspx)_
### 💲Currency Codes
- CurrencyCode
- CurrencyNumber
- CurrencyName
_**Source:** [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)_
### 🚩Flag
- FlagEmoji
- FlagUnicode
- FlagImage [ToDo]
_**Source:** [Openmoji](https://openmoji.org/library/)_
## ⚙️Installation
Install `country-db`
```bash
pip install country-db
```
## ✅ToDo
- [ ] Include Usage/Example in README
- [ ] Add wiki page
- [ ] Add documentation page
- [ ] Add FlagImage
## 🤝 Contributing
Contributions are welcome! Here's how you can help:
1. Fork the repository
2. Create a new branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Commit your changes (`git commit -m 'feat: add amazing feature'`)
5. Push to the branch (`git push origin feature/amazing-feature`)
6. Open a Pull Request
## ⚖️License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏Show your support
Give a ⭐️ if <a href="https://github.com/sivakumar-mahalingam/country-db/">this</a> project helped you!
Raw data
{
"_id": null,
"home_page": "https://github.com/sivakumar-mahalingam/country-db/",
"name": "country-db",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "country",
"author": "Sivakumar Mahalingam, Sabarinath Velayudham",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/d4/14/7ae06e16c1d75cc71f4f59e0686e307335dc27ccde05cc215ee24db56917/country-db-1.0.1.tar.gz",
"platform": null,
"description": "# Country Database\r\n\r\n<div align=\"center\">\r\n\r\n[](https://github.com/sivakumar-mahalingam/country-db/blob/main/LICENSE)\r\n\r\n[](https://pypi.org/project/country-db/)\r\n\r\n<a href=\"https://github.com/sivakumar-mahalingam/country-db/\" target=\"_blank\">\r\n <img src=\"https://raw.githubusercontent.com/sivakumar-mahalingam/country-db/main/docs/images/country-db-banner.png\" target=\"_blank\" />\r\n</a>\r\n\r\nA comprehensive repository of global country details, including country codes, ISD codes, currency codes, and more. \r\n\r\n</div>\r\n\r\n## \ufe0f\u2728Features\r\n\r\n### \ud83c\udf10Country Codes\r\n- Alpha2Code\r\n- Alpha3Code\r\n- NumericCode\r\n \r\n_**Source:** [ISO 3166 - 1](https://en.wikipedia.org/wiki/ISO_3166-1)_\r\n\r\n### \ud83c\udf0dRegion Details\r\n- Continent\r\n- Capital\r\n\r\n_**Source:** [Wikipedia](https://en.wikipedia.org/wiki/List_of_national_capitals)_\r\n \r\n- RegionName\r\n- RegionCode\r\n- SubRegionName\r\n- SubRegionCode\r\n- IntermediateRegionName\r\n- IntermediateRegionCode\r\n\r\n_**Source:** [UN M49](https://unstats.un.org/unsd/methodology/m49/overview/)_\r\n\r\n### \ud83d\udd17TLD\r\n- TopLevelDomain\r\n\r\n_**Source:** [IANA](https://www.iana.org/domains/root/db)_\r\n\r\n### \u260e\ufe0fCalling Codes\r\n- CallingCode\r\n\r\n_**Source:** [ITU](https://www.itu.int/en/ITU-T/Pages/default.aspx)_\r\n\r\n### \ud83d\udcb2Currency Codes\r\n- CurrencyCode\r\n- CurrencyNumber\r\n- CurrencyName\r\n\r\n_**Source:** [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)_\r\n\r\n### \ud83d\udea9Flag\r\n- FlagEmoji\r\n- FlagUnicode\r\n- FlagImage [ToDo]\r\n\r\n_**Source:** [Openmoji](https://openmoji.org/library/)_\r\n\r\n## \u2699\ufe0fInstallation\r\n\r\nInstall `country-db` \r\n```bash\r\npip install country-db\r\n```\r\n\r\n## \u2705ToDo\r\n\r\n- [ ] Include Usage/Example in README\r\n- [ ] Add wiki page\r\n- [ ] Add documentation page\r\n- [ ] Add FlagImage\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nContributions are welcome! Here's how you can help:\r\n\r\n1. Fork the repository\r\n2. Create a new branch (`git checkout -b feature/amazing-feature`)\r\n3. Make your changes\r\n4. Commit your changes (`git commit -m 'feat: add amazing feature'`)\r\n5. Push to the branch (`git push origin feature/amazing-feature`)\r\n6. Open a Pull Request\r\n\r\n## \u2696\ufe0fLicense\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83d\ude4fShow your support\r\n\r\nGive a \u2b50\ufe0f if <a href=\"https://github.com/sivakumar-mahalingam/country-db/\">this</a> project helped you!\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A comprehensive repository of global country details, including country codes, ISD codes, currency codes, and more.",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/sivakumar-mahalingam/country-db/",
"Source": "https://github.com/sivakumar-mahalingam/country-db",
"Tracker": "https://github.com/sivakumar-mahalingam/country-db/issues"
},
"split_keywords": [
"country"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b0fab197fbf85d70e7e97f6113e2486d35173c4777e602a29144974ca24d4f21",
"md5": "41cb036ac329759a7541c567cedb0d57",
"sha256": "47c92580428cbb434ba22d7a3fd985cc0cd159b7e59050121a82234801b7d085"
},
"downloads": -1,
"filename": "country_db-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "41cb036ac329759a7541c567cedb0d57",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 22653,
"upload_time": "2025-02-15T18:42:34",
"upload_time_iso_8601": "2025-02-15T18:42:34.311057Z",
"url": "https://files.pythonhosted.org/packages/b0/fa/b197fbf85d70e7e97f6113e2486d35173c4777e602a29144974ca24d4f21/country_db-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d4147ae06e16c1d75cc71f4f59e0686e307335dc27ccde05cc215ee24db56917",
"md5": "ddb67c0e07977a1cfb719df3deddf8af",
"sha256": "636ebda76142a83af9842605ddabc5d3ab46a4eedb08d23b50a43821524094f2"
},
"downloads": -1,
"filename": "country-db-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "ddb67c0e07977a1cfb719df3deddf8af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 21796,
"upload_time": "2025-02-15T18:42:36",
"upload_time_iso_8601": "2025-02-15T18:42:36.297981Z",
"url": "https://files.pythonhosted.org/packages/d4/14/7ae06e16c1d75cc71f4f59e0686e307335dc27ccde05cc215ee24db56917/country-db-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-15 18:42:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sivakumar-mahalingam",
"github_project": "country-db",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "country-db"
}
JSON
