Skip to main content

Simple execution orchestrator.

Project description


GitHub Actions PyPI Downloads License: MIT Code style: black

Simple execution orchestrator.


Molot requires Python 3.8 or above.


Create a new orchestration file, e.g. for a build orchestration. Make it executable chmod +x to make it easier to run.

#!/usr/bin/env python3
from molot import *  # pylint: disable=wildcard-import,unused-wildcard-import

# Your targets and environment arguments here


Pylint comment silences editor warnings about wildcard imports, you can alternatively import everything individually.

Now you're ready to run the build script to see the help message:


To only see a list of targets and environment arguments, call the built-in list target:

./ list

Not very exciting so far, let's learn how to add your own targets and environment arguments.


Any piece of work that your build needs to perform is defined as a target. Here's a trivial example of a target that executes ls.

    description="lists current directory items",
    depends=["target1", "target2"]
def ls():

Parameters explained:

  • name - unique name to reference the target (optional; function name is used by default)
  • description - short description of what the target does displayed in the help message (optional)
  • group - grouping to list target under (optional; listed under "ungrouped" by default)
  • depends - list of other targets that must be executed first (optional)

Since all the parameters are optional, the shortest definition of the same target can be as follows:

def ls():

Here's how you run your new target:

./ ls

Dependency Resolution

Now we can define another target hello that depends on ls:

@target(description="say hello", depends=["ls"])
def hello():

There is basic dependency resolution that checks for circular dependencies and finds all transitive dependency targets to execute before running the one that you called. When you call:

./ hello

What actually happens is equivalent to calling:

./ ls hello

Environment Arguments

Environment arguments ar a cross between environment variables and arguments. Values can be passed as the former and then overriden as the latter.

Here's how you define one:

ENV = envarg("ENV", default="dev", description="build environment")

Parameters explained:

  • name - unique name for the argument
  • default - default value if none is supplied (optional; None by default)
  • description - short description of what the argument is displayed in the help message (optional)
  • sensitive - indicates the value is sensitive and should be masked (optional)

The argument is evaluated right there (not inside of targets), so you can use that variable straightaway.

It can be set as a regular environment variable:

ENV=dev ./ sometarget

Alternatively, it can be passed as an argument:

./ sometarget --arg ENV=prod

Finally, you can pass .env file to load:

./ sometarget --dotenv /path/to/.env

If both are passed simultaneously, then argument takes precedence over the environment variable.


See examples for use cases that demonstrate the main features.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

molot-1.0.0.tar.gz (16.0 kB view hashes)

Uploaded Source

Built Distribution

molot-1.0.0-py3-none-any.whl (10.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page