setuptools_darcs 1.2.9

setuptools_darcs is a plugin for setuptools that integrates darcs. Once installed, Setuptools can be told to include in a package distribution all the files tracked by darcs. This is an alternative to explicit inclusion specifications with `MANIFEST.in`.<br /><br />A distribution here refers to a package that you create using setup.py, ex:<br /><br /> python setup.py sdist<br /> python setup.py bdist_egg<br /> python setup.py bdist_rpm<br /><br />This package was formerly known as setuptools_darcs_plugin. The name change is the result of an agreement by the setuptools plugin developers to provide a uniform naming convention.<br /><br />Installation:<br /><br />With easy_install:<br /><br /> easy_install setuptools_darcs<br /><br />Alternative manual installation:<br /><br /> tar -zxvf setuptools_darcs-X.Y.Z.tar.gz<br /> cd setuptools_darcs-X.Y.Z<br /> python setup.py install<br /><br />Where X.Y.Z is a version number.<br /><br />Usage:<br /><br />To use this plugin, you must first package your python module with `setup.py` and use setuptools. The former is well documented in the distutils manual:<br /><br /> http://docs.python.org/dist/dist.html<br /><br />To use setuptools instead of distutils, just edit `setup.py` and change<br /><br /> from distutils.core import setup<br /><br />to<br /><br /> from setuptools import setup<br /><br />When setuptools builds a source package, it always includes all files tracked by your revision control system, if it knows how to learn what those files are.<br /><br />When setuptools builds a binary package, you can ask it to include all files tracked by your revision control system, by adding this argument to your invocation of `setup()`:<br /><br /> setup(...,<br /> include_package_data=True,<br /> ...)<br /><br />This plugin lets setuptools know what files are tracked by your darcs revision control tool. setuptools ships with support for cvs and subversion. Other plugins like this one are available for bzr, git, monotone, and mercurial, at least.<br /><br />It might happen that you track files with your revision control system that you don't want to include in your packages. In that case, you can prevent setuptools from packaging those files with a directive in your `MANIFEST.in`, ex:<br /><br /> exclude .darcs-boringfile<br /> recursive-exclude images *.xcf *.blend<br /><br />In this example, we prevent setuptools from packaging `.darcs-boringfile` and the Gimp and Blender source files found under the `images` directory.<br /><br />Alternatively, files to exclude from the package can be listed in the<br /><br />`setup()` directive:<br /><br /> setup(...,<br /> exclude_package_data = {'': ['.darcs-boringfile'],<br /> 'images': ['*.xcf', '*.blend']},<br /> ...)<br /><br />Gotchas<br /><br />If someone clones your darcs repository using darcs but does not install this plugin, then when they run a package building command they will not get all the right files. On the other hand if someone gets a source distribution that was created by "./setup.py sdist", then it will come with a list of all files, so they will not need darcs in order to build a distribution themselves.<br /><br />You can make sure that anyone who uses your setup.py file has this plugin by adding a `setup_requires` argument.<br /><br /> setup_requires=[]<br /> # setuptools_darcs is required to produce complete distributions (such as with<br /> # "sdist" or "bdist_egg"), unless there is a ${PKG}.egg-info/SOURCES.txt file<br /> # present which contains a complete list of files that should be included in<br /> # distributions.<br /> # http://pypi.python.org/pypi/setuptools_darcs<br /> setup_requires.append('setuptools_darcs >= 1.1.0')<br /><br /> setup(...,<br /> setup_requires = setup_requires,<br /> ...)<br /><br /><br />#md5=0ef0b223974e56f2c88a48ba8007ec8f

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Complete,  Control,  Darcs,  Distribution,  Files,  Import,  Include,  Package,  Plugin,  Python,  Revision,  Setup,  Setup Requires,  Setuppy,  Setuptools,  Setuptools Darcs,  Source,  System,  Tracked
Users rating:	0/10