Intersphinx Inventory broken as of 1.26.81

[potiuk]

Describe the issue

Seems that as of 1.26.81 release of boto, intersphinx inventory is broken.

The inventory (https://boto3.amazonaws.com/v1/documentation/api/latest/objects.inv) has gotten significantly bigger as of 1.26.81 and it does not contain many of the methods that were there before:

You can see airflow documentation builds failing for example here:

https://github.com/apache/airflow/actions/runs/4308610594/jobs/7515244502

The above build shows 155 missing symbols.

This is clearly visible in the sizes of the inventories that jumped from 130 K to 175 K (downloaded by replacing latest by specific versions):

⌁ [jarek:~/Downloads] [airflow-3.9] % ls -la objects*
-rw-r--r--@ 1 jarek  staff  130677 Mar  2 08:19 objects_1.26.80.inv
-rw-r--r--@ 1 jarek  staff  175114 Mar  2 08:18 objects_1.26.81.inv
-rw-r--r--@ 1 jarek  staff  175114 Mar  2 08:16 objects_1.26.82.inv

The lack of methods can be seen using sphobjinv tool (example missing method: STS.Client.get_caller_identity) - and you can see that despite bigger size, there are far less number of objects in the inventory:

⌁ [jarek:~/code/airflow/docs/_inventory_cache/boto3] [airflow-3.9] main+ 17s 130 ± sphobjinv su ~/Downloads/objects_1.26.80.inv  STS.Client.get_caller_identity

------------------------------------------------------------------------------------------------------------------------

Cannot infer intersphinx_mapping from a local objects.inv.

------------------------------------------------------------------------------------------------------------------------

Project: Boto3 Docs
Version: 1.26.80

21245 objects in inventory.

------------------------------------------------------------------------------------------------------------------------

1 result found at/above current threshold of 75.

:py:method:`STS.Client.get_caller_identity`

Compare with:

⌁75% [jarek:~/code/airflow/docs/_inventory_cache/boto3] [airflow-3.9] main+ 17s ± sphobjinv su ~/Downloads/objects_1.26.81.inv  STS.Client.get_caller_identity

------------------------------------------------------------------------------------------------------------------------

Cannot infer intersphinx_mapping from a local objects.inv.

------------------------------------------------------------------------------------------------------------------------

Project: Boto3 Docs
Version: 1.26.81

15791 objects in inventory.

------------------------------------------------------------------------------------------------------------------------

No results found with score at/above current threshold of 75.

Exiting...

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/objects.inv

[potiuk]

Updated version to be correct (1.26 instead of 2.26)

[tim-finnigan]

Thanks @potiuk for reporting this issue. The boto3 team has created the following PRs to address this:

• Sphinx domain fix botocore#2880
• Updated signatures to support sphinx domain #3615

[potiuk]

Thanks @potiuk for reporting this issue. The boto3 team has created the following PRs to address this:

• Sphinx domain fix botocore#2880
• Updated signatures to support sphinx domain #3615

Cool. Thanks for notifying ! I will subscribe to those issues and I am happy to help with testing once this issue is addressed.

[potiuk]

Confirm the problem is fixed. Thanks!