The Utilities plugin is used to store common utility functions used by various plugins/workflows.
Where each step of the plugin corresponds to a different utility functionality. Refer to individual step functions in arcaflow_plugin_utilities.py
to see what input is expected for each step.
In order to run the utilities plugin run the following steps:
- Clone this repository
- Create the container with
docker build -t arca-utilities -f Dockerfile
- Run
cat example.yaml | docker run -i arca-utilities -f -
to run the plugin
- Clone this repository
- Create a
venv
in the current directory withpython3 -m venv $(pwd)/venv
- Activate the
venv
by runningsource venv/bin/activate
- Run
pip install poetry
- Run
poetry install
- Run
arcaflow_plugin_utilities/arcaflow_plugin_utilities.py -f example.yaml
to run the plugin
You can change this plugin's image version tag in
.github/workflows/carpenter.yaml
by editing the
IMAGE_TAG
variable, and pushing that change to the
branch designated in that workflow.
Generates a random timestamp in ISO 8601 format with millisecond accuracy
Type: | scope | ||||
---|---|---|---|---|---|
Root object: | InputParams | ||||
Properties | |||||
ObjectsInputParams (
|
Type: | object |
---|---|
Properties |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | ErrorOutput | ||||||||||||
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Objects
ErrorOutput (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | SuccessOutputTimestamp | ||||||||||||
Properties | timestamp (
|
Name: | timestamp |
---|---|
Description: | An ISO 8601 timestamp with millisecond precision |
Required: | Yes |
Type: | string |
Objects
SuccessOutputTimestamp (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | timestamp (
|
Name: | timestamp |
---|---|
Description: | An ISO 8601 timestamp with millisecond precision |
Required: | Yes |
Type: | string |
Generates a random UUID which can be used for tracking uniqueness
Type: | scope | ||||
---|---|---|---|---|---|
Root object: | InputParams | ||||
Properties | |||||
ObjectsInputParams (
|
Type: | object |
---|---|
Properties |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | ErrorOutput | ||||||||||||
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Objects
ErrorOutput (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | SuccessOutputUUID | ||||||||||||
Properties | uuid (
|
Name: | UUID |
---|---|
Description: | A randomly generated UUID |
Required: | Yes |
Type: | string |
Objects
SuccessOutputUUID (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | uuid (
|
Name: | UUID |
---|---|
Description: | A randomly generated UUID |
Required: | Yes |
Type: | string |
Wait for specified milliseconds
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | WaitInput | ||||||||||||
Properties | wait_time_ms (
|
Name: | Wait time |
---|---|
Description: | How long to wait in milliseconds |
Required: | Yes |
Type: | int |
Objects
WaitInput (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | wait_time_ms (
|
Name: | Wait time |
---|---|
Description: | How long to wait in milliseconds |
Required: | Yes |
Type: | int |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | ErrorOutput | ||||||||||||
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Objects
ErrorOutput (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | error (
|
Name: | Failure Error |
---|---|
Description: | Reason for failure |
Required: | Yes |
Type: | string |
Type: | scope | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Root object: | SuccessOutputWait | ||||||||||||
Properties | waited_ms (
|
Name: | waited |
---|---|
Description: | Confirmation of milliseconds waited |
Required: | Yes |
Type: | float |
Objects
SuccessOutputWait (object
)
Type: | object | ||||||||
---|---|---|---|---|---|---|---|---|---|
Properties | waited_ms (
|
Name: | waited |
---|---|
Description: | Confirmation of milliseconds waited |
Required: | Yes |
Type: | float |