License: | MIT |
---|---|
Name: | pypicache |
Project-Label: | pypicache |
Version: | 0.1 |
Author: | Robin Bryce |
Author-email: | robinbryce@gmail.com |
Description: | Generate and maintain an easy_install compatible package index. |
Copyright: | Copyright (c) 2007 Robin Bryce |
Classifiers: | Programming Language :: Python |
Abstract
The main script provides a relatively painless way to convert a single directory of python packages into an easy_install compatible package archive.
The tool does the following:
There is limited - simple %()s - string templating support for the index and project page generation.
NOTICE:
The indexpackages.py python module can be run independently, without being installed and without setuptools installed. When the module is run directly, eg as python indexpackages.py, if it cant import setuptools in the normal manner it will look for a setuptools egg in the archive root directory. If multiple setuptools eggs are present it sorts the filenames lexicaly and chooses the highest. If you need to pin the setuptools version place a setuptools.pth file in the archive root.
If there is a setuptools.pth in the index root then all directories listed in that file are added to the path, via site.addsitedir, before attempting to import setuptools.
Currently only .egg dists are supported. source dists and svn checkout urls to follow in short order.
In order to make index generation quick, the long_description meta information in packages is NOT consulted or included in the generated project pages. This means any author provided links get missed. A feature to allow deeper package introspection will follow shortly. However, the primary use case this tool is written for is:
I want to maintain a local python package archive - for when other sources are either unavailable or in-appropriate - and I want that archive to be a valid easy_install package index.
Copyright (c) 2007 Robin Bryce
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.