darcsver-1.7.2.egg/EGG-INFO/PKG-INFO

   1 Metadata-Version: 1.0
   2 Name: darcsver
   3 Version: 1.7.2
   4 Summary: generate a version number from darcs history
   5 Home-page: http://tahoe-lafs.org/trac/darcsver
   6 Author: Zooko O'Whielacronx
   7 Author-email: zooko@zooko.com
   8 License: BSD
   9 Description: darcsver - generate version numbers from darcs revision control history
  10         =======================================================================
  11
  12         What Does It Do
  13         ---------------
  14
  15         Create files containing version numbers, based upon the latest darcs
  16         release tag.
  17
  18         If your source tree is coming from darcs (i.e. it is in a darcs
  19         repository), this tool will determine the most recent release tag,
  20         count the patches that have been applied since then, and compute a
  21         version number to be written into _version.py (and optionally other
  22         version files). This version number will be available by doing:
  23
  24         from your_package_name import __version__
  25
  26         Source trees that do not come from darcs (e.g. release tarballs, nightly
  27         tarballs) and are not within a darcs repository should instead, come with a
  28         _version.py that was generated before the tarball was produced. In this case,
  29         this tool will quietly exit without modifying the existing _version.py .
  30
  31         'release tags' are tags in the source repository that match the following
  32         regexp:
  33
  34         ^your_package_name-(\d+)(\.(\d+)(\.(\d+))?)?((a|b|c|rc)(\d+))?
  35
  36
  37         Installation
  38         ------------
  39
  40         With easy_install:
  41
  42         easy_install darcsver
  43
  44         Alternative manual installation:
  45
  46         tar -zxvf darcsver-X.Y.Z.tar.gz
  47         cd darcsver-X.Y.Z
  48         python setup.py install
  49
  50         Where X.Y.Z is a version number.
  51
  52         Alternative to make a specific package use darcsver without installing
  53         darcsver into the system:
  54
  55         Put "setup_requires=['darcsver']" in the call to setup() in the
  56         package's setup.py file.
  57
  58
  59         Usage
  60         -----
  61
  62         There are two ways to use this: the command-line tool and the
  63         setuptools plugin.
  64
  65         To use the command-line tool, execute it as:
  66
  67         darcsver $PACKAGE_NAME $PATH_TO_VERSION_PY
  68
  69
  70         To use the setuptools plugin (which enables you to write "./setup.py
  71         darcsver" and which cleverly figures out where the _version.py file
  72         ought to go), you must first package your python module with
  73         `setup.py` and use setuptools.
  74
  75         The former is well documented in the distutils manual:
  76
  77         http://docs.python.org/dist/dist.html
  78
  79         To use setuptools instead of distutils, just edit `setup.py` and
  80         change
  81
  82         from distutils.core import setup
  83
  84         to
  85
  86         from setuptools import setup
  87
  88
  89         References
  90         ----------
  91
  92         How to distribute Python modules with Distutils:
  93
  94         http://docs.python.org/dist/dist.html
  95
  96
  97         Setuptools complete manual:
  98
  99         http://peak.telecommunity.com/DevCenter/setuptools
 100
 101
 102         Thanks to Yannick Gingras for providing the prototype for this
 103         README.txt.
 104
 105 Keywords: distutils setuptools plugin setup darcs
 106 Platform: UNKNOWN
 107 Classifier: Framework :: Setuptools Plugin
 108 Classifier: Development Status :: 5 - Production/Stable
 109 Classifier: License :: OSI Approved :: BSD License
 110 Classifier: License :: DFSG approved
 111 Classifier: Intended Audience :: Developers
 112 Classifier: Operating System :: OS Independent
 113 Classifier: Natural Language :: English
 114 Classifier: Programming Language :: Python
 115 Classifier: Programming Language :: Python :: 2
 116 Classifier: Programming Language :: Python :: 2.4
 117 Classifier: Programming Language :: Python :: 2.5
 118 Classifier: Programming Language :: Python :: 2.6
 119 Classifier: Programming Language :: Python :: 2.7
 120 Classifier: Topic :: Utilities
 121 Classifier: Topic :: Software Development :: Libraries