infer v1.0.0 Release Notes

  • Checkers

    ๐Ÿ‘• AL is now deprecated and may be removed in future versions.

    ๐Ÿ“„ Annotation Reachability

    • ๐Ÿ“‡ reporting format improvements (the trace is no longer included in the report text, only as metadata)

    ๐Ÿ“„ Biabduction

    • disable some less-used bug types

    ๐Ÿ“„ Eradicate

    • โœ‚ remove "Field not mutable" check

    ๐Ÿ“„ RacerD

    • 0๏ธโƒฃ Now defaults to "angelic" ownership: an unknown function is assumed to return owned objects.
    • No more reports on races on paths rooted on temporary or local variables, as these are unreliably modelled.

    ๐Ÿ†• Litho Required Properties: new Java checker to check that all non-optional @Props have been specified when constructing Litho components. ๐Ÿ†• Self in Block: new Objective-C checker to detect when an Objective-C block incorrectly captures self ๐Ÿ“„ Starvation

    • ๐Ÿ†• New experimental "global" analysis mode. Enable with --starvation-whole-program

    ๐Ÿ“„ Miscellaneous improvements to most checkers, in particular Annotation Reachability, Cost Analysis, Eradicate, Inefficient Keyset Iterator, InferBO, Pulse, RacerD, Starvation, and Uninitialized Value.

    ๐Ÿ‘ท Build System Integrations

    • The Gradle integration now captures Java files in parallel
    • ๐Ÿ†• New Buck integration for Java, enable with --buck-java-flavor
    • โฌ†๏ธ Clang upgraded to version 9.0

    ๐Ÿ’ป Command Line Interface

    • ๐Ÿ†• New subcommand infer help to display information about checkers and issue types.
    • ๐Ÿ†• New subcommand infer debug that replaces the uses of infer explore not related to reported issues.
    • --debug no longer disables filtering, you have to pass -g -F to get the previous behaviour back.
    • All disk artefacts (except the Java type environment) are now stored in the SQLite database in infer-out/results.db. The contents of the database can be explored with infer debug.
    • ๐Ÿ”„ Changed how to select the Buck integration. The old command line interface is still supported but is now deprecated.
      • clang via "flavors", activated with --flavors, now with --buck-clang
      • clang via "compilation DB", activated with --buck-compilation-database, unchanged
      • Java via "genrule", activated with --genrule-master-mode, now with --buck-java
      • Java "without genrules", used to be activated by not specifying any other Buck mode, deleted
      • In addition, there is a new Java integration, activated with --buck-java-flavor
    • ๐Ÿšš The textual version of the report infer-out/bugs.txt has moved to infer-out/report.txt. The bugs.txt file is still created with dummy contents to allow for a smooth transition.
    • โœ‚ Removed the --report-hook option.
    • Properly terminate on Control-C instead of sometimes leaving around zombie processes.
    • Spec files (summaries) are now stored in the database. Explore with infer debug --procedures --procedures-summary.

    ๐Ÿ“š Documentation

    • ๐Ÿ“š Revamped online documentation for bug types and checkers. See the list of all issue types and the pages for each checker. The infer help command can be used locally to also get this information and more.
    • ๐Ÿ“š Access the documentation for previous and future versions online.
    • The https://fbinfer.com/ website now uses Docusaurus 2.

    Internal Changes

    • ๐Ÿ”Œ Folded the facebook-clang-plugins sub-repo inside the infer repository; there is no more git submodule for it.
    • ๐Ÿ‘Œ Improve internal documentation of OCaml source code.
    • ๐Ÿ— Build with OCaml 4.11.1 and dune 2.7.1
    • Migrated our Python 2 code to OCaml
    • Split the infer OCaml source code into individual dune libraries.
    • ๐Ÿ‘ Better defaults for SQLite, and a write daemon to reduce contention.
    • ๐Ÿ†• New analysis schedulers that speed up the analysis phase. Enable with --scheduler callgraph or --scheduler restart.
    • ๐Ÿ— Infer no longer builds by default in "opt" mode (optimised, using OCamlโ€™s flambda pass). The default is now "dev", which does not include as many optimisations (hence builds faster) and turns warnings into errors.
    • The starvation checker is now based on SIL instead of HIL.