Add perf timings in docs

docs/Project.toml

@@ -1,3 +1,4 @@
 [deps]
+BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
 DispatchedTuples = "508c55e1-51b4-41fd-a5ca-7eb0327d070d"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"

docs/make.jl

@@ -15,7 +15,8 @@ makedocs(
     modules = [DispatchedTuples],
     pages = Any[
         "Home" => "index.md",
-        "Performance" => "performance.md",
+        "Performance introspection" => "performance.md",
+        "Performance timing" => "performance_timing.md",
         "API" => "api.md",
     ],
 )

docs/src/perf.jl

@@ -0,0 +1,48 @@
+using DispatchedTuples
+using BenchmarkTools
+
+# (N, N_buf) are low for quick doc builds
+# (N, N_buf) = (5, 3) is reasonable
+N = 0
+N_buf = 1
+
+foo(i) = Symbol(:Foo, i)
+expr(i) = :(struct $(foo(i)) end)
+for i in 1:N+N_buf
+    eval(expr(i))
+end
+
+fooinst(i::Int) = eval(:($(foo(i))))()
+
+footup(n::Int) = ntuple(n) do i
+    (fooinst(i), i)
+end
+
+function perf_dt(N, N_buf)
+    println("********* DispatchedTuple")
+    for n in N_buf:N+N_buf
+        println("--- n = $n")
+        tup = footup(n)
+        @btime footup($n)
+
+        dtup = DispatchedTuple(tup)
+        @btime DispatchedTuple($tup)
+        # @btime $dtup[Foo3()] # always results in 0.028 ns (0 allocations: 0 bytes)
+    end
+end
+
+function perf_ds(N, N_buf)
+    println("********* DispatchedSet")
+    for n in N_buf:N+N_buf
+        println("--- n = $n")
+        tup = footup(n)
+        @btime footup($n)
+
+        dtup = DispatchedSet(tup)
+        @btime DispatchedSet($tup)
+        # @btime $dtup[Foo3()] # always results in 0.028 ns (0 allocations: 0 bytes)
+    end
+end
+
+perf_dt(N, N_buf)
+perf_ds(N, N_buf)

docs/src/performance.md

@@ -1,4 +1,4 @@
-# Performance
+# Performance introspection
 
 The performance of `DispatchedTuple`s should scale similar to the performance of ordinary tuples (good with small tuples, but expensive with larger ones).
 

docs/src/performance_timing.md

@@ -0,0 +1,8 @@
+# Performance timing
+
+See the `perf.jl` file for adjusting / experimenting with timings. Note that the output is limited for quick doc builds.
+
+```@example perf
+include("perf.jl")
+nothing
+```