tecosaur / about.jl Goto Github PK

julia> struct Foo
           a::Int
           b::Matrix{Float32}
           c::typeof(identity)
       end

julia> f = Foo(1, rand(3, 4), identity)
Foo(1, Float32[0.8633268 0.40085334 0.27201754 0.60436267; 0.34008977 0.2632495 0.82902575 0.6264377; 0.32734197 0.008732563 0.8294697 0.10690562], identity)

julia> about(f)
Foo, 16B referencing 128B (<: Any)
 a::Int64            8B 000000000000000000000000 … 00000000000000000000001 1
 b::Matrix{Float32}  8B Ptr{Float32} @0x000000010cbac5c0                   Float32[0.8 … 7 0.106906]
 c::typeof(identity) 0B Ptr?                                               identity

ERROR: InexactError: Int64(NaN)
Stacktrace:
 [1] Int64
   @ ./float.jl:981 [inlined]
 [2] convert
   @ ./number.jl:7 [inlined]
 [3] round
   @ ./rounding.jl:469 [inlined]
 [4] round
   @ ./rounding.jl:467 [inlined]
 [5] memorylayout(io::Base.TTY, type::DataType)
   @ About ~/.julia/packages/About/9q1TE/src/types.jl:102
 [6] memorylayout(io::Base.TTY, value::Foo)
   @ About ~/.julia/packages/About/9q1TE/src/values.jl:72
 [7] about(io::Base.TTY, value::Foo)
   @ About ~/.julia/packages/About/9q1TE/src/values.jl:18
 [8] about(x::Foo)
   @ About ~/.julia/packages/About/9q1TE/src/About.jl:24
 [9] top-level scope
   @ REPL[12]:1

julia> About.structinfo(typeof(f))
3-element Vector{About.FieldInfo}:
 About.FieldInfo(1, :bright_green, 0, 8, 8, false, :a, Int64)
 About.FieldInfo(2, :bright_yellow, 8, 8, 0, true, :b, Matrix{Float32})
 About.FieldInfo(3, :bright_magenta, 16, 0, 0, true, :c, typeof(identity))

julia> Returns(3) |> about
ERROR: "Returns{Int64}(3)" is not defined in module Base
Stacktrace:
 [1] error(s::String)
   @ Base ./error.jl:35
 [2] which
   @ ./reflection.jl:2237 [inlined]
 [3] about(io::Base.TTY, fn::Function)
   @ About ~/.julia/packages/About/wwaGm/src/functions.jl:2
 [4] about(x::Function)
   @ About ~/.julia/packages/About/wwaGm/src/About.jl:28
 [5] |>(x::Function, f::typeof(about))
   @ Base ./operators.jl:926
 [6] top-level scope
   @ REPL[8]:1

julia> str = "Hello, I am writing some text."
"Hello, I am wrinting some text."

julia> about(str)
51-codeunit String (mutable), 51B referencing 59B (<: AbstractString <: Any)
ERROR: ArgumentError: reducing over an empty collection is not allowed; consider supplying `init` to the reducer
Stacktrace:
  [1] _empty_reduce_error()
    @ Base ./reduce.jl:319
  [2] mapreduce_empty(f::Function, op::Function, T::Type)
    @ Base ./reduce.jl:321
[...]
 [10] maximum
    @ ./reducedim.jl:981 [inlined]
 [11] memorylayout(io::Base.TTY, value::String)
    @ About ~/.julia/packages/About/XPN7V/src/values.jl:60
 [12] about(io::Base.TTY, value::String)
    @ About ~/.julia/packages/About/XPN7V/src/values.jl:18
 [13] about(x::String)
    @ About ~/.julia/packages/About/XPN7V/src/About.jl:24
 [14] top-level scope
    @ REPL[13]:1

julia> about(cos ∘ sin)
ERROR: "cos ∘ sin" is not defined in module Base
Stacktrace:
 [1] error(s::String)
   @ Base ./error.jl:35
 [2] which
   @ ./reflection.jl:2246 [inlined]
 [3] about(io::Base.TTY, fn::Function)
   @ About ~/About.jl/src/functions.jl:2
 [4] about(x::Function)
   @ About ~/About.jl/src/About.jl:24
 [5] top-level scope
   @ REPL[27]:1

julia> x = Base.infer_effects(round, Tuple{Type{Float64}, Int})
(+c,+e,+n,+t,+s,+m,+u)

julia> x.nothrow
true

julia> about(x)
Method effects:
 ✔ consistent     guaranteed to return or terminate consistently
 ✔ effect free    guaranteed to be free from externally semantically visible side effects
 ✔ no throw       may throw an exception # Nope! It's "will not throw an exception".
 ✔ terminates     might not always terminate
 ✔ no task state  may access task state (preventing migration between tasks)
 ✔ inaccessible memory only  guaranteed to never access or modify externally accessible mutable memory
 ✔ no undefined behaviour  guaranteed to never execute undefined behaviour
 ✔ non-overlayed  never calls any methods from an overlayed method table