| Name | django-countries JSON |
| Version |
7.8
JSON |
| download |
| home_page | None |
| Summary | Provides a country field for Django models. |
| upload_time | 2025-11-04 02:12:27 |
| maintainer | None |
| docs_url | None |
| author | Chris Beaven |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
django
countries
flags
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Django Countries
[](https://badge.fury.io/py/django-countries)
[](https://github.com/SmileyChris/django-countries/actions/workflows/tests.yml)
A Django application that provides country choices for use with forms, flag icons static files, and a country field for models.
## Documentation
📚 **[Read the full documentation](https://smileychris.github.io/django-countries/)**
## Quick Start
Install:
```bash
pip install django-countries
```
Add to `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
# ...
'django_countries',
]
```
Use in your models:
```python
from django_countries.fields import CountryField
class Person(models.Model):
country = CountryField()
```
## Features
- **Country Field**: Django model field with all ISO 3166-1 countries
- **Translated Names**: Country names translated using Django's i18n system
- **Flag Icons**: Static flag image files for all countries
- **REST Framework**: Full Django REST Framework integration
- **GraphQL**: Support for graphene-django
- **Multiple Selection**: Support for multiple country selection
## Support
- **Python**: 3.8, 3.9, 3.10, 3.11, 3.12, 3.13
- **Django**: 3.2 (LTS), 4.2 (LTS), 5.0, 5.1
- **Django REST Framework**: 3.11+
## Contributing
Contributions are welcome! See the [Contributing Guide](https://smileychris.github.io/django-countries/contributing/) for details.
## Translations
Country names are translated using Django's standard `gettext` and imported from our [Transifex project](https://explore.transifex.com/smileychris/django-countries/).
Raw data
{
"_id": null,
"home_page": null,
"name": "django-countries",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "django, countries, flags",
"author": "Chris Beaven",
"author_email": "Chris Beaven <smileychris@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/06/ac/3b4ce340bedf96743f403542acfe7f66667954f5f0b2bed7aa4ade7ddaa8/django_countries-7.8.tar.gz",
"platform": null,
"description": "# Django Countries\n\n[](https://badge.fury.io/py/django-countries)\n[](https://github.com/SmileyChris/django-countries/actions/workflows/tests.yml)\n\nA Django application that provides country choices for use with forms, flag icons static files, and a country field for models.\n\n## Documentation\n\n\ud83d\udcda **[Read the full documentation](https://smileychris.github.io/django-countries/)**\n\n## Quick Start\n\nInstall:\n```bash\npip install django-countries\n```\n\nAdd to `INSTALLED_APPS`:\n```python\nINSTALLED_APPS = [\n # ...\n 'django_countries',\n]\n```\n\nUse in your models:\n```python\nfrom django_countries.fields import CountryField\n\nclass Person(models.Model):\n country = CountryField()\n```\n\n## Features\n\n- **Country Field**: Django model field with all ISO 3166-1 countries\n- **Translated Names**: Country names translated using Django's i18n system\n- **Flag Icons**: Static flag image files for all countries\n- **REST Framework**: Full Django REST Framework integration\n- **GraphQL**: Support for graphene-django\n- **Multiple Selection**: Support for multiple country selection\n\n## Support\n\n- **Python**: 3.8, 3.9, 3.10, 3.11, 3.12, 3.13\n- **Django**: 3.2 (LTS), 4.2 (LTS), 5.0, 5.1\n- **Django REST Framework**: 3.11+\n\n## Contributing\n\nContributions are welcome! See the [Contributing Guide](https://smileychris.github.io/django-countries/contributing/) for details.\n\n## Translations\n\nCountry names are translated using Django's standard `gettext` and imported from our [Transifex project](https://explore.transifex.com/smileychris/django-countries/).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Provides a country field for Django models.",
"version": "7.8",
"project_urls": {
"Change Log": "https://github.com/SmileyChris/django-countries/blob/main/CHANGES.rst",
"Homepage": "https://github.com/SmileyChris/django-countries/",
"Source Code": "https://github.com/SmileyChris/django-countries",
"Translations": "https://explore.transifex.com/smileychris/django-countries/"
},
"split_keywords": [
"django",
" countries",
" flags"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1f6998ad5bd078c6447e252d915a54e6b4d8909e793e6c8dfaf3e91172c9280c",
"md5": "f2b5a2cb61bb5fb3214c3a6a39c2ee8d",
"sha256": "6a9cc056f22f160b8f4df6fb11583208d503a8407af1ef7a51985f8ff1a13b34"
},
"downloads": -1,
"filename": "django_countries-7.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2b5a2cb61bb5fb3214c3a6a39c2ee8d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 896926,
"upload_time": "2025-11-04T02:12:25",
"upload_time_iso_8601": "2025-11-04T02:12:25.318019Z",
"url": "https://files.pythonhosted.org/packages/1f/69/98ad5bd078c6447e252d915a54e6b4d8909e793e6c8dfaf3e91172c9280c/django_countries-7.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "06ac3b4ce340bedf96743f403542acfe7f66667954f5f0b2bed7aa4ade7ddaa8",
"md5": "ff4b96f6200e7f4d7ce10125c370a9d8",
"sha256": "b8413065160bc93efe1293d746bbde32951d9a1fe7e44f1fe2add1bebbb6962f"
},
"downloads": -1,
"filename": "django_countries-7.8.tar.gz",
"has_sig": false,
"md5_digest": "ff4b96f6200e7f4d7ce10125c370a9d8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 551056,
"upload_time": "2025-11-04T02:12:27",
"upload_time_iso_8601": "2025-11-04T02:12:27.562695Z",
"url": "https://files.pythonhosted.org/packages/06/ac/3b4ce340bedf96743f403542acfe7f66667954f5f0b2bed7aa4ade7ddaa8/django_countries-7.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-04 02:12:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SmileyChris",
"github_project": "django-countries",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-countries"
}
