[openstack-dev] RFC: last minute changes to Oslo library versioning and naming
Sascha Peilicke
saschpe at suse.de
Thu Mar 7 08:08:10 UTC 2013
Am 5. März 2013 15:02:15 schrieb Mark McLoughlin <markmc at redhat.com>:
> Hey,
>
> The thread on naming of namespace packages[1] and the discussion about
> PEP426 on distutils-sig[2] have lead me to these conclusion:
>
> - Naming the package oslo.config is a better choice than oslo-config.
> I don't think there's necessarily a standard for naming these
> things but it seems more likely that period-separated will become
> more common than hyphen-separated (i.e. zope.interface vs
> oslo-config)
>
> - The date based 2013.1 version is likely to be disallowed by PEP426
> when it is ratified and we'll end up making the date based version
> a "private version" but 0.2013.1 would be the version on PyPI. Uggh.
>
> - I'm coming around to the idea of using semantic versioning (i.e.
> x.y.z) and increasing the major number when removing any deprecated
> APIs. That certainly is the trend expressed in PEP426 and on
> distutils-sig. I'd be far more reluctant to actually remove
> deprecated APIs, though, so this would change our policy from
> "remove APIs after a year of deprecation" to "very rarely making
> any incompatible changes to our APIs"
>
> - With semantic versioning, I figure we'd increase the micro number
> when we do release from the stable branch and increase the minor
> number with every coordinated OpenStack release.
>
> In practical terms, I'm proposing doing:
>
> -package = 'oslo-config'
> -version = '2013.1'
> +package = 'oslo.config'
> +version = '1.1.0'
>
> in oslo-config's setup.py
>
> I know this is painful for packagers. In Fedora, I'll have to set an
> "epoch" which packagers always hate doing.
Lucky SUSE guys where too lazy to submit it to openSUSE already, so we
can avoid that. Thus I'd say its ok for us.
> In Debian, it'll probably
> mean the package name changing to python-oslo.config.
>
> However, this is why we didn't publish directly to PyPI - we wanted the
> opportunity to catch issues like this. So, I'm thinking we should just
> go for it ASAP.
>
> Thoughts?
>
Better now than never.
> Thanks,
> Mark.
>
> [1] -
> http://lists.openstack.org/pipermail/openstack-dev/2013-February/thread.html#6078
> [2] -
> http://mail.python.org/pipermail/distutils-sig/2013-March/thread.html#20054
>
>
>
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
--
With kind regards,
Sascha Peilicke
SUSE Linux GmbH, Maxfeldstr. 5, D-90409 Nuernberg, Germany
GF: Jeff Hawn, Jennifer Guild, Felix Imendörffer HRB 16746 (AG Nürnberg)
More information about the OpenStack-dev
mailing list