mirror of
https://github.com/tahoe-lafs/tahoe-lafs.git
synced 2024-12-22 14:22:25 +00:00
122 lines
4.1 KiB
Plaintext
122 lines
4.1 KiB
Plaintext
|
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
|