Skip to content
check-circle

GitHub Action

ape-github-action

v3.0 Latest version

ape-github-action

check-circle

ape-github-action

Run an ape command

Installation

Copy and paste the following snippet into your .yml file.

              

- name: ape-github-action

uses: ApeWorX/[email protected]

Learn more about this action in ApeWorX/github-action

Choose a version

GitHub Actions CI File for Ape Projects

This action allows you to use your favorte ape commands in the GitHub Actions CI environment, such as ape compile and ape test

Inputs

python-version

Optional Overrides the version of python used to run ape. Default is using Python '3.10'.

ape-version-pin

Optional Overrides the pin used to install eth-ape. Default is to use the latest version of eth-ape (no pin). Can also use a git+ value to install a branch, commit, or tag.

Example values:

  • 1.0.0
  • ==1.0.0
  • >=1.0.0,<2.0
  • git+https://github.com/your-github/ape.git@your-branch

ape-plugins-list

Optional Space-separated list of plugins to install. The default is to install from your project's local ape-config.yaml. If you do not have any plugin version constraints specified in your ape-config.yaml file, the default includes the -U (--upgrade) flag to ensure you get the latest plugin versons. Otherwise, it relies on the constraints you have configured.

To request specific versions of plugins, use a space-separated value like this 'plugin-a plugin-b==1.2.3 plugin-c>1.2'.

Outputs

ape-version

The version of Ape installed. This will either be the same as the ape-version-pin input if you provided that, else it will be the latest version found from pypi.

Example usage

steps:
  - uses: actions/checkout@v4
  - uses: ApeWorX/github-action@v3
    with:
      python-version: '3.10' # (optional)
      ape-version-pin: '>=0.8.10' # (optional)
      ape-plugins-list: 'solidity vyper==0.8.4' # (optional)
  - run: ape test -s

NOTE This action is still in development