Skip to main content

Django Address Model

Project description

pypi version license build status

django abstract model that provide the complete address, eg: no, na/rt, ca/rw, village, sub district, district, province, country, postal code, currency code, phone code, etc.

Support Languages

  1. ID - Indonesia

Quick start

  1. Django Log Viewer is available directly from PyPI:
pip install django-address-model
  1. Add "django_address" to your INSTALLED_APPS setting like this
  1. Create an initial address
python create_address --language=id --show-print=true

Usage Example

In your

from django.db import models
from django_address.models import AddressModel

class Profile(AddressModel, models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField(blank=True, null=True)
    phone = models.CharField(max_length=15, blank=True, null=True)

    def __str__(self):

    class Meta:
        ordering = ('-id',)

ORM Usage Example

>>> from django_address.models import SubDistrict
>>> from app.models import Profile
>>> sub_district = SubDistrict.objects.first()
>>> profile_data {'name': 'Summon Agus', 'email': '', 'phone': '+6282133338888',
                  'address': 'Jl. Karto Dimejo', 'number': 35, 'na': 3, 'ca': 34, 'village': 'Sinduarjo',
                  'sub_district': sub_district}
>>> profile = Profile.objects.create(**profile_data)
>>> profile.number
>>> profile.address
'Jl. Karto Dimejo'
>>> profile.village
>>> profile.sub_district
>>> profile.sub_district.district
>>> profile.get_full_address(format_address='id', include_country=True)
'Jl. Karto Dimejo No.35, RT.3/RW.34 Sinduarjo, Ngaglik, Sleman, Yogyakarta, Indonesia - 55581'
>>> profile.get_full_address_json()
  'na': 3,
  'ca': 34,
  'number': 35,
  'village': 'Sinduarjo',
  'address': 'Jl. Karto Dimejo',
  'sub_district': {
    'id': 1,
    'district': 1,
    'deleted_at': None,
    'postal_code': '55581',
    'name': 'Ngaglik'
  'district': {
    'id': 1,
    'name': 'Sleman',
    'deleted_at': None,
    'province': 1
  'province': {
    'id': 1,
    'name': 'Yogyakarta',
    'deleted_at': None,
    'country': 1
  'country': {
    'id': 1,
    'phone_code': '+62',
    'deleted_at': None,
    'name': 'Indonesia',
    'currency_code': 'IDR',
    'code': 'ID',
    'states': [
      'Jawa Barat',
      'Jawa Tengah',
      'Jawa Timur',
      'Kalimantan Barat',
      'Kalimantan Selatan',
      'Kalimantan Tengah',
      'Kalimantan Timur',
      'Kalimantan Utara',
      'Kepulauan Bangka Belitung',
      'Kepulauan Riau',
      'Maluku Utara',
      'Nusa Tengga     ra Barat',
      'Nusa Tenggara Timur',
      'Papua (Irian Jaya)',
      'Papua Barat',
      'Sulawesi Barat',
      'Sulawesi Selatan',
      'Sulawesi Tengah',
      'Sulawesi Tenggara',
      'Sulawesi Utara',
      'Sumatera Barat',
      'Sumatera Selatan',
      'Sumatera Utara',

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-address-model-1.0.4.tar.gz (919.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page