bfis / law

Build large-scale task workflows: luigi + job submission + remote targets + environment sandboxing using Docker/Singularity

Home Page:http://law.readthedocs.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

law logo
Build status Documentation status Package version License DOI

Note: This project is currently under development. Version 0.1.0 will be the first, fully documented beta release, targetted for early 2020.

Use law to build complex and large-scale task workflows. It is build on top of luigi and adds abstractions for run locations, storage locations and software environments. Law strictly disentangles these building blocks and ensures they remain interchangeable and resource-opportunistic.

Key features:

  • CLI with auto-completion and interactive status and dependency inspection.
  • Remote targets with automatic retries and local caching
    • WebDAV, HTTP, Dropbox, SFTP, all WLCG protocols (srm, xrootd, rfio, dcap, gsiftp, ...)
  • Automatic submission to batch systems from within tasks
    • HTCondor, LSF, gLite, ARC
  • Environment sandboxing, configurable on task level
    • Docker, Singularity, Sub-Shells

First steps

Installation and Dependencies

Install via pip:

pip install law

This command also installs luigi and six.

Remote targets also require gfal2 and gfal2-python (optional, also via pip) to be installed.

Docker Images

To run and test law, there are three docker images available on the DockerHub, corresponding to Python versions 2.7, 3.7 and 3.8. They are based on CentOS 7 and ship with the dependencies listed above, including gfal2.

docker run -ti riga/law:latest

Tags:

  • latest, py3, py38: Python 3.8.2
  • py37: Python 3.7.6
  • py2, py27: Python 2.7.5

Examples

All examples can be run either in a Jupyter notebook or a dedicated docker container. For the latter, do

docker run -ti riga/law:example <example_name>

Auto completion on the command-line

bash

source "$( law completion )"

zsh

zsh is able to load and evaluate bash completion scripts via bashcompinit. In order for bashcompinit to work, you should run compinstall to enable completion scripts:

autoload -Uz compinstall && compinstall

After following the instructions, these lines should be present in your ~/.zshrc:

# The following lines were added by compinstall
zstyle :compinstall filename '~/.zshrc'

autoload -Uz compinit
compinit
# End of lines added by compinstall

If this is the case, just source the law completion script (which internally enables bashcompinit) and you're good to go:

source "$( law completion )"

Development

About

Build large-scale task workflows: luigi + job submission + remote targets + environment sandboxing using Docker/Singularity

http://law.readthedocs.io

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Python 92.1%Language:Shell 6.6%Language:Dockerfile 1.3%