/howl.ci

A continuous integration service for ComputerCraft

Primary LanguageHTMLMIT LicenseMIT

howl.ci is a project which aims to provide a continuous integration service to ComputerCraft users.

An example view of the build

Introduction

So what is this "Continuous Integration" thing anyway?

In this context, continuous integration is a way of automating "building" your code whenever you push a commit. This could mean checking your code compiles, running a series of tests, or even uploading your finished build to be distributed to the appreciative public.

What's in it for me?

Continuous integration is a way of automating a task that you do a lot: testing and releasing code. It gives you instant feedback of when you (or someone else) has written broken code. howl.ci allows testing against multiple versions of ComputerCraft, with or without CCTweaks, on normal, advanced or pocket computers.

This of course would take a very long time to do manually, especially if you do it every commit. With howl.ci you'll have every build result back within a manner of minutes, avalible on an easy to use interface.

How does it work?

Builds are executed by Travis using a special emulator called the howl.ci runner. This outputs a log file detailing actions taken during the build. The howl.ci interface then scrapes this log file and extracts useful information such as terminal output, build status and log messages and displays it to you. You can then step through the build to see the state at any point.

Let's see an example then!

The Howl build system uses howl.ci to build itself, ensuring that all code is valid. You can view the latest builds

It is also possible to display log files from arbitrary URLs, such as this one.

I wanna do this!

We've created a useful guide on how to get set up with how.ci.

More images!

Playing back the build

A list of all historic builds