DOC: plugin package setup add PEP 621 example

[unkcpz]

Test and update section redirect from aiida-tutorial-intro.
Change entry points set from setup.py to pyproject.toml as PEP 621

• Interfacing with external codes - Example
• Guidelines on plugin design -> new

[ltalirz]

thanks for the update @unkcpz , just one comment

[ltalirz]

For a howto I would suggest to stick with one option.

The pyproject.toml is a little more verbose and I wonder whether we need to specify flit as the build backend even in this minimalistic example...
but if the consensus is that the pyproject.toml is the way to go, you can remove the setup.py.

[unkcpz]

Thanks for the quick reply. I'd vote for only keep pyproject.toml since the cookie-cutter is already only has pyproject.toml and the 'plugin packaging section is changed to only conform with PEP 621 in this PR.
Most of cases, beginner users would simply copy and paste the code to have a taste, and then for creating a new plugin, the cookie-cutter should be always the starting point.

[ltalirz]

Yes, let's keep only the pyproject.toml.

As mentioned you can experiment with removing the flit stuff to keep things a bit more "minimal" but that's up to you.

[ltalirz]

thanks, changed the wording a little bit; good to go now

[unkcpz]

Thanks a lot @ltalirz

Seems some CI tests are not running, how should I trigger them?

[ltalirz]

I think the relevant tests were run (only docs changed)

and it's safe to squash & merge now.
I'm travelling today - if you are not allowed to do this and need help, please ping another maintainer (you should get these right though in my view if you don't have them already)

[unkcpz]

if you are not allowed to do this and need help, please ping another maintainer (you should get these right though in my view if you don't have them already)

Okay, I think I don't have the permission to merge without all required CI tests are passed. @ramirezfranciscof Can you check this? thanks!

[ramirezfranciscof]

@unkcpz I just made you admin, check if now you can merge it

(Edit: note that now the branch is also out of date so you need to take care of that beforehand)