smalltalkci

Continuous integration for Smalltalk projects

TLDR

Run tests

$ smalltalkci

Run with config

$ smalltalkci [.smalltalk.ston]

Specify Smalltalk

$ smalltalkci -s [Squeak64-5.3]

Headless mode

$ smalltalkci --headless

Debug mode

$ smalltalkci -d

SYNOPSIS

smalltalkci [-s smalltalk] [-d] [options] [config]

smalltalkci provides continuous integration testing for Smalltalk projects across multiple dialects including Squeak, Pharo, GemStone/S, and Moose. It automates the process of downloading the appropriate Smalltalk virtual machine, loading project code, running tests, and reporting results.Configuration is defined in a .smalltalk.ston file using STON (Smalltalk Object Notation) format, specifying which Smalltalk platform to use, packages to load, and test classes to run. The tool integrates with GitHub Actions, Travis CI, and other CI/CD platforms.Tests run in headless mode by default, requiring no graphical display. Debug mode provides additional output for troubleshooting failed builds, and a custom Smalltalk image can be specified for projects with specific environment requirements.

PARAMETERS

-s SMALLTALK

Smalltalk image version to use (e.g., Squeak64-5.3, Pharo-10.0).

-d

Debug mode for additional output when troubleshooting.

--headless

Run the Smalltalk VM without graphical display (default for CI).

--image FILE

Use a specific Smalltalk image file.

--baseline NAME

Define the Metacello baseline to load or test.

--dir PATH

Set the working directory for the project. Defaults to the current directory.

--cache-dir PATH

Directory where Smalltalk images and VMs are cached.

--github-token TOKEN

GitHub token for accessing private repositories or increasing API rate limits.

--no-tracking

Opt out of anonymous build metrics collection.

--help

Show help.

CAVEATS

Smalltalk-specific. Configuration via .smalltalk.ston required. VM download may be slow on first run as images are cached.