Metadata-Version: 2.0
Name: experipy
Version: 0.3.0
Summary: A framework for writing and running Computational Science experiments
Home-page: https://experipy.readthedocs.io
Author: Adam Howard
Author-email: ahoward0920@gmail.com
License: BSD 3-clause
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering

==========
 Experipy
==========

A framework for writing and running Computational Science experiments.

``experipy`` provides a composable grammar for automating experiment script generation and a tool which can then execute those scripts. Supports PBS script based queueing.

------------------
 A Simple Example
------------------

::

    from experipy.exp       import Experiment
    from experipy.grammar   import Executable

    exp = Experiment(Executable("echo", ["Hello World"]), 
                     expname="test", 
                     destdir="results")
    exp.run()

This will run the program ``echo`` with the argument ``Hello World`` in a directory in ``/tmp``, writing the output and error, along with timing information, to the directory ``results``. Directories will be created as needed. A complete example showing how to write an experiment for a Python script can be found in ``test/runtest.py``.

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

``experipy`` can be installed from PyPI, and has no other dependencies.

::

    ?> pip install experipy

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

Full documentation for experipy can be found at https://experipy.readthedocs.io. 

-----------------------
 Features In The Works
-----------------------

- Expand ``experipy.system`` to include more standard command line tools

- Beef up PBS script options


