Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add links to third-party projects enhancing Click #2815

Merged
merged 1 commit into from
Dec 7, 2024

Conversation

kdeldycke
Copy link
Contributor

I propose to promote third-party projects which extends Click in major ways.

I referenced notable repositories that are actively maintained and brings non-trivial enhancements to Click. I sorted them by their popularity (i.e. number of GitHub stars).

CC: @ewels, @simonw, @janluke

@Rowlando13
Copy link
Collaborator

Thanks for this! Can you change the PR to be against stable? Stable are the currently visible docs.

@davidism
Copy link
Member

davidism commented Dec 6, 2024

A long time ago, we maintained a similar list for Flask extensions. It was impossible to maintain, and anything on the list immediately looked more "official". We couldn't keep track of projects over time, and many users would try to get their new or little used project on the list. It wasn't clear why certain things were or were not on the list, did they not meet some criteria, or did someone just forget to add it? For example, Typer isn't listed here.

I do have a desire to create a site similar to https://djangopackages.org/ for Flask, Jinja, and Click eventually.

@davidism davidism closed this Dec 6, 2024
@davidism davidism reopened this Dec 6, 2024
@Rowlando13
Copy link
Collaborator

I agree with your sentiment @davidism. However, I think there is value to not always thinking super long term and seeing how it plays out. The additions are clear improvements over what we have. I only comment because you reopened the issue and I was planning on merging it.

@Rowlando13
Copy link
Collaborator

Perhaps more clearly stated I am happy to take on the temporary burden. If it becomes to much I will simply, remove the section.

@kdeldycke
Copy link
Contributor Author

I had no clue Typer was built on top of Click. Just added it (CC @tiangolo).

My goal with that list is to increase Click usage. And also have a page to point out users to when they're requesting a feature that is out of Click's scope but available in third party tools.

For moderation and keep the signal to noise ratio high, I added a couple of simple editorial rules. They're easy to check and good enough to filter unimportant projects.

I made the list into a table, inspired by:

Now as @Rowlando13 said, we can just test this minimal arrangement and see how it is used or abused by the community.

@kdeldycke
Copy link
Contributor Author

kdeldycke commented Dec 7, 2024

@kdeldycke kdeldycke force-pushed the add-third-party-projects branch from 0966fa8 to f4afb05 Compare December 7, 2024 06:37
@kdeldycke kdeldycke changed the base branch from main to stable December 7, 2024 06:38
@kdeldycke kdeldycke changed the base branch from stable to main December 7, 2024 06:39
@Rowlando13
Copy link
Collaborator

Thanks for working this out. My goal is also to increase click usage and build community around its maintenance.

@kdeldycke kdeldycke force-pushed the add-third-party-projects branch from f4afb05 to 822d4fd Compare December 7, 2024 07:01
@kdeldycke kdeldycke changed the base branch from main to stable December 7, 2024 07:01
@kdeldycke
Copy link
Contributor Author

I just rebased this PR on top of stable. It is ready to be merged if you like it.

@Rowlando13 Rowlando13 merged commit c23223b into pallets:stable Dec 7, 2024
1 check passed
@davidism davidism added the docs label Dec 7, 2024
@kdeldycke kdeldycke deleted the add-third-party-projects branch December 8, 2024 06:43
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Dec 23, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants