Sounds great! Thanks Hussein, for bringing this together! I agree that splitting into smaller pieces, which I think is a great stability improvement, such as reducing the impact area of changes. Although it has cons, it has pros from many different perspectives.
Regards, Bugra Ozturk On Thu, Mar 26, 2026 at 8:12 PM Blain David <[email protected]> wrote: > Very good idea Hussein, I like the proposal! > ________________________________ > From: Hussein Awala <[email protected]> > Sent: Monday, March 23, 2026 21:57 > To: [email protected] <[email protected]> > Subject: [DISCUSS] Release apache-airflow-mypy as a standalone package > > EXTERNAL MAIL: Indien je de afzender van deze e-mail niet kent en deze > niet vertrouwt, klik niet op een link of open geen bijlages. Bij twijfel, > stuur deze e-mail als bijlage naar [email protected]<mailto: > [email protected]>. > > Hi everyone, > > I’d like to propose releasing the existing MyPy plugins as a standalone > package: *apache-airflow-mypy*. > > > *Background* > > Apache Airflow currently ships two MyPy plugins (decorators and outputs) > that improve type checking for DAG authors. > > At the moment, these plugins live inside the repository but are not > published to PyPI. As a result, users who want to benefit from type > checking need to manually copy these plugin files into their own projects. > This is what several teams are doing today. > > > *Proposal* > > Publish *apache-airflow-mypy* as an independently versioned package on > PyPI, following SemVer. > > The package is small and self-contained (two plugins, ~150 lines of code), > which should make it straightforward to maintain. > > PR: > https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fairflow%2Fpull%2F61422&data=05%7C02%7Cdavid.blain%40infrabel.be%7C744fad9585e54987f93c08de891ef3dd%7Cb82bc314ab8e4d6fb18946f02e1f27f2%7C0%7C0%7C639098963203053619%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=SdMKbaSyMeLrCzKCeylnFO5AO1Hv%2BTUYJ1tMuOG3Xm8%3D&reserved=0 > <https://github.com/apache/airflow/pull/61422> > > It includes: > > - A dedicated package under dev/mypy/ with its own pyproject.toml > - A Breeze release command: prepare-mypy-distributions > - Release documentation: dev/README_RELEASE_MYPY.md > - Tests and Towncrier-based release notes > > The name *apache-airflow-mypy* has already been reserved on PyPI (thanks > Jens!). > > > *What the plugins do* > > - *outputs plugin* > Makes operator.output and @task calls return Any instead of XComArg, > allowing DAGs that pass task outputs between tasks to type-check without > errors. > - *decorators plugin* > Adjusts type signatures for certain Google Cloud decorators (e.g. > fallback_to_default_project_id, etc.). > > > *Usage* > > pip install apache-airflow-mypy > > Add to mypy.ini: > > [mypy] > plugins = > airflow_mypy.plugins.decorators > airflow_mypy.plugins.outputs > > > I’m happy to take ownership of the release process for this package. > > Any thoughts or feedback would be very welcome. > > Thanks, > Hussein >
