feat(TaskProcessing): Add trigger_handler to set_handlers()

[marcelklehr]

See nextcloud/app_api#683 for the corresponding AppAPI PR.

Changes proposed in this pull request:

• Add a trigger_handler param to set_handlers() that will be called when the /trigger endpoint is requested by AppAPI.

[Copilot]

Pull Request Overview

This PR adds support for trigger handlers in the FastAPI integration by introducing a new trigger_handler parameter to the set_handlers() function. This enables handling of task processing trigger events from AppAPI.

• Adds trigger_handler parameter to set_handlers() function
• Implements automatic FastAPI endpoint registration for trigger callbacks
• Provides documentation for the new trigger handler functionality

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[oleksandr-nc]

What do you think about passing providerId in the URL path? (e.g. "trigger/{provider_id}")

[marcelklehr]

What do you think about passing providerId in the URL path? (e.g. "trigger/{provider_id}")

Mh, no opnion, either is good for me, I think. What would be the benefit of having it in the URL path?

[oleksandr-nc]

Linters only complains for two things:

1. Too long line(125 symbols): :param trigger_handler: callback which will be called for task processing trigger events with the name of the provider.
2. Snake-case style of variable: providerId

We can fix second option with url path or with adding #pylint ignore or with something like this:

async def trigger_callback(**provider_id: Annotated[str, Body(alias="providerId")]**):

Not sure that this will work for FastAPI for query params - I know that this works for FormMetadata and for JSON inputs well.

I am fine with any type of fix, even with adding pylint ignore.

Other Pylint error that is not related to this PR I already fixed in the main branch

[oleksandr-nc]

🚀

[codecov]

Codecov Report

❌ Patch coverage is 0% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.93%. Comparing base (48c9113) to head (b2c157b).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
nc_py_api/ex_app/integration_fastapi.py	0.00%	10 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #382      +/-   ##
==========================================
- Coverage   95.11%   94.93%   -0.18%     
==========================================
  Files          45       45              
  Lines        5361     5371      +10     
==========================================
  Hits         5099     5099              
- Misses        262      272      +10     

Files with missing lines	Coverage Δ
nc_py_api/ex_app/integration_fastapi.py	23.63% <0.00%> (-1.53%)	⬇️

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.