grana 1.0.0

Declarative task runner

grana

Grana is an extensible declarative task runner, aimed to make complex routine jobs easier to configure.

Table of Contents

1. Installation
2. Usage
3. How to contribute

Installation

# Install only core components
pip install grana

# Install with all extensions
pip install "grana[all]"

Usage

Basic examples

# Execute a workflow that is outlined
# in the workdir-located grana.yaml file
grana run

# Print usage
grana --help

Options are configured either via environment variables or via command-line switches. The most common are:

• GRANA_LOG_LEVEL: Set log level.
• GRANA_LOG_FILE: Set log file.
• GRANA_WORKFLOW_FILE: Set the workflow file path explicitly.
• GRANA_STRATEGY_NAME: Manage execution strategy.
• GRANA_ACTIONS_CLASS_DEFINITIONS_DIRECTORY: Where to look for custom action runners.
• GRANA_STRICT_OUTCOMES_RENDERING: Manage failure behaviour when an outcome key is missing.

Full list of used environment variable names can be obtained with this command:

grana info env-vars

How to contribute

Development environment setup

Requires system-wide poetry>=1.3.2, see official documentation.

poetry env use python3.8
poetry install --no-root --sync --all-extras

The root directory for the source code is src, thus one may add it to the project's python path for better IDE integration.

Running tests with coverage on current environment

poetry run pytest --cov --cov-report=html:.coverage_report

Running tests on all available environments

poetry run tox