-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into verkle-support
- Loading branch information
Showing
39 changed files
with
669 additions
and
347 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,33 @@ | ||
|
|
||
| name: Build latest image | ||
|
|
||
| on: | ||
| workflow_dispatch: | ||
|
|
||
| concurrency: | ||
| group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} | ||
| cancel-in-progress: true | ||
|
|
||
| permissions: | ||
| contents: write | ||
|
|
||
| jobs: | ||
|
|
||
| check_source: | ||
| name: "Run code checks" | ||
| uses: ./.github/workflows/_shared-check.yaml | ||
|
|
||
| build_binaries: | ||
| name: "Build Assertoor" | ||
| needs: [check_source] | ||
| uses: ./.github/workflows/_shared-build.yaml | ||
| with: | ||
| ref: ${{ github.sha }} | ||
| release: "snapshot" | ||
| docker: true | ||
| docker_repository: "ethpandaops/assertoor" | ||
| docker_tag_prefix: "master" | ||
| additional_tags: "['master','master-latest','latest']" | ||
| secrets: | ||
| DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }} | ||
| DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| # REST API | ||
|
|
||
| When enabled, Assertoor offers a REST API that facilitates interaction with the testing framework, enabling users to programmatically fetch statuses and results of tests and tasks. Additionally, the API supports basic operations such as scheduling or canceling test runs, making it a powerful tool for automating and integrating Assertoor into broader testing and CI/CD pipelines. | ||
|
|
||
| ## Key Features of the REST API: | ||
|
|
||
| - **Status and Results Retrieval**: Users can query the API to obtain detailed status updates and results for both tests and individual tasks, allowing for real-time monitoring and analysis of test executions. | ||
|
|
||
| - **Test Management**: The API supports scheduling new test runs and canceling existing ones, providing flexibility in managing test execution according to dynamic testing requirements or conditions. | ||
|
|
||
| - **Integration Friendly**: The REST API's standard interface ensures it can be easily integrated with external tools and systems, enhancing Assertoor's utility in automated testing environments. | ||
|
|
||
| ### Accessing the API Documentation: | ||
|
|
||
| The detailed API documentation, including all supported endpoints, request formats, and response structures, is accessible via the Assertoor web UI. This comprehensive documentation is designed to be user-friendly, offering examples and explanations to facilitate easy adoption and integration of the API into your workflows. | ||
|
|
||
| To access the API documentation, ensure the Assertoor web interface is enabled and navigate to the designated URL. The documentation provides interactive examples and the ability to test endpoints directly from your browser, offering a hands-on approach to learning and utilizing the REST API. | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,71 @@ | ||
| # Test Configuration | ||
|
|
||
| Assertoor allows you to set up tests to check various aspects of the Ethereum network. You can organize these tests in two ways: directly within your main configuration file or through external files for more complex scenarios. Here’s how it works: | ||
|
|
||
| ## Local Tests | ||
|
|
||
| Local tests are defined in your main Assertoor configuration file. You can list tasks that you want to run as part of your test, along with any cleanup tasks to run afterward, regardless of whether your test passes or fails. | ||
|
|
||
| ```yaml | ||
| - id: "test1" | ||
| name: "Test with local tasks" | ||
| timeout: "48h" | ||
| config: {} | ||
| tasks: [] | ||
| cleanupTasks: [] | ||
| schedule: | ||
| startup: true | ||
| cron: | ||
| - "* * * * *" | ||
| ``` | ||
| - **`id`**:\ | ||
| A unique identifier for your test. | ||
| - **`name`**:\ | ||
| The test's name. | ||
| - **`timeout`**:\ | ||
| How long to run the test before stopping it. This is optional. | ||
| - **`config`**:\ | ||
| A place to set static variables for your test. Optional. | ||
| - **`tasks`**:\ | ||
| The tasks to run for your test. | ||
| - **`cleanupTasks`**:\ | ||
| Tasks that clean up after your main tasks. These run no matter if the main tasks pass or fail. This is optional. | ||
| - **`schedule`**:\ | ||
| Determines when your test runs. You can set it to start when Assertoor starts or on a schedule using cron format. This is optional. | ||
|
|
||
| ## External Tests | ||
|
|
||
| External test playbooks, loaded via the `file` attribute in the Assertoor configuration, follow a structured format. These playbooks allow for defining comprehensive tests with specific tasks, variable configurations, and scheduling options. | ||
|
|
||
| **Example External Test Playbook:** | ||
|
|
||
| ```yaml | ||
| id: test1 | ||
| name: "Test 1" | ||
| timeout: 1h | ||
| config: | ||
| # walletPrivkey: "" | ||
| # validatorPairNames: [] | ||
| configVars: {} | ||
| tasks: [] | ||
| cleanupTasks: [] | ||
| schedule: | ||
| startup: true | ||
| cron: | ||
| - "* * * * *" | ||
| ``` | ||
|
|
||
| **Key Properties Explained:** | ||
|
|
||
| - **`id`**: A unique identifier for the test, allowing for easy reference. | ||
| - **`name`**: The descriptive name of the test, providing clarity on its purpose. | ||
| - **`timeout`**: Specifies the duration after which the test should be considered failed if not completed. | ||
| - **`config`**: Static variable configuration, where you can define variables directly used by the test. | ||
| - **`configVars`**: Dynamic variable configuration that copies variables from the global scope, supporting complex expressions through jq syntax. | ||
| - **`tasks`**: The list of tasks to be executed as part of the test. Refer to the task configuration section for detailed task structures. | ||
| - **`cleanupTasks`**: Specifies tasks to be executed after the main tasks, regardless of their success or failure. | ||
| - **`schedule`**: Determines when the test should be run. If omitted, the test is scheduled to start upon Assertoor startup. It also supports cron expressions for more precise scheduling. | ||
|
|
||
| This format provides a flexible and powerful way to define tests outside the main configuration file, allowing for modular test management and reusability across different scenarios or environments. | ||
|
|
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.