librelist archives

« back to archive

Semantic Versioning

Semantic Versioning

From:
Andrius Bentkus
Date:
2011-06-22 @ 19:47
Hello,
I was implementing a Version class for libgit2 using an OOP language.
Does libgit2 utilize versioning as described in http://semver.org/?

Re: [libgit2] Semantic Versioning

From:
Vicent Marti
Date:
2011-06-23 @ 18:11
Yes, absolutely.

As the SemVer standard says,

"Major version zero (0.y.z) is for initial development. Anything may
change at any time. The public API should not be considered stable."

That's the situation where we are sitting now, we are trying to make a
minor relase (0.X.0) every time we commit major changes to the
external API, but these changes may not be (and usually aren't)
backwards compatible.

Once we hit 1.0.0, we'll stick fully to the SemVer standard.

Cheers,
Vicent

On Wed, Jun 22, 2011 at 9:47 PM, Andrius Bentkus
<andrius.bentkus@gmail.com> wrote:
> Hello,
> I was implementing a Version class for libgit2 using an OOP language.
> Does libgit2 utilize versioning as described in http://semver.org/?

Re: [libgit2] Semantic Versioning

From:
Charlie Sharpsteen
Date:
2011-06-23 @ 18:14
On Wed, Jun 22, 2011 at 12:47 PM, Andrius Bentkus <andrius.bentkus@gmail.com
> wrote:

> Hello,
> I was implementing a Version class for libgit2 using an OOP language.
> Does libgit2 utilize versioning as described in http://semver.org/?
>

It seems to me that libgit2 is still in a "beta" stage in that breaking
changes can happen on any release. For example, 0.11 changed the API enough
that almost all language bindings were broken. Some, like libqgit2, haven't
recovered yet.

So, I would say that semantic versioning is not in place yet ;)

-Charlie

Re: [libgit2] Semantic Versioning

From:
Charlie Sharpsteen
Date:
2011-06-23 @ 18:19
On Thu, Jun 23, 2011 at 11:14 AM, Charlie Sharpsteen
<chuck@sharpsteen.net>wrote:

> So, I would say that semantic versioning is not in place yet ;)
>
> -Charlie
>

On Thu, Jun 23, 2011 at 11:11 AM, Vicent Marti <vicent@github.com> wrote:

> Yes, absolutely.
>
> As the SemVer standard says,
>
> "Major version zero (0.y.z) is for initial development. Anything may
> change at any time. The public API should not be considered stable."


Ahh... apologies. Forgot that the semantic version standard treats 0.x.y
releases as a special case.

-Charlie

Re: [libgit2] Semantic Versioning

From:
Andrew Mason
Date:
2011-06-24 @ 00:30
> It seems to me that libgit2 is still in a "beta" stage in that breaking
> changes can happen on any release. For example, 0.11 changed the API  
> enough
> that almost all language bindings were broken. Some, like libqgit2,  
> haven't
> recovered yet.

Yeh I'm working on it sorry. Laszlo is too busy and I'm also suffering  
 from a lack of time / knowledge at the moment due to work and family  
commitments.

Andrew