README.md

Template Python Operator

Cell-wise mean calculated implemented in Python.

Python operator - Development workflow

• Set up the Tercen Studio development environment
• Create a new git repository based on the template Python operator
• Open VS Code Server by going to: http://127.0.0.1:8443
• Clone this repository into VS Code (using the 'Clone from GitHub' command from the Command Palette for example)
• Load the environment and install core requirements by running the following commands in the terminal:

source /config/.pyenv/versions/3.9.0/bin/activate
pip install -r requirements.txt

• Develop your operator. Note that you can interact with an existing data step by specifying arguments to the TercenContext function:

tercenCtx = ctx.TercenContext()

tercenCtx = ctx.TercenContext(
    workflowId="YOUR_WORKFLOW_ID",
    stepId="YOUR_STEP_ID",
    username="admin", # if using the local Tercen instance
    password="admin", # if using the local Tercen instance
    serviceUri = "http://tercen:5400/" # if using the local Tercen instance 
)

• Generate requirements

python3 -m tercen.util.requirements . > requirements.txt

• Push your changes to GitHub: triggers CI GH workflow
• Tag the repository: triggers Release GH workflow
• Go to tercen and install your operator

Helpful Commands

Install Tercen Python Client

python3 -m pip install --force git+https://github.com/tercen/[email protected]

Wheel

Though not strictly mandatory, many packages require it.

python3 -m pip install wheel