# Python Sorted Collections

Sorted Collections is an Apache2 licensed Python sorted collections library.

## Features

- Pure-Python

- Depends on the Sorted Containers module.

- ValueSortedDict - Dictionary with (key, value) item pairs sorted by value.

- ItemSortedDict - Dictionary with key-function support for item pairs.

- NearestDict - Dictionary with nearest-key lookup.

- OrderedDict - Ordered dictionary with numeric indexing support.

- OrderedSet - Ordered set with numeric indexing support.

- IndexableDict - Dictionary with numeric indexing support.

- IndexableSet - Set with numeric indexing support.

- SegmentList - List with fast random access insertion and deletion.

- 100% code coverage testing.

- Developed on Python 3.9

- Tested on CPython 3.6, 3.7, 3.8, and 3.9

## Quickstart

Installing Sorted Collections is simple with pip:

    $ pip install sortedcollections

You can access documentation in the interpreter with Python’s built-in help function:

    >>> from sortedcollections import ValueSortedDict
    >>> help(ValueSortedDict)

## Recipes

- Value Sorted Dictionary Recipe

- Item Sorted Dictionary Recipe

- Nearest Dictionary Recipe

- Ordered Dictionary Recipe

- Ordered Set Recipe

- Indexable Dictionary Recipe

- Indexable Set Recipe

- Segment List Recipe

## Reference and Indices

- Sorted Collections Documentation

- Sorted Collections at PyPI

- Sorted Collections at Github

- Sorted Collections Issue Tracker

## Sorted Collections License

Copyright 2015-2021 Grant Jenks

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

> http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.