[openstack-dev] RFC: last minute changes to Oslo library versioning and naming
Doug Hellmann
doug.hellmann at dreamhost.com
Wed Mar 6 13:04:28 UTC 2013
On Tuesday, March 5, 2013, Mark McLoughlin wrote:
> On Tue, 2013-03-05 at 10:29 -0500, Doug Hellmann wrote:
> >
> >
> > On Tue, Mar 5, 2013 at 9:02 AM, Mark McLoughlin <markmc at redhat.com<javascript:;>>
> wrote:
> > 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"
> >
> >
> > +1 to semantic versioning
> >
> >
> > -0 to not cleaning up deprecated APIs
>
> Thanks
>
> > - 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.
> >
> >
> > And the major number?
>
> If/when we ever remove deprecated APIs.
OK
>
> > In practical terms, I'm proposing doing:
> >
> > -package = 'oslo-config'
> > -version = '2013.1'
> > +package = 'oslo.config'
> > +version = '1.1.0'
> >
> >
> > Why not 1.0.0?
>
> A weak, silly 2013.1.0-2012 approach :)
Heh, got it.
Doug
>
> Cheers,
> Mark.
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130306/5ef101ee/attachment.html>
More information about the OpenStack-dev
mailing list