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

Comece pelo ponto de entrada ipaddress.collapse_addresses() e pelos testes dedicados existentes mencionados no relatório. Revise o PR vinculado gh-149723 antes de alterar o comportamento. O trabalho estará concluído quando os endereços IP compatíveis estiverem documentados, for decidido como as interfaces IP serão tratadas, TypeError for gerado consistentemente para entradas inválidas e forem adicionados testes para casos extremos.