Skip to main content

JSON with tz-aware datetime support

Project description

Sick of rewriting the same JSON datetime handling code for each project? jsondate3-aware is a drop-in replacement for Python’s standard json library that adds sensible handling of datetime and date objects.

jsondate3-aware uses ISO8601 for encoding datetime objects and the date-specific part of ISO6801 for encoding date objects.

It:

  • supports Python 2 and 3

  • creates timezone-aware datetime objects when able

  • supports JavaScript-style dates (datetime.datetime(%Y, %m, %d, %H, %M, %S))

Example:

import datetime
import jsondate3 as json

>>> data = json.dumps(dict(created_at=datetime.datetime(2012, 10, 31)))
'{"created_at": "2012-10-31T00:00:00Z"}'

>>> json.loads(data)
{u'created_at': datetime.datetime(2012, 10, 31, 0, 0, tzinfo=datetime.timezone.utc)}

>>> date = json.dumps(dict(date=datetime.date(2012, 10, 31)))
'{"date": "2012-10-31"}'

>>> json.loads(data)
{u'created_at': datetime.date(2012, 10, 31)}

Testing

Run them with:

python -m unittest tests.test_jsondate

Deployment

If you wish to create a new version manually, the process is:

  1. Update version info in setup.py

  2. Install the requirements in requirements_dev.txt

  3. Set up a config file at ~/.pypirc

  4. Generate a universal distribution that worksin py2 and py3 (see setup.cfg)

    rm -r dist &&  python setup.py sdist bdist_wheel
  5. Upload the distributions

    twine upload dist/* -r pypi (or pypitest)

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

jsondate3-aware-0.2.1.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

jsondate3_aware-0.2.1-py2.py3-none-any.whl (5.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page