unBreakABLE: Better Software Through Semantic Versioning

When Kimmy first poked her head out of that bunker a lot had changed in the world around her. Armed with only the finest cultural memes of the late 90's, she stepped out of the bunker and into her new life. Lucky for Kimmy, people are adaptable and are able to absorb a few cultural version changes pretty easily. Despite the prefix, software is rarely so flexible.

Semantic versioning has introduced a whole new way to think about what version numbers mean. Properly practiced, semantic version numbers communicate a lot about what's going on in a given software release. When consuming a library or framework, what can you learn from their version number? On the flip side, how can you properly release semantically versioned code? What is a breaking change? What is a deprecation? Leaving this talk you'll have a solid understanding of what it means to establish public contracts for your code, how to go about properly versioning those contracts, and even test to be sure you're adhering to them. As a library consumer, you should walk away from this talk better suited to deal with changes to your dependencies and poised to make your applications unBreakABLE.

Transcript

1. UNBREAKABLE STRONGER SOFTWARE WITH SEMVER
2. DUSTY BURWELL @dustyburwell I envy you I’ve never been able to meet me
3. VERSION NUMBERS OF THE PAST
4. 1.0.0.0
5. 1 .0 .0 .0
6. MAJOR BIG FEATURES WHEN MARKETING SAYS .REVISION .HOT FIXES .BUILD .EVERY BUILD .MINOR .SMALL FEATURES .LITERALLY ALWAYS ZERO .EVERY BUILD .WHEN THE LEAD DEVELOPER SAYS
7. MARKETING NUMBERS
8. OTHER SCHEMES
10. ENTER SEMVER
11. MAJOR.MINOR.PATCH
12. BREAK .FIX .PATCH .MINOR MAJOR .FEATURE
13. PATCH (FIX)
14. public class Calculator { // Subtracts b from a public int sub(int a, int b) { return b - a; } }
15. public class Calculator { // Subtracts b from a public int sub(int a, int b) { return a - b; } }
16. var sort = function () { // bubble sort }; module.exports = sort;
17. var sort = function () { // QUICK SORT }; module.exports = sort;
18. REFACTOR
19. MINOR (FEATURE)
20. public class Calculator { public int add(int a, int b) { return a + b; } public int sub(int a, int b) { return a - b; } }
21. public class Calculator { public int add(int a, int b) { return a + b; } public int sub(int a, int b) { return a - b; } public int div(int a, int b) // New Function! { return a / b; } }
22. public class Person { public FirstName { get; set; } public LastName { get; set; } }
23. public class Person { public FirstName { get; set; } public MiddleName { get; set; } // New Property! public LastName { get; set; } }
24. var add = function(a, b) { return a + b; } var sub = function(a, b) { return a - b; } module.exports = { add: add, sub: sub }
25. var add = function(a, b, c) { if (!c) { c = 0; } return a + b + c; } var sub = function(a, b) { return a - b; } module.exports = { add: add, sub: sub }
26. DEPRECATIONS
27. public class Calculator { public int add(int a, int b) { return a + b; } [System.Obsolete("Just use `-`")] public int sub(int a, int b) { return a - b; } }
28. public class Person { public FirstName { get; set; } [System.Obsolete("I hate my middle name")] public MiddleName { get; set; } public LastName { get; set; } }
29. var add = function(a, b) { return a + b; } var sub = function(a, b) { return a - b; } module.exports = { add: add, sub: util.deprecate(sub, "Just use `-`") }
30. var add = function(a, b, c) { if (!c) { Console.warn("Two addend `add` is deprecated"); c = 0; } return a + b + c; } var sub = function(a, b) { return a - b; } module.exports = { add: add, sub: sub }
31. MAJOR (BREAK)
32. REMOVE DEPRECATIONS
33. VERSION 0.X.Y
34. PRE-RELEASE TAGS 1.2.1-alpha.0 2.4.8-beta.1 5.4.71-yolo
35. DEPENDENCY RESOLUTIon >=1.0 >=1.0 <2.0 ~1.0
36. NESTED VERSION LOCKING NPM SHRINKWRAP BUNDLER LOCK FILE
37. APP VERSIONING
38. LOGS
39. CONFIGURATION
40. SERVICE API VERSIONING
41. SINGLE DEPLOY
42. EMBER.JS
43. NODE.JS
44. var b1 = Buffer.new(“test”); var b2 = Buffer.new([1,2,3]); var b3 = Buffer.new(16);
45. var b1 = Buffer.from(“test”); var b2 = Buffer.from([1,2,3]); var b3 = Buffer.alloc(16); var b4 = Buffer.allocUnsafe(16);
46. ELM-LANG
47. TEST FOR BREAKS $ git checkout v1.0.0 -- specs/version_tests $ ./run_tests specs/version_tests
48. DOCUMENT DOCUMENT DOCUMENT Being an adult is terrible
49. SEMVER.ORG
50. THE END