Skip to main content

Simple app for automatization of everything

Project description

Latest Version Downloads Supported Python Versions Wheel Status Development Status

Sloth CI is an easy-to-use, lightweight, extendable tool that executes actions you need when certain events happen.

Sloth CI was created because Jenkins is too heavy and Buildbot was too hard to learn.

Read the docs at http://sloth-ci.com/ (yes, they are built with Sloth CI).

Requirements

Sloth CI runs with Python 3.3+ on Windows, Linux, and Mac.

Install

Install Sloth with pip:

$ pip install sloth-ci

It’s also a good idea to install a validator for Bitbucket or GitHub right away:

$ pip install sloth-ci.validators.bitbucket
$ pip install sloth-ci.validators.github

Configure

Create a file named sloth.yml in any directory and cd to that directory.

Here’s how your sloth.yml can look like:

host: localhost
port: 8080

daemon: true

api_auth:
    login: admin
    password: supersecret

Start

Start the Sloth CI server with:

$ sloth-ci start

Create App

Create a file called myapp.yml:

listen_point: docs

work_dir: ~/projects

provider:
    bitbucket:
        owner: username
        repo: repository
        branches:
            - master
            - staging

actions:
    - rm -rf repository
    - hg clone https://bitbucket.org/username/repository
    - hg up {branch} --cwd repository
    - pip3 install -U sphinx
    - pip3 install -r repository/docs/requirements.txt
    - sphinx-build -aE repository/docs/ {output}/{branch}

params:
    output: /var/www/html

Create the app from the config:

$ sloth-ci create /path/to/myapp.yml
App created, listening on docs

Note

Run sloth-ci create from the directory with the sloth.yml file.

That’s it! Your app now listens for payload from Bitbucket at http://yourdomain:8080/docs.

Create a hook on Bitbucket, and you docs will be automatically built on every push to the repo.

Project details


Release history Release notifications

This version
History Node

1.2.6

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
sloth_ci-1.2.6-py3-none-any.whl (26.4 kB) Copy SHA256 hash SHA256 Wheel 3.4 May 8, 2015
sloth-ci-1.2.6.win-amd64.exe (289.4 kB) Copy SHA256 hash SHA256 Windows Installer any May 8, 2015
sloth-ci-1.2.6.zip (27.9 kB) Copy SHA256 hash SHA256 Source None May 8, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page