https://github.com/montag451/pypi-mirror
A script to create a partial PyPI mirror
https://github.com/montag451/pypi-mirror
mirror pypi pypi-mirror python python3
Last synced: 3 days ago
JSON representation
A script to create a partial PyPI mirror
- Host: GitHub
- URL: https://github.com/montag451/pypi-mirror
- Owner: montag451
- License: mit
- Created: 2018-12-20T22:26:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-31T21:49:07.000Z (over 1 year ago)
- Last Synced: 2025-05-10T21:02:54.581Z (about 2 months ago)
- Topics: mirror, pypi, pypi-mirror, python, python3
- Language: Python
- Size: 69.3 KB
- Stars: 75
- Watchers: 2
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
``pypi-mirror`` is a small script to generate a partial PyPI mirror. It
relies on ``pip`` to do the most difficult part of the job (downloading
a package and its dependencies).
Why?
====
Because most of the time you don't need a full PyPI mirror but only a
mirror that contains the packages you use. If you want a full PyPI
mirror you should look at `bandersnatch`_.
Installation
============
You can install ``pypi-mirror`` using ``pip``:
.. code:: sh
pip install python-pypi-mirror
Or using ``conda``:
.. code:: sh
conda install -c conda-forge python-pypi-mirror
How to use it?
==============
The script provides several commands to manage your mirror. To find out
which commands are available, type:
.. code:: sh
pypi-mirror --help
Every command provides its own help message. So for example to get the
help message of the ``download`` command, type:
.. code:: sh
pypi-mirror download --help
The commands that you will probably use the most are the ``download``
command and the ``create`` command. For example to create a mirror which
contains the ``requests`` package and its dependencies, you can type the
following:
.. code:: sh
pypi-mirror download -d downloads requests
pypi-mirror create -d downloads -m simple
The first command will create a ``downloads`` directory into the current
directory and use ``pip`` to download the ``requests`` package and its
dependencies into the newly created directory. Then the ``create``
command will create a ``simple`` directory into the current directory
and will build the mirror inside this newly created directory. You can
add new packages by repeating this sequence of commands.
To make your mirror available through HTTP, you can point your HTTP
server of choice to the ``simple`` directory. For exemple, type the
following command into the current directory:
.. code:: sh
python3 -m http.server
It will start a HTTP server that will serve files from the current
directory (which should contain the ``downloads`` directory and the
``simple`` directory). You can then install packages using your brand
new mirror using the following command:
.. code:: sh
pip install -i http://127.0.0.1:8000/simple requests
About versioning
================
This package use `semver`_ to manage version numbering. It means that
every times the major number is increased a backward incompatible
change has been introduced in the API (the command line is an API). So
be careful when upgrading to a new major release as it will surely
break your scripts.
.. _bandersnatch: https://github.com/pypa/bandersnatch.git
.. _semver: https://semver.org/