# automan

**Repository Path**: mirrors_lepy/automan

## Basic Information

- **Project Name**: automan
- **Description**: A simple automation framework in Python
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2025-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

automan: a simple automation framework
--------------------------------------

|Travis Status|  |Appveyor Status|  |Coverage Status| |Documentation Status|

.. |Travis Status| image:: https://travis-ci.org/pypr/automan.svg?branch=master
  :target: https://travis-ci.org/pypr/automan

.. |Appveyor Status| image:: https://ci.appveyor.com/api/projects/status/82mxewh71wodobdf
  :target: https://ci.appveyor.com/project/prabhuramachandran/automan

.. |Coverage Status| image:: https://codecov.io/gh/pypr/automan/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/pypr/automan

.. |Documentation Status| image:: https://readthedocs.org/projects/automan/badge/?version=latest
  :target: https://automan.readthedocs.io/en/latest/?badge=latest


This framework allows you to automate your computational pipelines.
``automan`` is open source and distributed under the terms of the 3-clause BSD
license.

Features
--------

It is designed to automate the drudge work of managing many numerical
simulations. As an automation framework it does the following:

- helps you organize your simulations.
- helps you orchestrate running simulations and then post-processing the
  results from these.
- helps you reuse code for the post processing of your simulation data.
- execute all your simulations and post-processing with one command.
- optionally distribute your simulations among other computers on your
  network.

This greatly facilitates reproducibility. Automan is written in pure Python
and is easy to install.


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

You should be able to install automan using pip_ as::

  $ pip install automan

If you want to run on the bleeding edge, you may also clone this repository,
change directory into the created directory and run either::

  $ python setup.py install

or::

  $ python setup.py develop


.. _pip: https://pip.pypa.io/en/stable/


Documentation
-------------

Documentation for this project is available at https://automan.rtfd.io

There is a paper on ``automan`` that motivates and describes the software:

- Prabhu Ramachandran, "automan: A Python-Based Automation Framework for
  Numerical Computing," in Computing in Science & Engineering, vol. 20, no. 5,
  pp. 81-97, 2018. `doi:10.1109/MCSE.2018.05329818
  <http://doi.ieeecomputersociety.org/10.1109/MCSE.2018.05329818>`_

A draft of this paper is available here: https://arxiv.org/abs/1712.04786

To see a complete example of a research publication using this framework, see
here: https://gitlab.com/prabhu/edac_sph

The ``README.rst`` in that repository documents how to set everything up. The
scripts to look at are in ``common.py`` and ``automate.py``.

A simpler example project which uses automan is here:
https://github.com/mesnardo/automan-example



The package name
----------------

The name automan comes from an old serial with the same name.  Most
other names were taken on pypi.