Metadata-Version: 1.1
Name: toxgen
Version: 0.1
Summary: Tox.ini generator
Home-page: https://bitbucket.org/cdevienne/toxgen
Author: Christophe de Vienne
Author-email: cdevienne@gmail.com
License: UNKNOWN
Description: Toxgen
        ======
        
        Produces a tox.ini file from a template config file.
        
        The template config file is a standard tox.ini file with additional sections.
        Theses sections will be combined to create new testenv: sections if they do
        not exists yet.
        
        The added sections are:
        
        [axes]
            options::
        
                axis1name = value1(*)[,value2(*)[, ...]]
                axis2name = value1(*)[,value2[, ...]]
        
            In this section, a list of test axes are given and for each of them a
            list of possible values.
        
            A tailing '*' on a value means it is this axis default value. Hence it can
            be set on only one value.
            The default value will create additional sections with this axis value
            removed from the section name (see below)
        
            Example:
                To test a lib against different python version with and without
                'lxml'::
        
                    [axes]
                    python = py25,py32
                    lxml = lxml*,nolxml
        
                This will generate the following [testenv:] sections::
        
                    [testenv:py25-lxml]
                    # ...
        
                    [testenv:py25]
                    # A copy of testenv:py25-lxml
        
                    [testenv:py25-nolxml]
                    # ...
        
                    [testenv:py32-lxml]
                    # ...
        
                    [testenv:py32]
                    # A copy of testenv:py27-lxml
        
                    [testenv:py32-nolxml]
                    # ...
        
        [axis:name]
            The default options for an axis.
        
            Any option can be added, and if not overridden for a specific value,
            combined with the same option in the other axis
        
        [axis:name:value]
            Options for a specific axis value.
        
            The only option that will be interpreted by gentox is 'constraints', a
            multi-lines option that allow to exclude other axis values.
        
            For example, if we want not to test py25 without lxml::
        
                [axis:lxml:nolxml]
                constraints=
                    !python:py25
        
            The other options will be combined.
        
        Complete example::
        
            [tox]
            envlist = py25-nolxml,py32
        
            [axes]
            python = py25,py32
            lxml = lxml*,nolxml
        
            [axis:python]
            deps =
                six
        
            [axis:python:py25]
            basepython=python2.5
        
            [axis:python:py32]
            basepython=python3.2
        
            [axis:lxml:nolxml]
            constraints =
                !python:py25
        
            [axis:lxml:lxml]
            deps =
                lxml
        
        This will generate the following tox file::
        
            [tox]
            envlist = py25-nolxml,py32
        
            [testenv:py25-lxml]
            deps = 
                six
                lxml
            basepython = python2.5
        
            [testenv:py25]
            deps = 
                six
                lxml
            basepython = python2.5
        
            [testenv:py32-lxml]
            deps = 
                six
                lxml
            basepython = python3.2
        
            [testenv:py32]
            deps = 
                six
                lxml
            basepython = python3.2
        
            [testenv:py32-nolxml]
            deps = 
                six
            basepython = python3.2
        
        
        Running
        -------
        
        ::
        
            Usage: toxgen.py [options]
        
            Options:
              -h, --help            show this help message and exit
              -i FILE, --input=FILE
                                    input template file to process [default: tox-tmpl.ini]
              -o FILE, --output=FILE
                                    output file to generate [default: tox.ini]
              -r, --rewrite         rewrite [tox] envlist [default: False]
            
            Produce a tox.ini file from a template config file.  The template config file
            is a standard tox.ini file with additional sections. Theses sections will be
            combined to create new testenv: sections if they do not exists yet.
        
Keywords: tox template generator combinations test
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
