Metadata-Version: 2.3
Name: django-countries
Version: 8.2.0
Summary: Provides a country field for Django models.
Keywords: django,countries,flags
Author: Chris Beaven
Author-email: Chris Beaven <smileychris@gmail.com>
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Requires-Dist: asgiref
Requires-Dist: typing-extensions
Requires-Dist: pyuca ; extra == 'pyuca'
Requires-Python: >=3.8
Project-URL: Homepage, https://github.com/SmileyChris/django-countries/
Project-URL: Change Log, https://github.com/SmileyChris/django-countries/blob/main/CHANGES.md
Project-URL: Source Code, https://github.com/SmileyChris/django-countries
Project-URL: Translations, https://explore.transifex.com/smileychris/django-countries/
Provides-Extra: pyuca
Description-Content-Type: text/markdown

# Django Countries

<p align="center">
  <img src="https://raw.githubusercontent.com/SmileyChris/django-countries/main/docs/images/logo.png" alt="Django Countries Logo" width="164">
</p>

<p align="center">
  <a href="https://badge.fury.io/py/django-countries"><img src="https://badge.fury.io/py/django-countries.svg" alt="PyPI version"></a>
  <a href="https://github.com/SmileyChris/django-countries/actions/workflows/tests.yml"><img src="https://github.com/SmileyChris/django-countries/actions/workflows/tests.yml/badge.svg" alt="Build status"></a>
</p>

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, 5.2
- **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/).
