summaryrefslogtreecommitdiff
path: root/darcsver-1.6.3.egg/EGG-INFO/PKG-INFO
diff options
context:
space:
mode:
Diffstat (limited to 'darcsver-1.6.3.egg/EGG-INFO/PKG-INFO')
-rw-r--r--darcsver-1.6.3.egg/EGG-INFO/PKG-INFO121
1 files changed, 121 insertions, 0 deletions
diff --git a/darcsver-1.6.3.egg/EGG-INFO/PKG-INFO b/darcsver-1.6.3.egg/EGG-INFO/PKG-INFO
new file mode 100644
index 0000000..0bee80f
--- /dev/null
+++ b/darcsver-1.6.3.egg/EGG-INFO/PKG-INFO
@@ -0,0 +1,121 @@
+Metadata-Version: 1.0
+Name: darcsver
+Version: 1.6.3
+Summary: generate a version number from darcs history
+Home-page: http://tahoe-lafs.org/trac/darcsver
+Author: Zooko O'Whielacronx
+Author-email: zooko@zooko.com
+License: BSD
+Description: darcsver - generate version numbers from darcs revision control history
+ =======================================================================
+
+ What Does It Do
+ ---------------
+
+ Create files containing version numbers, based upon the latest darcs
+ release tag.
+
+ If your source tree is coming from darcs (i.e. it is in a darcs
+ repository), this tool will determine the most recent release tag,
+ count the patches that have been applied since then, and compute a
+ version number to be written into _version.py (and optionally other
+ version files). This version number will be available by doing:
+
+ from your_package_name import __version__
+
+ Source trees that do not come from darcs (e.g. release tarballs, nightly
+ tarballs) and are not within a darcs repository should instead, come with a
+ _version.py that was generated before the tarball was produced. In this case,
+ this tool will quietly exit without modifying the existing _version.py .
+
+ 'release tags' are tags in the source repository that match the following
+ regexp:
+
+ ^your_package_name-(\d+)(\.(\d+)(\.(\d+))?)?((a|b|c|rc)(\d+))?
+
+
+ Installation
+ ------------
+
+ With easy_install:
+
+ easy_install darcsver
+
+ Alternative manual installation:
+
+ tar -zxvf darcsver-X.Y.Z.tar.gz
+ cd darcsver-X.Y.Z
+ python setup.py install
+
+ Where X.Y.Z is a version number.
+
+ Alternative to make a specific package use darcsver without installing
+ darcsver into the system:
+
+ Put "setup_requires=['darcsver']" in the call to setup() in the
+ package's setup.py file.
+
+
+ Usage
+ -----
+
+ There are two ways to use this: the command-line tool and the
+ setuptools plugin.
+
+ To use the command-line tool, execute it as:
+
+ darcsver $PACKAGE_NAME $PATH_TO_VERSION_PY
+
+
+ To use the setuptools plugin (which enables you to write "./setup.py
+ darcsver" and which cleverly figures out where the _version.py file
+ ought to go), you must first package your python module with
+ `setup.py` and use setuptools.
+
+ The former is well documented in the distutils manual:
+
+ http://docs.python.org/dist/dist.html
+
+ To use setuptools instead of distutils, just edit `setup.py` and
+ change
+
+ from distutils.core import setup
+
+ to
+
+ from setuptools import setup
+
+
+ References
+ ----------
+
+ How to distribute Python modules with Distutils:
+
+ http://docs.python.org/dist/dist.html
+
+
+ Setuptools complete manual:
+
+ http://peak.telecommunity.com/DevCenter/setuptools
+
+
+ Thanks to Yannick Gingras for providing the prototype for this
+ README.txt.
+
+Keywords: distutils setuptools plugin setup darcs
+Platform: UNKNOWN
+Classifier: Framework :: Setuptools Plugin
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: DFSG approved
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.4
+Classifier: Programming Language :: Python :: 2.5
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: Libraries