Metadata-Version: 2.1
Name: django-districts
Version: 2023.2
Summary: A Django app for managing districts in Africa.
Home-page: https://www.example.com/
Author: Ongom Daniel
Author-email: ongomdaniel9@gmail.com
License: MIT License
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown  # text/markdown | text/x-rst
License-File: LICENSE

# Districts - Africa

Districts - Africa is a Django app for managing regions, districts, counties, sub-counties, parishes, and their corresponding locations within the African continent.

Detailed documentation is in the "docs" directory.

## Quick start

1. Install the Districts package using `pip` by running the following command:

2. Add "districts" to your `INSTALLED_APPS` setting like this:

INSTALLED_APPS = [
...,
"districts",
]

3. Include the districts URLconf in your project urls.py like this:

path("districts/", include("districts.urls")),

4. Run `python manage.py migrate` to create the districts models.

5. Run `python manage.py load_districts_data` to load the Districts data to your model.

6. Start the development server and visit `http://127.0.0.1:8000/districts/` to view the districts and the URLs.

7. For instance, visit `http://127.0.0.1:8000/districts/region/` to access the regions within a country.
