Changelog

Version 0.9.5

• JDK17 support improvements:
  • Fix crash with switch expression as a lambda body (#543, follow up: #545)
  • Better fix for crash on member selects inside module-info.java (#544)
• Bump Guava dependency to 24.1.1 (#536)
• Build / CI tooling for NullAway itself:
  • Bump AutoValue and AutoService versions (#538)
  • Add task to run NullAway on itself (#542)
  • Add test case for unsound map reassignment handling (#541)

Version 0.9.4

• Fix crash with fully-qualified names in module-info.java import (#534)

Version 0.9.3

IMPORTANT: This version introduces EXPERIMENTAL JDK17 support. There is a known crash on lambdas with switch expressions as body (see #524). Best current workaround is to @SuppressWarnings("NullAway") on the enclosing method

• Improve reporting of multiple parameter errors on a single method call (#503)
• Support compile-time constant field args in method Access Paths (#504)
• Add basic library support for grpc Metadata through GrpcHandler (#505)
• Fix soundness bug with dereference of ternary expressions (#516)
• Add support for switch expressions (#520) [JDK 17]
• Allow setting custom Nullable Annotation via Error Prone CLI flags (#522)
• Add JarInfer models for Android SDK 31 (Android 12) (#532)
• Build / CI tooling for NullAway itself:
  • Prevent JMH tests from running on pre-v11 JDKs (#492)
  • Bump to Error Prone 2.8.1 (#494), 2.9.0 (#497), and 2.10.0 (#507)
  • Docs: Fix a broken link in README.md (#495)
  • Update to Gradle 7.2 (#496), 7.3.1 (#509), and 7.3.3 (#530)
  • Add Autodispose benchmark (#498)
  • Bump jmh plugin to 0.6.6 (#500)
  • Bump to Checker dataflow 3.20.0 (#510)
  • CI tests for JDK 17 (#512)
  • Some fixes to GitHub Actions config (#514)
  • Make jar-infer-lib tests pass on JDK 11 (#523)
  • Extra tests for all DummyOptionsConfig's methods (#525)
  • Pull jmh Gradle plugin version to top level (#526)
  • Add tests for JDK 16+ records (#527)
  • Support for Coveralls on multiple modules (#521)
  • Changes to avoid re-running Gradle tasks unnecessarily (#528)

Version 0.9.2

• Allow specifying custom names for Contract annotations (#476)
• Use shaded Checker Framework dataflow artifact made for NullAway (#485)
• Bump Checker dataflow to 3.16.0 (#490)
• Library Models:
  • Add library model for java.nio.file.Path.getParent() (#464)
  • Default models support for Spring's Autowired (#477)
  • Models for Objects.requireNonNull() with Supplier (#483)
• Build / CI tooling for NullAway itself:
  • Small Gradle build cleanup (#469)
  • Allow Error Prone API version to be configured via a property (#470)
  • Also test NullAway on Error Prone 2.6.0 (#471)
  • Check our code with Error Prone 2.6.0 (#472) [temporary, see below]
  • Check code with Error Prone 2.7.1 (#480)
  • Update to Gradle 7.0.2 (#481) then 7.1 (#486)
  • Add a jmh module for benchmarking (#487, #489)
  • Test on CI with Error Prone 2.8.0 (#491)

Version 0.9.1

• Add baseline support for (Java 15) records (#377)
• Multiple build tooling fixed:
  • Update Gradle to 6.8.3 (#451)
  • Gradle: switch to java-library plugin where possible (#455)
  • Switch from mvn-push script to gradle-maven-publish-plugin (#457)
  • Fix publication of fat jar for jar-infer-cli. (#461)
• Add JarInfer models for Android 11 (SDK 30) (#460)

Version 0.9.0

• IMPORTANT: Error Prone minimum version moved to 2.4.0 (#447)
  • This allows compatibility with Error Prone 2.5.1 by moving to updated APIs.
  • Remove Checker Framework shadow config from nullaway module (#449)
• @Contract annotations are now checked (#312) (#428) (#450)
• Add support for @RequiresNonnull/@EnsuresNonnull annotations (#423)
• [Fix] Handle WideningConversionNode in Map key specifiers (#415)
• [Fix] Try to handle lombok.Builder without crashing. (#414)
• [Fix] Ignore library models return nullability on first-party code (#446)
• Update to Checker Dataflow dependency to 3.6.0 (#416)
• Library Models:
  • Add library model for TextView.getLayout() (#418)
  • Add library model for Service.onStartCommand (#419)
  • Models for common Spring/Spark/Apache utility classes (#436)
  • Add support for jakarta.inject-api (#439)
• Build / CI tooling for NullAway itself:
  • Update to Gradle 6.6.1 (#420)
  • Switch CI to GitHub Actions (#440) (#442) (#450)

Version 0.8.0

• Improve suppression of subcheckers, using full AST path (#392)
• Support null implies false library models (#394)
• Make @ChecksForNull an alias for @Nullable (#397)
• Fix: android-jar.py's exit code. (#399)
• Upgrade Error Prone dependencies to 2.4.0. (#400)
  • And fix detected issues (#403, #404)
• Allow library models of the form null param -> null return (#407)
• Make excluded class annotations work on nested classes (#412)
• Improved Map handling: Strings and integers. (#413)
• Also -SNAPSHOT builds are being published correctly again (#409)
• New android-jarinfer-models-sdk29 artifact for Android 10

Version 0.7.10

• Add Java 8 streams nullness-propagation support (#371)
• Give line numbers for uninitialized fields when reporting error on an initializer (#380)
• Include outer$inner class name when reporting field init errors (#375)
• Update to Gradle 6.1.1 (#381)
• Add @MonotonicNonNull as lazy initialization annotation. (#383)
• Add default library model for CompilationUnitTree.getPackageName() (#384)
• Improve matching of native Map methods (#390)
  • Fixes an IndexOutOfBoundsException checker crash

Version 0.7.9

• Multiple dependency upgrades
  • Gradle to 5.6.2. (#362)
  • WALA to 1.5.4 (#337)
  • Checker Dataflow to 3.0.0 (#369)
• Added OPTIONAL_CONTENT synthetic field to track Optional emptiness (#364)
  • With this, -XepOpt:NullAway:CheckOptionalEmptiness should be ready for use.
• Handle Nullchk operator (#368)

Version 0.7.8

• Added NullAway.Optional suppression (#359)
• [JarInfer] Ignore non-public classes when inferring annotations. (#360)

Version 0.7.7

• [Optionals] Support Optional isPresent call in assertThat (#349)
• Preconditions checkNotNull support, added missing cases. (#355)
• [JarInfer] Use Android Nullable/NonNull annotations for AARs (not javax) (#357)

Version 0.7.6

• Library models for guava's AsyncFunction (#328)
• Annotate StringUtils.isBlank() of org.apache.commons (lang & lang3) (#330)
• Adding support for Aar-to-aar transformation (#334)
• Add support for @RecentlyNullable and @RecentlyNonNull (#335)
• Update to Gradle 5.5.1 (#336)
• Don't compute frames on bytecode writting in JarInfer (#338)
• Use exact jar output path when possible in JarInfer (#339)
• Avoid adding redundant annotations during bytecode rewriting in JarInfer (#341)
• Handle cases when there are no annotations on methods or parameters in JarInfer (#342)
• Fix #333 Nullaway init suppression issue (#343)
• Add option to JarInfer to deal with signed jars (#345)
• Fix #344 onActivityCreated known initializer (#346)
• Skip read-before-init analysis for assert statements (#348)

Version 0.7.5

• Allow models to override @nullable on third-party functional interfaces (#326)
  • Defines Guava's Function and Predicate as @NonNull->@NonNull by default.

Version 0.7.4

• Add support for Jar to Jar transformation to JarInfer (#316)
• Refactor the driver and annotation summary type in JarInfer (#317)
• Minor refactor and cleanup in JarInfer-lib (#319)
• Different approach for param analysis (#320)
• Fix @NullableDecl support (#324)
• Treat methods of final classes as final for initialization. (#325)

Version 0.7.3

• Optional support for assertThat(...).isNotNull() statements (#304)
• Fix NPE in AccessPathElement.toString() (#306)
• Add tests for optional emptiness support with Rx (#308)
• Support for assertThat in JUnit and Hamcrest. (#310)
• Add support for CoreMatchers and core.IsNull in hamcrest. (#311)
• Make class-level caches for InferredJARModelsHandler instance fields. (#315)

Version 0.7.2

• Install GJF hook using a gradle task, rather than a gradlew hack (#298).
• Nullable switch expression support (#300).
• Upgrade to Error Prone 2.3.3 (#295). Update Gradle, Error Prone plugin, and Android Gradle Plugin (#294). Add support for UNSIGNED_RIGHT_SHIFT (#303).

Version 0.7.1

• Remove warning about @nullable var args (#296).

Version 0.7.0

• Added Optional emptiness handler (#278). -XepOpt:NullAway:CheckOptionalEmptiness=true to enable (experimental) support for Optional emptiness.
• Improved (partial but sound-er) varargs support (#291).
• Refactor for ErrorMessage class use (#284).
• Custom path to Optional class for Optional emptiness handler (#288).
• Add support for methods taking literal constant args in Access Paths. (#285).

Version 0.6.6

This only adds a minor library fix supporting Guava's Preconditions.checkNotNull with an error message argument (#283)

Version 0.6.5

• Various fixes for generating @SuppressWarnings (#271)
• Improved error message now doesn't tell users to report NullAway config errors to Error Prone (#273)
• Adding support for Activity and Fragment coming from the support libraries (#275)
• Library models fixes (#277)
• Add Fragment.onViewCreated as a known initializer. (#279)

Version 0.6.4

• Initial support for JDK 11 (#263). Core NullAway should be working, but JarInfer does not yet work.
• Disable JarInfer handler by default (#261). -XepOpt:NullAway:JarInferEnabled=true is now required to enable the JarInfer handler.
• Add models for Apache StringUtils isEmpty methods (#264)
• Optimize library model lookups to reduce overhead (#265)

Version 0.6.3

• Fix handling of enhanced for loops (#256)

Version 0.6.2

• Handle lambda override with AcknowledgeRestrictiveAnnotations (#255)
• Handle interaction between AcknowledgeRestrictiveAnnotations and TreatGeneratedAsUnannotated (#254)

Version 0.6.1

• Enable excluded class annotations to (mostly) work on inner classes (#239)
• Assertion of not equal to null updates the access path (#240)
• Update Gradle examples in README (#244)
• Change how jarinfer finds astubx model jars. (#243)
• Update to Error Prone 2.3.2 (#242)
• Update net.ltgt.errorprone to 0.6, and build updates ((#248)
• Restrictive annotated method overriding (#249) Note: This can require significant annotation changes if -XepOpt:NullAway:AcknowledgeRestrictiveAnnotations=true is set. Not a new minor version, since that option is false by default.
• Fix error on checking the initTree2PrevFieldInit cache. (#252)
• Add support for renamed android.support packages in models. (#253)

Version 0.6.0

• Add support for marking library parameters as explicitly @Nullable (#228)
• De-genericize NullnessStore (#231)
• Bump Checker Framework to 2.5.5 (#233)
• Pass nullability info on enclosing locals into dataflow analysis for lambdas and anonymous / local classes (#235)

Version 0.5.6

• Add coverage measurement through coveralls. (#224)
• Fix empty comment added when AutoFixSuppressionComment is not set. (#225)
• Make JarInfer generated jars fully deterministic by removing timestamps. (#227)

Version 0.5.5

• Allow for custom Error URLS (#220)
• Fix crash with native methods invoked from initializer (#222)

Version 0.5.4

• Add AutoFixSuppressionComment flag. (#213)
• [JarInfer] Write to/load from separate astubx model jars (#214)
• Update readme and tooling versions (#217)
• Update to Error Prone 2.3.1 and centralize Java compiler flags (#218)
• [JarInfer] Handler for @Nullable return value annotations (#216)

Version 0.5.3

• JarInfer: Third-party bytecode analysis (MVP version) (#199)
• Handle @NotNull in hasNonNullAnnotation. (#204)
• Handler for separate Android models jar (#206)
• fix: zip entry size error (#207)
• Small test for restrictive annotations and generics. (#209)
• Create android-jarinfer-models-sdk28 and fix release scripts. (#210)
• JarInfer checks for null tested parameters #211

Note: This is the first release to include jar-infer-cli, jar-infer-lib, and android-jarinfer-models-sdk28 artifacts

Version 0.5.2

• Fix NPE in Thrift handler on complex receiver expressions (#195)
• Add ExcludedFieldAnnotations unit tests. (#192)
• Various crash fixes (#196)
• Fix @NonNull argument detection in RestrictiveAnnotationHandler. (#198)

Version 0.5.1

• Various fixes for AcknowledgeRestrictiveAnnotations (#194)

Version 0.5.0

• Breaking change: Warn when castToNonNull method is not passed @NonNull (#191)
• Add -XepOpt:NullAway:AcknowledgeRestrictiveAnnotations config flag. (#189)
  • WARNING: This feature is broken in this release, fixed on 0.5.1
• Add support for LEFT_SHIFT and RIGHT_SHIFT (#188)
• Remove a suppression from a test that doesn't need it. (#183)
• Support Objects.isNull (#179)

Version 0.4.7

• Clean up some unnecessary state (#168)
• Properly read type use annotations when code is present as a class file (#172)
• Fix NPE inside NullAway when initializer methods use try-with-resources (#177)

Version 0.4.6

• Fix a couple of Thrift issues (#164)
• Don't report initialization warnings on fields for @ExternalInit classes with no initializer methods (#166)

Version 0.4.5

• Fix bug with handling Thrift TBase.isSet() calls (#161)

Version 0.4.4

• add UnannotatedClasses option (#160)

Version 0.4.3

• properly handle compound assignments (#157)
• handle unboxing of array index expression (#158)

Version 0.4.2

• Upgrade Checker Framework dependency to upstream version 2.5.0 (#150)
• Don't crash on field initialization inside an enum (#146)
• Properly find super constructor for anonymous classes (#147)
• Add a Handler for supporting isSetXXXX() methods in Thrift-generated code (#148)
• Use @SuppressWarnings as autofix in a couple more places (#149)

Version 0.4.1

• Initial RxNullabilityPropagator support for method references. (#141)

Version 0.4.0

• Support for checking uses of method references (#139, #140). Note that this may lead to new NullAway warnings being reported for code that previously passed.
• Add support for Observable.doOnNext to RxNullabilityPropagator (#137)

Version 0.3.7

• Small bug fix in @Contract support (#136)

Version 0.3.6

• Support for a subset of JetBrains @Contract annotations (#129)
• Built-in support for JUnit 4/5 assertNotNull, Objects.requireNonNull
• Fix crash when using try-with-resource with an empty try block. (#135)

Version 0.3.5

• Support for treating @Generated-annotated classes as unannotated (#127)

Version 0.3.4

• Support for classes with external initialization (#124)

Version 0.3.3

• Made dependence on Guava explicit (#120)
• Significantly improved handling of try/finally (#123)

Version 0.3.2

• Just fixed a Gradle configuration problem

Version 0.3.1 (never made it to Maven Central)

• Bug fixes (#107, #108, #110, #112)

Version 0.3.0

• Update library models to require full method signatures rather than just method names (#90). This is an API-breaking change; if you've written your own library models, they will need to be updated.
• Support @BeforeEach and @BeforeAll as initializer annotations, and @Inject and @LazyInit as excluded field annotations. (#81)
• Support Checker Framework's @NullableDecl annotation (#84)
• Add models for java.util.Deque methods (#86)
• Add model for WebView.getUrl() (#91)

Version 0.2.2

• minor fixes (#69, #71)

Version 0.2.1

• Fix bug with accesses of fields from unannotated packages (#67)
• Add models for ArrayDeque (#68)

Version 0.2.0

• New feature: NullAway now does some checking that @NonNull fields are not used before the are initialized (#58, #63). Updating to 0.2.0 may cause “read before initialized” problems to be detected in code that was NullAway-clean before.
• Model Throwable.getMessage() as returning @Nullable, matching the spec. This may also cause new warnings in code that was previously NullAway-clean.

Version 0.1.8

• Make NullAway's Error Prone dependence compileOnly (#50). This could help reduce size of annotation processor paths, speeding build times.
• Handle AND, OR, XOR expressions getting autoboxed (#55)
• Handle @Nullable type use annotations (#56)

Version 0.1.7

• -XepOpt:NullAway:ExcludedClasses accepts package prefixes. (#38)
• Handle unary minus and unary plus (#40)
• Handle prefix increment / decrement (#43)
• add check for unannotated packages when excluding a class (#46)

Version 0.1.6

• We now check static fields and initializer blocks (#34)
• Fix for lambdas where the functional interface method had void return type (#37)

Version 0.1.5

• Add finer grained suppressions and auto-fixes (#31). You can suppress initialization errors specifically now with @SuppressWarnings("NullAway.Init")
• Fix performance issue with lambdas (#29)
• Add lambda support to the RxNullabilityPropagator handler. (#12)

Version 0.1.4

• Another lambda fix (#23)

Version 0.1.3

• Fixes for lambdas (#13, #17)

Version 0.1.2

• Downgrade Checker Framework due to crash (#7)
• More modeling of Rx operators (#8)

Version 0.1.1

• Update Checker Framework dependence to pick up bug fix (#4)

Version 0.1.0

• Initial release