Metadata-Version: 2.1
Name: machetli
Version: 0.6
Summary: Locate bugs in your program
Home-page: https://github.com/aibasel/machetli
Author: Lucas Galery Käser
Author-email: lucas.galerykaeser@gmail.com
License: GPL3+
Project-URL: Documentation, https://machetli.readthedocs.io/
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE.md

Machetli
========

**Machetli** is a Python package for reproducing characteristics of a program
(such as bugs) with modified instances. It is meant to be helpful for debugging
complex programs and narrowing down where specific behaviors are caused.

Currently, Machetli handles instances for automated planners, specified either
in PDDL or in the SAS\ :sup:`+` format used by `Fast Downward
<https://www.fast-downward.org>`_ but adding support for other file formats is
easy.


Installation
------------

Machetli requires Python 3.7+ and can be installed with ``pip``.

.. code-block:: bash

    pip install machetli

If you want to avoid changes to your system-wide Python installation you can
`install Machetli in a virtual Python environment
<https://machetli.readthedocs.io/en/latest/installation.html>`_.


Usage
-----

An `interactive demo of Machetli <https://tinyurl.com/machetli-demo>`_ is
available as a Jupyter notebook on Google Colab. You can find additional
examples in the directory `examples
<https://github.com/aibasel/machetli/tree/main/examples>`_.

For a more detailed description, please refer to the `documentation
<https://machetli.readthedocs.io/en/latest/usage.html>`_.


Support
-------

* Documentation: https://machetli.readthedocs.io
* Issue tracker: https://github.com/aibasel/machetli/issues
* Code: https://github.com/aibasel/machetli


License
-------

Machetli is licensed under GPL3.
