Tests

All tests were run in the REPL with Julia 1.6 using an Apple M1 Pro chip.

`@↓`

using Revise
using ArrowMacros, ExtractMacro, UnPack
using BenchmarkTools

BenchmarkTools.DEFAULT_PARAMETERS.samples = 1_000_000
mutable struct A; a; b; c; end
mutable struct B; d; e; end
s = A(1, [2, 3], B(4, [5, 6]))
v = [s]

Download a field from a struct:

@btime @extract s : a
# 25.226 ns (0 allocations: 0 bytes)
@btime @unpack a = s
# 18.388 ns (0 allocations: 0 bytes)
@btime @↓ a = s
# 18.180 ns (0 allocations: 0 bytes)

Download from a vector of structs:

@btime @extract v[1] : a
# 44.910 ns (0 allocations: 0 bytes)
@btime @unpack a = v[1]
# 36.836 ns (0 allocations: 0 bytes)
@btime @↓ a = v[1]
# 37.760 ns (0 allocations: 0 bytes)

Download multiple fields:

@btime @extract s : a b
# 44.571 ns (0 allocations: 0 bytes)
@btime @unpack a, b = s
# 32.519 ns (0 allocations: 0 bytes)
@btime @↓ a, b = s
# 33.157 ns (0 allocations: 0 bytes)

Download whilst doing some maths:

@btime @extract s : a = 2a
# 48.245 ns (0 allocations: 0 bytes)
@btime @↓ a ← 2a = s
# 41.204 ns (0 allocations: 0 bytes)

Download with different names:

For some reason, @↓ a ← b .+ 1, b = s is not parsed correctly by @btime, hence the need of f(). On the other hand, it works fine with @time.

@btime @extract s : a = b .+ 1 b
# 338.470 ns (3 allocations: 160 bytes)
f() = @↓ a ← b .+ 1, b = s
@btime f()
# 320.763 ns (3 allocations: 160 bytes)

Download from nested structs:

@btime @extract s.c : d e
# 82.642 ns (0 allocations: 0 bytes)
@btime @unpack d, e = s.c
# 52.369 ns (0 allocations: 0 bytes)
@btime @↓ d, e = s.c
# 59.402 ns (0 allocations: 0 bytes)

`@↑`

@↓ a, b, c = s
@↓ e, d = c

Upload a variable into a struct:

@btime @pack! s = a
# 54.822 ns (1 allocation: 16 bytes)
@btime @↑ s = a
# 21.314 ns (0 allocations: 0 bytes)

Upload into a vector of structs:

@btime @pack! v[1] = a
# 65.032 ns (1 allocation: 16 bytes)
@btime @↑ v[1] = a
# 37.215 ns (0 allocations: 0 bytes)

Upload multiple variables:

@btime @pack! s = a, b
# 70.927 ns (1 allocation: 32 bytes)
@btime @↑ s = a, b
# 34.911 ns (0 allocations: 0 bytes)

Upload into nested structs:

@btime @pack! s.c = d, e
# 91.186 ns (1 allocation: 32 bytes)
@btime @↑ s.c = d, e
# 57.264 ns (0 allocations: 0 bytes)