Metadata-Version: 2.1
Name: bisecter
Version: 0.1
Summary: Allows to bisect over arbitrary number of arguments.
Home-page: https://github.com/ldoktor/bisecter
Author: Lukas Doktor
Author-email: ldoktor@redhat.com
License: GPLv2+
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Topic :: Software Development :: Testing
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

============
Introduction
============

This tool is inspired by the ``git bisect`` tool but allows to bisect over
multiple arbitrary lists of arguments like nightly builds, tool versions or
simply list of arguments.

Setup
=====

Bisecter is available from ``pip`` so one can install it by executing::

    python3 -m pip install bisecter

or to install directly the latest version from git::

    python3 -m pip install git+https://github.com/ldoktor/bisecter.git

Basic usage
===========

The workflow is similar to ``git bisect``, only when starting the bisection
one needs to specify the lists of arguments this bisection is going to use::

    bisecter start '20230101,20230102,20230103,20230104,20230105,20230106,20230107'
    bisecter run ./test.sh
    bisecter log

One can also manually tag variants::

    bisecter start '20230101,20230102,20230103,20230104,20230105,20230106,20230107'
    ./test.sh $(bisecter args)
    bisecter good
    ./test.sh $(bisecter args)
    bisecter bad
    ...

See ``bisecter --help`` for more details.


