This guide provides instructions for upgrading Crystal from one release to the next. Upgrades must be run sequentially, meaning you should not skip minor/major releases while upgrading.
Crystal commits to a backwards-compatibility guarantee that code should continue to work with all future minor releases of the same major release series.
Still, even bug fixes introduce changes that may break existing code in some edge cases. We're only listing the most relevant changes here that could have a relevant impact.
The changelog contains more information about all changes in a specific release.
- The implementation of the comparison operator
#<=>
betweenBig*
(BigDecimal
,BigFloat
,BigInt
,BigRational
) andFloat
(Float32
,Float64
) number types is now nilable. When invoking these comparisons,Nil
values must be handled.