Add hints for parameters and return values! about toponetx

[ffl096]

(or maybe flake8 has a type checking plugin, I don't have a strong preference for a specific tool, just type checking in general)

flake8 doesn't do much on its own, it delegates the heavy work to other existing tools. There is a plugin for mypy as well, but I think it's better to use mypy directly. That one really only exists as a workaround for editors that have integrated flake8 support but no integration for mypy.

[ffl096]

I personally always use type annotations in my code, as it generally improves IDE support (suggestions, errors).

[mhajij]

what is your recommendation ?

[mhajij]

ok then, I will start addressing this issue then.

[josefhoppe]

I agree. In the medium term, I think we should also add mypy to the linters as it can easily detect some type errors (I just ran it manually and it found two mistakes that can be easily overlooked by humans, even with the limited type hinting currently present in the codebase)

[josefhoppe]

(or maybe flake8 has a type checking plugin, I don't have a strong preference for a specific tool, just type checking in general)

[michaelschaub]

It appears the discussion has a relatively clear outcome (so I changed the title of the issues). It seems, clear we should do it, but it is not a top-priority right now. However, we should probably add this as requirement for new commits.

[ninamiolane]

@ffl096 do you have updates on this? Should we close it?

[ffl096]

This is an ongoing effort and will be automatically closed once #163 is merged. The remaining issues are non-trivial and will take more time.

[ninamiolane]

@ffl096 when will you expect this to be completed?

[USFCA-MSDS]

@ffl096 should we close this task ?

[ffl096]

See #163.