Skip to main content

A task executor

Project description

https://img.shields.io/pypi/v/jolt.svg https://readthedocs.org/projects/jolt/badge/?version=latest

Jolt is a task execution tool designed for software development tasks. It can build your C/C++ applications and React frontends, run tests, deploy your web services, and much more.

Tasks are defined in Python scripts. They may be executed locally by developers or by automation software such as Jenkins in a continuous integration pipeline. In both cases, tasks may be distributed and executed in parallel in a server cluster. The output of each task is cached to reduce overall execution times on repeat attempts. In one real world deployment, Jolt shortend the CI build duration from 10 hours to 10 minutes on average.

Example C++ application task:

class CppApp(CXXExecutable):
    """ Builds a C++ application """
    arch = Parameter(values=["arm", "x64"])
    requires = [
       "git:url=https://github.com/org/cppapp.git",
       "gcc:arch={arch},version=9.1.1",
    ]
    sources = ["cppapp/include/*.hpp", "cppapp/src/*.cpp"]
$ jolt build cppapp:arch=x64

Example Node.js tasks:

class NodeJS(Download):
    """ Downloads and publishes Node.js. Adds binaries to PATH. """

    version = Parameter("14.16.1")
    url = "https://nodejs.org/dist/v{version}/node-v{version}-win-x64.zip"

    def publish(self, artifact, tools):
        super(publish).publish(artifact, tools)
        artifact.environ.PATH.append("node-v{version}-win-x64")


 class WebApp(Task):
     """ Builds a really cool WebApp """

     requires = [
         "git:url=https://github.com/org/webapp.git",
         "nodejs"
     ]

     def run(self, deps, tools):
         with tools.cwd("webapp"):
             tools.run("npm ci")
             tools.run("npm build")
$ jolt build webapp

A common command line interface for all tasks enables developers from different disciplines to quickly run each others tasks without in-depth knowledge of the underlying technology - a C++ developer doesn’t have to learn NPM and a React developer doesn’t have to know anything about CMake, Make, MSBuild, etc. Required tools and dependencies are also provisioned automatically.

For full documentation, please visit http://jolt.readthedocs.io/

Installing

Jolt is available in the Python Package Index:

$ pip install jolt
$ jolt

And as a Docker image:

$ docker run robrt/jolt

A thin Python wrapper is available for the Docker images. By using it, multiple versions of Jolt can coexist on the host since the version used is selected during runtime rather than install time. To use a specific version in a project, add a version attribute in the Jolt manifest. By always using a specific version cache hits become more likely.

$ pip install jolt_docker
$ jolt

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

jolt-0.9.329.tar.gz (12.6 MB view details)

Uploaded Source

Built Distribution

jolt-0.9.329-py3-none-any.whl (12.7 MB view details)

Uploaded Python 3

File details

Details for the file jolt-0.9.329.tar.gz.

File metadata

  • Download URL: jolt-0.9.329.tar.gz
  • Upload date:
  • Size: 12.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.2

File hashes

Hashes for jolt-0.9.329.tar.gz
Algorithm Hash digest
SHA256 cd80b99e31da6d14a3fbd1aceb5e74c479035266db88c8094a8430fa82e2e19b
MD5 5e699eb8faa82035d1da6ebc4cef6605
BLAKE2b-256 e238ec89aebbb253d8ab98b1175a19fd2f6cf772c434bbcf0ec8ff4b161fec70

See more details on using hashes here.

File details

Details for the file jolt-0.9.329-py3-none-any.whl.

File metadata

  • Download URL: jolt-0.9.329-py3-none-any.whl
  • Upload date:
  • Size: 12.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.2

File hashes

Hashes for jolt-0.9.329-py3-none-any.whl
Algorithm Hash digest
SHA256 d47e91f9c5ee11251cb272a73bb2530e969af27e558a979555b7f2794fdffad1
MD5 56a55c9a8a9446d7a98da4824f0f1219
BLAKE2b-256 2060b91114e549ae37bfa31e9d91ec953db47eb14f0556cdbefa730ad050d328

See more details on using hashes here.

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