Comparing types of library public API, compatibility check

[dimaqq]

I'm wondering if there already is a tool that extracts and compares public API (versions) of a library.

Or perhaps I can extract enough data from pyright and use some internal pyright assignability machinery for comparison.

Let's say I have a PR with some feature, I'd analyse the public interface vs. that in the main branch.

I'd expect new feature (strictly backwards-compatible changes) to show up.

I'd want an error and description if a backwards-incompatible change is present.

Are there such tools?

If not, can someone give me some direction to investigate building one?