Skip to main content

A TravisCI inspired builder

Project description


GitHub Issues GitHub Pull Requests License

Arcli is a lightweight cross-platform builder inspired by TravisCI. It can automate deploying aplications with a single command line, and is highly extensive.

📝 Table of Contents

🧐 About

Arcli started as a hobby and quickly evolved into something incredibly useful that I implement in my daily life. With Arcli you can write code routines to be executed at the time of a deployment, as well as optional steps that can be triggered by certain conditions.

🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.


You can install Arcli using pip

pip install arcli

or by downloading one of our pre-compiled binaries.

# Download
# Extract
tar arcli-linux_arm64.tar.gz
# Make executable
chmod u+x arcli

Start using it or add it to your PATH

arcli run

🎈 Usage and Definitions

Arcli will try to find and read an Arcli File (arcli.yml) where it will parse and run it.

Arcli File

An Arcli file is an instruction file written in YAML. Arcli will interpret it, perform validations, and thus run the codes described.

Here it is a sample Arcli file (more samples on samples).

arcli: 0.1
os: linux
  - git
  - TEST=sampleenv
  - 'echo Hello World'
  - $step checkgit
  - 'echo Arcli End'
step @checkgit:
    name: GitDiff
    args: ["arcli/*.py"]
    - 'echo Python Files Modified'

Arcli file definitions

Key Type Optional Description
arcli float No Refers to the version of Arcli that that file was made, it is possible to use Semantic Versioning for this field
os str Yes Which operating system this file was made to run [linux, osx, windows, any (default)]
dependencies list Yes Which executables this file will need to use
env list Yes List of environment variables that will be injected at runtime.
runtime list No List of main commands to be executed by Arcli. You can reference steps using $step [step name]

Step and Triggers definitions

Steps are separate blocks of code that can be executed under certain circumstances when triggered by Triggers.

This is how a step look like:

step @checkgit:
    name: GitDiff
    args: ["arcli/*.py"]
    - 'echo Python Files Modified'
Key Type Optional Description
step str No It will be used to refer to the step in the runtime, you must name it after the @. Example: step @mystep
trigger obj Yes Not all steps need to have a trigger, in the absence of a trigger it will always be executed. You can see the triggers available in arcli/triggers.
script list Yes Code to be executed if the step is valid (trigger is triggered or trigger is missing)

This is how a trigger looks like:

  name: GitDiff
  args: ["arcli/*.py"]
    autopull: true
Key Type Optional Description
name str No It will be used to identify the trigger, it must be the same as the class name
args list Yes Arguments that can be passed at the time of executing the trigger
options obj Yes Advanced options that can contain keys and values to be passed to the trigger

Triggers documentation can be found in each respective trigger file.

⛏️ Built Using

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

arcli-0.1.1.tar.gz (13.3 kB view hashes)

Uploaded source

Built Distribution

arcli-0.1.1-py3-none-any.whl (14.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page