Offer a template semantic versioning information for display in the cookieplone --info option

[acsr]

Only hashes versions for the templates available

Currently you get a commit hash of the cookieplone-template written as version information to the README.md files generated by Cookieplone.

This does not help to simply figure out if one version is older or newer and if changes were cosmetic or signficant or breaking.

The current cookieplone -v option is more a debug tool an does not help here.

Goals

1. Make the relation between used template versions obvious with Semver 2.0. sersion strings used in cookieplone runs before, during and after execution.
2. Add an pipx run cookieplone --templates-list option to dump the available templates versions in advance and use the -v option to dig deeper (but this is already bloated, so maybe --templates-details would do the job better.

Example outputs of the cookieplone version 0.8.3 and template revision f1d0094

Example output from a pipx run cookieplone --info:

pipx run cookieplone --info
⚠️  cookieplone is already on your PATH and installed at /Users/astro/.local/bin/cookieplone. Downloading and running anyway.
╭────────────────────────────────────────────────────────────── cookieplone ──────────────────────────────────────────────────────────────╮
│ ╭─ Installation ⚡ ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │
│ │  Version                          0.8.3                                                                                             │ │
│ │  Location                         /Users/astro/Library/Caches/pipx/635e6fe9814b2fe/lib/python3.11/site-packages/cookieplone         │ │
│ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │
│ ╭─ Repository 🔗 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │
│ │  Location (COOKIEPLONE_REPOSITO…  gh:plone/cookieplone-templates                                                                    │ │
│ │  Tag (COOKIEPLONE_REPOSITORY_TA…  main                                                                                              │ │
│ │  Password (COOKIEPLONE_REPO_PAS…                                                                                                    │ │
│ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │
│ ╭─ Cookiecutter 🍪 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │
│ │  Version                          2.6.0                                                                                             │ │
│ │  Location                         /Users/astro/Library/Caches/pipx/635e6fe9814b2fe/lib/python3.11/site-packages/cookiecutter        │ │
│ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │
│ ╭─ Python 🐍 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │
│ │  Version                          3.11.5 (main, Aug 24 2023, 15:09:32) [Clang 14.0.0 (clang-1400.0.29.202)]                         │ │
│ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │
╰────────────────────────────────────────────────── Made with ❤️ by the Plone Community ───────────────────────────────────────────────────╯

The corresponding output of a pipx run cookieplone --version is:

⚠️  cookieplone is already on your PATH and installed at /Users/astro/.local/bin/cookieplone. Downloading and running anyway.
Cookieplone 0.8.3 from /Users/astro/Library/Caches/pipx/635e6fe9814b2fe/lib/python3.11/site-packages/cookieplone (Cookiecutter 2.6.0, 
Python 3.11.5 (main, Aug 24 2023, 15:09:32) [Clang 14.0.0 (clang-1400.0.29.202)])

The summary of the actual pipx run cookiecutter project contains no traces of the cookiecutter and template version like generated for the README.md using the _generator-signature function in Cookieplone.

output from Version 0.8.3:

╭──────────────────────────────────────────────────────────────── kwkdev volto generation ─────────────────────────────────────────────────────────────────╮
│ Summary:                                                                                                                                                 │
│   - Plone version: 6.1.0                                                                                                                                 │
│   - Volto version: 18.9.1                                                                                                                                │
│   - Output folder: /Users/astro/github/kwk-Plone6/kwk.dev.acsr.de/kwkdev-volto                                                                           │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

This is the Markdown from the current README.md:

## Credits and Acknowledgements 🙏

Generated using [Cookieplone (0.8.3)](https://github.com/plone/cookieplone) and [cookiecutter-plone (f1d0094)](https://github.com/plone/cookiecutter-plone/commit/91f7d2b0a61b4685d383e79a7367b23b6488e534) on 2025-02-13 18:18:49.930741. A special thanks to all contributors and supporters!

The latest PR #144 and cookieplone PR #65by @davisagli seems not reflected yet in the cookieplone 0.8.3 Release in spite of both seem to be merged.

I will try to provide the output after the PR are in charge here for reference asap.

[acsr]

I have forced a reinstall of cookieplone using explicit pipx reinstall cookieplone resulting in:

uninstalled cookieplone! ✨ 🌟 ✨
  installed package cookieplone 0.8.3, installed using Python 3.11.5
  These apps are now globally available
    - cookieplone
done! ✨ 🌟 ✨

A testrun of pipx run cookieplone project is not reflecting the expected changes from the PRs mentioned before.
The output of the README.md ends with:

Credits and Acknowledgements 🙏

Generated using Cookieplone (0.8.3) and cookiecutter-plone (f1d0094) on 2025-02-22 18:36:01.186576. A special thanks to all contributors and supporters!

So the version is unchanged.

I am not sure how to force the latest changes from #144 and https://github.com/plone/cookieplone/pull/65by @davisagli into effect.

[davisagli]

@acsr There hasn't been a new release of cookieplone yet since #144 was merged, so I don't know why you expect reinstalling cookieplone to include this change. For now you would have to run it from a repository checkout of https://github.com/plone/cookieplone using hatch run cookieplone. @ericof could you please make a new release and/or give me access to do that?

[acsr]

@davisagli I do not expect the changes from the old release. Maybe I used a misleading wording. I just wanted to make sure to check the impact of a reinstall of cookieplone on the template version pulled.

What confused me was the commit hash in the README.md reflecting the current state of cookieplone-template (no releases) and writing cookiecutter-plone (f1d0094) into the resulting file. I mentioned the reinstall to weed it out as a missed state.

Thanks for the hint to using hatch. This worked fine for me.

I followup on this later.

[ericof]

cookieplone 0.8.4 released,

@davisagli: I've transferred the package to the Plone organization and added you as an owner.