Skip to content

Manual examples

Manual examples #2466

Workflow file for this run

# TODO the next great simplification might be deploying multiple examples to one dfx replica instance: https://forum.dfinity.org/t/use-the-same-local-replica-for-multiple-projects/11900
# TODO this might allow us to avoid spinning up so many jobs in the matrix
# This GitHub Action flow works as follows:
# The tests are currently simple example-based integration tests.
# Each directory in the examples directory represents an example project and is intended to have tests that ensure the canisters contained in that example function properly.
# These tests are currently written in TypeScript and are intended to be run in a Node.js environment.
# This GitHub Action takes care of deploying to npm and GitHub.
# Tests can either run against the current code of Azle found in the repository, or the code deployed by the GitHub Action to npm.
# Feature branch pull requests (pull requests without release-- in the base branch name) will run all tests against the code found in the repository.
# Release branch pull requests (pull requests with release-- in the base branch name) will run all tests against the code found in the repository and the code deployed by the GitHub Action to npm.
# Pushes to main will run all tests against the code in the repository if the latest commit was not a merge of a release branch, and will run tests against the code in the repository and the code deployed by the GitHub Action to npm otherwise.
# The basic-integration-tests matrix spins up one job per combination of example directory and code source (repo or npm).
# The check-basic-integration-tests-success job is designed to ensure that all jobs spun up from the matrix in the basic-integration-tests have succeeded
# All Examples TODO restore when https://github.com/demergent-labs/azle/issues/1192 is resolved
# "examples/async_await",
# "examples/audio_recorder",
# "examples/bitcoin",
# "examples/blob_array",
# "examples/bytes",
# "examples/call_raw",
# "examples/candid_encoding",
# "examples/complex_init",
# "examples/complex_types",
# "examples/composite_queries",
# "examples/counter",
# "examples/cross_canister_calls",
# "examples/cycles",
# "examples/date",
# "examples/ethereum_json_rpc",
# "examples/func_types",
# "examples/generics",
# "examples/guard_functions",
# "examples/heartbeat",
# "examples/ic_api",
# "examples/imports",
# "examples/init",
# "examples/inline_types",
# "examples/inspect_message",
# "examples/key_value_store",
# "examples/ledger_canister",
# "examples/list_of_lists",
# "examples/management_canister",
# "examples/manual_reply",
# "examples/motoko_examples/calc",
# "examples/motoko_examples/counter",
# "examples/motoko_examples/echo",
# "examples/motoko_examples/factorial",
# "examples/motoko_examples/hello",
# "examples/motoko_examples/hello-world",
# "examples/motoko_examples/http_counter",
# "examples/motoko_examples/minimal-counter-dapp",
# "examples/motoko_examples/persistent-storage",
# "examples/motoko_examples/phone-book",
# "examples/motoko_examples/quicksort",
# "examples/motoko_examples/simple-to-do",
# "examples/motoko_examples/superheroes",
# "examples/motoko_examples/threshold_ecdsa",
# "examples/motoko_examples/whoami",
# "examples/notify_raw",
# "examples/null_example",
# "examples/optional_types",
# "examples/outgoing_http_requests",
# "examples/pre_and_post_upgrade",
# "examples/primitive_types",
# "examples/principal",
# "examples/query",
# "examples/randomness",
# "examples/rejections",
# "examples/robust_imports",
# "examples/run_time_errors",
# "examples/rust_type_conversions",
# "examples/service",
# "examples/simple_erc20",
# "examples/simple_user_accounts",
# "examples/stable_memory",
# "examples/stable_structures",
# "examples/timers",
# "examples/tuple_types",
# "examples/update"
# These are the ones that don't work
# "examples/tuple_types",
# "examples/service",
# "examples/robust_imports",
# "examples/run_time_errors",
# "examples/rust_type_conversions",
# "examples/complex_types",
# "examples/func_types",
# "examples/generics",
# "examples/guard_functions",
# "examples/inline_types",
# "examples/motoko_examples/superheroes",
# "examples/motoko_examples/threshold_ecdsa",
name: Azle Tests
on:
push:
branches:
- main
pull_request: # Runs on pull requests to any branch
jobs:
release-candidate-deploy:
runs-on: ubuntu-latest
env:
GPG_SIGNING_KEY: ${{ secrets.GPG_SIGNING_KEY }} # All commits must be verified
outputs:
# These outputs are used to pass information along to the next job
should_run_tests: ${{ steps.should_run_tests.outputs.should_run_tests }} # We only want the next job to run the tests once we have finished deploying to npm and GitHub
example_directories: ${{ steps.example_directories.outputs.example_directories }}
steps:
- uses: actions/checkout@v2
# if: contains(github.head_ref, 'release--')
with:
ref: ${{ contains(github.head_ref, 'release--') && github.event.pull_request.head.ref || github.ref }} # This is necessary for this job to be able to commit and push to the origin remote properly
token: ${{ secrets.LASTMJS_GITHUB_TOKEN || github.token }} # A personal GitHub token is setup as a secret so that committing and pushing to GitHub from the Action will trigger another workflow
- uses: actions/setup-node@v3
with:
node-version: 18
registry-url: https://registry.npmjs.org
env:
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
# TODO we should use some Action-specific bot account
- if: contains(github.head_ref, 'release--')
run: git config --global user.name 'Jordan Last'
- if: contains(github.head_ref, 'release--')
run: git config --global user.email '[email protected]'
- if: contains(github.head_ref, 'release--')
run: git config --global commit.gpgsign true
- if: contains(github.head_ref, 'release--')
run: echo -n "$GPG_SIGNING_KEY" | base64 --decode | gpg --import
- if: contains(github.head_ref, 'release--')
run: git config --global user.signingkey C8B77BCBE16CD2B94B43F9C8757397B82D4ED7B0
- id: example_directories
# TODO to improve this further we might be able to create an environment variable that grabs the example directories with a glob
# TODO we want to be able to easily include and exclude examples though
run: |
EXAMPLE_DIRECTORIES=$(cat << END
[
"examples/audio_recorder",
"examples/async_await",
"examples/bitcoin",
"examples/blob_array",
"examples/bytes",
"examples/call_raw",
"examples/candid_encoding",
"examples/counter",
"examples/complex_init",
"examples/composite_queries",
"examples/cross_canister_calls",
"examples/cycles",
"examples/ethereum_json_rpc",
"examples/date",
"examples/heartbeat",
"examples/ic_api",
"examples/imports",
"examples/init",
"examples/inspect_message",
"examples/key_value_store",
"examples/ledger_canister",
"examples/list_of_lists",
"examples/management_canister",
"examples/manual_reply",
"examples/motoko_examples/calc",
"examples/motoko_examples/counter",
"examples/motoko_examples/echo",
"examples/motoko_examples/factorial",
"examples/motoko_examples/hello",
"examples/motoko_examples/hello-world",
"examples/motoko_examples/http_counter",
"examples/motoko_examples/minimal-counter-dapp",
"examples/motoko_examples/persistent-storage",
"examples/motoko_examples/phone-book",
"examples/motoko_examples/quicksort",
"examples/motoko_examples/simple-to-do",
"examples/motoko_examples/whoami",
"examples/notify_raw",
"examples/null_example",
"examples/optional_types",
"examples/pre_and_post_upgrade",
"examples/outgoing_http_requests",
"examples/primitive_types",
"examples/principal",
"examples/query",
"examples/randomness",
"examples/rejections",
"examples/simple_erc20",
"examples/simple_user_accounts",
"examples/stable_memory",
"examples/stable_structures",
"examples/timers",
"examples/update"
]
END
)
EXAMPLE_DIRECTORIES="${EXAMPLE_DIRECTORIES//'%'/'%25'}"
EXAMPLE_DIRECTORIES="${EXAMPLE_DIRECTORIES//$'\n'/'%0A'}"
EXAMPLE_DIRECTORIES="${EXAMPLE_DIRECTORIES//$'\r'/'%0D'}"
echo "::set-output name=example_directories::$EXAMPLE_DIRECTORIES"
- id: should_run_tests
run: |
BRANCH_NAME="${{ github.head_ref }}"
RELEASE_VERSION="${BRANCH_NAME:9}"
COMMIT_MESSAGE=$(git log -1 --pretty=format:"%s")
if [[ "${{ contains(github.head_ref, 'release--') }}" == "true" && "$COMMIT_MESSAGE" != "azle-bot automated release $RELEASE_VERSION" ]]
then
./publish-github-action.sh $RELEASE_VERSION ${{ toJSON(steps.example_directories.outputs.example_directories) }}
else
echo "::set-output name=should_run_tests::true"
fi
basic-integration-tests:
needs: release-candidate-deploy
runs-on: ubuntu-latest
env:
ETHEREUM_URL: ${{ secrets.ETHEREUM_URL }}
strategy:
fail-fast: false # We want to see which example tests succeed and which ones fail, we don't want one example test to cancel the rest
matrix:
include_npm:
# Only include npm in the matrix if you've pushed to main and the last commit was a merge of a release branch, or the base branch of the pull request is a release branch
- ${{ (github.ref == 'refs/heads/main' && contains(github.event.head_commit.message, 'Merge pull request') && contains(github.event.head_commit.message, 'demergent-labs/release--')) || contains(github.head_ref, 'release--') }}
azle_source:
- npm
- repo
exclude:
- include_npm: false
azle_source: npm
# If should_run_tests is false, we still want the steps of this job to execute so that check-basic-integration-tests-success will run. We do this by creating an array with one dummy element
example_directories: ${{ needs.release-candidate-deploy.outputs.should_run_tests == 'true' && fromJSON(needs.release-candidate-deploy.outputs.example_directories) || fromJSON('["dummy"]') }}
steps:
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
uses: actions/checkout@v2
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
uses: actions/setup-node@v3
with:
node-version: 18
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
run: DFX_VERSION=0.14.2 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
uses: actions/cache@v3
with:
path: ~/.config/azle
key: azle-cargo-${{ hashFiles('src/compiler/typescript_to_javascript/cargo_toml_files.ts') }}
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
shell: bash -l {0} # TODO figure out why this is here and comment about it
run: npm install
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests && matrix.azle_source == 'repo' }}
shell: bash -l {0}
run: npm link
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
working-directory: ${{ matrix.example_directories }}
run: dfx start --clean --background --host 127.0.0.1:8000
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
shell: bash -l {0}
working-directory: ${{ matrix.example_directories }}
run: npm install
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests && matrix.azle_source == 'repo' }}
shell: bash -l {0}
working-directory: ${{ matrix.example_directories }}
run: npm link azle
- if: ${{ needs.release-candidate-deploy.outputs.should_run_tests }}
shell: bash -l {0}
working-directory: ${{ matrix.example_directories }}
run: npm test
check-basic-integration-tests-success:
needs: basic-integration-tests
runs-on: ubuntu-latest
if: success()
steps:
- run: exit 0
check-basic-integration-tests-failure:
needs: basic-integration-tests
runs-on: ubuntu-latest
if: failure()
steps:
- run: exit 1