Skip to content

Build Paclet

Actions
Build a paclet using its definition notebook file
v1.11.0
Latest
Star (4)

The Build Paclet action is an interface to the BuildPaclet function from Wolfram/PacletCICD and can be used to build your Wolfram Language paclet from source code within GitHub Actions. This is roughly equivalent to using the Build > All menu item from the resource definition notebook within Wolfram Desktop or Mathematica.

Usage

A YAML file that uses this action can be automatically generated for your paclet using WorkflowExport:

PacletSymbol["Wolfram/PacletCICD", "WorkflowExport"]["path/to/paclet", "Build"]

Alternatively, using GitHub actions YAML syntax directly:

name: Build Paclet
on: [push]
jobs: 
  Build: 
    name: Build Paclet
    runs-on: ubuntu-latest
    container: 
      image: wolframresearch/wolframengine:latest
      options: --user root
    env: 
      WOLFRAMSCRIPT_ENTITLEMENTID: ${{ secrets.WOLFRAMSCRIPT_ENTITLEMENTID }}
    steps: 
    - name: Checkout repository
      uses: actions/checkout@v2
    - name: Build paclet
      uses: WolframResearch/build-paclet@v1
    - name: UploadArtifact
      uses: actions/upload-artifact@v3
      with: 
        path: ${{ env.PACLET_BUILD_DIR }} # set during the build-paclet step

Parameters

Input Default Description
check true Whether to check the paclet for errors prior to building
target "Submit" The named configuration to use for error checking when check is true. Some possible values are "Build", "Check", "Deploy", and "Submit".
definition_notebook "./ResourceDefinition.nb" The relative path to the paclet's resource definition notebook
paclet_cicd_version "latest" The version of PacletCICD to use

Notes

For this action to work, your repository needs to have a license entitlement ID defined as a repository secret. See this tutorial for details.

See Also

Build Paclet is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Build a paclet using its definition notebook file
v1.11.0
Latest

Build Paclet is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.