Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.9.17

Changed

Even when JET fails to be loaded on nightly versions, stub functions mimicking JET’s API are now defined. These stubs raise an error with an appropriate message when executed. (#688, #689)

0.9.15

Changed

JET.jl now will not be loaded on nightly version by default. This ensures that JETremains at least loadable on nightly builds, where JET's compatibility is not guaranteed. If you want to load JET on a nightly version, set the JET_DEV_MODE configuration of Preferences.jl to true and load it as usual (#684, #686).
JET now fully uses JuliaSyntax.jl for reporting syntax errors (#685).

0.9.14

Added

Added include_callback to the virtual process, allowing custom callback logic during code inclusion (#683).

0.9.12

Fixed

Fixed a broadcasting-related issue in @report_call (which caused false error reports) by allowing concrete evaluation for typejoin (#669, #670).

0.9.11

Fixed

Fixed an exception thrown by report_package on Julia 1.11.1 (#668).

0.9.10

Changed

The improved statement selection logic implemented in v0.9.9 is now ported to LoweredCodeUtils.jl@3.0.2, so that it can shared by JET.jl and Revise.jl.

0.9.9

Added

Added reference documentation on JET’s analysis report-splitting feature (#652).

Changed

Implemented an improved control-flow graph analysis and statement selection logic, enhancing JET’s top-level analysis accuracy (#654).

0.9.8

Added

An extension that integrates @report_opt with Cthulhu (#648)
reportkey for trimming multiple reports that resolve to the same runtime-dispatch caller/callee pair (#648)

0.9.7

Updated dependencies, made minor refactorings.

0.9.6

Fixed

report_opt no longer raises reports from callees on throw code path when the skip_unoptimized_throw_blocks::Bool=true configuration is enabled (#643).

0.9.5

Added

analyze_from_definitions can now be specified as entry_point_name::Symbol to make JET's top-level analyses start analysis using the interpreted method signature whose name is equal to entry_point_name as the analysis entry point. For example, when analyzing a script that specifies its entry point using the new @main special macro, you can specify report_file(script_name; analyze_from_definitions=:main) to automatically start the analysis from the main(args) function.

0.9.4

Changed

Made some adjustments to the warning text in the README.

0.9.3

Added

A simple logo badge for JET.jl is now available (thanks to @MilesCranmer!). You can add the line [![](https://img.shields.io/badge/%F0%9F%9B%A9%EF%B8%8F_tested_with-JET.jl-233f9a)](https://github.com/aviatesk/JET.jl) to your package's README to display the logo image that shows your package uses JET.jl for code quality checks (#635).
JET's top-level analyses such as report_package and report_file can now handle the new public keyword that is introduced in v1.11. (#637)

0.9.2

Fixed

Allow overly deep relative module paths when analyzing a package with report_package (#619, #633)

0.9.1

Fixed

Fixed the issue where the line numbers of methods whose locations were revised by Revise were not being updated (#513).

0.9.0

Added

A new configuration stacktrace_types_limit::Union{Nothing,Int}=nothing has been added. It's turned on by default and limits deeply nested types when JET prints reports. If you prefer the old behavior, set stacktrace_types_limit=0 (#601).

Changed

Revise.jl-related features are now implemented as a package extension, so in order to use watch_file, you need to load Revise.jl into your session first (#624, #625).
The compatibility with LoweredCodeUtils has been raised to version 2.4 and later, so it's now possible to use the latest version of Revise with JET again. Additionally, the top-level statement selection algorithm internally used by top-level analysis functions like report_file has been significantly improved.

0.8.9

Fixed

report_package now supports the using Module: Inner.object syntax (#554, #555).
Various internal improvements.

0.8.8

Fixed

report_package now supports the import Module as Alias syntax (#521, #553).

0.8.7

Changed

Changed the default toplevel_logger configuration for test_package to nothing. test_package no longer emits logs like [toplevel-info] analyzing from top-level definitions (xxx/yyy) (#550).

0.8.6

Fixed

Fixed the default ignore_missing_comparison configuration for report_package.

0.8.5

Fixed

Fixed report_package so that it does not produce noisy error reports from reducing on potentially empty collections.

0.8.4

Added

Made the (x == y)::Union{Missing,Bool} → Any widening behavior for report_package (that was added in #542) configurable. Specify report_package("TargetPkg", ignore_missing_comparison=false) if TargetPkg handles missing (#547).

0.8.3

Changed

Generalized the (x == y)::Union{Missing,Bool} → Any widening behavior for report_package that was added in #542 to other comparison operators (e.g. in) (#545).

0.8.2

Changed

JET now ignores the possibility of a poorly-inferred x == y call returning missing during the report_package analysis. Refer to issue #542 for reasons justifying this behavior. Essentially, report_package often relies on poor input argument type information at the beginning of analysis, leading to noisy error reports for function definitions like:
```
struct MyToken end
ismytoken(x) = x == MyToken() ? true : false
```
This error is arguably just noise when the target package does not handle missing. report_package is designed as an entry point for easy analysis, even at the cost of accuracy, so it is not sound from the beginning. Hence, it might be beneficial to simply ignore such noise.

However note that in interactive entry points like report_call, where concrete input argument types are available, this behavior should be turned off. This is because, if the code, when given specific input argument types, results in a Union{Bool,Missing} possibility, it likely signifies an inferrability issue or the code really needs to handle missing (#541, #542).

0.8.1

Fixed

report_package now supports the using MyPkg syntax (without specifying relative module path ...) from inner modules of MyPkg (#539, #540).

0.8.0

Added

report_call and report_opt can now analyze mi::MethodInstance. This feature allows JET to analyze method instances collected by MethodAnalysis.methodinstances. See the documentation for the details. (#510)
This CHANGELOG.md has been added and will be updated (#536).

Changed

JET's tree-like view, which represents inference stacktrace leading to each error point, now closely resembles the stacktrace displayed by Julia Base upon exception. The new view should be more intuitive for general users and additionally, the type information of arguments of each frame are nicely truncated, as in Julia Base.

Before

julia> @report_call sum([])
═════ 1 possible error found ═════
┌ @ reducedim.jl:996 Base.:(var"#sum#821")(:, pairs(NamedTuple()), #self#, a)
│┌ @ reducedim.jl:996 Base._sum(a, dims)
││┌ @ reducedim.jl:1000 Base.:(var"#_sum#823")(pairs(NamedTuple()), #self#, a, _3)
│││┌ @ reducedim.jl:1000 Base._sum(identity, a, :)
││││┌ @ reducedim.jl:1001 Base.:(var"#_sum#824")(pairs(NamedTuple()), #self#, f, a, _4)
│││││┌ @ reducedim.jl:1001 mapreduce(f, Base.add_sum, a)
││││││┌ @ reducedim.jl:357 Base.:(var"#mapreduce#814")(:, Base._InitialValue(), #self#, f, op, A)
│││││││┌ @ reducedim.jl:357 Base._mapreduce_dim(f, op, init, A, dims)
││││││││┌ @ reducedim.jl:365 Base._mapreduce(f, op, IndexStyle(A), A)
│││││││││┌ @ reduce.jl:432 Base.mapreduce_empty_iter(f, op, A, Base.IteratorEltype(A))
││││││││││┌ @ reduce.jl:380 Base.reduce_empty_iter(Base.MappingRF(f, op), itr, ItrEltype)
│││││││││││┌ @ reduce.jl:384 Base.reduce_empty(op, eltype(itr))
││││││││││││┌ @ reduce.jl:361 Base.mapreduce_empty(op.f, op.rf, T)
│││││││││││││┌ @ reduce.jl:372 Base.reduce_empty(op, T)
││││││││││││││┌ @ reduce.jl:352 Base.reduce_empty(+, T)
│││││││││││││││┌ @ reduce.jl:343 zero(T)
││││││││││││││││┌ @ missing.jl:106 Base.throw(Base.MethodError(zero, tuple(Base.Any)))
│││││││││││││││││ MethodError: no method matching zero(::Type{Any}): Base.throw(Base.MethodError(zero, tuple(Base.Any)::Tuple{DataType})::MethodError)
││││││││││││││││└──────────────────

After

julia> @report_call sum([])
═════ 1 possible error found ═════
┌ sum(a::Vector{Any}) @ Base ./reducedim.jl:996
│┌ sum(a::Vector{Any}; dims::Colon, kw::@Kwargs{}) @ Base ./reducedim.jl:996
││┌ _sum(a::Vector{Any}, ::Colon) @ Base ./reducedim.jl:1000
│││┌ _sum(a::Vector{Any}, ::Colon; kw::@Kwargs{}) @ Base ./reducedim.jl:1000
││││┌ _sum(f::typeof(identity), a::Vector{Any}, ::Colon) @ Base ./reducedim.jl:1001
│││││┌ _sum(f::typeof(identity), a::Vector{Any}, ::Colon; kw::@Kwargs{}) @ Base ./reducedim.jl:1001
││││││┌ mapreduce(f::typeof(identity), op::typeof(Base.add_sum), A::Vector{Any}) @ Base ./reducedim.jl:357
│││││││┌ mapreduce(f::typeof(identity), op::typeof(Base.add_sum), A::Vector{Any}; dims::Colon, init::Base._InitialValue) @ Base ./reducedim.jl:357
││││││││┌ _mapreduce_dim(f::typeof(identity), op::typeof(Base.add_sum), ::Base._InitialValue, A::Vector{Any}, ::Colon) @ Base ./reducedim.jl:365
│││││││││┌ _mapreduce(f::typeof(identity), op::typeof(Base.add_sum), ::IndexLinear, A::Vector{Any}) @ Base ./reduce.jl:432
││││││││││┌ mapreduce_empty_iter(f::typeof(identity), op::typeof(Base.add_sum), itr::Vector{Any}, ItrEltype::Base.HasEltype) @ Base ./reduce.jl:380
│││││││││││┌ reduce_empty_iter(op::Base.MappingRF{typeof(identity), typeof(Base.add_sum)}, itr::Vector{Any}, ::Base.HasEltype) @ Base ./reduce.jl:384
││││││││││││┌ reduce_empty(op::Base.MappingRF{typeof(identity), typeof(Base.add_sum)}, ::Type{Any}) @ Base ./reduce.jl:361
│││││││││││││┌ mapreduce_empty(::typeof(identity), op::typeof(Base.add_sum), T::Type{Any}) @ Base ./reduce.jl:372
││││││││││││││┌ reduce_empty(::typeof(Base.add_sum), ::Type{Any}) @ Base ./reduce.jl:352
│││││││││││││││┌ reduce_empty(::typeof(+), ::Type{Any}) @ Base ./reduce.jl:343
││││││││││││││││┌ zero(::Type{Any}) @ Base ./missing.jl:106
│││││││││││││││││ MethodError: no method matching zero(::Type{Any}): Base.throw(Base.MethodError(zero, tuple(Base.Any)::Tuple{DataType})::MethodError)
││││││││││││││││└────────────────────

(#524)

A predicate function that is specified as the function_filter configuration now takes a function object instead of its type. For instance, the following code

myfilter(@nospecialize ft) = !(
    ft === typeof(Base.mapreduce_empty) ||
    ft === typeof(Base.reduce_empty))
@test_opt function_filter=myfilter func(args...)

should now be written:

myfilter(@nospecialize f) = !(
    f === Base.mapreduce_empty ||
    f === Base.reduce_empty)
@test_opt function_filter=myfilter func(args...)

(#507).

Removed

Dropped the support for Julia 1.8. JET now supports Julia 1.9 and above (#527).
report_and_watch_file has been removed. Use watch_file instead.

Fixed

Concrete evaluation is now enabled within JET's error analysis. This fixes numerous false positive error reports, and leads to faster analysis speed (#529, #523, #522).
report_package no longer reports error from methods that are intentionally designed to throw, e.g.
```
@noinline raise_error(x::T) where T = error(lazy"Missing interface implementation for $T")
```
(#532, #477).
report_package no longer reports error from methods with keyword arguments that don't have default values, e.g.
```
struct Bar
    x
end
Bar(; x) = Bar(x)
```
(#532, #478).
Fixed false error report from Base.aligned_sizeof (#512, #514, JuliaLang/julia#49801).
The optimization analysis has been adjusted to prevent skipping the reporting of runtime dispatches within non-compileable but inlineable frames (#526).
The sound error analysis mode has been fixed and now reports if there are any unanalyzed function calls, which typically occur due to excessive matching methods (#533).
report_file can now handle parameterized type alias definitions (#534).
Extensive refactoring and cleanup has been carried out.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

Changed

Changed

Changed

Added

Fixed

Fixed

Changed

Added

Changed

Added

Fixed

Added

Changed

Added

Fixed

Fixed

Added

Changed

Fixed

Fixed

Changed

Fixed

Fixed

Added

Changed

Changed

Fixed

Added

Changed

Removed

Fixed