Priority Queue Dictionary (pqdict)

A priority queue dictionary maps hashable objects (keys) to priority-determining values. It provides a hybrid dictionary/priority queue API.

.. image:: https://github.com/nvictus/priority-queue-dictionary/actions/workflows/ci.yml/badge.svg :target: https://github.com/nvictus/priority-queue-dictionary/actions/workflows/ci.yml :alt: CI

.. image:: https://readthedocs.org/projects/pqdict/badge/?version=latest :target: https://readthedocs.org/projects/pqdict/ :alt: Documentation Status

.. image:: https://img.shields.io/pypi/v/pqdict.svg :target: https://pypi.python.org/pypi/pqdict

The priority queue itself is implemented as a binary heap of (key, priority value) elements, which supports:

• O(1) search for the item with highest priority

• O(log n) removal of the item with highest priority

• O(log n) insertion of a new item

Additionally, an index maps each key to its element's location in the heap and is kept up to date as the heap is manipulated. As a result, pqdict also supports:

• O(1) lookup of any item by key

• O(log n) removal of any item

• O(log n) updating of any item's priority level

Documentation

Documentation is available at http://pqdict.readthedocs.org/.

License

This module is released under the MIT license. The augmented heap implementation was adapted from the heapq module in the Python standard library, which was written by Kevin O'Connor and augmented by Tim Peters and Raymond Hettinger.