mesa-examples icon indicating copy to clipboard operation
mesa-examples copied to clipboard

Feature: Create mesa-models PyPI package

Open tpike3 opened this issue 2 years ago • 8 comments

Per Mesa #1707 we need to create mesa-model PyPI library for easy use access to models.

tpike3 avatar Jul 20 '23 10:07 tpike3

Would be great if there's also a readthedocs site for all the example models

wang-boyu avatar Aug 08 '23 08:08 wang-boyu

We also should tag releases in sync with the main repo, so that the mesa examples are guaranteed to work with a certain mesa version.

For examples, if we tag 2.2.0 of Mesa, we should test and update all the Mesa examples for that version, and then also tag 2.2.0 for the Mesa examples.

EwoutH avatar Dec 10 '23 10:12 EwoutH

Good idea, but I don't think we should be completely in sync. What happens when we add more examples or need a Bugfix for some example? If we then push the mesa-examples version, do we also push mesa to a higher version? This doesn't make sense, so we should probably only do it for Mayor.Minor versions and abuse the Bugfix version for updates to mesa examples. It won't be semver for Mesa examples, but semver doesn't make much sense for examples in the first place, so that should be fine

We could probably do this automatically when we release a new version of mesa via GitHub actions. But of course only if the models work on the new version.

Corvince avatar Dec 10 '23 11:12 Corvince

We can just add an extra digit right? Like major.minor.patch.build.

Actually, I think PEP 440 post releases are perfect for this. Like 2.2.0.post1.

EwoutH avatar Dec 10 '23 11:12 EwoutH

I will try to get this working upcoming week.

EwoutH avatar Jan 21 '24 23:01 EwoutH

We also should tag releases in sync with the main repo, so that the mesa examples are guaranteed to work with a certain mesa version.

@projectmesa/maintainers I still think this is an idea worth perusing. Especially with the 3.0 changes incoming, it would be really nice to have an 2.3 branch with 2.3 tags, on which we can maintain examples, and a main branch on which we can develop new examples for 3.0.

EwoutH avatar Jul 03 '24 12:07 EwoutH

Do we need separate branches for each tag, or is it possible to have only one main branch with all tags, similar to how packages are released?

wang-boyu avatar Jul 04 '24 00:07 wang-boyu

I think for breaking changes we need to have branches. So probably mesa-2.x, mesa-3.x, etc

EwoutH avatar Jul 04 '24 06:07 EwoutH