Metadata-Version: 2.1
Name: pip-shims
Version: 0.1.0
Summary: Compatibility shims for pip versions 8 thru current.
Home-page: https://github.com/sarugaku/pip-shims
Author: Dan Ryan
Author-email: dan@danryan.co
License: ISC License
Description: ===============================================================================
        pip-shims: Shims for importing packages from pip's internals.
        ===============================================================================
        
        .. image:: https://img.shields.io/pypi/v/pip-shims.svg
            :target: https://pypi.python.org/pypi/pip-shims
        
        .. image:: https://img.shields.io/pypi/l/pip-shims.svg
            :target: https://pypi.python.org/pypi/pip-shims
        
        .. image:: https://travis-ci.org/sarugaku/pip-shims.svg?branch=master
            :target: https://travis-ci.org/sarugaku/pip-shims
        
        .. image:: https://img.shields.io/pypi/pyversions/pip-shims.svg
            :target: https://pypi.python.org/pypi/pip-shims
        
        .. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
            :target: https://saythanks.io/to/techalchemy
        
        .. image:: https://readthedocs.org/projects/pip-shims/badge/?version=master
            :target: http://pip-shims.readthedocs.io/en/master/?badge=master
            :alt: Documentation Status
        
        
        Installation
        *************
        
        Install from `PyPI`_:
        
          ::
        
            $ pipenv install --pre pip-shims
        
        Install from `Github`_:
        
          ::
        
            $ pipenv install -e git+https://github.com/sarugaku/pip-shims.git#egg=pip-shims
        
        
        .. _PyPI: https://www.pypi.org/project/pip-shims
        .. _Github: https://github.com/sarugaku/pip-shims
        
        
        .. _`Summary`:
        
        Summary
        ********
        
        **pip-shims** is a set of compatibilty access shims to the `pip`_ internal API. **pip-shims**
        provides compatibility with pip versions 8.0 through the current release (18.x).  The shims
        are provided using a lazy import strategy (powered by `modutil`_ where possible, falling
        back to *importlib* from the standard library with a lazy import strategy otherwise).
        This library exists due to my constant writing of the same set of import shims across
        many different libraries, including `pipenv`_, `pip-tools`_, `requirementslib`_, and
        `passa`_.
        
        .. _modutil: https://github.com/sarugaku/pipfile
        .. _passa: https://github.com/sarugaku/passa
        .. _pip: https://github.com/pypa/pip
        .. _pipenv: https://github.com/pypa/pipenv
        .. _pip-tools: https://github.com/jazzband/pip-tools
        .. _requirementslib: https://github.com/sarugaku/requirementslib
        
        
        .. _`Usage`:
        
        Usage
        ******
        
        Importing a shim
        /////////////////
        
        You can use **pip-shims** to expose elements of **pip**'s internal API by importing them:
        
          ::
        
            from pip_shims import Wheel
            mywheel = Wheel('/path/to/my/wheel.whl')
        
        
        Available Shims
        ****************
        
        **pip-shims** provides the following compatibility shims:
        
        ================== =========================== ================
        Import Path        Import Name                 Former Path
        ================== =========================== ================
        req.req_install    _strip_extras
        cli                cmdoptions                  cmdoptions
        cli.base_command   Command                     basecommand
        cli.parser         ConfigOptionParser          baseparser
        exceptions         DistributionNotFound
        utils.hashes       FAVORITE_HASH
        index              FormatControl
        utils.misc         get_installed_distributions utils
        cli.cmdoptions     index_group                 cmdoptions
        req.req_install    InstallRequirement
        download           is_archive_file
        download           is_file_url
        utils.misc         is_installable_dir          utils
        index              Link
        operations.prepare make_abstract_dist          req.req_set
        cli.cmdoptions     make_option_group           cmdoptions
        index              PackageFinder
        req.req_file       parse_requirements
        index              parse_version
        download           path_to_url
        __version__        pip_version
        exceptions         PipError
        operations.prepare RequirementPreparer
        req.req_set        RequirementSet
        req.req_tracker    RequirementTracker
        resolve            Resolver
        download           SafeFileCache
        download           url_to_path
        locations          USER_CACHE_DIR
        vcs                VcsSupport
        wheel              Wheel
        cache              WheelCache
        ================== =========================== ================
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=2.6,!=3.0,!=3.1,!=3.2,!=3.3
Provides-Extra: test
