v5.21.0

⭐️ Enhancements

• Allow artifact optional names (#1405) @elliotgunton
• Add custom Artifact serialisation (#1367) @elliotgunton
• Add custom Parameter serialisation (#1366) @elliotgunton

📔 Documentation

• Improve API Reference pages (#1415) @elliotgunton
• Add Best Practices user guide (#1401) @elliotgunton
• Update experimental examples (#1411) @elliotgunton
• Update loops examples and sidebar layout (#1410) @elliotgunton
• Update steps examples (#1409) @elliotgunton
• Update dag examples (#1407) @elliotgunton
• Update script and artifact examples (#1406) @elliotgunton
• Update user guides (#1399) @elliotgunton
• Update walkthrough (second half) (#1393) @elliotgunton
• Revamp walkthrough (roughly halfway) (#1386) @elliotgunton
• Use a readiness_probe on daemon example (#1392) @elliotgunton
• Streamline quick start guide (#1383) @elliotgunton
• YAML code converter HEP (#1374) @elliotgunton
• Add custom serialisation sections to script annotations guide (#1368) @elliotgunton
• Add upstream scripts-python example (#1372) @elliotgunton
• Add 2025 developer survey blog post (#1362) @elliotgunton
• Add Sebastian's talk from ArgoCon EU 2025 (#1357) @elliotgunton
• Add a recursive dag example (#1351) @elliotgunton

⛏ Dependency Upgrades

• Update all deps (#1423) @elliotgunton
• Bump urllib3 from 2.4.0 to 2.5.0 (#1424) @dependabot[bot]
• Bump the patches group across 1 directory with 4 updates (#1417) @dependabot[bot]
• Bump cappa from 0.26.6 to 0.27.2 (#1364) @dependabot[bot]
• Run poetry update (#1380) @elliotgunton
• Update deps and examples (#1363) @elliotgunton

v5.20.1

🐞 Bug Fixes

• Fix from_model method in Parameter class (#1336) @elliotgunton
• Fix edge case for model parameter conversion (#1337) @elliotgunton

📔 Documentation

• Create new docs homepage (#1343) @elliotgunton

🚧 Tasks

• Refactor runner utils for clarity (#1339) @elliotgunton

⛏ Dependency Upgrades

• Bump types-requests from 2.32.0.20250301 to 2.32.0.20250306 (#1342) @dependabot[bot]
• Bump the patches group with 2 updates (#1341) @dependabot[bot]
• Bump jinja2 from 3.1.5 to 3.1.6 (#1340) @dependabot[bot]

v5.20.0

⭐️ Enhancements

• Add human readable yaml ordering (#1326) @elliotgunton @jaseemabid
• Allow Artifacts in argument dictionaries (#1322) @elliotgunton

🐞 Bug Fixes

• Fix with_items handling for scripts (#1332) @elliotgunton
• Allow Parameter defaults in WorkflowTemplate arguments (#1323) @elliotgunton

📔 Documentation

• Update upstream examples collection (#1329) @elliotgunton
• Fix map function used in split and reduce steps (#1309) @yorickdevries

⛏ Dependency Upgrades

• Bump types-requests from 2.32.0.20241016 to 2.32.0.20250301 (#1331) @dependabot[bot]
• Bump the patches group with 2 updates (#1330) @dependabot[bot]
• Bump the patches group across 1 directory with 3 updates (#1319) @dependabot[bot]
• Bump types-pyyaml from 6.0.12.20240917 to 6.0.12.20241230 (#1304) @dependabot[bot]
• Bump cappa from 0.26.1 to 0.26.4 in the patches group (#1303) @dependabot[bot]
• Bump varname from 0.13.5 to 0.14.0 (#1305) @dependabot[bot]
• Bump ruff from 0.8.2 to 0.9.2 (#1306) @dependabot[bot]

v5.19.0

ℹ️ Information

• Fix compatibility with Argo Workflows 3.6 (#1293) @elliotgunton

⭐️ Enhancements

• Add get_artifact for template invocator use (#1284) @elliotgunton
• Graduate script annotations (#1287) @elliotgunton

📔 Documentation

• Update walk through and user guides (#1288) @elliotgunton

⛏ Dependency Upgrades

• Bump jinja2 from 3.1.4 to 3.1.5 (#1300) @dependabot
• Bump the patches group across 1 directory with 2 updates (#1302) @dependabot
• Bump cappa from 0.25.1 to 0.26.0 (#1291) @dependabot
• Bump the patches group with 3 updates (#1290) @dependabot

v5.18.0

ℹ️ Information

• Remove error override for default usage in Parameter annotations (#1278) @elliotgunton

⭐️ Enhancements

• Support Literal types in script runner (#1249) @alicederyn

🐞 Bug Fixes

• Fix issues with with_param (#1236) @alicederyn
• Fix deserialization for str unions (#1239) @alicederyn

📔 Documentation

• Add ArgoCon NA24 talk (#1265) @elliotgunton
• Add missing volume claim to user-container example (#1242) @jeongukjae

⛏ Dependency Upgrades

• Bump pydantic from 2.9.2 to 2.10.1 (#1277) @dependabot
• Bump ruff from 0.7.4 to 0.8.0 (#1276) @dependabot
• Bump cappa from 0.24.1 to 0.25.1 (#1274) @dependabot
• Bump codecov/codecov-action from 4 to 5 (#1272) @dependabot
• Bump ruff from 0.7.3 to 0.7.4 in the patches group (#1269) @dependabot
• Bump the patches group with 2 updates (#1263) @dependabot
• Bump ruff from 0.7.1 to 0.7.2 in the patches group (#1255) @dependabot
• Bump pytest-cov from 5.0.0 to 6.0.0 (#1256) @dependabot
• Bump cappa from 0.23.0 to 0.24.0 (#1251) @dependabot
• Bump ruff from 0.7.0 to 0.7.1 in the patches group (#1250) @dependabot
• Bump ruff from 0.6.9 to 0.7.0 (#1246) @dependabot
• Bump types-requests from 2.32.0.20240914 to 2.32.0.20241016 (#1247) @dependabot
• Bump jsonpath-ng from 1.6.1 to 1.7.0 (#1237) @dependabot
• Add Python 3.13 support (#1232) @elliotgunton
• Bump build from 1.2.2 to 1.2.2.post1 (#1231) @dependabot
• Bump cappa from 0.22.5 to 0.23.0 (#1230) @dependabot
• Bump ruff from 0.6.8 to 0.6.9 in the patches group (#1229) @dependabot

🚧 Tasks

• Fix some argo lint errors in examples folder (#1244) @jeongukjae

v5.17.1

🐞 Bug Fixes

• Fix TypeError in script.py for functions returning non-types (#1224) @alicederyn
• Fix various bugs in dag/steps decorator (#1221) @elliotgunton

📔 Documentation

• Add Hera data science blog to README (#1226) @elliotgunton
• Update contributing installation guide (#1225) @elliotgunton
• Refresh examples and cleanup make targets (#1216) @elliotgunton
• Update dask use case example (#1212) @Joibel

⛏ Dependency Upgrades

• Bump ruff from 0.6.7 to 0.6.8 in the patches group (#1220) @dependabot
• Bump types-pyyaml from 6.0.12.20240808 to 6.0.12.20240917 (#1210) @dependabot
• Bump the patches group with 3 updates (#1209) @dependabot

🚧 Tasks

• Fix unclosed file warning (#1217) @alicederyn
• Disable warnings from model_dump (#1214) @alicederyn
• Remove use of skip_defaults (#1213) @alicederyn
• Fix type annotations on template decorators (#1211) @alicederyn

v5.17.0

ℹ️ Information

• Remove RunnerInput/RunnerOutput types aliases to Input/Output (#1207) @elliotgunton
• Error on Parameter default kwarg usage for input annotations (#1197) @elliotgunton
• Remove Python 3.8 support (#1202) @elliotgunton

⭐️ Enhancements

• Create or use user's Session in WorkflowsService to reuse connections (#1183) @AchilleAsh
• Allow Artifact/Parameter in any position in Annotated metadata (#1168) @jeongukjae

🐞 Bug Fixes

• Fix multiple bugs in Hera Input and Output classes (#1193) @alicederyn
• Support raw tuple output from script functions (#1186) @jeongukjae

📔 Documentation

• Remove references to needing to enable second experimental flag (flags can now supersede) (#1201) @elliotgunton
• General docs tidy ups. Improve Script guides (#1199) @elliotgunton

⛏ Dependency Upgrades

• Bump the patches group with 2 updates (#1204) @dependabot
• Bump types-requests from 2.32.0.20240907 to 2.32.0.20240914 (#1205) @dependabot
• Bump types-requests from 2.32.0.20240712 to 2.32.0.20240907 (#1195) @dependabot
• Bump pydantic from 2.8.2 to 2.9.1 (#1196) @dependabot
• Bump the patches group with 2 updates (#1194) @dependabot
• Bump ruff from 0.6.2 to 0.6.3 in the patches group (#1185) @dependabot

v5.16.3

⭐️ Enhancements

• Use sys.version_info to guard imports (#1177) @alicederyn

🐞 Bug Fixes

• Use overloads in script decorator types (#1180) @alicederyn
• Prefer user signature over Hera-added overloads in @script typing (#1181) @alicederyn
• Update script to handle Optional and Union input parameters (#1160) @jeongukjae
• Refactor init_containers building logic in TemplateMixin (#1157) @shyoon-devops

📔 Documentation

• Add docstrings for ArtifactLoader values (#1179) @elliotgunton
• Fix new container decorator example (#1178) @elliotgunton
• Update upstream examples (#1158) @elliotgunton
• Add missing MD for recursive workflow example (#1154) @alicederyn

⛏ Dependency Upgrades

• Bump ruff from 0.6.1 to 0.6.2 in the patches group (#1175) @dependabot
• Bump ruff from 0.5.7 to 0.6.1 (#1159) @dependabot

v5.16.2

🐞 Bug Fixes

• Disable template name conflict detection (#1153) @alicederyn

📔 Documentation

• Add site_url in mkdocs.yml for broken stylesheet links in 404 page (#1143) @jeongukjae

⛏ Dependency Upgrades

• Bump types-pyyaml from 6.0.12.20240724 to 6.0.12.20240808 (#1150) @dependabot
• Bump the patches group with 3 updates (#1149) @dependabot
• Bump the patches group with 2 updates (#1145) @dependabot
• Bump types-pyyaml from 6.0.12.20240311 to 6.0.12.20240724 (#1141) @dependabot
• Bump the patches group with 2 updates (#1140) @dependabot

v5.16.1

📔 Documentation

• Add docs signposts to install experimental extra for decorators (#1137) @elliotgunton