pyproject.toml

# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.

[build-system]
requires = [
    "GitPython==3.1.44",
    "gitdb==4.0.12",
    "hatchling==1.27.0",
    "packaging==24.2",
    "pathspec==0.12.1",
    "pluggy==1.5.0",
    "smmap==5.0.2",
    "tomli==2.2.1; python_version < '3.11'",
    "trove-classifiers==2025.4.11.15",
]
build-backend = "hatchling.build"

[project]
name = "apache-airflow"
description = "Programmatically author, schedule and monitor data pipelines"
readme = { file = "generated/PYPI_README.md", content-type = "text/markdown" }
license-files.globs = ["LICENSE"]
requires-python = "~=3.9,<3.13"
authors = [
    { name = "Apache Software Foundation", email = "[email protected]" },
]
maintainers = [
    { name = "Apache Software Foundation", email="[email protected]" },
]
keywords = [ "airflow", "orchestration", "workflow", "dag", "pipelines", "automation", "data" ]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Environment :: Console",
    "Environment :: Web Environment",
    "Framework :: Apache Airflow",
    "Intended Audience :: Developers",
    "Intended Audience :: System Administrators",
    "License :: OSI Approved :: Apache Software License",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Topic :: System :: Monitoring",
    "Topic :: System :: Monitoring",
]

# Version is defined in src/airflow/__init__.py and it is automatically synchronized by pre-commit
version = "3.1.0"

dependencies = [
    "apache-airflow-task-sdk<1.2.0,>=1.0.0",
    "apache-airflow-core==3.1.0",
]

packages = []

[project.optional-dependencies]
# Automatically generated airflow optional dependencies
"aiobotocore" = [
    "apache-airflow-core[aiobotocore]"
]
"all-core" = [
    "apache-airflow-core[all]"
]
"apache-atlas" = [
    "apache-airflow-core[apache-atlas]"
]
"apache-webhdfs" = [
    "apache-airflow-core[apache-webhdfs]"
]
"async" = [
    "apache-airflow-core[async]"
]
"cloudpickle" = [
    "apache-airflow-core[cloudpickle]"
]
"github-enterprise" = [
    "apache-airflow-core[github-enterprise]"
]
"google-auth" = [
    "apache-airflow-core[google-auth]"
]
"graphviz" = [
    "apache-airflow-core[graphviz]"
]
"kerberos" = [
    "apache-airflow-core[kerberos]"
]
"ldap" = [
    "apache-airflow-core[ldap]"
]
"otel" = [
    "apache-airflow-core[otel]"
]
"pandas" = [
    "apache-airflow-core[pandas]"
]
"rabbitmq" = [
    "apache-airflow-core[rabbitmq]"
]
"s3fs" = [
    "apache-airflow-core[s3fs]"
]
"sentry" = [
    "apache-airflow-core[sentry]"
]
"statsd" = [
    "apache-airflow-core[statsd]"
]
"uv" = [
    "apache-airflow-core[uv]"
]
"airbyte" = [
    "apache-airflow-providers-airbyte>=5.0.0"
]
"alibaba" = [
    "apache-airflow-providers-alibaba>=3.0.0"
]
"amazon" = [
    "apache-airflow-providers-amazon>=9.0.0"
]
"apache.beam" = [
    "apache-airflow-providers-apache-beam>=5.8.1"
]
"apache.cassandra" = [
    "apache-airflow-providers-apache-cassandra>=3.7.0"
]
"apache.drill" = [
    "apache-airflow-providers-apache-drill>=2.8.1"
]
"apache.druid" = [
    "apache-airflow-providers-apache-druid>=3.12.0"
]
"apache.flink" = [
    "apache-airflow-providers-apache-flink>=1.6.0"
]
"apache.hdfs" = [
    "apache-airflow-providers-apache-hdfs>=4.6.0"
]
"apache.hive" = [
    "apache-airflow-providers-apache-hive>=8.2.1"
]
"apache.iceberg" = [
    "apache-airflow-providers-apache-iceberg>=1.2.0"
]
"apache.impala" = [
    "apache-airflow-providers-apache-impala>=1.5.2"
]
"apache.kafka" = [
    "apache-airflow-providers-apache-kafka>=1.6.1"
]
"apache.kylin" = [
    "apache-airflow-providers-apache-kylin>=3.8.0"
]
"apache.livy" = [
    "apache-airflow-providers-apache-livy>=3.9.2"
]
"apache.pig" = [
    "apache-airflow-providers-apache-pig>=4.6.0"
]
"apache.pinot" = [
    "apache-airflow-providers-apache-pinot>=4.5.1"
]
"apache.spark" = [
    "apache-airflow-providers-apache-spark>=4.11.1"
]
"apache.tinkerpop" = [
    "apache-airflow-providers-apache-tinkerpop"
]
"apprise" = [
    "apache-airflow-providers-apprise>=1.4.1"
]
"arangodb" = [
    "apache-airflow-providers-arangodb>=2.7.0"
]
"asana" = [
    "apache-airflow-providers-asana>=2.7.0"
]
"atlassian.jira" = [
    "apache-airflow-providers-atlassian-jira>=2.7.1"
]
"celery" = [
    "apache-airflow-providers-celery>=3.8.3"
]
"cloudant" = [
    "apache-airflow-providers-cloudant>=4.0.1"
]
"cncf.kubernetes" = [
    "apache-airflow-providers-cncf-kubernetes>=9.0.0"
]
"cohere" = [
    "apache-airflow-providers-cohere>=1.4.0"
]
"common.compat" = [
    "apache-airflow-providers-common-compat>=1.2.1"
]
"common.io" = [
    "apache-airflow-providers-common-io>=1.4.2"
]
"common.messaging" = [
    "apache-airflow-providers-common-messaging>=1.0.0"
]
"common.sql" = [
    "apache-airflow-providers-common-sql>=1.18.0"
]
"databricks" = [
    "apache-airflow-providers-databricks>=6.11.0"
]
"datadog" = [
    "apache-airflow-providers-datadog>=3.8.0"
]
"dbt.cloud" = [
    "apache-airflow-providers-dbt-cloud>=3.11.0"
]
"dingding" = [
    "apache-airflow-providers-dingding>=3.7.0"
]
"discord" = [
    "apache-airflow-providers-discord>=3.9.0"
]
"docker" = [
    "apache-airflow-providers-docker>=3.14.1"
]
"edge3" = [
    "apache-airflow-providers-edge3"
]
"elasticsearch" = [
    "apache-airflow-providers-elasticsearch>=5.5.2"
]
"exasol" = [
    "apache-airflow-providers-exasol>=4.6.1"
]
"fab" = [
    "apache-airflow-providers-fab>=2.0.0"
]
"facebook" = [
    "apache-airflow-providers-facebook>=3.7.0"
]
"ftp" = [
    "apache-airflow-providers-ftp>=3.12.0"
]
"git" = [
    "apache-airflow-providers-git>=0.0.1"
]
"github" = [
    "apache-airflow-providers-github>=2.8.0"
]
"google" = [
    "apache-airflow-providers-google>=10.24.0"
]
"grpc" = [
    "apache-airflow-providers-grpc>=3.7.0"
]
"hashicorp" = [
    "apache-airflow-providers-hashicorp>=4.0.0"
]
"http" = [
    "apache-airflow-providers-http>=4.13.2"
]
"imap" = [
    "apache-airflow-providers-imap>=3.8.0"
]
"influxdb" = [
    "apache-airflow-providers-influxdb>=2.8.0"
]
"jdbc" = [
    "apache-airflow-providers-jdbc>=4.5.2"
]
"jenkins" = [
    "apache-airflow-providers-jenkins>=3.7.2"
]
"microsoft.azure" = [
    "apache-airflow-providers-microsoft-azure>=10.5.1"
]
"microsoft.mssql" = [
    "apache-airflow-providers-microsoft-mssql>=3.9.2"
]
"microsoft.psrp" = [
    "apache-airflow-providers-microsoft-psrp>=3.0.0"
]
"microsoft.winrm" = [
    "apache-airflow-providers-microsoft-winrm>=3.6.1"
]
"mongo" = [
    "apache-airflow-providers-mongo>=4.2.2"
]
"mysql" = [
    "apache-airflow-providers-mysql>=5.7.2"
]
"neo4j" = [
    "apache-airflow-providers-neo4j>=3.8.0"
]
"odbc" = [
    "apache-airflow-providers-odbc>=4.8.0"
]
"openai" = [
    "apache-airflow-providers-openai>=1.5.0"
]
"openfaas" = [
    "apache-airflow-providers-openfaas>=3.7.0"
]
"openlineage" = [
    "apache-airflow-providers-openlineage>=2.1.3"
]
"opensearch" = [
    "apache-airflow-providers-opensearch>=1.5.0"
]
"opsgenie" = [
    "apache-airflow-providers-opsgenie>=5.8.0"
]
"oracle" = [
    "apache-airflow-providers-oracle>=3.12.0"
]
"pagerduty" = [
    "apache-airflow-providers-pagerduty>=3.8.1"
]
"papermill" = [
    "apache-airflow-providers-papermill>=3.8.2"
]
"pgvector" = [
    "apache-airflow-providers-pgvector>=1.4.0"
]
"pinecone" = [
    "apache-airflow-providers-pinecone>=2.1.1"
]
"postgres" = [
    "apache-airflow-providers-postgres>=5.13.1"
]
"presto" = [
    "apache-airflow-providers-presto>=5.7.0"
]
"qdrant" = [
    "apache-airflow-providers-qdrant>=1.3.0"
]
"redis" = [
    "apache-airflow-providers-redis>=4.0.0"
]
"salesforce" = [
    "apache-airflow-providers-salesforce>=5.9.0"
]
"samba" = [
    "apache-airflow-providers-samba>=4.9.0"
]
"segment" = [
    "apache-airflow-providers-segment>=3.7.0"
]
"sendgrid" = [
    "apache-airflow-providers-sendgrid>=4.0.0"
]
"sftp" = [
    "apache-airflow-providers-sftp>=5.0.0"
]
"singularity" = [
    "apache-airflow-providers-singularity>=3.7.0"
]
"slack" = [
    "apache-airflow-providers-slack>=8.9.1"
]
"smtp" = [
    "apache-airflow-providers-smtp>=1.8.1"
]
"snowflake" = [
    "apache-airflow-providers-snowflake>=5.8.0"
]
"sqlite" = [
    "apache-airflow-providers-sqlite>=3.9.1"
]
"ssh" = [
    "apache-airflow-providers-ssh>=3.14.0"
]
"standard" = [
    "apache-airflow-providers-standard"
]
"tableau" = [
    "apache-airflow-providers-tableau>=5.0.0"
]
"telegram" = [
    "apache-airflow-providers-telegram>=4.7.0"
]
"teradata" = [
    "apache-airflow-providers-teradata>=2.6.1"
]
"trino" = [
    "apache-airflow-providers-trino>=5.8.1"
]
"vertica" = [
    "apache-airflow-providers-vertica>=3.9.1"
]
"weaviate" = [
    "apache-airflow-providers-weaviate>=3.0.0"
]
"yandex" = [
    "apache-airflow-providers-yandex>=4.0.0"
]
"ydb" = [
    "apache-airflow-providers-ydb>=1.4.0"
]
"zendesk" = [
    "apache-airflow-providers-zendesk>=4.9.0"
]
"all" = [
    "apache-airflow-core[all]",
    "apache-airflow-providers-airbyte>=5.0.0",
    "apache-airflow-providers-alibaba>=3.0.0",
    "apache-airflow-providers-amazon>=9.0.0",
    "apache-airflow-providers-apache-beam>=5.8.1",
    "apache-airflow-providers-apache-cassandra>=3.7.0",
    "apache-airflow-providers-apache-drill>=2.8.1",
    "apache-airflow-providers-apache-druid>=3.12.0",
    "apache-airflow-providers-apache-flink>=1.6.0",
    "apache-airflow-providers-apache-hdfs>=4.6.0",
    "apache-airflow-providers-apache-hive>=8.2.1",
    "apache-airflow-providers-apache-iceberg>=1.2.0",
    "apache-airflow-providers-apache-impala>=1.5.2",
    "apache-airflow-providers-apache-kafka>=1.6.1",
    "apache-airflow-providers-apache-kylin>=3.8.0",
    "apache-airflow-providers-apache-livy>=3.9.2",
    "apache-airflow-providers-apache-pig>=4.6.0",
    "apache-airflow-providers-apache-pinot>=4.5.1",
    "apache-airflow-providers-apache-spark>=4.11.1",
    "apache-airflow-providers-apache-tinkerpop",
    "apache-airflow-providers-apprise>=1.4.1",
    "apache-airflow-providers-arangodb>=2.7.0",
    "apache-airflow-providers-asana>=2.7.0",
    "apache-airflow-providers-atlassian-jira>=2.7.1",
    "apache-airflow-providers-celery>=3.8.3",
    "apache-airflow-providers-cloudant>=4.0.1",
    "apache-airflow-providers-cncf-kubernetes>=9.0.0",
    "apache-airflow-providers-cohere>=1.4.0",
    "apache-airflow-providers-common-compat>=1.2.1",
    "apache-airflow-providers-common-io>=1.4.2",
    "apache-airflow-providers-common-messaging>=1.0.0",
    "apache-airflow-providers-common-sql>=1.18.0",
    "apache-airflow-providers-databricks>=6.11.0",
    "apache-airflow-providers-datadog>=3.8.0",
    "apache-airflow-providers-dbt-cloud>=3.11.0",
    "apache-airflow-providers-dingding>=3.7.0",
    "apache-airflow-providers-discord>=3.9.0",
    "apache-airflow-providers-docker>=3.14.1",
    "apache-airflow-providers-edge3",
    "apache-airflow-providers-elasticsearch>=5.5.2",
    "apache-airflow-providers-exasol>=4.6.1",
    "apache-airflow-providers-fab>=2.0.0",
    "apache-airflow-providers-facebook>=3.7.0",
    "apache-airflow-providers-ftp>=3.12.0",
    "apache-airflow-providers-git>=0.0.1",
    "apache-airflow-providers-github>=2.8.0",
    "apache-airflow-providers-google>=10.24.0",
    "apache-airflow-providers-grpc>=3.7.0",
    "apache-airflow-providers-hashicorp>=4.0.0",
    "apache-airflow-providers-http>=4.13.2",
    "apache-airflow-providers-imap>=3.8.0",
    "apache-airflow-providers-influxdb>=2.8.0",
    "apache-airflow-providers-jdbc>=4.5.2",
    "apache-airflow-providers-jenkins>=3.7.2",
    "apache-airflow-providers-microsoft-azure>=10.5.1",
    "apache-airflow-providers-microsoft-mssql>=3.9.2",
    "apache-airflow-providers-microsoft-psrp>=3.0.0",
    "apache-airflow-providers-microsoft-winrm>=3.6.1",
    "apache-airflow-providers-mongo>=4.2.2",
    "apache-airflow-providers-mysql>=5.7.2",
    "apache-airflow-providers-neo4j>=3.8.0",
    "apache-airflow-providers-odbc>=4.8.0",
    "apache-airflow-providers-openai>=1.5.0",
    "apache-airflow-providers-openfaas>=3.7.0",
    "apache-airflow-providers-openlineage>=2.1.3",
    "apache-airflow-providers-opensearch>=1.5.0",
    "apache-airflow-providers-opsgenie>=5.8.0",
    "apache-airflow-providers-oracle>=3.12.0",
    "apache-airflow-providers-pagerduty>=3.8.1",
    "apache-airflow-providers-papermill>=3.8.2",
    "apache-airflow-providers-pgvector>=1.4.0",
    "apache-airflow-providers-pinecone>=2.1.1",
    "apache-airflow-providers-postgres>=5.13.1",
    "apache-airflow-providers-presto>=5.7.0",
    "apache-airflow-providers-qdrant>=1.3.0",
    "apache-airflow-providers-redis>=4.0.0",
    "apache-airflow-providers-salesforce>=5.9.0",
    "apache-airflow-providers-samba>=4.9.0",
    "apache-airflow-providers-segment>=3.7.0",
    "apache-airflow-providers-sendgrid>=4.0.0",
    "apache-airflow-providers-sftp>=5.0.0",
    "apache-airflow-providers-singularity>=3.7.0",
    "apache-airflow-providers-slack>=8.9.1",
    "apache-airflow-providers-smtp>=1.8.1",
    "apache-airflow-providers-snowflake>=5.8.0",
    "apache-airflow-providers-sqlite>=3.9.1",
    "apache-airflow-providers-ssh>=3.14.0",
    "apache-airflow-providers-standard",
    "apache-airflow-providers-tableau>=5.0.0",
    "apache-airflow-providers-telegram>=4.7.0",
    "apache-airflow-providers-teradata>=2.6.1",
    "apache-airflow-providers-trino>=5.8.1",
    "apache-airflow-providers-vertica>=3.9.1",
    "apache-airflow-providers-weaviate>=3.0.0",
    "apache-airflow-providers-yandex>=4.0.0",
    "apache-airflow-providers-ydb>=1.4.0",
    "apache-airflow-providers-zendesk>=4.9.0",
]
# End of automatically generated airflow optional dependencies

[project.urls]
"Bug Tracker" = "https://github.com/apache/airflow/issues"
Documentation = "https://airflow.apache.org/docs/"
Downloads = "https://archive.apache.org/dist/airflow/"
Homepage = "https://airflow.apache.org/"
"Release Notes" = "https://airflow.apache.org/docs/apache-airflow/stable/release_notes.html"
"Slack Chat" = "https://s.apache.org/airflow-slack"
"Source Code" = "https://github.com/apache/airflow"
LinkedIn = "https://www.linkedin.com/company/apache-airflow/"
Mastodon = "https://fosstodon.org/@airflow"
Bluesky = "https://bsky.app/profile/apache-airflow.bsky.social"
YouTube = "https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/"

[tool.hatch.build.targets.sdist]
exclude = ["*"]

[tool.hatch.build.targets.wheel]
bypass-selection = true

## black settings ##
# Used to format code examples inside .rst doc files
# Needed until https://github.com/astral-sh/ruff/issues/8237 is available.
[tool.black]
line-length = 110
target-version = ['py39', 'py310', 'py311', 'py312']

## ruff settings ##
[tool.ruff]
target-version = "py39"
line-length = 110
extend-exclude = [
    ".eggs",
    "*/_vendor/*",
    "airflow-core/tests/unit/dags/test_imports.py",
]

[tool.ruff.lint]
typing-modules = ["airflow.typing_compat"]
extend-select = [
    # Enable entire ruff rule section
    "I", # Missing required import (auto-fixable)
    "UP", # Pyupgrade
    "ASYNC", # subset of flake8-async rules
    "ISC",  # Checks for implicit literal string concatenation (auto-fixable)
    "TC", # Rules around TYPE_CHECKING blocks
    "G", # flake8-logging-format rules
    "LOG", # flake8-logging rules, most of them autofixable
    "PT", # flake8-pytest-style rules
    "TID25", # flake8-tidy-imports rules
    "E", # pycodestyle rules
    "W", # pycodestyle rules
    # Per rule enables
    "RUF006", # Checks for asyncio dangling task
    "RUF015", # Checks for unnecessary iterable allocation for first element
    "RUF019", # Checks for unnecessary key check
    "RUF100", # Unused noqa (auto-fixable)
    # We ignore more pydocstyle than we enable, so be more selective at what we enable
    "D1",
    "D2",
    "D213", # Conflicts with D212.  Both can not be enabled.
    "D3",
    "D400",
    "D401",
    "D402",
    "D403",
    "D412",
    "D419",
    "PGH004",  # Use specific rule codes when using noqa
    "PGH005", # Invalid unittest.mock.Mock methods/attributes/properties
    "S101", # Checks use `assert` outside the test cases, test cases should be added into the exclusions
    "SIM300", # Checks for conditions that position a constant on the left-hand side of the comparison
              # operator, rather than the right-hand side.
    "B004", # Checks for use of hasattr(x, "__call__") and replaces it with callable(x)
    "B006", # Checks for uses of mutable objects as function argument defaults.
    "B007", # Checks for unused variables in the loop
    "B017", # Checks for pytest.raises context managers that catch Exception or BaseException.
    "B019", # Use of functools.lru_cache or functools.cache on methods can lead to memory leaks
    "B028", # No explicit stacklevel keyword argument found
    "TRY002", # Prohibit use of `raise Exception`, use specific exceptions instead.
    "RET505", # Unnecessary {branch} after return statement
    "RET506", # Unnecessary {branch} after raise statement
    "RET507", # Unnecessary {branch} after continue statement
    "RET508", # Unnecessary {branch} after break statement
    "SIM105", # Use contextlib.suppress({exception}) instead of try-except-pass
]
ignore = [
    "D100", # Unwanted; Docstring at the top of every file.
    "D102", # TODO: Missing docstring in public method
    "D103", # TODO: Missing docstring in public function
    "D104", # Unwanted; Docstring at the top of every `__init__.py` file.
    "D105", # Unwanted; See https://lists.apache.org/thread/8jbg1dd2lr2cfydtqbjxsd6pb6q2wkc3
    "D107", # Unwanted; Docstring in every constructor is unnecessary if the class has a docstring.
    "D203",
    "D212", # Conflicts with D213.  Both can not be enabled.
    "E731", # Do not assign a lambda expression, use a def
    "TC003", # Do not move imports from stdlib to TYPE_CHECKING block
    "PT006", # Wrong type of names in @pytest.mark.parametrize
    "PT007", # Wrong type of values in @pytest.mark.parametrize
    "PT013", # silly rule prohibiting e.g. `from pytest import param`
    "PT011", # pytest.raises() is too broad, set the match parameter
    "PT019", # fixture without value is injected as parameter, use @pytest.mark.usefixtures instead
    # Rules below explicitly set off which could overlap with Ruff's formatter
    # as it recommended by https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
    # Except ISC rules
    "W191",
    "E111",
    "E114",
    "E117",
    "D206",
    "D300",
    "Q000",
    "Q001",
    "Q002",
    "Q003",
    "COM812",
    "COM819",
    "E501", # Formatted code may exceed the line length, leading to line-too-long (E501) errors.
    "ASYNC110", # TODO: Use `anyio.Event` instead of awaiting `anyio.sleep` in a `while` loop
]
unfixable = [
    # PT022 replace empty `yield` to empty `return`. Might be fixed with a combination of PLR1711
    # In addition, it can't do anything with invalid typing annotations, protected by mypy.
    "PT022",
]

[tool.ruff.format]
docstring-code-format = true

[tool.ruff.lint.isort]
required-imports = ["from __future__ import annotations"]
combine-as-imports = true


section-order = [
  "future",
  "standard-library",
  "third-party",
  "first-party",
  "local-folder",
  "testing"
]

known-first-party = ["airflow"]

# Make sure we put the "dev" imports at the end, not as a third-party module
[tool.ruff.lint.isort.sections]
testing = ["dev", "providers.tests", "tests_common", "tests", "system", "unit", "integration"]

[tool.ruff.lint.extend-per-file-ignores]
"airflow-core/src/airflow/__init__.py" = ["F401", "TC004", "I002"]
"airflow-core/src/airflow/models/__init__.py" = ["F401", "TC004"]
"airflow-core/src/airflow/models/sqla_models.py" = ["F401"]
"airflow-core/src/airflow/cli/api/datamodels/_generated.py" = ["UP007", "D101", "D200"]

# Those are needed so that __init__.py chaining of packages properly works for IDEs
# the first non-comment line of such empty __init__.py files should be:
# __path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore
"airflow-core/tests/unit/__init__.py" = ["I002"]
"airflow-core/tests/system/__init__.py" = ["I002"]
"airflow-core/tests/integration/__init__.py" = ["I002"]
"providers/*/tests/*/__init__.py" = ["I002"]
"providers/*/*/tests/*/*/__init__.py" = ["I002"]
"providers/*/src/airflow/__init__.py" = ["I002"]
"providers/*/src/airflow/providers/*/__init__.py" = ["I002"]
"providers/*/src/airflow/providers/__init__.py" = ["I002"]
"providers/*/*/src/airflow/providers/__init__.py" = ["I002"]
"providers/apache/*/src/airflow/providers/apache/__init__.py" = ["I002"]
"providers/atlassian/*/src/airflow/providers/atlassian/__init__.py" = ["I002"]
"providers/common/*/src/airflow/providers/common/__init__.py" = ["I002"]
"providers/cncf/*/src/airflow/providers/cncf/__init__.py" = ["I002"]
"providers/dbt/*/src/airflow/providers/dbt/__init__.py" = ["I002"]
"providers/microsoft/*/src/airflow/providers/microsoft/__init__.py" = ["I002"]

# The test_python.py is needed because adding __future__.annotations breaks runtime checks that are
# needed for the test to work
"providers/standard/tests/unit/standard/decorators/test_python.py" = ["I002"]

# The Pydantic representations of SqlAlchemy Models are not parsed well with Pydantic
# when __future__.annotations is used so we need to skip them from upgrading
# Pydantic also require models to be imported during execution
"airflow-core/src/airflow/serialization/pydantic/*.py" = ["I002", "UP007", "TC001"]

# The FastAPI models are not parsed well with Pydantic when __future__.annotations is used
# It is forcing for Union to replace with `|` pipe instead
"airflow-core/src/airflow/api_fastapi/core_api/datamodels/common.py" = ["UP007"]

# Provider's get_provider_info.py files are generated and do not need "from __future__ import annotations"
"providers/**/get_provider_info.py" = ["I002"]

# Failing to detect types and functions used in `Annotated[...]` syntax as required at runtime.
# Annotated is central for FastAPI dependency injection, skipping rules for FastAPI folders.
"airflow-core/src/airflow/api_fastapi/*" = ["TC001", "TC002"]
"airflow-core/tests/unit/api_fastapi/*" = ["T001", "TC002"]

# Ignore pydoc style from these
"*.pyi" = ["D"]
"scripts/*" = ["D", "PT"]  # In addition ignore pytest specific rules
"docs/*" = ["D"]
"airflow-core/docs/*" = ["D"]
"*/example_dags/*" = ["D"]
"chart/*" = ["D"]
"dev/*" = ["D"]
"devel-common/*" = ["D"]
# In addition, ignore in tests
# TID253: Banned top level imports, e.g. pandas, numpy
# S101: Use `assert`
# TRY002: Use `raise Exception`
"dev/perf/*" = ["TID253"]
"dev/check_files.py" = ["S101"]
"dev/breeze/tests/*" = ["TID253", "S101", "TRY002"]
"airflow-core/tests/*" = ["D", "TID253", "S101", "TRY002"]
"docker-tests/*" = ["D", "TID253", "S101", "TRY002"]
"kubernetes-tests/*" = ["D", "TID253", "S101", "TRY002"]
"helm-tests/*" = ["D", "TID253", "S101", "TRY002"]
"providers/**/tests/*" = ["D", "TID253", "S101", "TRY002"]

# All of the modules which have an extra license header (i.e. that we copy from another project) need to
# ignore E402 -- module level import not at top level
"scripts/ci/pre_commit/*.py" = [ "E402" ]
"airflow-core/src/airflow/api/auth/backend/kerberos_auth.py" = [ "E402" ]
"airflow-core/src/airflow/security/kerberos.py" = [ "E402" ]
"airflow-core/src/airflow/security/utils.py" = [ "E402" ]
"airflow-core/tests/unit/always/test_connection.py" = [ "E402" ]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_auto_ml.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_batch_prediction_job.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_custom_job.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_dataset.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_endpoint_service.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_generative_model.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_hyperparameter_tuning_job.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_model_service.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_pipeline_job.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/hooks/vertex_ai/test_prediction_service.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/links/test_translate.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/operators/test_automl.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/operators/test_vertex_ai.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/operators/vertex_ai/test_generative_model.py" = [ "E402"]
"providers/google/tests/unit/google/cloud/triggers/test_vertex_ai.py" = [ "E402"]
"providers/microsoft/azure/tests/conftest.py" = ["E402"]
"providers/qdrant/tests/unit/qdrant/hooks/test_qdrant.py" = ["E402"]
"providers/qdrant/tests/unit/qdrant/operators/test_qdrant.py" = ["E402"]

# Remove some docstring rules from files that do not need docstrings
"providers/apache/hdfs/src/airflow/providers/apache/hdfs/sensors/hdfs.py" = ["D101"]

"devel-common/src/sphinx_exts/exampleinclude.py" = ["E402", 'F401', ]

# All the modules which do not follow B028 yet: https://docs.astral.sh/ruff/rules/no-explicit-stacklevel/
"helm-tests/tests/helm_tests/airflow_aux/test_basic_helm_chart.py" = ["B028"]

# While pandas import is banned, sql.pyi should be excluded from it as it does not have a TYPE_CHECKING
# mechanism and whole .pyi is really "type-checking" only
"providers/common/sql/src/airflow/providers/common/sql/hooks/sql.pyi" = ["TID253"]

[tool.ruff.lint.flake8-tidy-imports]
# Disallow all relative imports.
ban-relative-imports = "all"
# Ban certain modules from being imported at module level, instead requiring
# that they're imported lazily (e.g., within a function definition).
banned-module-level-imports = ["numpy", "pandas"]

[tool.ruff.lint.flake8-tidy-imports.banned-api]
# Direct import from the airflow package modules and constraints
"airflow.AirflowException".msg = "Use airflow.exceptions.AirflowException instead."
"airflow.Dataset".msg = "Use airflow.datasets.Dataset instead."
# Deprecated imports
"airflow.models.baseoperator.BaseOperatorLink".msg = "Use airflow.models.baseoperatorlink.BaseOperatorLink"
"airflow.models.errors.ImportError".msg = "Use airflow.models.errors.ParseImportError"
"airflow.models.ImportError".msg = "Use airflow.models.errors.ParseImportError"
# Deprecated in Python 3.11, Pending Removal in Python 3.15: https://github.com/python/cpython/issues/90817
# Deprecation warning in Python 3.11 also recommends using locale.getencoding but it available in Python 3.11
"locale.getdefaultlocale".msg = "Use locale.setlocale() and locale.getlocale() instead."
# Deprecated in Python 3.12: https://github.com/python/cpython/issues/103857
"datetime.datetime.utcnow".msg = "Use airflow.utils.timezone.utcnow or datetime.datetime.now(tz=datetime.timezone.utc)"
"datetime.datetime.utcfromtimestamp".msg = "Use airflow.utils.timezone.from_timestamp or datetime.datetime.fromtimestamp(tz=datetime.timezone.utc)"
# Deprecated in Python 3.12: https://github.com/python/cpython/issues/94309
"typing.Hashable".msg = "Use collections.abc.Hashable"
"typing.Sized".msg = "Use collections.abc.Sized"
# Uses deprecated in Python 3.12 `datetime.datetime.utcfromtimestamp`
"pendulum.from_timestamp".msg = "Use airflow.utils.timezone.from_timestamp"
# Flask deprecations, worthwhile to keep it until we migrate to Flask 3.0+
"flask._app_ctx_stack".msg = "Deprecated in Flask 2.2, removed in Flask 3.0"
"flask._request_ctx_stack".msg = "Deprecated in Flask 2.2, removed in Flask 3.0"
"flask.escape".msg = "Use markupsafe.escape instead. Deprecated in Flask 2.3, removed in Flask 3.0"
"flask.Markup".msg = "Use markupsafe.Markup instead. Deprecated in Flask 2.3, removed in Flask 3.0"
"flask.signals_available".msg = "Signals are always available. Deprecated in Flask 2.3, removed in Flask 3.0"
# Use root logger by a mistake / IDE autosuggestion
# If for some reason root logger required it could obtained by logging.getLogger("root")
"logging.debug".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.info".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.warning".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.error".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.exception".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.fatal".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.critical".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
"logging.log".msg = "Instantiate new `logger = logging.getLogger(__name__)` and use it instead of root logger"
# unittest related restrictions
"unittest.TestCase".msg = "Use pytest compatible classes: https://docs.pytest.org/en/stable/getting-started.html#group-multiple-tests-in-a-class"
"unittest.skip".msg = "Use `pytest.mark.skip` instead: https://docs.pytest.org/en/stable/reference/reference.html#marks"
"unittest.skipIf".msg = "Use `pytest.mark.skipif` instead: https://docs.pytest.org/en/stable/reference/reference.html#marks"
"unittest.skipUnless".msg = "Use `pytest.mark.skipif` instead: https://docs.pytest.org/en/stable/reference/reference.html#marks"
"unittest.expectedFailure".msg = "Use `pytest.mark.xfail` instead: https://docs.pytest.org/en/stable/reference/reference.html#marks"
# Moved in SQLAlchemy 2.0
"sqlalchemy.ext.declarative.declarative_base".msg = "Use `sqlalchemy.orm.declarative_base`. Moved in SQLAlchemy 2.0"
"sqlalchemy.ext.declarative.as_declarative".msg = "Use `sqlalchemy.orm.as_declarative`. Moved in SQLAlchemy 2.0"
"sqlalchemy.ext.declarative.has_inherited_table".msg = "Use `sqlalchemy.orm.has_inherited_table`. Moved in SQLAlchemy 2.0"
"sqlalchemy.ext.declarative.synonym_for".msg = "Use `sqlalchemy.orm.synonym_for`. Moved in SQLAlchemy 2.0"
"providers".msg = "You should not import 'providers' as a Python module. Imports in providers should be done starting from 'src' or `tests' folders, for example 'from airflow.providers.airbyte'  or 'from unit.airbyte' or 'from system.airbyte'"

[tool.ruff.lint.flake8-type-checking]
exempt-modules = ["typing", "typing_extensions"]

[tool.ruff.lint.flake8-pytest-style]
mark-parentheses = false
fixture-parentheses = false

## pytest settings ##
[tool.pytest.ini_options]
addopts = [
    "--tb=short",
    "-rasl",
    "--verbosity=2",
    # Disable `flaky` plugin for pytest. This plugin conflicts with `rerunfailures` because provide the same marker.
    "-p", "no:flaky",
    # Disable `nose` builtin plugin for pytest. This feature is deprecated in 7.2 and will be removed in pytest>=8
    "-p", "no:nose",
    # Disable support of a legacy `LocalPath` in favor of stdlib `pathlib.Path`.
    "-p", "no:legacypath",
    # Disable warnings summary, because we use our warning summary.
    "--disable-warnings",
    "--asyncio-mode=strict",
    "--ignore-glob=**/tests/system/*",
    "--ignore-glob=tests/system/*",
]

norecursedirs = [
    ".eggs",
    "airflow",
    "airflow-core/tests/unit/_internals",
    "airflow-core/tests/unit/dags_with_system_exit",
    "airflow-core/tests/unit/dags_corrupted",
    "airflow-core/tests/unit/dags",
    "providers/google/tests/system/google/cloud/dataproc/resources",
    "providers/google/tests/system/google/cloud/gcs/resources",
]
log_level = "INFO"
filterwarnings = [
    "error::pytest.PytestCollectionWarning",
    "error::pytest.PytestReturnNotNoneWarning",
    # Avoid building cartesian product which might impact performance
    "error:SELECT statement has a cartesian product between FROM:sqlalchemy.exc.SAWarning:airflow",
    'error:Coercing Subquery object into a select\(\) for use in IN\(\):sqlalchemy.exc.SAWarning:airflow',
    'error:Class.*will not make use of SQL compilation caching',
    "ignore::DeprecationWarning:flask_appbuilder.filemanager",
    "ignore::DeprecationWarning:flask_appbuilder.widgets",
    # FAB do not support SQLAlchemy 2
    "ignore::sqlalchemy.exc.MovedIn20Warning:flask_appbuilder",
    # https://github.com/dpgaspar/Flask-AppBuilder/issues/2194
    "ignore::DeprecationWarning:marshmallow_sqlalchemy.convert",
    # https://github.com/dpgaspar/Flask-AppBuilder/pull/1940
    "ignore::DeprecationWarning:flask_sqlalchemy",
    # https://github.com/dpgaspar/Flask-AppBuilder/pull/1903
    "ignore::DeprecationWarning:apispec.utils",
]
# We cannot add warnings from the airflow package into `filterwarnings`,
# because it invokes import airflow before we set up test environment which breaks the tests.
# Instead of that, we use a separate parameter and dynamically add it into `filterwarnings` marker.
# Add airflow.exceptions.RemovedInAirflow4Warning when min provider version for providers is 3.0
forbidden_warnings = [
    "airflow.exceptions.AirflowProviderDeprecationWarning",
]
python_files = [
    "test_*.py",
    "example_*.py",
]
# We need to make sure airflow-core sources are first in the pythonpath, because uv sync adds sources to
# pythonpath in basically random order and pytest does not understand legacy namespace packages and cannot
# use namespace packages effectively when collecting tests.
pythonpath = [
    "airflow-core/src",
    "airflow-core/tests"
]
testpaths = [
    "tests",
]
asyncio_default_fixture_loop_scope = "function"

# Keep temporary directories (created by `tmp_path`) for 2 recent runs only failed tests.
tmp_path_retention_count = "2"
tmp_path_retention_policy = "failed"


## coverage.py settings ##
[tool.coverage.run]
branch = true
relative_files = true
omit = [
    "airflow-core/src/airflow/_vendor/**",
    "airflow-core/src/airflow/contrib/**",
    "airflow-core/src/airflow/example_dags/**",
    "airflow-core/src/airflow/migrations/**",
    "providers/google/src/airflow/providers/**/example_dags/**",
    "providers/google/src/airflow/providers/google/ads/_vendor/**",
]

[tool.coverage.report]
skip_empty = true
exclude_also = [
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "@(abc\\.)?abstractmethod",
    "@(typing(_extensions)?\\.)?overload",
    "if (typing(_extensions)?\\.)?TYPE_CHECKING:"
]


## mypy settings ##
[tool.mypy]
ignore_missing_imports = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = false
plugins = [
    "dev/airflow_mypy/plugin/decorators.py",
    "dev/airflow_mypy/plugin/outputs.py",
]
pretty = true
show_error_codes = true
disable_error_code = [
    "annotation-unchecked",
]
namespace_packages = true
explicit_package_bases = true
exclude = [
    ".*/node_modules/.*",
    # Exclude hidden files and directories
    ".*/\\..*"
]
mypy_path = [
    "$MYPY_CONFIG_FILE_DIR/airflow-core/src",
    "$MYPY_CONFIG_FILE_DIR/airflow-core/tests",
    "$MYPY_CONFIG_FILE_DIR/task-sdk/src",
    "$MYPY_CONFIG_FILE_DIR/task-sdk/tests",
    "$MYPY_CONFIG_FILE_DIR/airflow-ctl/src",
    "$MYPY_CONFIG_FILE_DIR/airflow-ctl/tests",
    "$MYPY_CONFIG_FILE_DIR/dev",
    "$MYPY_CONFIG_FILE_DIR/devel-common/src",
    "$MYPY_CONFIG_FILE_DIR/helm-tests/tests",
    "$MYPY_CONFIG_FILE_DIR/kubernetes-tests/tests",
    "$MYPY_CONFIG_FILE_DIR/docker-tests/tests",
    # Automatically generated mypy paths
    "$MYPY_CONFIG_FILE_DIR/providers/airbyte/src",
    "$MYPY_CONFIG_FILE_DIR/providers/airbyte/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/alibaba/src",
    "$MYPY_CONFIG_FILE_DIR/providers/alibaba/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/amazon/src",
    "$MYPY_CONFIG_FILE_DIR/providers/amazon/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/beam/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/beam/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/cassandra/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/cassandra/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/drill/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/drill/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/druid/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/druid/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/flink/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/flink/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/hdfs/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/hdfs/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/hive/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/hive/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/iceberg/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/iceberg/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/impala/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/impala/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/kafka/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/kafka/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/kylin/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/kylin/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/livy/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/livy/tests",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/pig/src",
    "$MYPY_CONFIG_FILE_DIR/providers/apache/pig/tests",