Metadata-Version: 1.2
Name: iterpop
Version: 0.2.2
Summary: iterpop makes popping the value out of a singleton container safe and fun
Home-page: https://github.com/mmore500/iterpop
Author: Matthew Andres Moreno
Author-email: m.more500@gmail.com
License: MIT license
Description: ============
        iterpop
        ============
        
        
        .. image:: https://img.shields.io/pypi/v/iterpop.svg
                :target: https://pypi.python.org/pypi/iterpop
        
        .. image:: https://img.shields.io/travis/mmore500/iterpop.svg
                :target: https://travis-ci.com/mmore500/iterpop
        
        .. image:: https://readthedocs.org/projects/iterpop/badge/?version=latest
                :target: https://iterpop.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        
        
        
        iterpop makes popping the value out of a singleton container safe and fun
        
        
        * Free software: MIT license
        * Documentation: https://iterpop.readthedocs.io.
        
        
        .. code-block:: python3
        
          from iterpop import iterpop as ip
        
          # returns 'a'
          ip.popsingleton(['a'])
          ip.popsingleton({'a'})
          ip.popsingleton('a')
        
          # throws
          ip.popsingleton([])
          ip.popsingleton(set())
          ip.popsingleton('')
        
          # throws
          ip.popsingleton(['a', 'b'])
          ip.popsingleton({'a', 'b'})
          ip.popsingleton('ab'})
        
          # returns 'a'
          ip.pophomogeneous(['a'])
          ip.pophomogeneous({'a'})
          ip.pophomogeneous('a')
        
          # also returns 'a'
          ip.pophomogeneous(['a', 'a'])
          ip.pophomogeneous('aaa')
          ip.pophomogeneous('a' for __ in range(100))
        
          # throws
          ip.pophomogeneous([])
          ip.pophomogeneous(set())
          ip.pophomogeneous('')
        
          # throws
          ip.pophomogeneous(['a', 'b'])
          ip.pophomogeneous({'a', 'b'})
          ip.pophomogeneous('ab'})
        
        
        Credits
        -------
        
        This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        .. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
        
        
        =======
        History
        =======
        
        0.1.0 (2020-07-06)
        ------------------
        
        * First release on PyPI.
        
Keywords: iterpop
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
