Metadata-Version: 2.1
Name: pyRFC3339
Version: 2.0.1
Summary: Generate and parse RFC 3339 timestamps
Home-page: https://github.com/kurtraschke/pyRFC3339
Author: Kurt Raschke
Author-email: kurt@kurtraschke.com
License: MIT
Keywords: rfc 3339 timestamp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet
License-File: LICENSE.txt
Description
===========
.. image:: https://github.com/kurtraschke/pyRFC3339/actions/workflows/test-python.yml/badge.svg
:target: https://github.com/kurtraschke/pyRFC3339/actions/workflows/test-python.yml
:alt: Build Status
.. image:: https://readthedocs.org/projects/pyrfc3339/badge/?version=latest
:target: https://pyrfc3339.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
pyRFC3339 parses and generates :RFC:`3339`-compliant timestamps using `Python <https://www.python.org/>`_ `datetime.datetime <https://docs.python.org/3/library/datetime.html#datetime-objects>`_ objects.
>>> from pyrfc3339 import generate, parse
>>> from datetime import datetime, timezone
>>> generate(datetime.now(timezone.utc)) #doctest:+ELLIPSIS
'...T...Z'
>>> parse('2009-01-01T10:01:02Z')
datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=datetime.timezone.utc)
>>> parse('2009-01-01T14:01:02-04:00')
datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=datetime.timezone(datetime.timedelta(days=-1, seconds=72000), '<UTC-04:00>'))
Installation
============
To install the latest version from `PyPI <https://pypi.python.org/pypi>`_:
``$ pip install pyRFC3339``
To install the latest development version:
``$ pip install https://github.com/kurtraschke/pyRFC3339/tarball/master#egg=pyRFC3339-dev``
To build the documentation with Sphinx:
#. ``$ pip install -r docs/requirements.txt``
#. ``$ sphinx-build -M html docs/source/ docs/build``
The documentation is also available online at:
``https://pyrfc3339.readthedocs.io/``
|