Astroid 4 breaks docs building

[potiuk]

Astroid 4 does not play well with autoapi-ignore settins.

[rich7420]

I’d like to work on this issue if that’s okay. Could you tell me more details about this issue?

[potiuk]

I’d like to work on this issue if that’s okay. Could you tell me more details about this issue?

The way to reproduce the issue:

1. Go to providers/airbyte dir (for example)
2. run uv sync
3. run uv run --group docs build-docs -> it should build the docs
4. Change "astroid>=3, <4" to "astroid>=4" in devel-common/pyproject.toml
5. run uv sync --group docs --resolution highest --refresh (should install astroid 4)
6. run uv run --group docs build-docs fails because there is missing _api folder or misplaces it or similar

Release notes in astroid might give some clues

############################## Start docs build errors summary ##############################

============================== apache-airflow-providers-airbyte ==============================
------------------------------ Error   1 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/__init__.py

------------------------------ Error   2 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/get_provider_info.py

------------------------------ Error   3 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/hooks/__init__.py

------------------------------ Error   4 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/hooks/airbyte.py

------------------------------ Error   5 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/operators/__init__.py

------------------------------ Error   6 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/operators/airbyte.py

------------------------------ Error   7 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/sensors/__init__.py

------------------------------ Error   8 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/sensors/airbyte.py

------------------------------ Error   9 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/triggers/__init__.py

------------------------------ Error  10 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/triggers/airbyte.py

------------------------------ Error  11 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/src/airflow/providers/airbyte/version_compat.py

------------------------------ Error  12 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/tests/system/airbyte/__init__.py

------------------------------ Error  13 --------------------
WARNING: Unable to read file: /Users/jarekpotiuk/code/airflow/providers/airbyte/tests/system/airbyte/example_airbyte_trigger_job.py

------------------------------ Error  14 --------------------
 WARNING: toctree contains reference to nonexisting document '_api/airflow/providers/airbyte/index'

[potiuk]

@rich7420 We are unassigning you from this issue as part of our updated assignment policy.

This is not meant to discourage your contribution — quite the opposite! You are still very welcome to work on this issue and submit a PR for it. Simply comment that you are working on it and open a PR when ready.

We found that formal assignments were not working well, as they often prevented others from contributing when the assignee was not actively working on the issue.

[rich7420]

@potiuk sorry about that and thanks a lot
I will contribute it again once I'm ready.