The 40ants-ci Reference Manual

2.1 40ants-ci

A tool simplify continuous deployment for Common Lisp projects.

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Long Description

<a id="x-2840ANTS-CI-3A-40README-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

# 40Ants-CI - Github Workflow Generator

[][de0b]


This is a small utility, which can generate GitHub workflows for Common Lisp
projects.

It generates workflow for running tests and building docs. These workflows
use [40ants/run-tests][8469] and [40ants/build-docs][b882]
actions and [‘SBLint‘][2f94] to check code for compilation errors.

<a id="40-ants-ci-asdf-system-details"></a>

## 40ANTS-CI ASDF System Details

* Version: 0.10.0

* Description: A tool simplify continuous deployment for Common Lisp projects.

* Licence: ‘BSD‘

* Author: Alexander Artemenko

* Homepage: [https://40ants.com/ci/][3f72]

* Source control: [GIT][e681]

<a id="x-2840ANTS-CI-3A-3A-40REASONS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## Reasons to Use

* This system hides all entrails related to caching.

* Includes a few ready to use job types.

* Custom job types can be defined and distributed as separate ‘ASDF‘ systems.

* You don’t have to write ‘YAML‘ anymore!

<a id="x-2840ANTS-CI-3A-3A-40QUICKSTART-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## Quickstart

This system allows you to define workflows in the lisp code. The best way is to make these
definitions a part of your ‘ASDF‘ system. This way [‘40ants-ci‘][b171] will be able to
automatically understand for which system it builds a workflow.

Each workflow consists of jobs and each job is a number of steps.

There are three predefine types of jobs and you can create your own. Predefined jobs
allows to reuse steps in multiple ‘CL‘ libraries.

In next examples, I’ll presume you are writing code in a file which is the part
of the package inferred ‘ASDF‘ system ‘EXAMPLE/CI‘. A file should have the following header:

“‘lisp
(defpackage #:example/ci
(:use #:cl)
(:import-from #:40ants-ci/workflow
#:defworkflow)
(:import-from #:40ants-ci/jobs/linter)
(:import-from #:40ants-ci/jobs/run-tests)
(:import-from #:40ants-ci/jobs/docs))
“‘
<a id="x-2840ANTS-CI-3A-3A-40JOB-TYPES-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

### Job Types

<a id="x-2840ANTS-CI-3A-3A-40LINTER-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Linter

The simplest job type is linter. It loads a

“‘lisp
(defworkflow linter
:on-pull-request t
:jobs ((40ants-ci/jobs/linter:linter)))
“‘
When you’ll hit ‘C-c C-c‘ on this definition,
it will generate ‘.github/workflows/linter.yml‘ with following content:

“‘json
{
"name": "LINTER",
"on": {
"pull_request": null
},
"jobs": {
"linter": {
"runs-on": "ubuntu-latest",
"env": {
"OS": "ubuntu-latest",
"QUICKLISP_DIST": "quicklisp",
"LISP": "sbcl-bin"
},
"steps": [
{
"name": "Checkout Code",
"uses": "actions/checkout@v3"
},
{
"name": "Setup Common Lisp Environment",
"uses": "40ants/setup-lisp@v2",
"with": {
"asdf-system": "example"
}
},
{
"name": "Install SBLint",
"run": "qlot exec ros install cxxxr/sblint",
"shell": "bash"
},
{
"name": "Run Linter",
"run": "qlot exec sblint example.asd",
"shell": "bash"
}
]
}
}
}
“‘
Here you can see, a few steps in the job:

1. Checkout the code.

2. Install Roswell & Qlot using [40ants/setup-lisp][8de1] action.

3. Install [‘SBLint‘][2f94].

4. Run linter for ‘example.asd‘.

Another interesting thing is that this workflow automatically uses ‘ubuntu-latest‘ ‘OS‘,
‘Quicklisp‘ and ‘sbcl-bin‘ Lisp implementation. Later I’ll show you how to redefine these settings.

<a id="x-2840ANTS-CI-2FJOBS-2FLINTER-3ALINTER-20CLASS-29"></a>

##### [class](66f9) ‘40ants-ci/jobs/linter:linter‘ (lisp-job)

<a id="x-2840ANTS-CI-3A-3A-40CRITIC-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Critic

This job is similar to linter, but instead of ‘SBL‘int it runs
[Lisp Critic][2100].

Lisp Critic is a program which advices how to make you Common Lisp code more
idiomatic, readable and performant. Also, sometimes it might catch logical
errors in the code.

Here is how you can add this job type in your workflow:

“‘lisp
(defworkflow ci
:on-pull-request t
:jobs ((40ants-ci/jobs/critic:critic)))
“‘
Also, you might combine this job together with others, for example,
with linter:

“‘lisp
(defworkflow ci
:on-pull-request t
:jobs ((40ants-ci/jobs/linter:linter)
(40ants-ci/jobs/critic:critic)))
“‘
and they will be executed in parallel. See docs on [‘40ants-ci/jobs/critic:critic‘][484a] function
to learn about supported arguments.

<a id="x-2840ANTS-CI-3A-3A-40RUN-TESTS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Running Tests

Another interesting job type is ‘40ants-ci/jobs/run-tests:run-tests‘ ([‘1‘][e35d] [‘2‘][6cb7]).

When using this job type, make sure, your system
runs tests on ‘(ASDF:TEST-SYSTEM :system-name)‘ call
and signals error if something went wrong.

“‘lisp

(defworkflow ci
:on-push-to "master"
:by-cron "0 10 * * 1"
:on-pull-request t
:jobs ((40ants-ci/jobs/run-tests:run-tests
:coverage t)))
“‘
Here I’ve added a few options to the workflow:

* ‘by-cron‘ - sets a schedule.

* ‘on-push-to‘ - defines a branch or branches to track.

It will generate ‘.github/workflows/ci.yml‘ with following content:

“‘json
{
"name": "CI",
"on": {
"push": {
"branches": [
"master"
]
},
"pull_request": null,
"schedule": [
{
"cron": "0 10 * * 1"
}
]
},
"jobs": {

"run-tests": {
"runs-on": "ubuntu-latest",
"env": {
"OS": "ubuntu-latest",
"QUICKLISP_DIST": "quicklisp",
"LISP": "sbcl-bin"
},
"steps": [
{
"name": "Checkout Code",
"uses": "actions/checkout@v3"
},
{
"name": "Setup Common Lisp Environment",
"uses": "40ants/setup-lisp@v2",
"with": {
"asdf-system": "example"
}
},
{
"name": "Run Tests",
"uses": "40ants/run-tests@v2",
"with": {
"asdf-system": "example",
"coveralls-token": "${{ secrets.github_token }}"
}
}
]
}
}
}
“‘
The result is similar to the workflow generated for Linter,
but uses [40ants/setup-lisp][59d7] action
at the final step.

Also, I’ve passed an option ‘:coverage t‘ to the job. Thus coverage
report will be uploaded to [Coveralls.io][b60c] automatically.

<a id="x-2840ANTS-CI-3A-3A-40MATRIX-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

##### Defining a test Matrix

Lisp has many implementations and can be used on multiple platforms. Thus
it is a good idea to test our software on many combinations of ‘OS‘ and lisp
implementations. Workflow generator makes this very easy.

Here is an example of workflow definition with three dimentional matrix.
It not only tests a library under different lisps and ‘OS‘, but also checks
if it works with the latest Quicklisp and Ultralisp distributions:

“‘lisp
(defworkflow ci
:on-pull-request t
:jobs ((run-tests
:os ("ubuntu-latest"
"macos-latest")
:quicklisp ("quicklisp"
"ultralisp")
:lisp ("sbcl-bin"
"ccl-bin"
"allegro"
"clisp"
"cmucl")
:exclude (;; Seems allegro is does not support 64bit OSX.
;; Unable to install it using Roswell:
;; alisp is not executable. Missing 32bit glibc?
(:os "macos-latest" :lisp "allegro")))))
“‘
<a id="x-2840ANTS-CI-3A-3A-40MULTIPLE-JOBS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

##### Multiple jobs

Besides a build matrix, you might specify a multiple jobs of the same type,
but with different parameters:

“‘lisp
(defworkflow ci
:on-push-to "master"
:on-pull-request t
:jobs ((run-tests
:lisp "sbcl-bin")
(run-tests
:lisp "ccl-bin")
(run-tests
:lisp "allegro")))
“‘
This will generate a workflow with three jobs: "run-tests", "run-tests-2" and "run-tests-3".

Meaningful names might be specified as well:

“‘lisp
(defworkflow ci
:on-push-to "master"
:on-pull-request t
:jobs ((run-tests
:name "test-on-sbcl"
:lisp "sbcl-bin")
(run-tests
:name "test-on-ccl"
:lisp "ccl-bin")
(run-tests
:name "test-on-allegro"
:lisp "allegro")))
“‘
Here is how these jobs will look like in the GitHub interface:


<a id="x-2840ANTS-CI-3A-3A-40BUILD-DOCS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Building Docs

Third predefined job type is ‘40ants-ci/jobs/docs:build-docs‘ ([‘1‘][13b8] [‘2‘][1ddb]).
It uses [40ants/build-docs][613f]
action and will work only if your ‘ASDF‘ system uses a documentation builder supported by
[40ants/docs-builder][f2be].

To build docs on every push to master, just use this code:

“‘lisp

(defworkflow docs
:on-push-to "master"
:jobs ((40ants-ci/jobs/docs:build-docs)))
“‘
It will generate ‘.github/workflows/docs.yml‘ with following content:

“‘json

{
"name": "DOCS",
"on": {
"push": {
"branches": [
"master"
]
}
},
"jobs": {
"build-docs": {
"runs-on": "ubuntu-latest",
"env": {
"OS": "ubuntu-latest",
"QUICKLISP_DIST": "quicklisp",
"LISP": "sbcl-bin"
},
"steps": [
{
"name": "Checkout Code",
"uses": "actions/checkout@v3"
},
{
"name": "Setup Common Lisp Environment",
"uses": "40ants/setup-lisp@v2",
"with": {
"asdf-system": "example",
"qlfile-template": ""
}
},
{
"name": "Build Docs",
"uses": "40ants/build-docs@v1",
"with": {
"asdf-system": "example"
}
}
]
}
}
}
“‘
<a id="x-2840ANTS-CI-3A-3A-40CACHING-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

### Caching

To significantly speed up our tests, we can cache installed Roswell,
Qlot and Common Lisp fasl files.

To accomplish this task, you don’t need to dig into GitHub’s docs anymore!
Just add one line ‘:cache t‘ to your workflow definition:

“‘lisp
(defworkflow docs
:on-push-to "master"
:cache t
:jobs ((40ants-ci/jobs/docs:build-docs)))
“‘
Here is the diff of the generated workflow file. It shows steps, added automatically:

“‘diff
modified .github/workflows/docs.yml
@@ -20,13 +20,40 @@
"name": "Checkout Code",
"uses": "actions/checkout@v3"
},
+ {
+ "name": "Grant All Perms to Make Cache Restoring Possible",
+ "run": "sudo mkdir -p /usr/local/etc/roswell\n sudo chown \"${USER}\" /usr/local/etc/roswell\n # Here the ros binary will be restored:\n sudo chown \"${USER}\" /usr/local/bin",
+ "shell": "bash"
+ },
+ {
+ "name": "Get Current Month",
+ "id": "current-month",
+ "run": "echo \"::set-output name=value::$(date -u \"+%Y-%m\")\"",
+ "shell": "bash"
+ },
+ {
+ "name": "Cache Roswell Setup",
+ "id": "cache",
+ "uses": "actions/cache@v3",
+ "with": {
+ "path": "qlfile\n qlfile.lock\n /usr/local/bin/ros\n ~/.cache/common-lisp/\n ~/.roswell\n /usr/local/etc/roswell\n .qlot", + "key": "${{ steps.current-month.outputs.value }}-${{ env.cache-name }}-ubuntu-latest-quicklisp-sbcl-bin-${{ hashFiles(’qlfile.lock’) }}"
+ }
+ },
+ {
+ "name": "Restore Path To Cached Files",
+ "run": "echo $HOME/.roswell/bin >> $GITHUB_PATH\n echo .qlot/bin >> $GITHUB_PATH",
+ "shell": "bash",
+ "if": "steps.cache.outputs.cache-hit == ’true’"
+ },
{
"name": "Setup Common Lisp Environment",
"uses": "40ants/setup-lisp@v2",
"with": {
"asdf-system": "40ants-ci",
"qlfile-template": ""
- }
+ },
+ "if": "steps.cache.outputs.cache-hit != ’true’"
},
{
“‘
<a id="x-2840ANTS-CI-3A-3A-40DETAILS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## Details

‘TODO‘: I have to write a few chapters with details on additional job’s parameters
and a way how to create new job types.

<a id="x-2840ANTS-CI-3AGENERATE-20FUNCTION-29"></a>

### [function](4bd5) ‘40ants-ci:generate‘ system &key path

Generates GitHub workflow for given ‘ASDF‘ system.

This function searches workflow definitions in all packages
of the given ‘ASDF‘ system.

If ‘PATH‘ argument is not given, workflow files will be written
to .github/workflow/ relarive to the ‘SYSTEM‘.

<a id="x-2840ANTS-CI-2FJOBS-2FRUN-TESTS-3ARUN-TESTS-20FUNCTION-29"></a>

### [function](3c01) ‘40ants-ci/jobs/run-tests:run-tests‘ &rest rest &key coverage qlfile asdf-system asdf-version os quicklisp lisp exclude custom

Creates a job step of class [‘run-tests‘][6cb7].

<a id="x-2840ANTS-CI-2FJOBS-2FRUN-TESTS-3ARUN-TESTS-20CLASS-29"></a>

### [class](1461) ‘40ants-ci/jobs/run-tests:run-tests‘ (lisp-job)

This job test runs tests for a given ‘ASDF‘ system.

<a id="x-2840ANTS-CI-2FJOBS-2FDOCS-3ABUILD-DOCS-20FUNCTION-29"></a>

### [function](3822) ‘40ants-ci/jobs/docs:build-docs‘ &key asdf-system asdf-version (error-on-warnings t)

Creates a job of class [‘build-docs‘][1ddb].

<a id="x-2840ANTS-CI-2FJOBS-2FDOCS-3ABUILD-DOCS-20CLASS-29"></a>

### [class](e511) ‘40ants-ci/jobs/docs:build-docs‘ (lisp-job)

Builds documentation and uploads it to GitHub using ["40ants/build-docs" github action][613f].

<a id="x-2840ANTS-CI-2FJOBS-2FLINTER-3ALINTER-20FUNCTION-29"></a>

### [function](7099) ‘40ants-ci/jobs/linter:linter‘ &key asdf-systems asdf-version check-imports

Creates a job which will run ‘SBL‘int for given ‘ASDF‘ systems.

If no ‘ASD‘ files given, it will use all ‘ASD‘ files from
the current ‘ASDF‘ system.

<a id="x-2840ANTS-CI-2FJOBS-2FLINTER-3ALINTER-20FUNCTION-29"></a>

### [function](7099) ‘40ants-ci/jobs/linter:linter‘ &key asdf-systems asdf-version check-imports

Creates a job which will run ‘SBL‘int for given ‘ASDF‘ systems.

If no ‘ASD‘ files given, it will use all ‘ASD‘ files from
the current ‘ASDF‘ system.

<a id="x-2840ANTS-CI-2FJOBS-2FCRITIC-3ACRITIC-20CLASS-29"></a>

### [class](fdfc) ‘40ants-ci/jobs/critic:critic‘ (lisp-job)

<a id="x-2840ANTS-CI-2FJOBS-2FCRITIC-3ACRITIC-20FUNCTION-29"></a>

### [function](f25a) ‘40ants-ci/jobs/critic:critic‘ &key asdf-systems asdf-version ignore-critiques

Creates a job which will run Lisp Critic for given ‘ASDF‘ systems.

If argument ‘ASDF-SYSTEMS‘ is ‘NIL‘, it will use ‘ASDF‘ system
to which current lisp file is belong.

You may also provide ‘ASDF-VERSION‘ argument. It should be
a string. By default, the latest ‘ASDF‘ version will be used.

[2100]: https://40ants.com/40ants-critic
[b882]: https://40ants.com/build-doc
[613f]: https://40ants.com/build-docs/
[3f72]: https://40ants.com/ci/
[b171]: https://40ants.com/ci/#x-28-23A-28-289-29-20BASE-CHAR-20-2E-20-2240ants-ci-22-29-20ASDF-2FSYSTEM-3ASYSTEM-29
[484a]: https://40ants.com/ci/#x-2840ANTS-CI-2FJOBS-2FCRITIC-3ACRITIC-20FUNCTION-29
[1ddb]: https://40ants.com/ci/#x-2840ANTS-CI-2FJOBS-2FDOCS-3ABUILD-DOCS-20CLASS-29
[13b8]: https://40ants.com/ci/#x-2840ANTS-CI-2FJOBS-2FDOCS-3ABUILD-DOCS-20FUNCTION-29
[6cb7]: https://40ants.com/ci/#x-2840ANTS-CI-2FJOBS-2FRUN-TESTS-3ARUN-TESTS-20CLASS-29
[e35d]: https://40ants.com/ci/#x-2840ANTS-CI-2FJOBS-2FRUN-TESTS-3ARUN-TESTS-20FUNCTION-29
[f2be]: https://40ants.com/docs-builder/
[8469]: https://40ants.com/run-tests
[59d7]: https://40ants.com/run-tests/
[8de1]: https://40ants.com/setup-lisp/
[b60c]: https://coveralls.io/
[e681]: https://github.com/40ants/ci
[de0b]: https://github.com/40ants/ci/actions
[4bd5]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/core.lisp#L526
[fdfc]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/critic.lisp#L12
[f25a]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/critic.lisp#L22
[e511]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/docs.lisp#L14
[3822]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/docs.lisp#L21
[66f9]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/linter.lisp#L14
[7099]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/linter.lisp#L33
[1461]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/run-tests.lisp#L18
[3c01]: https://github.com/40ants/ci/blob/98915f1bd6e1b68f923825bd5fe71f71aa06db78/src/jobs/run-tests.lisp#L28
[2f94]: https://github.com/cxxxr/sblint

* * *
###### [generated by [40ANTS-DOC](https://40ants.com/doc/)]

Version

0.10.0

Defsystem Dependency

40ants-asdf-system (system).

Dependencies

• 40ants-ci/core (system).
• 40ants-ci/ci (system).
• 40ants-ci/changelog (system).

Source

40ants-ci.asd.

2.2 40ants-ci/core

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-doc (system).
• 40ants-ci/github (system).
• 40ants-ci/jobs/docs (system).
• 40ants-ci/jobs/linter (system).
• 40ants-ci/jobs/critic (system).
• 40ants-ci/jobs/run-tests (system).
• docs-config (system).

Source

40ants-ci.asd.

2.3 40ants-ci/github

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/utils (system).
• 40ants-ci/vars (system).

Source

40ants-ci.asd.

2.4 40ants-ci/utils

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/vars (system).
• str (system).
• yason (system).

Source

40ants-ci.asd.

2.5 40ants-ci/vars

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Source

40ants-ci.asd.

2.6 40ants-ci/jobs/docs

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/jobs/lisp-job (system).
• 40ants-ci/jobs/job (system).
• 40ants-ci/steps/action (system).
• 40ants-ci/utils (system).

Source

40ants-ci.asd.

2.7 40ants-ci/jobs/lisp-job

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/jobs/job (system).
• 40ants-ci/steps/action (system).
• 40ants-ci/utils (system).
• 40ants-ci/steps/sh (system).
• 40ants-ci/vars (system).

Source

40ants-ci.asd.

2.8 40ants-ci/jobs/job

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/utils (system).
• 40ants-ci/github (system).

Source

40ants-ci.asd.

2.9 40ants-ci/steps/action

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/steps/step (system).
• 40ants-ci/github (system).
• alexandria (system).

Source

40ants-ci.asd.

2.10 40ants-ci/steps/step

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/github (system).
• 40ants-ci/utils (system).

Source

40ants-ci.asd.

2.11 40ants-ci/steps/sh

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/steps/step (system).
• 40ants-ci/github (system).
• alexandria (system).
• 40ants-ci/utils (system).

Source

40ants-ci.asd.

2.12 40ants-ci/jobs/linter

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/steps/sh (system).
• 40ants-ci/jobs/lisp-job (system).
• 40ants-ci/jobs/job (system).
• 40ants-ci/utils (system).

Source

40ants-ci.asd.

2.13 40ants-ci/jobs/critic

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/steps/sh (system).
• 40ants-ci/jobs/job (system).
• 40ants-ci/jobs/lisp-job (system).

Source

40ants-ci.asd.

2.14 40ants-ci/jobs/run-tests

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/steps/action (system).
• 40ants-ci/jobs/lisp-job (system).
• 40ants-ci/jobs/job (system).
• 40ants-ci/utils (system).
• alexandria (system).

Source

40ants-ci.asd.

2.15 40ants-ci/ci

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/jobs/linter (system).
• 40ants-ci/jobs/critic (system).
• 40ants-ci/jobs/run-tests (system).
• 40ants-ci/jobs/docs (system).
• 40ants-ci/workflow (system).

Source

40ants-ci.asd.

2.16 40ants-ci/workflow

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependencies

• 40ants-ci/github (system).
• 40ants-ci/utils (system).
• 40ants-ci/vars (system).
• alexandria (system).

Source

40ants-ci.asd.

2.17 40ants-ci/changelog

Author

Alexander Artemenko

Home Page

https://40ants.com/ci/

Source Control

(GIT https://github.com/40ants/ci)

License

BSD

Dependency

40ants-doc/changelog (system).

Source

40ants-ci.asd.

3.1 Lisp

• 40ants-ci/40ants-ci.asd
• 40ants-ci/core/file-type.lisp
• 40ants-ci/github/file-type.lisp
• 40ants-ci/utils/file-type.lisp
• 40ants-ci/vars/file-type.lisp
• 40ants-ci/jobs/docs/file-type.lisp
• 40ants-ci/jobs/lisp-job/file-type.lisp
• 40ants-ci/jobs/job/file-type.lisp
• 40ants-ci/steps/action/file-type.lisp
• 40ants-ci/steps/step/file-type.lisp
• 40ants-ci/steps/sh/file-type.lisp
• 40ants-ci/jobs/linter/file-type.lisp
• 40ants-ci/jobs/critic/file-type.lisp
• 40ants-ci/jobs/run-tests/file-type.lisp
• 40ants-ci/ci/file-type.lisp
• 40ants-ci/workflow/file-type.lisp
• 40ants-ci/changelog/file-type.lisp

4.1 40ants-ci/vars

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• *current-system* (special variable).
• *use-cache* (special variable).

4.2 40ants-ci/github

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• generate (generic function).
• prepare-data (generic function).

4.3 40ants-ci/steps/sh

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• sections (macro).
• sh (function).
• sh (class).

Internals

• *default-shell* (special variable).
• command (generic reader).
• shell (generic reader).

4.4 40ants-ci/jobs/job

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• job (class).
• lisp (generic function).
• name (generic reader).
• os (generic function).
• quicklisp (generic function).
• steps (generic function).
• use-matrix-p (generic function).

Internals

• exclude (generic function).
• make-env (generic function).
• make-matrix (generic function).
• make-runs-on (generic function).
• make-steps (generic function).

4.5 40ants-ci/utils

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• alistp (function).
• current-system-name (function).
• dedent (function).
• ensure-list-of-plists (function).
• ensure-primary-system (function).
• make-github-workflows-path (function).
• plist-to-alist (function).
• plistp (function).
• single (function).
• system-packages (generic function).
• to-json (function).

Internals

• count-leading-spaces (function).
• empty-line (function).
• list-to-json (function).

4.6 40ants-ci/jobs/lisp-job

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• asdf-system (generic function).
• lisp-job (class).

Internals

• asdf-version (generic reader).
• make-cache-key (generic function).
• make-cache-steps (generic function).
• qlfile (generic reader).
• qlot-version (generic reader).
• roswell-version (generic reader).

4.7 40ants-ci/jobs/docs

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• build-docs (function).
• build-docs (class).

Internals

error-on-warnings (generic reader).

4.8 40ants-ci/workflow

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

defworkflow (macro).

Internals

• *registered-workflows* (special variable).
• by-cron (generic function).
• cache-p (generic reader).
• eval-arg (function).
• jobs (generic function).
• make-job (function).
• make-triggers (generic function).
• make-workflow-path (function).
• name (generic reader).
• on-pull-request (generic reader).
• on-push-to (generic function).
• on-workflow-redefinition (generic function).
• package-workflows (function).
• register-workflow (function).
• workflow (class).

4.9 40ants-ci/steps/step

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• step (class).
• step-id (generic reader).
• step-name (generic reader).

Internals

• env (generic reader).
• make-env (generic function).
• step-if (generic reader).

4.10 40ants-ci/jobs/critic

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• critic (function).
• critic (class).

Internals

• asdf-systems (generic reader).
• ignore-critiques (generic reader).

4.11 40ants-ci/jobs/run-tests

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• run-tests (function).
• run-tests (class).

Internals

• coverage (generic reader).
• custom (generic reader).

4.12 40ants-ci/jobs/linter

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• linter (function).
• linter (class).

Internals

• asdf-systems (generic function).
• check-imports (generic reader).

4.13 40ants-ci/changelog

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

@changelog (special variable).

Internals

• 0.1.0 (special variable).
• 0.1.1 (special variable).
• 0.10.0 (special variable).
• 0.2.0 (special variable).
• 0.2.1 (special variable).
• 0.2.2 (special variable).
• 0.3.0 (special variable).
• 0.4.0 (special variable).
• 0.5.0 (special variable).
• 0.6.0 (special variable).
• 0.7.0 (special variable).
• 0.8.0 (special variable).
• 0.8.1 (special variable).
• 0.9.0 (special variable).

4.14 40ants-ci/steps/action

Source

file-type.lisp.

Use List

common-lisp.

Public Interface

• action (function).
• action (class).

Internals

• action-args (generic reader).
• uses (generic reader).

4.15 40ants-ci/ci

Source

file-type.lisp.

Use List

common-lisp.

Internals

• ci (class).
• docs (class).

4.16 40ants-ci

Source

file-type.lisp.

Nickname

40ants-ci/core

Use List

common-lisp.

Public Interface

• @index (special variable).
• @readme (special variable).
• generate (function).

Internals

• @build-docs (special variable).
• @caching (special variable).
• @critic (special variable).
• @details (special variable).
• @job-types (special variable).
• @linter (special variable).
• @matrix (special variable).
• @multiple-jobs (special variable).
• @quickstart (special variable).
• @reasons (special variable).
• @run-tests (special variable).

5.1 Public Interface

• Special variables
• Macros
• Ordinary functions
• Generic functions
• Standalone methods
• Classes

5.2 Internals

• Special variables
• Ordinary functions
• Generic functions
• Classes