# pyworldatlas
**pyworldatlas** is a lightweight and comprehensive Python package that compiles detailed data about every country in the world. Whether you're building applications that require accurate global data or simply need quick access to country profiles, pyworldatlas provides an efficient and easy-to-use interface.
## Key Features
- Extensive country data including official names, population, geography, government, GDP, and more.
- Lightweight and efficient, ensuring fast access to country information.
- No external dependencies, making it easy to install and integrate into any Python project.
- Provides detailed country profiles in a simple dictionary format.
## Installation
You can install `pyworldatlas` from PyPI using pip:
```bash
pip install pyworldatlas
```
## Basic Usage
Once installed, using pyworldatlas is straightforward. Here's a quick example of how to fetch a country's profile:
```python
import pyworldatlas as pwa
atlas = pwa.Atlas()
# Fetch the profile of a country by name
profile = atlas.get_country_profile("Albania")
# Display the profile information
print(profile)
```
Example output:
```python
{
"capital": {
"name": "Tirana",
"coordinates_degree_east": 19.49,
"coordinates_degree_north": 41.19,
"is_largest_city": True
},
"area": {
"total_km2_including_disputed_territories": None,
"total_km2_internationally_recognized": 28748.0,
"water_percentage": 4.7
},
"driving_side": "Right",
"calling_code": "355",
"iso_3166_code": "AL",
"internet_tld": ".al",
"population": {
"total": 2994667,
"density_km2": 111.1,
"date_year": 2011
},
"gini_index": {
"value": 26.7,
"year": 2005
},
"gdp": {
"ppp_trillions": 0.025035,
"ppp_per_capita": 7780.0,
"nominal_total_trillions": 0.013292,
"nominal_per_capita": 4131.0,
"ppp_gdp_year": 2011,
"nominal_gdp_year": 2011
},
"government": {
"president": "Bajram Begaj",
"prime_minister": "Edi Rama",
"declaration_of_state_sovereignty": "1912-11-28",
"other_leader_title": None,
"other_leader": None,
"government_type": "Parliamentary republic",
"president_assumed_office": "2022-07-24",
"prime_minister_assumed_office": "2013-09-15",
"other_leader_assumed_office": None
},
"official_names": {
"Albanian": "Republika e Shqipërisë",
"English": "Republic of Albania"
},
"anthem": {
"Albanian": "Himni i Flamurit",
"English": "Hymn to the Flag"
},
"motto": {
"Albanian": "Ti, Shqipëri, më jep nder, më jep emrin Shqiptar",
"English": "You, Albania, give me honor, give me the name Albanian"
},
"religion": {
"Islam": 50.67,
"Christianity": 16.02,
"Non-denominational": 13.83,
"Atheism": 3.55,
"Others": 0.15,
"Undeclared": 15.77
},
"ethnic_groups": {
"Albanians": 98.2,
"Others": 1.8
},
"languages": {
"official_languages": ["Albanian"],
"recognized_languages": []
},
"currency": {
"name": "Lek",
"symbol": "L",
"iso_code": "ALL"
},
"continent": "Europe",
"timezones": {
"UTC+1": {"DST": 1},
"UTC+2": {"DST": 1}
}
}
```
## Documentation
Comprehensive documentation is available, including examples, API references, and more. Visit the [pyworldatlas Documentation](https://jcari-dev.github.io/pyworldatlas-documentation/index.html) to get started.
## Contributing
If you'd like to contribute, please check out the [Contributing Page](https://jcari-dev.github.io/pyworldatlas-documentation/contributing.html) for details.
## License
This project is licensed under the MIT License. See the [LICENSE](https://jcari-dev.github.io/pyworldatlas-documentation/license.html) file for more information.
## Links
- [Documentation](https://jcari-dev.github.io/pyworldatlas-documentation/index.html)
- [PyPI Page](https://pypi.org/project/pyworldatlas/)
- [Issue Tracker](https://github.com/jcari-dev/pyworldatlas-issue-tracker)
Raw data
{
"_id": null,
"home_page": "https://jcari-dev.github.io/pyworldatlas-documentation/",
"name": "pyworldatlas",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "country data atlas global statistics geography government economy",
"author": "jcari-dev",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/4b/09/373055d6e005f232b6f896607c12a3b06331c2cb263622572882facf01c5/pyworldatlas-0.0.12.tar.gz",
"platform": null,
"description": "\r\n# pyworldatlas\r\n\r\n**pyworldatlas** is a lightweight and comprehensive Python package that compiles detailed data about every country in the world. Whether you're building applications that require accurate global data or simply need quick access to country profiles, pyworldatlas provides an efficient and easy-to-use interface.\r\n\r\n## Key Features\r\n\r\n- Extensive country data including official names, population, geography, government, GDP, and more.\r\n- Lightweight and efficient, ensuring fast access to country information.\r\n- No external dependencies, making it easy to install and integrate into any Python project.\r\n- Provides detailed country profiles in a simple dictionary format.\r\n\r\n## Installation\r\n\r\nYou can install `pyworldatlas` from PyPI using pip:\r\n\r\n```bash\r\npip install pyworldatlas\r\n```\r\n\r\n## Basic Usage\r\n\r\nOnce installed, using pyworldatlas is straightforward. Here's a quick example of how to fetch a country's profile:\r\n\r\n```python\r\nimport pyworldatlas as pwa\r\n\r\natlas = pwa.Atlas()\r\n\r\n# Fetch the profile of a country by name\r\nprofile = atlas.get_country_profile(\"Albania\")\r\n\r\n# Display the profile information\r\nprint(profile)\r\n```\r\n\r\nExample output:\r\n\r\n```python\r\n{\r\n \"capital\": {\r\n \"name\": \"Tirana\",\r\n \"coordinates_degree_east\": 19.49,\r\n \"coordinates_degree_north\": 41.19,\r\n \"is_largest_city\": True\r\n },\r\n \"area\": {\r\n \"total_km2_including_disputed_territories\": None,\r\n \"total_km2_internationally_recognized\": 28748.0,\r\n \"water_percentage\": 4.7\r\n },\r\n \"driving_side\": \"Right\",\r\n \"calling_code\": \"355\",\r\n \"iso_3166_code\": \"AL\",\r\n \"internet_tld\": \".al\",\r\n \"population\": {\r\n \"total\": 2994667,\r\n \"density_km2\": 111.1,\r\n \"date_year\": 2011\r\n },\r\n \"gini_index\": {\r\n \"value\": 26.7,\r\n \"year\": 2005\r\n },\r\n \"gdp\": {\r\n \"ppp_trillions\": 0.025035,\r\n \"ppp_per_capita\": 7780.0,\r\n \"nominal_total_trillions\": 0.013292,\r\n \"nominal_per_capita\": 4131.0,\r\n \"ppp_gdp_year\": 2011,\r\n \"nominal_gdp_year\": 2011\r\n },\r\n \"government\": {\r\n \"president\": \"Bajram Begaj\",\r\n \"prime_minister\": \"Edi Rama\",\r\n \"declaration_of_state_sovereignty\": \"1912-11-28\",\r\n \"other_leader_title\": None,\r\n \"other_leader\": None,\r\n \"government_type\": \"Parliamentary republic\",\r\n \"president_assumed_office\": \"2022-07-24\",\r\n \"prime_minister_assumed_office\": \"2013-09-15\",\r\n \"other_leader_assumed_office\": None\r\n },\r\n \"official_names\": {\r\n \"Albanian\": \"Republika e Shqip\u00ebris\u00eb\",\r\n \"English\": \"Republic of Albania\"\r\n },\r\n \"anthem\": {\r\n \"Albanian\": \"Himni i Flamurit\",\r\n \"English\": \"Hymn to the Flag\"\r\n },\r\n \"motto\": {\r\n \"Albanian\": \"Ti, Shqip\u00ebri, m\u00eb jep nder, m\u00eb jep emrin Shqiptar\",\r\n \"English\": \"You, Albania, give me honor, give me the name Albanian\"\r\n },\r\n \"religion\": {\r\n \"Islam\": 50.67,\r\n \"Christianity\": 16.02,\r\n \"Non-denominational\": 13.83,\r\n \"Atheism\": 3.55,\r\n \"Others\": 0.15,\r\n \"Undeclared\": 15.77\r\n },\r\n \"ethnic_groups\": {\r\n \"Albanians\": 98.2,\r\n \"Others\": 1.8\r\n },\r\n \"languages\": {\r\n \"official_languages\": [\"Albanian\"],\r\n \"recognized_languages\": []\r\n },\r\n \"currency\": {\r\n \"name\": \"Lek\",\r\n \"symbol\": \"L\",\r\n \"iso_code\": \"ALL\"\r\n },\r\n \"continent\": \"Europe\",\r\n \"timezones\": {\r\n \"UTC+1\": {\"DST\": 1},\r\n \"UTC+2\": {\"DST\": 1}\r\n }\r\n}\r\n```\r\n\r\n## Documentation\r\n\r\nComprehensive documentation is available, including examples, API references, and more. Visit the [pyworldatlas Documentation](https://jcari-dev.github.io/pyworldatlas-documentation/index.html) to get started.\r\n\r\n## Contributing\r\n\r\nIf you'd like to contribute, please check out the [Contributing Page](https://jcari-dev.github.io/pyworldatlas-documentation/contributing.html) for details.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](https://jcari-dev.github.io/pyworldatlas-documentation/license.html) file for more information.\r\n\r\n## Links\r\n\r\n- [Documentation](https://jcari-dev.github.io/pyworldatlas-documentation/index.html)\r\n- [PyPI Page](https://pypi.org/project/pyworldatlas/)\r\n- [Issue Tracker](https://github.com/jcari-dev/pyworldatlas-issue-tracker)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Comprehensive and Lightweight Country Data Package",
"version": "0.0.12",
"project_urls": {
"Documentation": "https://jcari-dev.github.io/pyworldatlas-documentation/",
"Homepage": "https://jcari-dev.github.io/pyworldatlas-documentation/",
"Issue Tracker": "https://github.com/jcari-dev/pyworldatlas-issue-tracker",
"PyPI": "https://pypi.org/project/pyworldatlas/"
},
"split_keywords": [
"country",
"data",
"atlas",
"global",
"statistics",
"geography",
"government",
"economy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "38579997fc8a11804711bc7fc49bac60df29bb3007c211ba96292c67a7c52997",
"md5": "5089044269451bf04f460eaaa7f1f5bf",
"sha256": "86ea7126c26a45316187b5686c6ae7cc94e96b233ef13a1635502cb26bb472c5"
},
"downloads": -1,
"filename": "pyworldatlas-0.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5089044269451bf04f460eaaa7f1f5bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 35869,
"upload_time": "2024-09-26T00:08:57",
"upload_time_iso_8601": "2024-09-26T00:08:57.355449Z",
"url": "https://files.pythonhosted.org/packages/38/57/9997fc8a11804711bc7fc49bac60df29bb3007c211ba96292c67a7c52997/pyworldatlas-0.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b09373055d6e005f232b6f896607c12a3b06331c2cb263622572882facf01c5",
"md5": "f8fa61368ed14c3cfdaa7fa991d5bb1f",
"sha256": "5f362b72480d5b08d7f5f33da8aca8823813b6e38891ac80aa163118b6e954e5"
},
"downloads": -1,
"filename": "pyworldatlas-0.0.12.tar.gz",
"has_sig": false,
"md5_digest": "f8fa61368ed14c3cfdaa7fa991d5bb1f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 38522,
"upload_time": "2024-09-26T00:08:59",
"upload_time_iso_8601": "2024-09-26T00:08:59.137830Z",
"url": "https://files.pythonhosted.org/packages/4b/09/373055d6e005f232b6f896607c12a3b06331c2cb263622572882facf01c5/pyworldatlas-0.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-26 00:08:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jcari-dev",
"github_project": "pyworldatlas-issue-tracker",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pyworldatlas"
}
JSON
