Move example_dags in standard provider to example_dags in sources (apache#51260)

Folow up after apache#51192.

Actually choosing the same approach as for system tests was
pretty wrong and even before attempting to have final solution
for example_dags/system tests we should move the standard examples
out of "tests.system" as rightfully pointed out by Jed in
the apache#51192.

The snippets of code to run the tests as pytests are not neeeded
and they are actually even harmful as they cause import errors
when no tests_common is around

Author: potiuk

airflow-core/docs/tutorial/taskflow.rst

@@ -270,7 +270,7 @@ system-level packages. TaskFlow supports multiple execution environments to isol
 Creates a temporary virtualenv at task runtime. Great for experimental or dynamic tasks, but may have cold start
 overhead.
 
-.. exampleinclude:: /../../providers/standard/tests/system/standard/example_python_decorator.py
+.. exampleinclude:: /../../providers/standard/src/airflow/providers/standard/example_dags//example_python_decorator.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_python_venv]
@@ -284,7 +284,7 @@ overhead.
 
 Executes the task using a pre-installed Python interpreter — ideal for consistent environments or shared virtualenvs.
 
-.. exampleinclude:: /../../providers/standard/tests/system/standard/example_python_decorator.py
+.. exampleinclude:: /../../providers/standard/src/airflow/providers/standard/example_dags//example_python_decorator.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_external_python]
@@ -334,7 +334,7 @@ Using Sensors
 Use ``@task.sensor`` to build lightweight, reusable sensors using Python functions. These support both poke and reschedule
 modes.
 
-.. exampleinclude:: /../../providers/standard/tests/system/standard/example_sensor_decorator.py
+.. exampleinclude:: /../../providers/standard/src/airflow/providers/standard/example_dags//example_sensor_decorator.py
     :language: python
     :start-after: [START tutorial]
     :end-before: [END tutorial]

airflow-core/src/airflow/example_dags/standard

@@ -1 +1 @@
-../../../../providers/standard/tests/system/standard/
+../../../../providers/standard/src/airflow/providers/standard/example_dags

airflow-core/tests/unit/jobs/test_scheduler_job.py

@@ -101,7 +101,16 @@
 ELASTIC_DAG_FILE = os.path.join(PERF_DAGS_FOLDER, "elastic_dag.py")
 
 TEST_DAG_FOLDER = os.environ["AIRFLOW__CORE__DAGS_FOLDER"]
-EXAMPLE_STANDARD_DAGS_FOLDER = AIRFLOW_ROOT_PATH / "providers" / "standard" / "tests" / "system" / "standard"
+EXAMPLE_STANDARD_DAGS_FOLDER = (
+    AIRFLOW_ROOT_PATH
+    / "providers"
+    / "standard"
+    / "src"
+    / "airflow"
+    / "providers"
+    / "standard"
+    / "example_dags"
+)
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 DEFAULT_LOGICAL_DATE = timezone.coerce_datetime(DEFAULT_DATE)
 TRY_NUMBER = 1

devel-common/src/docs/provider_conf.py

@@ -61,7 +61,6 @@
     get_html_theme_options,
     get_intersphinx_mapping,
     get_rst_epilogue,
-    get_rst_filepath_from_path,
 )
 from sphinx_exts.provider_yaml_utils import load_package_data
 
@@ -162,10 +161,10 @@
     *[f"_api/tests/system/{subpackage}/index.rst" for subpackage in empty_subpackages],
 ]
 
-exclude_patterns.extend(
-    get_rst_filepath_from_path(f, AIRFLOW_REPO_ROOT_PATH)
-    for f in BASE_PROVIDER_SRC_PATH.rglob("example_dags")
-)
+# exclude_patterns.extend(
+#     get_rst_filepath_from_path(f, AIRFLOW_REPO_ROOT_PATH)
+#     for f in BASE_PROVIDER_SRC_PATH.rglob("example_dags")
+# )
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["templates"]
@@ -297,7 +296,6 @@
     (
         "*/airflow/__init__.py",
         "*/airflow/providers/__init__.py",
-        "*/example_dags/*",
         "*/providers/__init__.py",
         "*/conf/*",
     )

docs/spelling_wordlist.txt

@@ -1315,6 +1315,7 @@ pluggable
 pluggy
 plyvel
 png
+PoC
 PodManager
 podName
 PodSpec

providers/arangodb/docs/index.rst

@@ -49,13 +49,7 @@
     :maxdepth: 1
     :caption: Resources
 
-    Example DAGs <https://github.com/apache/airflow/tree/providers-arangodb/|version|/airflow/providers/arangodb/example_dags>
-
-.. toctree::
-    :hidden:
-    :maxdepth: 1
-    :caption: Resources
-
+    Example DAGs <_api/airflow/providers/arangodb/example_dags/index>
     PyPI Repository <https://pypi.org/project/apache-airflow-providers-arangodb/>
     Installing from sources <installing-providers-from-sources>
 

providers/edge3/docs/index.rst

@@ -57,7 +57,7 @@
     :maxdepth: 1
     :caption: Resources
 
-    Example DAGs <https://github.com/apache/airflow/tree/providers-edge3/|version|/providers/edge3/src/airflow/providers/edge3/example_dags>
+    Example DAGs <_api/airflow/providers/edge3/example_dags/index>
     PyPI Repository <https://pypi.org/project/apache-airflow-providers-edge3/>
     Installing from sources <installing-providers-from-sources>
 

providers/edge3/src/airflow/providers/edge3/example_dags/win_notepad.py

@@ -41,7 +41,7 @@
 
 
 class NotepadOperator(BaseOperator):
-    """Example Operator Implementation which starts a Notepod.exe on WIndows."""
+    """Example Operator Implementation which starts a ``Notepad.exe`` on Windows."""
 
     template_fields: Sequence[str] = "text"
 

providers/oracle/docs/index.rst

@@ -56,7 +56,7 @@
     :maxdepth: 1
     :caption: Resources
 
-    Example DAGs <https://github.com/apache/airflow/tree/providers-oracle/|version|/airflow/providers/oracle/example_dags>
+    Example DAGs <_api/airflow/providers/oracle/example_dags/index>
     PyPI Repository <https://pypi.org/project/apache-airflow-providers-oracle/>
     Installing from sources <installing-providers-from-sources>
 

providers/standard/docs/index.rst

@@ -38,19 +38,12 @@
     Sensors <sensors/index>
     Configuration <configurations-ref>
 
-.. toctree::
-    :hidden:
-    :maxdepth: 1
-    :caption: System tests
-
-    System Tests <_api/tests/system/standard/index>
-
 .. toctree::
     :hidden:
     :maxdepth: 1
     :caption: Resources
 
-    Example DAGs <https://github.com/apache/airflow/tree/providers-standard/|version|/providers/standard/tests/system/standard>
+    Example DAGs <_api/airflow/providers/standard/example_dags/index>
     PyPI Repository <https://pypi.org/project/apache-airflow-providers-standard/>
     Installing from sources <installing-providers-from-sources>
     Python API <_api/airflow/providers/standard/index>