Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Easily store, retrieve, and convert measurements of weight, volume, distance, area and more.
Branch: master

Merge pull request #8 from codingjoe/master

I decided to merge is as the discussion about saving the selected unit didn't produce any code.
@coddingtonbear would you be so kind to release or add me as a pypi maintainer?
latest commit 6e670a4e90
@codingjoe codingjoe authored
Failed to load latest commit information.
django_measurement Finilizing v2.0
docs Finilizing v2.0
.gitignore add pytest cache to gitignore
LICENSE Adding license file.
pytest.ini Finilizing v2.0
requirements.txt Bumping version number; bumping python-measurement requirement. version 1.6 preview


Easily use, manipulate, and store unit-aware measurement objects using Python and Django.

Note: Version 2.0 has no backward compatibility due to major design changes.

django.contrib.gis.measure has these wonderful 'Distance' objects that can be used not only for storing a unit-aware distance measurement, but also for converting between different units and adding/subtracting these objects from one another.

This module provides for a django model field and admin interface for storing any measurements provided by python-measurement.

Example use with a model:

from django_measurement.models import MeasurementField
from django_measurement.measure import Volume
from django.db import models

class BeerConsumptionLogEntry(models.Model):
    name = models.CharField(max_length=255)
    volume = MeasurementField(Volume)

    def __unicode__(self):
        return u"%s of %s" % (, self.volume)

entry = BeerConsumptionLogEntry() = 'Bear Republic Racer 5'
entry.volume = Volume(us_pint=1)

These stored measurement objects can be used in all of the usual ways supported by python-measurement too:

>>> from django_measurement.measures import Weight
>>> weight_1 = Weight(lb=125)
>>> weight_2 = Weight(kg=40)
>>> added_together = weight_1 + weight_2
>>> added_together
>>>  # Maybe I actually need this value in kg?
  • Documentation for django-measurement is available an ReadTheDocs.
  • Please post issues on Github.
  • Test status available on Travis-CI.
Something went wrong with that request. Please try again.