Metadata-Version: 2.1
Name: lektor-datetime-helpers
Version: 0.3.3.post1
Summary: Lektor plugin to help with dates and times
Home-page: https://github.com/dairiki/lektor-datetime-helpers
Author: Jeff Dairiki
Author-email: dairiki@dairiki.org
License: BSD
Keywords: lektor,date,datetime
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Environment :: Web Environment
Classifier: Framework :: Lektor
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
License-File: LICENSE

#################################################
Helpers for Dealing with ``datetime``\s in Lektor
#################################################

.. image:: https://img.shields.io/pypi/v/lektor-datetime-helpers.svg
   :target: https://pypi.org/project/lektor-datetime-helpers/
   :alt: PyPI version

.. image:: https://img.shields.io/pypi/pyversions/lektor-datetime-helpers.svg
   :target: https://pypi.python.org/pypi/lektor-datetime-helpers/
   :alt: PyPI Supported Python Versions

.. image:: https://img.shields.io/github/license/dairiki/lektor-datetime-helpers
   :target: https://github.com/dairiki/lektor-datetime-helpers/blob/master/LICENSE
   :alt: GitHub license

.. image:: https://github.com/dairiki/lektor-datetime-helpers/workflows/Tests/badge.svg
   :target: https://github.com/dairiki/lektor-datetime-helpers
   :alt: GitHub Actions (Tests)

************
Introduction
************

This is a plugin for Lektor which provides some helpers for dealing with
dates and times.

Currently this provides a ``dateordatetime`` model field type which
can contain either a ``date`` or a ``datetime``.

Also the following jinja filters are provided:

isoformat(dt)
   Returns an iso formatted version the datetime, with timezone information.
   If ``dt`` is naive, it is localized to the site's default timezone.

localize_datetime(dt)
   If ``dt`` is naive, it is localized to the site's default timezone.

*********
Changelog
*********

Release 0.3.3.post1 (2021-08-16)
================================

- Fix useless comparison in test.
- Fix formatting in ``CHANGES.rst``.

Release 0.3.3 (2021-08-15)
==========================

Bugs
----

- Pin ``tzlocal<3``.  (``Tzlocal >= 3`` drops support for python 2.)

Release 0.3.2 (2020-11-19)
==========================

Bugs
----

- Ensure that ``comparable_date`` and ``comparable_datetime`` objects
  are hashable.  This fixes issues using these classes with ``pytz``
  under py3k.
  
Testing
-------

- Test under py3.9

Release 0.3.1 (2020-05-21)
==========================

This release freshens the packaging.
There are no substantive changes to the code in this release.

Packaging
---------

- Update packaging to :PEP:`517`.

- Update LICENSE to latest 3-clause BSD text.

Docstrings
----------

- Fix docstring syntax.  No substantive changes.

Tests
-----

- Test under python 3.7 and 3.8.

- Use ``twine check`` rather than ``setup.py check`` to test
  description syntax.

Release 0.3 (2018-01-18)
========================

Fix things so that date and datetime types returned by the ``dateordatetime`` Lektor type are comparable against ``None``.  (``None`` compares less than all other dates and datetimes.)


Release 0.2 (2017-08-04)
========================

New features
------------

Make lists of ``dateordatetime`` types sortable
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The ``dateordatetime`` custom Lektor type now returns subclasses of ``datetime.date`` or ``datetime.datetime`` which can be compared against one another.  Normally, attempts to compare a ``date`` against a ``datetime`` results in a ``TypeError`` being raised.  This made it difficult to sort on ``dateordatetime`` values.

Now ``date``\s sort before any ``datetime``\s with the same date.  Naïve ``datetime``\s sort before timezone-aware ``datetime``\s with the same date.

Release 0.1 (2017-04-19)
========================

Initial release.


