Documentation: Add link to types-icalendar

[niccokunzmann]

This project adds the typing information for icalendar:
https://pypi.org/project/types-icalendar/

I think, we should document this in the installation section or related work if people are interested.

• link to project
• describe its purpose

[stevepiercy]

This option of supporting types in a separate repo has the most overhead. How do you test the types? How do you keep them in sync with the icalendar repo? How do you synch releases between the the two repos?

Did you consider shipping the stub files with the icalendar distribution?

Refs:

• https://typing.readthedocs.io/en/latest/index.html
• https://peps.python.org/pep-0526/ (history)

[niccokunzmann]

Your idea is nice. However it takes work, so the proposed change helps for now and if someone wants to take on your idea, it can be implemented! ❤️

[stevepiercy]

Oops, I omitted an important clause. I meant to say "This option of supporting types in a separate repo has the most overhead.

Anyway, there is a good discussion about the various options in the Python Typing docs. If you choose to use stub files, I don't see how keeping them in the same repo takes more work than in a separate repo. The latter sounds like more work to me.

• How to provide type annotations?
• In Distributing type information:
  • Stub files
  • Type information in libraries