travis-ci

Put your Commodore 64 assembly language code programs into Travis-CI harness.

Usage

Installation

This script currently works only in Linux and other Unix-like operating systems (including Windows with CygWin installed). Concept is very simple: you download install.sh script and execute it via sourcing:

source <(curl -SLs https://raw.githubusercontent.com/c64lib/travis-ci/master/install.sh)

After sourcing, all additional dependencies are installed locally and few additional bash commands are available. In particular, assembler should be downloaded and stored in .cbm directory. Currently only KickAssembler is supported.

Please note that this framework is a proof-of-concept and it's API is a subject for a change. You have been warned!

Assembling command

The ka command is a convenient shortcut for launching installed KickAssembler. It accepts all arguments that can be normally used with KickAssembler, but it does the nasty Java stuff for you transparently.

The following command

ka vic2.asm

will produce vic2.prg code out of asm file.

General syntax is

ka <arguments>

All arguments are documented in KickAssembler manual: http://www.theweb.dk/KickAssembler/webhelp/content/cpt_QuickReference.html#sct_cmdLineOpt

Dependency management

A very simple version of dependency management is currently available. You can use it for downloading assembler libraries from github portal before assembling your project. To download given library you should use cpm command using following syntax:

cpm <lib name> <url>

The url should point to tar.gz file containing library. It will be depacked into lib name subdirectory of cpm_modules directory.

To compile your file you can use ka command in following way:

ka -libdir cpm_modules <file.asm>

This one will automatically include all libraries installed in cpm_modules in assembling process. Please note that currently cpm command works only under linux (should work with CygWin as well, although I haven't tested it yet).

Examples

Installation of framework and external libraries

In following example we are building test.asm file that includes three libraries: common, vic2 and cia. This example is real and you can find it in https://github.com/c64lib/test repository.

Your travis config file should look similar to the following:

language: asm
sudo: false
before_install:
  - source <(curl -SLs https://raw.githubusercontent.com/c64lib/travis-ci/master/install.sh)
script:
  - cpm common https://github.com/c64lib/common/archive/develop.tar.gz
  - cpm chipset https://github.com/c64lib/chipset/archive/develop.tar.gz
  - ka -libdir cpm_modules test.asm
notifications:
  email:
     on_success: change
     on_error: change

For given example repository a travis build is configured and can be reviewed: https://travis-ci.org/c64lib/test/builds