[Distutils] What's the difference between --index-url and --find-links?

Tarek Ziadé ziade.tarek at gmail.com
Sat Oct 4 02:10:36 CEST 2008

On Sat, Oct 4, 2008 at 1:38 AM, Eric Smith <eric at trueblade.com> wrote:
> I understand that --index-url is single valued, and --find-links is
> multi-valued. But what's the semantic difference between them? From my
> reading, it sounds like they both point to pages that contain links to eggs
> (or other distributions).

The index url contains an index page of packages, like
as defined here

When setuptools or easy_install are used, they load the index and look
for packages
using the INDEX/PACKAGE_NAME/ base for the url.

find-links will let you add extra links for setuptools to look at, so
basically you
can add any place that contains a flat list of distributions.

Notice that there's a patch that has been proposed so setuptools can handle
several indexes.

> What I'm really trying to do is set up my own server, with my own collection
> of eggs. I want to configure easy_install (via a config file or command
> line) to only look at my collection of eggs, and never the Cheeseshop or
> anywhere else. Do I do this with just --index-url? Or with --find-links, and
> if so, how do I disable the index?

You could build your own index, using static html files, or use one
of the pypi compatible server applications out there, like EggBasket
or PloneSoftwareCenter.

to make sure you don't use anything else than your server (even if some packages
are trying to access other places with dependency links) you can use
the --allow-hosts
option to give a white list of urls patterns.

> Thanks. I searched the archives, but I couldn't find anything (these are
> very common search terms!).
> Eric.
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> http://mail.python.org/mailman/listinfo/distutils-sig

Tarek Ziadé | Association AfPy | www.afpy.org
Blog FR | http://programmation-python.org
Blog EN | http://tarekziade.wordpress.com/

More information about the Distutils-SIG mailing list