Skip to content

Latest commit

 

History

History
513 lines (354 loc) · 15.1 KB

HISTORY.rst

File metadata and controls

513 lines (354 loc) · 15.1 KB
Raw

Sorted Containers Release History

sortedcontainers

2.4.0 (2021-05-16)

API Changes

  • Implement SortedDict methods: __or__, __ror__, and __ior__ per PEP 584.

2.3.0 (2020-11-08)

Bugfixes

  • Make sort order stable when updating with large iterables.

2.2.2 (2020-06-07)

Miscellaneous

  • Add "small slice" optimization to SortedList.__getitem__.
  • Silence warning when testing SortedList.iloc.

2.2.1 (2020-06-06)

Miscellaneous

  • Fix a warning regarding classifiers in setup.py.

2.2.0 (2020-06-06)

Miscellaneous

  • Change SortedDict to avoid cycles for CPython reference counting.

2.1.0 (2018-11-21)

Miscellaneous

  • Small updates to docs and tests for Python 3.7.

2.0.5 (2018-09-03)

Bugfixes

  • Change imports for Abstract Base Classes to collections.abc to avoid warnings in Python 3.7.

2.0.4 (2018-06-06)

Bugfixes

  • SortedDict methods iterkeys, iteritems, itervalues, viewkeys, viewitems, and viewvalues are not implemented for Python 2. Attribute lookup now raises AttributeError.

2.0.3 (2018-05-31)

API Changes

  • Accessing SortedDict.iloc will emit DeprecationWarning.

Bugfixes

  • SortedSet.__rsub__ erroneously reversed its arguments. The method has been removed in favor of the inherited Set.__rsub__ which has a correct implementation.
  • SortedKeysView and SortedValuesView set-operations now return SortedSet objects to better match the semantics of version 1.

Miscellaneous

  • The source distribution no longer contains the docs and tests directories. If you need these, then please download an archive from Github. Version control is tagged with the version released to PyPI.

2.0.2 (2018-05-21)

API Changes

  • Add SortedDict.iloc for improved backwards compatibility with version 1.

2.0.1 (2018-05-18)

Miscellaneous

  • Rename Github repo from grantjenks/sorted_containers to grantjenks/python-sortedcontainers.
  • Fix broken links in documentation.

2.0.0 (2018-05-18)

Version 2 represents a significant update to the source base. The code has been refactored and modernized to embrace Python 3 semantics while also using autodoc in Sphinx for more maintainable documentation. The core design and algorithms are all the same. Sorted Containers still supports and is tested on Python 2 but primary development is now on Python 3.6.

Version 2 is developed on the master branch in the source repository and Version 1 of Sorted Containers will be maintained on branch v1.

Version 3 of Sorted Containers will be released sometime after January 1, 2020 and will drop support for Python 2.

At a high-level, changes can be categorized in three ways:

  1. SortedList methods __setitem__, append, extend, and insert all now raise NotImplementedError. Use add or update instead. Though it's possible to implement these methods, they were confusing, inefficient and wrongly used by some users. Sorted list implementations that need the functionality are encouraged to do so through subclassing. Branch v1 contains a reference implementation.
  2. SortedDict now uses Python 3 semantics for dict views. The iterkeys, iteritems, itervalues, viewkeys, viewitems, and viewvalues methods have all been removed. Use the keys, items, or values methods which now return sorted dict views. SortedKeysView has also replaced SortedDict.iloc as a better interface for indexing.
  3. Method parameter names have changed to be more consistent with Python's built-in data types: val has changed to value, idx has changed to index, and that has changed to other.

API Changes

  • SortedListWithKey is deprecated. Use SortedKeyList instead. The name SortedListWithKey remains as an alias for SortedKeyList. The alias will be removed in Version 3.
  • sortedcontainers.sortedlist.LOAD has moved to SortedList.DEFAULT_LOAD_FACTOR so that derived classes can customize the value.
  • SortedList._half and SortedList._dual have been removed. Use SortedList._load instead.
  • SortedList.add parameter val renamed to value.
  • SortedList.__contains__ parameter val renamed to value.
  • SortedList.discard parameter val renamed to value.
  • SortedList.remove parameter val renamed to value.
  • SortedList.__delitem__ parameter idx renamed to index.
  • SortedList.__getitem__ parameter idx renamed to index.
  • SortedList.__setitem__ now raises NotImplementedError. Use SortedList.__delitem__ and SortedList.add instead.
  • SortedList.bisect_left parameter val renamed to value.
  • SortedList.bisect_right parameter val renamed to value.
  • SortedList.bisect parameter val renamed to value.
  • SortedList.count parameter val renamed to value.
  • SortedList.append now raises NotImplementedError. Use SortedList.add instead.
  • SortedList.extend now raises NotImplementedError. Use SortedList.update instead.
  • SortedList.insert now raises NotImplementedError. Use SortedList.add instead.
  • SortedList.pop parameter idx renamed to index.
  • SortedList.index parameter val renamed to value.
  • SortedList.__add__ parameter that renamed to other.
  • SortedList.__iadd__ parameter that renamed to other.
  • SortedList.__mul__ parameter that renamed to num.
  • SortedList.__imul__ parameter that renamed to num.
  • SortedList._make_cmp renamed to SortedList.__make_cmp.
  • SortedKeyList.add parameter val renamed to value.
  • SortedKeyList.__contains__ parameter val renamed to value.
  • SortedKeyList.discard parameter val renamed to value.
  • SortedKeyList.remove parameter val renamed to value.
  • SortedKeyList.bisect_left parameter val renamed to value.
  • SortedKeyList.bisect_right parameter val renamed to value.
  • SortedKeyList.bisect parameter val renamed to value.
  • SortedKeyList.count parameter val renamed to value.
  • SortedKeyList.append now raises NotImplementedError. Use SortedKeyList.add instead.
  • SortedKeyList.extend now raises NotImplementedError. Use SortedKeyList.update instead.
  • SortedKeyList.insert now raises NotImplementedError. Use SortedKeyList.add instead.
  • SortedKeyList.index parameter val renamed to value.
  • SortedKeyList.__add__ parameter that renamed to other.
  • SortedKeyList.__radd__ added.
  • SortedKeyList.__iadd__ parameter that renamed to other.
  • SortedKeyList.__mul__ parameter that renamed to num.
  • SortedKeyList.__rmul__ added.
  • SortedKeyList.__imul__ parameter that renamed to num.
  • Removed SortedDict.iloc. Use SortedDict.keys and SortedKeysView instead.
  • SortedDict.fromkeys parameter seq renamed to iterable.
  • SortedDict.keys now returns SortedKeysView.
  • SortedDict.items now returns SortedItemsView.
  • SortedDict.values now returns SortedValuesView.
  • Removed SortedDict.viewkeys. Use SortedDict.keys instead.
  • Removed SortedDict.viewitems. Use SortedDict.items instead.
  • Removed SortedDict.viewvalues. Use SortedDict.values instead.
  • SortedDict.iterkeys removed. Use SortedDict.keys instead.
  • SortedDict.iteritems removed. Use SortedDict.items instead.
  • SortedDict.itervalues removed. Use SortedDict.values instead.
  • SortedDict.popitem now accepts an optional index argument. Default -1.
  • sorteddict.KeysView renamed to SortedKeysView.
  • sorteddict.ItemsView renamed to SortedItemsView.
  • sorteddict.ValuesView renamed to SortedValuesView.
  • Sorted dict views rely on collections abstract base classes: dict views and sequence. The SortedKeysView.__getitem__, SortedItemsView.__getitem__, and SortedValuesView.__getitem__ methods are implemented and optimized. All other mixin methods use the default implementation provided by the base class. Prefer SortedDict methods to view methods when possible.
  • SortedSet._make_cmp renamed to SortedSet.__make_cmp.
  • SortedSet.symmetric_difference parameter that renamed to other.
  • SortedSet.symmetric_difference_update parameter that renamed to other.

Miscellaneous

  • Sphinx autodoc now used for API documentation.
  • All benchmarks now run on CPython 3.6 unless otherwise noted.
  • Testing now uses pytest rather than nose.
  • AppVeyor CI testing added.
  • Updated versions of alternative implementations.

1.5.10 (2018-04-21)

Miscellaneous

  • Improved performance of irange(...) and islice(...) methods.

1.5.9 (2017-12-08)

Miscellaneous

  • Dropped CPython 2.6 testing.

1.5.8 (2017-12-08)

Bugfixes

  • Added SortedList.reverse to override MutableSequence.reverse and raise NotImplementedError.

1.5.7 (2016-12-22)

Bugfixes

  • Changed SortedList.__setitem__ to support slices with stop less than start and step equal one.

1.5.6 (2016-12-09)

Bugfixes

  • Changed SortedList.__setitem__ to support slices that alias itself.

1.5.5 (2016-12-05)

Bugfixes

  • Changed SortedList.extend to support empty iterables.

1.5.4 (2016-10-16)

Bugfixes

  • Changed SortedList.__new__ to call SortedListWithKey.__init__ once instead of twice.

1.5.3 (2016-06-01)

Miscellaneous

  • Updated documentation with PyCon 2016 Talk.

1.5.2 (2016-05-28)

API Changes

  • Added SortedDict.peekitem method.

1.5.1 (2016-05-26)

Miscellaneous

  • Added support for PyLint and minor source changes.
  • Dropped Python 3.2 support from tox testing due to virtualenv limitations.

1.5.0 (2016-05-26)

Miscellaneous

  • Added Performance at Scale documentation.

1.4.3 (2015-12-03)

Miscellaneous

  • Updated documentation with SF Python 2015 Holiday Meetup Talk.

1.4.2 (2015-10-20)

API Changes

  • Changed SortedList initializer to support key-argument callable and automatically return SortedListWithKey when present.
  • Changed SortedListWithKey to inherit from SortedList.
  • Changed SortedSet.__ior__ to call update rather than union.
  • Changed SortedList comparison to match Sequence semantics as described in CPython Language Reference Section 5.9.
  • Changed SortedSet comparison to raise NotImplemented on type mismatch.
  • Removed SortedList.as_list method. Use list(sorted_list) instead.
  • Removed SortedList._slice method. Use slice.indices instead.
  • Added private references to public methods for internal use to ease method over-loading.

Bugfixes

  • Changed sorteddict.ValuesView.count to correctly reference sorted dictionary.

Improvements

  • SortedList.__getitem__ now 35% faster for indexing at beginning and end.
  • SortedList.pop now 35% faster by inlining fast-paths.
  • del sorted_list[:] now calls clear and is much faster.
  • sorted_list[:] = values now calls clear and update and is much faster.

Miscellaneous

  • Added Python 3.5 support in tox testing.
  • Added discussion of ruamel.ordereddict.sorteddict to performance documentation.
  • Merged file sortedlistwithkey.py into sortedlist.py.

0.9.6 (2015-06-22)

API Changes

  • Added islice method to sorted list, dict, and set types.
  • Added irange and irange_key method to sorted list, dict, and set types.

0.9.5 (2015-03-16)

API Changes

  • Added bisect_key methods to sorted list, dict, and set types.
  • Added last=True argument to SortedDict.popitem.

0.9.4 (2014-12-04)

Bugfixes

  • Added implementation and testing for Python pickle module.

0.9.3 (2014-11-30)

API Changes

  • Removed SortedListWithKeyPair type.

Improvements

  • Changed type references to self.__class__ as able.

0.9.2 (2014-10-20)

API Changes

  • Removed value_orderable argument from SortedListWithKey initializer.
  • Added key-callable argument to SortedDict initializer.
  • Added key-callable argument to SortedSet initializer.

Improvements

  • Changed SortedDict to inherit directly from dict.

Miscellaneous

  • Added PyPy3 support to tox testing.
  • Added SortedListWithKey to sorted list performance comparison documentation.

0.9.1 (2014-09-20)

Bugfixes

  • Changed SortedList.__setitem__ with slices to correctly update internal "maxes" index.

0.9.0 (2014-09-17)

API Changes

  • Added __ior__, __iand__, __isub__, and __ixor__ methods to SortedSet interface.

Improvements

  • Changed position-based indexing to use dense tree-based index.

Miscellaneous

  • Added workload-based performance comparison for sorted list: Priority Queue, Multiset, etc.

0.8.5 (2014-08-11)

Bugfixes

  • Changed copy methods to make shallow copies: values are not copied, only references to values are copied.

Miscellaneous

  • Added load-factor performance comparison documentation.

0.8.4 (2014-07-29)

API Changes

  • Added value_orderable parameter to SortedListWithKey to support incomparable value types.

Bugfixes

  • Changed repr methods to prevent infinite recursion and allow easier subclassing.

0.8.3 (2014-07-07)

Miscellaneous

  • Added more testing for sorted lists with key-callable argument.

0.8.2 (2014-06-13)

API Changes

  • Added SortedListWithKey type with implementation based on (key, value) tuples.

0.8.1 (2014-05-08)

Bugfixes

  • Added contains-key check in sorted dict equality comparisons.

Miscellaneous

  • Added Python runtime comparison to documentation.
  • Added sorted dict and set comparison to benchmark documentation.
  • Added Travis-CI testing.

0.8.0 (2014-04-08)

API Changes

  • Added bisect methods from SortedList to SortedDict interface.

0.7.0 (2014-04-02)

Miscellaneous

  • Added Banyan module to benchmark documentation.

0.6.0 (2014-03-18)

Miscellaneous

  • Added testing support for CPython 2.6, 2.7, 3.2, and 3.3 with full coverage.

0.5.0 (2014-03-14)

  • Initial release of sorted list, dict, and set types.