From: Zooko O'Whielacronx Date: Fri, 4 Jun 2010 04:46:48 +0000 (-0700) Subject: setup: bundle a copy of setuptools_trial as an unzipped egg in the base dir of the... X-Git-Url: https://git.rkrishnan.org/pf/content/en/footer/running.html?a=commitdiff_plain;h=37444ce1034219cce5e4754486eacd7b13733163;p=tahoe-lafs%2Ftahoe-lafs.git setup: bundle a copy of setuptools_trial as an unzipped egg in the base dir of the Tahoe-LAFS source tree This is to work-around this Distribute issue: http://bitbucket.org/tarek/distribute/issue/55/revision-control-plugin-automatically-installed-as-a-build-dependency-is-not-present-when-another-build-dependency-is-being --- diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/PKG-INFO b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/PKG-INFO new file mode 100644 index 00000000..35e535c8 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/PKG-INFO @@ -0,0 +1,25 @@ +Metadata-Version: 1.0 +Name: setuptools-trial +Version: 0.5.9 +Summary: Setuptools plugin that makes unit tests execute with trial instead of pyunit. +Home-page: http://allmydata.org/trac/setuptools_trial +Author: Chris Galvan +Author-email: cgalvan@enthought.com +License: BSD +Description: UNKNOWN +Keywords: distutils setuptools trial setuptools_plugin +Platform: UNKNOWN +Classifier: Development Status :: 4 - Beta +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: Topic :: Utilities +Classifier: Topic :: Software Development :: Libraries +Classifier: Framework :: Setuptools Plugin diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/SOURCES.txt b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/SOURCES.txt new file mode 100644 index 00000000..5d746b51 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/SOURCES.txt @@ -0,0 +1,24 @@ + +COPYING.SPL.txt +README.txt +setup.py +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/PKG-INFO +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/SOURCES.txt +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/dependency_links.txt +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/entry_points.txt +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/not-zip-safe +setuptools_darcs-1.2.11-py2.6.egg/EGG-INFO/top_level.txt +setuptools_darcs-1.2.11-py2.6.egg/setuptools_darcs/__init__.py +setuptools_darcs-1.2.11-py2.6.egg/setuptools_darcs/_version.py +setuptools_darcs-1.2.11-py2.6.egg/setuptools_darcs/setuptools_darcs.py +setuptools_darcs-1.2.11-py2.6.egg/share/doc/python-setuptools_darcs/README.txt +setuptools_trial/__init__.py +setuptools_trial/_version.py +setuptools_trial/setuptools_trial.py +setuptools_trial.egg-info/PKG-INFO +setuptools_trial.egg-info/SOURCES.txt +setuptools_trial.egg-info/dependency_links.txt +setuptools_trial.egg-info/entry_points.txt +setuptools_trial.egg-info/not-zip-safe +setuptools_trial.egg-info/requires.txt +setuptools_trial.egg-info/top_level.txt \ No newline at end of file diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/dependency_links.txt b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/dependency_links.txt new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/dependency_links.txt @@ -0,0 +1 @@ + diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/entry_points.txt b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/entry_points.txt new file mode 100644 index 00000000..ad4ed8ca --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/entry_points.txt @@ -0,0 +1,3 @@ +[distutils.commands] +trial = setuptools_trial.setuptools_trial:TrialTest + diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/not-zip-safe b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/not-zip-safe new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/not-zip-safe @@ -0,0 +1 @@ + diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/requires.txt b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/requires.txt new file mode 100644 index 00000000..a6d30923 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/requires.txt @@ -0,0 +1 @@ +Twisted >= 2.4.0 \ No newline at end of file diff --git a/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/top_level.txt b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/top_level.txt new file mode 100644 index 00000000..5bf1cb15 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/EGG-INFO/top_level.txt @@ -0,0 +1 @@ +setuptools_trial diff --git a/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/__init__.py b/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/_version.py b/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/_version.py new file mode 100644 index 00000000..ea5c08fa --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/_version.py @@ -0,0 +1,16 @@ + +# This is the version of this tree, as created by setup.py darcsver from the Darcs patch +# information: the main version number is taken from the most recent release +# tag. If some patches have been added since the last release, this will have a +# -NN "build number" suffix, or else a -rNN "revision number" suffix. Please see +# pyutil.version_class for a description of what the different fields mean. + +verstr = "0.5.9" +try: + from pyutil.version_class import Version as pyutil_Version + __version__ = pyutil_Version(verstr) +except (ImportError, ValueError): + # Maybe there is no pyutil installed, or this may be an older version of + # pyutil.version_class which does not support SVN-alike revision numbers. + from distutils.version import LooseVersion as distutils_Version + __version__ = distutils_Version(verstr) diff --git a/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/setuptools_trial.py b/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/setuptools_trial.py new file mode 100644 index 00000000..1f15a746 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/setuptools_trial/setuptools_trial.py @@ -0,0 +1,106 @@ +import sys + +from setuptools.command import test + + +class TrialTest(test.test): + """ + Twisted Trial setuptools command + """ + + user_options = test.test.user_options + [ + ('rterrors', 'e', "Realtime errors: print out tracebacks as soon as they occur."), + ('debug-stacktraces', 'B', "Report Deferred creation and callback stack traces."), + ('coverage','c', "Report coverage data."), + ('reactor=','r', "which reactor to use"), + ('reporter=', None, "Customize Trial's output with a Reporter plugin."), + ('until-failure','u', "Repeat test until it fails."), + ] + + boolean_options = ['coverage', 'debug-stacktraces', 'rterrors'] + + def initialize_options(self): + test.test.initialize_options(self) + self.coverage = None + self.debug_stacktraces = None + self.reactor = None + self.reporter = None + self.rterrors = None + self.until_failure = None + + def finalize_options(self): + if self.test_suite is None: + if self.test_module is None: + self.test_suite = self.distribution.test_suite + else: + self.test_suite = self.test_module + elif self.test_module: + raise DistutilsOptionError( + "You may specify a module or a suite, but not both" + ) + + self.test_args = self.test_suite + + def run_tests(self): + # We do the import from Twisted inside the function instead of the top + # of the file because since Twisted is a setup_requires, we can't + # assume that Twisted will be installed on the user's system prior + # to using Tahoe, so if we don't do the import here, then importing + # from this plugin will fail. + from twisted.scripts import trial + + # Handle parsing the trial options passed through the setuptools + # trial command. + cmd_options = [] + if self.reactor is not None: + cmd_options.extend(['--reactor', self.reactor]) + else: + # Cygwin requires the poll reactor to work at all. Linux requires the poll reactor + # to avoid twisted bug #3218. In general, the poll reactor is better than the + # select reactor, but it is not available on all platforms. According to exarkun on + # IRC, it is available but buggy on some versions of Mac OS X, so just because you + # can install it doesn't mean we want to use it on every platform. + # Unfortunately this leads to this error with some combinations of tools: + # twisted.python.usage.UsageError: The specified reactor cannot be used, failed with error: reactor already installed. + if sys.platform in ("cygwin"): + cmd_options.extend(['--reactor', 'poll']) + if self.reporter is not None: + cmd_options.extend(['--reporter', self.reporter]) + if self.rterrors is not None: + cmd_options.append('--rterrors') + if self.debug_stacktraces is not None: + cmd_options.append('--debug-stacktraces') + config = trial.Options() + config.parseOptions(cmd_options) + + + args = self.test_args + if type(args) == str: + args = [args,] + + config['tests'] = args + + if self.coverage: + config.opt_coverage() + + trial._initialDebugSetup(config) + trialRunner = trial._makeRunner(config) + suite = trial._getSuite(config) + + # run the tests + if self.until_failure: + test_result = trialRunner.runUntilFailure(suite) + else: + test_result = trialRunner.run(suite) + + # write coverage data + if config.tracer: + sys.settrace(None) + results = config.tracer.results() + results.write_results(show_missing=1, summary=False, + coverdir=config.coverdir) + + if test_result.wasSuccessful(): + sys.exit(0) # success + else: + sys.exit(1) # failure diff --git a/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/COPYING.SPL.txt b/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/COPYING.SPL.txt new file mode 100644 index 00000000..502b360b --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/COPYING.SPL.txt @@ -0,0 +1,3 @@ +Permission is hereby granted to any person obtaining a copy of this work to +deal in this work without restriction (including the rights to use, modify, +distribute, sublicense, and/or sell copies). diff --git a/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/README.txt b/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/README.txt new file mode 100644 index 00000000..dea90ee5 --- /dev/null +++ b/setuptools_trial-0.5.9-py2.6.egg/share/doc/python-setuptools_trial/README.txt @@ -0,0 +1,83 @@ + +setuptools_trial Manual +======================= + +About +----- + +This is a plugin for setuptools that integrates Twisted trial. Once +installed, "python ./setup.py trial" will run the package's unit tests +using Twisted trial. The package can also optionally be configured so +that "python ./setup.py test" will use Twisted trial instead of pyunit +a.k.a. unittest. + + +Installation +------------ + +With easy_install: + + easy_install setuptools_trial + +Alternative manual installation: + + tar -zxvf setuptools_trial-X.Y.Z.tar.gz + cd setuptools_trial-X.Y.Z + python setup.py install + +Where X.Y.Z is a version number. + +Alternative to make a specific package use setuptools_trial without +installing setuptools_trial into the system: + + Put "setup_requires=['setuptools_trial']" in the call to setup() in + the package's setup.py file. + + +Usage +----- + +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: + + 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 + +Once setuptools_trial is installed (either into the system or just for +the current package), then "python ./setup.py trial" will run trial on +the package. + +You can then make "python ./setup.py test" use trial instead of pyunit +(unittest) by adding the following stanza to your project's setup.py: + + [aliases] + test = trial + +See also the output of "python ./setup.py trial --help" for usage +options. + + +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.