Sets of integers like 1,3-7,33
Project description
| |travisci| |version| |downloads| |versions| |impls| |wheel| |coverage| |br-coverage|
.. |travisci| image:: https://api.travis-ci.org/jonathaneunice/intspan.svg
:target: http://travis-ci.org/jonathaneunice/intspan
.. |version| image:: http://img.shields.io/pypi/v/intspan.svg?style=flat
:alt: PyPI Package latest release
:target: https://pypi.python.org/pypi/intspan
.. |versions| image:: https://img.shields.io/pypi/pyversions/intspan.svg
:alt: Supported versions
:target: https://pypi.python.org/pypi/intspan
.. |impls| image:: https://img.shields.io/pypi/implementation/intspan.svg
:alt: Supported implementations
:target: https://pypi.python.org/pypi/intspan
.. |wheel| image:: https://img.shields.io/pypi/wheel/intspan.svg
:alt: Wheel packaging support
:target: https://pypi.python.org/pypi/intspan
.. |coverage| image:: https://img.shields.io/badge/test_coverage-100%25-6600CC.svg
:alt: Test line coverage
:target: https://pypi.python.org/pypi/intspan
.. |br-coverage| image:: https://img.shields.io/badge/branch_coverage-100%25-6600CC.svg
:alt: Test branch coverage
:target: https://pypi.python.org/pypi/intspan
``intspan`` is a ``set`` subclass that conveniently stores sets of integers.
Sets can be created from and displayed as integer spans such as
``1-3,14,29,92-97`` rather than exhaustive member listings. Compare::
intspan('1-3,14,29,92-97')
[1, 2, 3, 14, 29, 92, 93, 94, 95, 96, 97]
Or worse, the unsorted, non-intuitive listings that crop up with Python's
native unordered sets, such as::
set([96, 1, 2, 3, 97, 14, 93, 92, 29, 94, 95])
While they all indicate the same values, ``intspan`` is more compact. And it
better divulges the contiguous nature of segments of the collection, making it
easier for humans to quickly determine the "shape" of the data and ascertain
"what's missing?"
When iterating, ``pop()``-ing an item, or converting to a list, ``intspan``
behaves as if it were an ordered--in fact, sorted--collection. A key
implication is that, regardless of the order in which items are added,
an ``intspan`` will always be rendered in the most compact, organized
form possible.
The main draw is having a convenient way to specify (possibly discontinuous)
ranges--for example, rows to process in a spreadsheet. It can also help you
quickly identify or report which items were *not* successfully processed in
a large dataset.
There is also an ordered ``intspanlist`` type that helps specify the
ordering of a set of elements.
For this and more, see the full details on `Read the Docs
<http://intspan.readthedocs.org/en/latest/>`_.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
intspan-1.5.6.zip
(15.3 kB
view hashes)
Built Distribution
Close
Hashes for intspan-1.5.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0a68530c923b970747095eca3fb5ac8c8eb94830ca85ae6f7a9014803fed3ea |
|
MD5 | ba23639e9909ef79898aa451dc888be5 |
|
BLAKE2b-256 | 6158739e63b8cf663c24da0eafb67874d77bf6fef979b09cdec6cb649b624f91 |