Metadata-Version: 1.1
Name: multirange
Version: 0.1.0
Summary: Convenience functions for multiple range objects with step == 1
Home-page: https://github.com/iburadempa/multirange
Author: ibu radempa
Author-email: ibu@radempa.de
License: MIT
Description: multirange
        ==========
        
        Introduction
        ------------
        
        This library for Python ≥ 3.3 provides convenience functions for multiple
        range objects with step == 1 (corresponding to finite sets of consecutive
        integers).
        
        It has 3 types of operations::
            
            * operations involving few range objects
            * operations involving an iterable of range objects (*range iterable*)
            * operations involving so-called multiranges; we define a *multirange*
              as an iterable of ranges, which have no mutual overlap, which are not
              adjacent, and which are ordered increasingly;
              a special case of multirange is a *partition* of finite set of
              consecutive integers
        
        It is not yet feature complete; most operations involving multiranges are
        missing.
        
        Examples
        --------
        
        import multirange as mr
        
        mr.intermediate(range(10, 15), range(0, 5))
        range(5, 10)
        
        list(mr.gaps([range(4, 6), range(6, 7), range(8, 10), range(0, 1), range(1, 3)]))
        [range(3, 4), range(7, 8)]
        
        mr.difference(range(1, 9), range(2, 3))
        (range(1, 2), range(3, 9))
        
        mr.normalize_multi([None, range(0, 5), range(5, 7), range(8, 20)])
        [range(0, 7), range(8, 20)]
        
        Consult the unit tests for more examples.
        
        Documentation
        -------------
        
        http://____________________________
        
        Source
        ------
        
        github
        
        See also
        --------
        
        If *multirange* is not what you are searching for, you might
        be interested in one of these python modules::
        
          * https://pypi.python.org/pypi/rangeset
          * https://pypi.python.org/pypi/intspan
          * https://pypi.python.org/pypi/cowboy
        
        
Keywords: set integer integers range ranges multi span interval operations
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
