aniso8601

Release date: 2021-03-01

Added

• Development requirements handled by extras_require (install with pip install -e .[dev])

• Pre-commit hooks, managed with pre-commit (install with pre-commit install)

• Add readthedocs.yaml to make configuration explicit

Changed

• Code formatted with Black

• Imports sorted with isort

• Following Keep a Changelog for this and future CHANGELOG entries

• Removed python-dateutil from BuildRequires in specfile as they are no longer required since calendar level duration building was split to a separate project (6.0.0)

• Heading level of top of CHANGELOG

Fixed

• Parsing prescribed durations with only hour and second time components (see PR 14)

• Parsing prescribed durations with only year and day components

Release date: 2021-02-18

Changes

• Add support for concise interval format (see 27)

• Add explicit bounds of [000, 366] to day of year component _parse_ordinal_date, this adds the same limits to dates of the format YYYYDDD or YYYY-DDD when using parse_date

• Add range_check_date, range_check_time, range_check_duration, range_check_repeating_interval, and range_check_timezone range checking class methods to BaseTimeBuilder there are no datetime or non-repeating interval check function as they are made of already checked parts

• PythonTimeBuilder now calls the appropriate range check functions using the range_check_date, range_check_time, range_check_duration, range_check_repeating_interval, and range_check_timezone methods defined in aniso8601.builders

• Add range_check_duration to PythonTimeBuilder which calls BaseTimeBuilder.range_check_duration and performs additional checks against maximum timedelta size

• Add range_check_interval to PythonTimeBuilder which handles building concise dates and performs additional checks against maximum timedelta size

• Add get_datetime_resolution which behaves like get_time_resolution but accepts a ISO 8601 date time as an argument, return value is a TimeResolution

• Add exceptions.RangeCheckError as a parent type of all failures in the range check methods, it descends from ValueError

• Add get_duration_resolution which behaves like other resolution helpers, return value is a DurationResolution

• Add get_interval_resolution which behaves like other resolution helpers, return value is a IntervalResolution

• Negative durations now fail at the parse step and simply raise ISOFormatError, calling a PythonTimeBuilder.build_duration directly with a negative duration component will yield an ISOFormatError in the range check

• Raise DayOutOfBoundsError if calendar day exceeds number of days in calendar month

• Raise DayOutOfBoundsError if ordinal day exceeds number of days in calendar year (366 now raises DayOutOfBoundsError in non-leap year)

• Raise ISOFormatError when date or time string contains extra whitespace

• Raise ISOFormatError on multiple fraction separators (comma, full-stop) in a time string

• Raise ISOFormatError when duration contains multiple duration designators ("P"), or time designators ("T")

• PythonTimeBuilder.build_duration raises YearOutOfBoundsError, MonthOutOfBoundsError, WeekOutOfBoundsError, HoursOutOfBoundsError, MinutesOutOfBoundsError, or SecondsOutOfBoundsError when a given duration component would result in a timedelta that would exceed the maximum size

• Raise ISOFormatError if number of delimiters is not exactly 1 in parse_interval

• Raise ISOFormatError when either part of an interval string before of after the delimiter is empty

• Raise YearOutOfBoundsError in PythonTimeBuilder.build_interval if an interval with a duration would exceed the maximum or minimum years for Python date objects

• Simplify parse_date, build_date will now be called with explicit None arguments instead of date components not in the parsed string excluded from the call

• Change get_date_resolution to call parse_date and return the resolution based on the smallest parsed component

• Simplify parse_time, build_time will now be called with explicit None arguments instead of date components not in the parsed string excluded from the call

• Change get_time_resolution to call parse_time and return the resolution based on the smallest parsed component

• TupleBuilder now builds DateTuple, TimeTuple, DatetimeTuple, DurationTuple, IntervalTuple, RepeatingIntervalTuple and TimezoneTuple namedtuples

• Simplify parse_duration, build_duration will now be called with explicit None arguments when components of a prescribed duration are not present in the ISO 8601 duration string instead of being excluded from the call

• Remove unused decimalfraction.find_separator

• Remove unused PythonTimeBuilder._split_to_microseconds

• Removed NegativeDurationError

Deprecation

• Update on Python 2 support: Python 2 support was slated to be removed in 7.0.0 but was not, it will remain until a test fails on Python 2 but not Python 3

• Using Setuptools to run tests (python setup.py tests) will be removed in the next major or minor version (either 9.1.0, 10.0.0)

Release date: 2021-01-29

Changes

• Add version to __init__.py

• Cleaner reading of README.rst into the long_description field of setup.py

• Define long_description_content_type as text/x-rst

• Simplify Sphinx configuration

• Add compat.is_string method, returns True for str, unicode types, False otherwise, used to fix 28

Deprecation

• Deprecate running tests with python setup.py tests as the test suite support in Setuptools is deprecated

Release date: 2020-11-30

Changes

• Empty string arguments to get_date_resolution and parse_date now raise ISOFormatError, fixes 26

• None and non-string arguments to get_date_resolution and parse_date now raise ValueError

• Empty string arguments to parse_duration now raise ISOFormatError

• None and non-string arguments to parse_duration now raise ValueError

• Empty string arguments to parse_interval and parse_repeating_interval now raise ISOFormatError

• None and non-string arguments to parse_interval and parse_repeating_internval now raise ValueError

• Empty string arguments to get_time_resolution and parse_time now raise ISOFormatError

• None and non-string arguments to parse_time now raise ValueError

• None and non-string arguments to parse_timezone now raise ValueError

• Empty string arguments to parse_datetime now raise ISOFormatError

• None and non-string arguments to parse_datetime now raise ValueError

• Missing delimiter in datetime strings when calling parse_datetime now raises ISOFormatError

• Missing delimiter in regular and repeating interval strings when calling parse_interval and parse_repeating_interval now raises ISOFormatError

• get_time_resolution now correctly throws ISOFormatError when a time component has too many characters in a time using ":" as a separator

Release date: 2019-09-11

Changes

• Handle ',' character as a fractional separator, as required by 4.2.2.4, see PR 12

• Fix semver usage for prelease version, as required by clause 9

Release date: 2019-06-11

Changes

• Handle all fractional components as an integer number of microseconds, eliminating rounding issues, fixes #24

Release date: 2019-03-08

Changes

• Remove previously deprecated built in version of relativetimebuilder

Deprecation

• Python 2 support will be removed in 7.0.0

Release date: 2019-03-01

Changes

• Add relativetimebuilder as an explicit requirement

Release date: 2019-03-01

Changes

• Make python-dateutil dependency explicit

Release date: 2019-03-01

Changes

• Previously deprecated relative keyword removed

• Move builders to builders module

  • aniso8601.builder.PythonTimeBuilder -> aniso8601.builders.python.PythonTimeBuilder

  • aniso8601.builder.RelativeTimeBuilder -> aniso8601.builders.relative.RelativeTimeBuilder

  • aniso8601.builder.TupleBuilder -> aniso8601.builders.TupleBuilder

• UTCOffset moved out of builder (aniso8601.builder.UTCOffset -> aniso8601.utcoffset.UTCOffset)

• Fractional arguments are now handled with greater precision (discussion <https://bitbucket.org/nielsenb/aniso8601/issues/21/sub-microsecond-precision-is-lost-when>_)

• When build_time is called with only hh 24<=hh<25, a MidnightBoundsError is raised, this used to be a HoursOutOfBoundsError

• Promote interval components to datetime objects if the given duration has second or microsecond resolution, or if the duration tuple has hour, minute, or second components

  • Before promotion would only happen if the duration tuple had hour, minute, or second components

Deprecation

• The built in RelativeTimeBuilder is deprecated, it will be removed in aniso8601 6.0.0, use RelativeTimeBuilder from relativetimebuilder instead

Release date: 2019-01-08

Changes

• Update copyright date

• Drop support for distutils

• Make tests package importable

• Add support for running tests via setuptools (python setup.py test)

• Explicitly exclude .pyc, __pycache__ from bundles

• Use unittest.mock with Python 3

Release date: 2018-10-25

Changes

• Correct date in CHANGELOG

Release date: 2018-10-25

Changes

• All parse functions now take an optional builder argument allowing for changing output format, PythonTimeBuilder is used by default maintaining compatbility with previous versions (discussion)

• Custom error types, especially ISOFormatError are raised for all known format errors (issue 18)

Deprecation

• relative keyword argument deprecated for all functions where it was available (parse_duration, parse_interval), it will be removed in aniso8601 5.0.0