Enhancement: Add Type Hints and Type Checks for Better Developer Experience

[anuragsinghbhandari]

Hi Sumy maintainers 👋,

First off, thank you for maintaining this project it's been super helpful for building quick and efficient extractive summarization tools.

I’d like to suggest adding type hints and possibly integrating type checking across the codebase.

💡 Why This Matters

• Type hints improve code readability and documentation.
• Type checking helps catch bugs early during development.
• It makes the project more developer-friendly and encourages community contributions from those using modern Python tooling.

🔧 Example

def summarize(text: str, sentence_count: int = 3) -> List[str]:

[anuragsinghbhandari]

Would you be open to a PR for gradually adding type annotations to the main modules (e.g., summarizers, parsers, etc.)?

Happy to help if you're interested in exploring this!

Best,
@anuragsinghbhandari

[miso-belica]

Hello, thank you for the suggestion. If you are willing to integrate types without changing the logic or breaking backward compatibility gradually it would be great. Maybe there is even tool for it? To type it by inference. For example https://pyrefly.org/ or https://github.com/astral-sh/ty? Since types were introduced I was not using Python heavily in any project so I can't tell any opinion but I would still like to keep duck typing a possibility. Too strict types often goes in a way.

[anuragsinghbhandari]

Got it! I’ll just add type hints for better readability and editor support, without enforcing any strict type checking or changing the logic. Will keep it non-intrusive and backward-compatible.
This would solve the readibilty issue.