Skip to content

Add more provider module categories to the provider page#70190

Open
Lee-W wants to merge 3 commits into
apache:mainfrom
astronomer:add-more-registry-module-categories
Open

Add more provider module categories to the provider page#70190
Lee-W wants to merge 3 commits into
apache:mainfrom
astronomer:add-more-registry-module-categories

Conversation

@Lee-W

@Lee-W Lee-W commented Jul 21, 2026

Copy link
Copy Markdown
Member

Why

Follow up of #70122. Extra links, queues, plugins, auth managers, DB managers, and dialects were not browsable in the registry

What

Add extra links, queues, plugins, auth managers, DB managers, and dialects. Each of them now gets it own category tab. The row now sorted by module count and tail collapses into a "More" menu so the page won't be too messy

image image
Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

Comment thread dev/registry/extract_parameters.py Outdated
Comment thread dev/registry/registry_tools/types.py
Comment on lines +147 to +153
"dialect": {
"yaml_key": "dialects",
"level": "flat",
"suffixes": [],
"label": "Dialects",
"icon": "C",
},

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Queues and dialect feel weird

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Queues look something like this:

image

And dialects look like this:

image

I'm a bit unsure about adding dialects, but I do think we should include queues.

I also considered removing all of these less common fields altogether, but in the end I decided to include them since they don't add much noise and may still be useful for some users.

@kaxil kaxil Jul 22, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aah Message Queues -- I think we should relabel it to "Message Queues" so folks aren't confused with things like "queue" argument on Base Operator.

https://airflow.apache.org/docs/apache-airflow-providers-common-messaging/stable/index.html

@Lee-W
Lee-W force-pushed the add-more-registry-module-categories branch 3 times, most recently from 1bae222 to e0be06b Compare July 22, 2026 05:43
@Lee-W
Lee-W requested a review from kaxil July 22, 2026 10:12
"secrets-backends": "secret",
"logging": "logging",
"executors": "executor",
"extra-links": "extra_link",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

extract_versions.py doesn't read these CLASS_LEVEL_SECTIONS — it has its own hardcoded FQCN_SECTIONS (line 304) that still stops at notifications/secrets/logging/executors. So backfilled version pages won't show any of the new categories, only latest pages will. Was that intentional?

It'd be nice if extract_versions.py picked these up from here the way it already does with MODULE_LEVEL_SECTIONS.

extract_versions.py hardcoded a 4-entry FQCN_SECTIONS map, so
backfilled (older) provider version pages only showed notifications,
secrets backends, logging, and executors. The newer categories added
for the provider page (extra links, queues, auth managers, db
managers) only showed up on the latest version page, which used a
separate code path already wired to all categories.

extract_versions.py now derives its category list from
CLASS_LEVEL_SECTIONS instead of duplicating it, and the category
overrides that used to live only in extract_parameters.py move to a
shared CLASS_LEVEL_CATEGORY_OVERRIDES constant so both scripts stay in
sync going forward.
@Lee-W
Lee-W force-pushed the add-more-registry-module-categories branch from e0be06b to a1ffe7e Compare July 22, 2026 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

4 participants