Semantic versioning and impact of breaking changes in the Maven repository

Semantic versioning and impact of breaking changes in the Maven repository

Raemaekers, S.B.A. (TU Delft Software Engineering; ING)
van Deursen, A. (TU Delft Software Technology)
Visser, Joost (Software Improvement Group)

Software Technology

2017

Systems that depend on third-party libraries may have to be updated when updates to these libraries become available in order to benefit from new functionality, security patches, bug fixes, or API improvements. However, often such changes come with changes to the existing interfaces of these libraries, possibly causing rework on the client system. In this paper, we investigate versioning practices in a set of more than 100,000 jar files from Maven Central, spanning over 7 years of history of more than 22,000 different libraries. We investigate to what degree versioning conventions are followed in this repository. Semantic versioning provides strict rules regarding major (breaking changes allowed), minor (no breaking changes allowed), and patch releases (only backward-compatible bug fixes allowed). We find that around one third of all releases introduce at least one breaking change. We perform an empirical study on potential rework caused by breaking changes in library releases and find that breaking changes have a significant impact on client libraries using the changed functionality. We find out that minor releases generally have larger release intervals than major releases. We also investigate the use of deprecation tags and find out that these tags are applied improperly in our dataset.

Semantic versioning
Breaking changes
Software libraries

http://resolver.tudelft.nl/uuid:7c30551c-a00a-49c6-809a-48cc28a1b386

https://doi.org/10.1016/j.jss.2016.04.008

0164-1212

Journal of Systems and Software, 129 (July), 140-158

Institutional Repository

journal article

© 2017 S.B.A. Raemaekers, A. van Deursen, Joost Visser