Add type hint to allure.step parameters (fixes #828)

[darsor]

Context

Current versions of Pyright flag errors on functions decorated with @allure.step, as reported in #828. Adding type hints to allure.step fixes this issue.

Tests pass on Python 3.7 and Python 3.13.

Checklist

• Sign Allure CLA
• Provide unit tests

[CLAassistant]

All committers have signed the CLA.

[kamikaze]

it seems something is wrong withing CI build pipeline, not the PR. could please someone take a look? this PR might help a lot of people :)

[delatrie]

Hi, @darsor ! Thank you for contributing in allure-python!

Let's better use @typing.overload:

@overload
def step(title: str) -> StepContext:
    ...

@overload
def step(title: _TFunc) -> _TFunc:
    ...

This will require moving StepContext above step.

And it also makes sense to disable type checking when returning the wrapper in StepContext.__call__ for those of us who enable pyright when working on the repo :)

return impl # type: ignore

[delatrie]

Turns out #830 implements this in a more correct way.
I'm closing this PR as a duplicate then.