Metadata-Version: 2.4
Name: pip-downloader
Version: 0.2.dev1
Summary: Download packages from pip for offline usage.
Home-page: https://github.com/AbdealiJK/pip-downloader
Author: AbdealiJK
Author-email: abdealikothari@gmail.com
License: MIT
License-File: LICENSE
Requires-Dist: click
Requires-Dist: requests
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

pip-downloader
==============
``pip-downloader`` helps in allowing offline installations of python packages.

``pip download`` already exists, which does something similar:
 - Pro: Handles dependency resolution in the same way ``pip install`` does - so no confusion
 - Pro: It is useful to download all the source packages with the ``--no-binary :all:`` argument.
 - Con: It downloads only 1 file per package (i.e. only source or only one of the wheel files)
 - Con: For downloads of a different system (not the system you're running it from) it expects
        the package and all it's dependencies to have similar wheels (eg: If ``cp36m-manylinux``
        is the wheel for one library, all it's dependencies should also have that wheel)

``pip-downloader`` aims to solve the same issue but in a slightly different way:
 - It uses the same dependency resolution ``pip download`` uses but after resolving the dependencies
 - It downloads all the files (source and all wheels) available for that version of the package

This gives an experience that is more consistent with the online installation with pip as it has
all the files (all wheels and sources) for installation.

Installation
============
It is recommended to use the latest version of pip (currently - 19.1) when using pip-downloader.

.. code:: bash

    pip install pip-downloader

Usage
=====
The command line utility `pip-downloader` should be available.

.. code:: bash

    # To get help about pip-downloader
    pip-downloader --help

    # To fetch the list of packages and their versions that downloader will download (dry-run)
    pip-downloader list flask 

    # To download the list of packages and their versions to the provided destination
    pip-downloader download flask --dest /tmp/pypi

Known Limitations
=================
 - Dependencies mentioned in `setup_requires` are not downloaded as pip's dependency resolution
   mechanism does not consider them at the moment. Common setup-time requirements are:
   setuptools_scm, vcversioner, numpy, etc.
 - Build dependencies mentioned in `pyproject.toml` are not downlaoded as pip's dependency manages
   install/run-time dependencies at the moment. (These are needed only if source installation is
   chosen when installing a package.)
 - When solving for packages with `sys_platform` environment markers, the package resolution will
   happen based on the machine you're running `pip-downloader` from. Need to investigate on how to
   resolve this issue.
