Script annotations for input Parameters

[dejamiko]

Pull Request Checklist

• Fixes Support annotations for input parameters for script #705
• Tests added
• Documentation/examples added
• Good commit messages and/or PR title

Description of PR
This PR adds some basic support for annotations for script. We can avoid duplication of parameter names and default values. See the old version

@script(
    inputs=[
        Parameter(name="an_int", description="an_int parameter", default=1, enum=[1, 2, 3]), 
        Parameter(name="a_bool", description="a_bool parameter", default=True, enum=[True, False]), 
        Parameter(name="a_string", description="a_string parameter", default="a", enum=["a", "b", "c"])
    ]
)
def echo_all(an_int=1, a_bool=True, a_string="a"):
    print(an_int)
    print(a_bool)
    print(a_string)

vs the new one:

@script()
def echo_all(
    an_int: Annotated[int, Parameter(description="an_int parameter", default=1, enum=[1, 2, 3])], 
    a_bool: Annotated[bool, Parameter(description="a_bool parameter", default=True, enum=[True, False])], 
    a_string: Annotated[str, Parameter(description="a_string parameter", default="a", enum=["a", "b", "c"])]
):
    print(an_int)
    print(a_bool)
    print(a_string)

We also allow for renaming parameters, using YAML rules for naming

@script()
def echo(
    a_name: Annotated[str, Parameter(name="another-name")],
):
    print(a_name)

kebab-case support for runner

Since we now allow for parameters to have a new name and the naming rules come from YAML, we allow kebab-case names for parameters which could be used in a script runner. A mapping of kwargs was created that maps the parameter name from annotations to the one found in the python function signature.

@script()
def function_kebab(
    a_but_kebab: Annotated[int, Parameter(name="a-but-kebab")] = 2,
    b_but_kebab: Annotated[str, Parameter(name="b-but-kebab")] = "foo",
) -> Output:
    return Output(output=[Input(a=a_but_kebab, b=b_but_kebab)])

[codecov]

Codecov Report

Merging #708 (7b8c495) into main (c7374e7) will increase coverage by 0.2%.
The diff coverage is 93.7%.

@@           Coverage Diff           @@
##            main    #708     +/-   ##
=======================================
+ Coverage   77.4%   77.7%   +0.2%     
=======================================
  Files         45      45             
  Lines       3346    3386     +40     
  Branches     639     649     +10     
=======================================
+ Hits        2592    2632     +40     
+ Misses       576     573      -3     
- Partials     178     181      +3     

Impacted Files	Coverage Δ
src/hera/workflows/runner.py	74.0% <87.5%> (+5.8%)	⬆️
src/hera/workflows/script.py	89.5% <96.0%> (+0.5%)	⬆️
src/hera/workflows/parameter.py	86.4% <100.0%> (+6.4%)	⬆️

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[elliotgunton]

Two small comments! Looking good 💯

[elliotgunton]

We need to add the old behaviour back in but otherwise LGTM!

[elliotgunton]

More docs, slight change on env var then LGTM!