This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

eggtestinfo README

Overview

This package is a setuptools plugin: it adds a file to the generated .egg-info directory, capturing the information used by the setup.py test command when running tests.

In particular, the generated file contains the following information:

test_module

The dotted name of a module holding a test_suite function which can be called to compute a unittest.TestSuite for the package.

  • This option conflicts with test_suite.

  • This option can be overridden on the command line, e.g.:

    $ python setup.py test --test_module=my_package.tests
    
test_suite

The dotted name of a function which can be called to compute a unittest.TestSuite for the package.

  • This option conflicts with test_module.

  • Note that this name does not use the same conventions use by other setuptools callables: the function name is appended to the dotted name of the module with a dot, rather than a colon.

  • This option can be overridden on the command line, e.g.:

    $ python setup.py test --test_suite=my_package.utils.find_tests
    
test_loader

A setuptools entry point which, when called, returns an instalance of a loader class, suitable for passing as thet testLoader argument to unittest.main().

  • This option cannot be overridden on the command line; it can only be specified as an argument to setup().
tests_require

A list of setuptools requirement specifications for packages which must be importable when running the tests.

  • This option cannot be overridden on the command line.

Using the Extension

The package registers a entrypoint for setuptools’ egg_info.writers group: it will therefore be used when building egg info in any environment where it is present on the PYTHONPATH.

To ensure that your packages get the test information recorded, even when used from an environment where this package is not already installed, add the following to your call to setup():

from setuptools import setup
setup(name='my_package',
      # ...
      setup_requires=['eggtestinfo'],
      #...
     )

Examples

The following examples show the generated test_info.txt file for various sample packages.

  • For a package whose tests are finadable by setuptools’ default loader, but whose tests depend on another package which is not part of the “normal” dependencies of the package:

    test_module = None
    test_suite = None
    test_loader = None
    tests_require = another_package
    
  • For a package which has a module, ‘tests’, which contains a ‘test_suite’ function that returns the test suite for the whole package:

    test_module = my_package.tests
    test_suite = None
    test_loader = None
    tests_require = None
    
  • For a package which has a function, ‘find_tests’, in its ‘utils’ module, that returns the test suite for the package:

    test_module = None
    test_suite = my_package.utils.find_tests
    test_loader = None
    tests_require = None
    
  • For a package which uses the “skip layers” loader from zope.testing:

    test_module = None
    test_suite = None
    test_loader = zope.testing.testrunner.eggsupport:SkipLayers
    tests_require = zope.testing>=3.7dev
    

eggtestinfo Changelog

0.3 (2011-03-10)

  • Verified / added assertion of Python3 compatibility.
  • Added tests.

0.2.2 (2008-09-19)

  • Packaging update: added more extensive docs.

0.2.1 (2008-03-09)

  • Packaging update: add new Trove classifier, ‘Framework :: Setuptools Plugin’.

0.2 (2007-11-16)

  • Added ‘test_loader’ and ‘test_module’ information to generated file.

0.1 (2007-11-15)

  • Initial release.
Release History

Release History

0.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
eggtestinfo-0.3.tar.gz (4.0 kB) Copy SHA256 Checksum SHA256 Source Mar 10, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting