Move sphinx-click into pallets ecosytem from click-contrib. Rehome click-example, click-run (click-extra) into click-sphinx

[Rowlando13]

It would be nice be able to use click-example and click-run in our docs in Myst. @kdeldycke Already has the work done, but its in click-extra. I think it would make sense to move sphinx-click to pallets ecosystem, then move the work the directives to that package. It only has sphinx click stuff in it. Then click can depend on it for its doc's generation without impinging on click-extra's ability to move more quickly. I will do the legwork to make it happen. What are your thoughts about whether it is a good idea or not? @kdeldycke @davidism

[kdeldycke]

I don't mind contributing back/relicensing my work on Sphinx from Click Extra to Pallets proper. Don't expect drama on this side to me. I'm happy for my code to be promoted! 😉 If the community identifies some parts you want to reuse, go ahead and feel free to copy and paste. As long as I have the freedom to be a bit aggressive and creative with Click Extra, I'm happy! :)

Sphinx internals can be a bit dense and intimidating, and Click needs some tricks to simulate CLI execution and trace (on the 3 main platforms). So for me it makes sense to concentrate all code interfacing the two worlds in a single project. That was my initial proposition in:

• Move .. click:example:: and .. click:run:: implementation to sphinx-click pallets-sphinx-themes#61
• Supports .. click:example:: and .. click:run:: directives click-contrib/sphinx-click#110

In the mean time, and for context, my Sphinx ↔ Click work is available at:

• https://kdeldycke.github.io/click-extra/sphinx.html
• https://github.com/kdeldycke/click-extra/blob/main/click_extra/sphinx.py
• https://github.com/kdeldycke/click-extra/blob/main/tests/test_sphinx.py

[Rowlando13]

Sounds good. @davidism Assuming that I get sphinx-click moved into pallets eco and cut a release with the new functionality, would you feel comfortable deprecating the functionality in pallets-sphinx-theme ?