Issues in ipaddress.collapse_addresses()

Bug report

The following issues was discovered during reviewing #141842:

• ipaddress.collapse_addresses() supports not only IP networks, but also IP addresses and a mix of them. There are dedicated tests, but this is not documented.
• ipaddress.collapse_addresses() contains code for supporting also IP interfaces, but it always was broken (it would work if interfaces were not subclasses of addresses). The test for mix of IP addresses and IP interfaces is mislabeled (it says a mix of addresses and networks) and partially commented out (it only tests addresses now, which is mostly a duplicate of other test).
• While TypeError is raised immediately for IP addresses of different versions and IP networks of different versions, it is delayed until the start of iteration for a mix of IP addresses and IP networks with addresses and networks having different versions.
• For objects other that IP objects you can get AttributeError instead of TypeError.

My plan for a fix:

• Document support of IP addresses.
• Explicitly forbid IP interfaces.
• Always raise TypeError for invalid types (the code is simpler this way).
• Add tests for corner cases.

For new version only:

• Implement support of IP interfaces and document it as a new feature.
• Either raise TypeError immediately for IP objects of different versions, or remove redundant explicit checks, they will be raised implicitly in comparisons.

Linked PRs

• gh-149723

Comienza con el punto de entrada ipaddress.collapse_addresses() y las pruebas específicas existentes mencionadas en el informe. Revisa el PR vinculado gh-149723 antes de cambiar el comportamiento. Se considera terminado documentar las direcciones IP compatibles, decidir cómo se manejan las interfaces IP, generar TypeError de forma coherente para las entradas no válidas y añadir pruebas para casos límite.