All Versions
Latest Version
Avg Release Cycle
79 days
Latest Release
1071 days ago

Changelog History
Page 1

  • v0.8.1 Changes

    October 19, 2020

    โœจ Enhancements

    โšก๏ธ Updates

  • v0.8.0 Changes

    September 08, 2020

    ๐Ÿ†• New features

    • Catch binary-incompatible method overriding in traits #541 by @dwijnand

    โœจ Enhancements

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.7.0 Changes

    February 28, 2020

    ๐Ÿ”‹ Features

    • Checking generic signatures is now opt-in. #471

    Most MiMa checks (DirectMissingMethod, IncompatibleResultType, IncompatibleMethType, etc) are against the method descriptor, which is the "raw" type signature, without any information about generic parameters.
    The IncompatibleSignature check compares the Signature, which includes the full signature including generic parameters. This can catch real incompatibilities, but also sometimes triggers for a change in generics that
    โšก๏ธ would not in fact cause problems at run time. Notably, it will warn when updating your project to scala 2.12.9+ or 2.13.1+, see #423 ("Signature checks fail using value classes & upgrading to 2.12.9+ or 2.13.1+") for details.

    0๏ธโƒฃ This check is now disabled by default. You can opt-in to it by setting:

    ThisBuild / mimaReportSignatureProblems := true

    ๐Ÿ‘Œ Improvements

    • ๐Ÿ‘Œ Improve problem reporting (#475), specifically, it now:
      • logs at the appropriate log level (warn/error, if there are problems/fatal problems)
      • includes the version of the artifact compared against
      • includes the number of filtered out problems

    ๐Ÿ›  Bugfixes

    • ๐Ÿ›  Fix a regression in how version filtered are... filtered. #468

    Other changes

    • โฌ‡๏ธ Drop Bintray, switch releasing the plugin to Maven Central. #469

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.6.4 Changes

    February 08, 2020

    ๐Ÿ›  Bugfixes

    • ๐Ÿ›  Fix a regression in problem identification, since 0.6.1 a case of IncompatibleResultTypeProblems were being reported as DirectMissingMethodProblem. #459 / #460 by @raboof (thank you!)

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.6.3 Changes

    February 03, 2020

    ๐Ÿ›  Bugfixes

    • ๐Ÿ›  Fix a false negative when removing all method implementations from a trait (with results in the loss of the trait's "initialisation" method, which is binary incompatible). #426 / #448 (kindly reported by @travisbrown)

    Other improvements

    • ๐Ÿ“„ Clarify the IncompatibleSignatureProblem message & link to the docs in the README. #435 by @raboof
    • โœ… Test infra: run the functional tests, to ensure they're correct. Motivated by the false negative in #426. #427 / #444
    • โช Restore sbt 1.2.8 support. #453
    • ๐Ÿ”จ Lots and lots of cleanup and refactoring. See the entire changelog details.

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.6.2 Changes

    February 03, 2020

    ๐Ÿš€ (Failed release. Details in the release tracking issue: #454)

  • v0.6.1 Changes

    September 20, 2019

    ๐Ÿ’ฅ Breaking change

    ๐Ÿš€ This release of MiMa uses sbt 1.3, which isn't forward-compatible with previous versions of sbt 1 (e.g. sbt 1.2.8). That means your build must on sbt 1.3 in order for it to use MiMa 0.6.1+. The step-wise approach would be to upgrade the build to sbt 1.3 first and then upgrade it to use MiMa 0.6.1.

    ๐Ÿš‘ Hotfix

    ๐Ÿš€ This release of MiMa is built against the scala compiler 2.12.10, which allows it to be used within sbt 1.3.1+ (fixes #389).

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.6.0 Changes

    August 22, 2019
    • Correctly display static methods #371
    • Ignore when the first constructor parameter is dropped from the signature #378
    • โœ‚ Removed overloads are missing, not incompatible #362
    • ๐Ÿ‘Œ Verify all overloads for result types and signatures #345

    Migration notes

    โšก๏ธ The last 2 highlighted changes fix the fact that previously some DirectMissingMethodProblems were incorrectly reported as IncompatibleResultTypeProblem/IncompatibleMethTypeProblem and vice-versa. If you have added filters for such cases to your project, when upgrading to mima 0.6.0 you might have to update those to filter out DirectMissingMethodProblem instead (example:

  • v0.5.0 Changes

    July 12, 2019

    ๐Ÿ›  Fixing the impact of 0.4.0's breaking change

    ๐Ÿš€ The 0.4.0 release of MiMa included a breaking change that sought to help users discover when they were running mimaReportBinaryIssues but hadn't configured mimaPreviousArtifacts.

    โšก๏ธ Unfortunately, that had a larger impact than expected, quickly brought to light thanks to the PRs sent by the ScalaSteward (see the ScalaSteward annoucement blog post!).

    ๐Ÿš€ With the release of MiMa 0.5.0 we've been able to solve the initial issue by being able to differentiate when mimaPreviousArtifacts was unset by the user and when it was purposely set to the empty set (for instance, if their library cross-builds to Scala 2.13 but hasn't yet been released for Scala 2.13).

    โž• Additionally the README has been fully refreshed and now gives better guidance, in particular see the Setting different mimaPreviousArtifacts and Make mimaReportBinaryIssues not fail sections, the latter of which details how use 0.4.0's mimaFailOnNoPrevious setting to handle breakages.


    โž• Additional improvements

    • ๐Ÿ›  Fix resolving previous artifacts that defined their Scala version suffix. #327/#329

    ๐Ÿ‘€ For full details see the milestone and/or the changelog.

  • v0.4.0 Changes

    July 09, 2019

    ๐Ÿ’ฅ Breaking changes

    0๏ธโƒฃ When mimaPreviousArtifacts is not set, default mimaReportBinaryIssues to fail

    0๏ธโƒฃ As of v0.4.0 mimaReportBinaryIssues will, by default, fail if mimaPreviousArtifacts is empty, to avoid users thinking they're checking binary-compatibility when they aren't.

    You may need to apply one of the following to mitigate this change:

    • set mimaPreviousArtifacts for all the projects that should be checking their binary compatibility
    • ๐Ÿ”Œ set mimaFailOnNoPrevious := false on specific projects that want to opt-out (alternatively disablePlugins(MimaPlugin))
    • ๐Ÿ— set mimaFailOnNoPrevious in ThisBuild := false, which disables it build-wide, effectively reverting back to the previous behaviour

    #263 / #289

    โฌ‡๏ธ Dropped sbt 0.13 support

    โšก๏ธ As of v0.4.0 MiMa no longer supports sbt 0.13 and is only available for sbt 1.x. We encourage you to update to sbt 1.x, and until that time use keep using MiMa v0.3.0.

    #269 / #272

    โฌ‡๏ธ Dropped Scala 2.10 support

    ๐Ÿ‘Œ Support for Scala 2.10 has also been dropping, meaning you should continue to use MiMa v0.3.0 to verify binary compatibility of a Scala 2.10 project.

    #248 / #272

    ๐Ÿ‘Œ Improvements

    Checking generic signatures

    ๐Ÿš€ This release introduces a new problem type, the IncompatibleSignatureProblem. This problem is reported when a method's erased signature has remained the same, but its full type signature has changed. Such a change is not always binary incompatible, but typically worthwhile to manually investigate and explicitly confirm. You can exclude all such problems with a ProblemFilters.exclude[IncompatibleSignatureProblem]("*").

    โฌ†๏ธ This change also fixes a problem where IncompatibleResultTypeProblem instances were missed. This means that this upgrade may require adding filters for old, but previously undetected, incompatibilities.

    #40 / #299

    โž• Additional improvements

    • #162 / #254 Don't fail if an effectively final method becomes final
    • #201 / #295 Don't fail when migrating from Java varargs to @varargs
    • #168 / #323 Handle mimaPreviousArtifacts with dots in their name
    • #239 Allow multiple filter files per version to be loaded from a directory
    • #238 Improve the error message when filter files fail to be processed
    • #305 Subsume the mima-reporter project (and jar) into mima-core

    ๐Ÿ‘€ For full details see the 0.4.0 milestone and/or the 0.3.0...0.4.0 changelog.