[airflow] 12/12: Limit astroid version to < 2.12 (#24982)

[potiuk]

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch v2-3-test
in repository https://gitbox.apache.org/repos/asf/airflow.git

commit 06e4976aaf3236d06b7e6ec85a796f82718ddfcd
Author: Jarek Potiuk <jarek.pot...@polidea.com>
AuthorDate: Tue Jul 12 02:32:41 2022 +0200

    Limit astroid version to < 2.12 (#24982)
    
    Astroid 2.12 released 9th of July breaks documentation building
    with sphinx-autoapi.
    
    Issue about it has been opened in
    https://github.com/PyCQA/astroid/issues/1708
    
    Until it is fixed, we should limit astroid.
    
    (cherry picked from commit ee564ef9e57707ef07db1c3353a1406e47d8e3db)
---
 docs/apache-airflow-providers-github/index.rst | 7 +++++++
 setup.py                                       | 5 +++++
 2 files changed, 12 insertions(+)

diff --git a/docs/apache-airflow-providers-github/index.rst 
b/docs/apache-airflow-providers-github/index.rst
index 3f3d7d5478..abd5d901d3 100644
--- a/docs/apache-airflow-providers-github/index.rst
+++ b/docs/apache-airflow-providers-github/index.rst
@@ -60,6 +60,13 @@ Content
 
     Detailed list of commits <commits>
 
+.. toctree::
+    :hidden:
+    :caption: System tests
+
+    System Tests <_api/tests/system/providers/github/index>
+
+
 .. THE REMAINDER OF THE FILE IS AUTOMATICALLY GENERATED. IT WILL BE 
OVERWRITTEN AT RELEASE TIME!
 
 
diff --git a/setup.py b/setup.py
index 3eb2673042..0c31292513 100644
--- a/setup.py
+++ b/setup.py
@@ -24,6 +24,7 @@ import sys
 import unittest
 from copy import deepcopy
 from os.path import dirname, relpath
+from pathlib import Path
 from textwrap import wrap
 from typing import Dict, List
 
@@ -46,6 +47,7 @@ logger = logging.getLogger(__name__)
 
 version = '2.3.3'
 
+AIRFLOW_SOURCES_ROOT = Path(__file__).parent.resolve()
 my_dir = dirname(__file__)
 
 
@@ -278,6 +280,9 @@ deprecated_api = [
     'requests>=2.26.0',
 ]
 doc = [
+    # Astroid 2.12.* breaks documentation building
+    # We can remove the limit here after 
https://github.com/PyCQA/astroid/issues/1708 is solved
+    'astroid<2.12.0',
     'click>=8.0',
     'sphinx>=4.4.0',
     # Docutils 0.17.0 converts generated <div class="section"> into <section> 
and breaks our doc formatting