How blazikentech/django-address works
Django Address is a reusable Django app for capturing postal addresses, normalizing their components, and storing them as related Country, State, Locality, and Address records. The principal workflow is a user entering an address in a Django form: the widget supplies browser autocomplete, submitted components are converted by the form field, and the model layer persists the address. AddressField also offers a convenient way for other models to reference addresses. Google Maps is an optional browser integration; the example-site view demonstrates form submission and address listing. Core model and example-form implementations were not sampled, so their internal wiring is shown only where documented or evident in the sampled view.
Main entry points: models.py Address records · views.py Example home view · forms.py Address form field · widgets.py Address widget
Components 15
Address domain
- Address conversion
address/models.py - AddressField
address/models.py - Address records
address/models.py - Place hierarchy
address/models.py
Address entry
- Address form field
address/forms.py - Address widget
address/widgets.py - Address browser glue
address/static/address/js/address.js - Autocomplete plugin
address/static/js/jquery.geocomplete.js
Example app
- Example home view
example_site/person/views.py - Person form
example_site/person/forms.py - Person model
example_site/person/models.py - Example page
example_site/person/templates/example/home.html
Other components
- Form user
- Google Maps APIs
- Application database
Connections 16
- Form user → Address form field: enters address
- Address form field → Address widget: renders with
- Address widget → Address browser glue: loads script
- Address browser glue → Autocomplete plugin: initializes
- Autocomplete plugin → Google Maps APIs: requests places
- Address widget → Address records: loads existing record
- Address form field → Address conversion: converts submission
- Address conversion → Address records: builds address
- AddressField → Address records: references
- Address records → Place hierarchy: links components
- Address records → Application database: persists
- Example home view → Person form: binds submission
- Example home view → Address records: queries addresses
- Example home view → Example page: renders context
- Person form → Person model: saves person
- Person model → AddressField: references address