action-setup

GitHub action to setup OpenAF.

Usage

 - name: Setup OpenAFuses: openaf/action-setup@v2.2.0
- name: Using OpenAFrun : | echo Recursive list of files order by size: echo oafp data="." in=ls lsrecursive=true\ sql="select filepath, permissions, size where isFile=TRUE order by size desc"\ out=ctable

Available commands

After setup you will be able to use:

Command	Description
oaf	The main OpenAF runtime
oafp	The OpenAF data processor
ojob	The OpenAF's oJob orchestrator (although using openaf/ojob-action instead is recommended)
opack	The OpenAF's package manager
pyoaf	The Python OpenAF extensions runner (if available)
oaf-sb	The main OpenAF runtime unix she-bang executor
ojob-sb	The OpenAF's oJob unix she-bang executor
oafp-sb	The OpenAF data processor she-bang executor

Caching

To cache the OpenAF installation you can use GitHub Actions caching (saving, at least, around ~4/5 seconds of action execution) but you will have to be carefull with the management of the cache. Example:

 - name: Cache OpenAFuses: actions/cache@v4with:
# you need to manage the cache in the best way specifically for your casekey : oafpath: /tmp/oaf
- name: Setup OpenAFuses: openaf/action-setup@v2.2.0

Using a different distribution

By default the 'stable' OpenAF distribution is used but you can specify a different one using the dist input:

 - name: Setup OpenAFuses: openaf/action-setup@v2.2.0with:
dist: nightly
- name: Check OpenAF distributionrun : | echo "The current OpenAF distribution is '$(oaf -c 'print(getDistribution())')'"

Using a specific version

By default the latest version of the defined (or stable) distribution will be retrived. To specify it you can use the version input:

 - name: Setup OpenAFuses: openaf/action-setup@v2.2.0with:
version: 20241117
- name: Check OpenAF versionrun : | echo "The current OpenAF version is '$(oaf -c 'print(getVersion())')'"

Installing specific oPacks

You can also list oPacks to be installed as part of the setup process:

 - name: Setup OpenAFuses: openaf/action-setup@v2.2.0with:
opacks: oJob-common,GIST
- name: Check list of installed oPacksrun : | opack list

Works together with https://github.com/OpenAF/ojob-action