luciano/specter
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

more docstrings and benchmarks

Browse source
This commit is contained in:
Nathan Marz 2016-06-07 10:18:20 -04:00
parent 88a79e3d77
commit e76363c532
3 changed files with 12 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
scripts/benchmarks.clj
View file

@ -56,6 +56,9 @@
p (comp-paths :a :b :c)] p (comp-paths :a :b :c)]
(run-benchmark "get value in nested map" 10000000 (run-benchmark "get value in nested map" 10000000
(select-any [:a :b :c] data) (select-any [:a :b :c] data)
(select-one [:a :b :c] data)
(select-first [:a :b :c] data)
(select-one! [:a :b :c] data)
(compiled-select-any p data) (compiled-select-any p data)
(get-in data [:a :b :c]) (get-in data [:a :b :c])
(-> data :a :b :c) (-> data :a :b :c)

9
src/clj/com/rpl/specter.cljx
View file

@ -91,7 +91,8 @@
NONE i/NONE) NONE i/NONE)
(defn select-any* (defn select-any*
"Returns any element found or [[NONE]] if nothing selected." "Returns any element found or [[NONE]] if nothing selected. This is the most
efficient of the various selection operations."
[path structure] [path structure]
(compiled-select-any (i/comp-paths* path) structure)) (compiled-select-any (i/comp-paths* path) structure))
@ -177,7 +178,11 @@
ALL ALL
(comp-paths (i/->AllNavigator))) (comp-paths (i/->AllNavigator)))
(defnav MAP-VALS [] (defnav
^{:doc "Navigate to each value of the map. This is more efficient than
navigating via [ALL LAST]"}
MAP-VALS
[]
(select* [this structure next-fn] (select* [this structure next-fn]
(doseqres NONE [v (vals structure)] (doseqres NONE [v (vals structure)]
(next-fn v) (next-fn v)

3
src/clj/com/rpl/specter/macros.clj
View file

@ -566,7 +566,8 @@
`(i/compiled-select-first* (path ~apath) ~structure)) `(i/compiled-select-first* (path ~apath) ~structure))
(defmacro select-any (defmacro select-any
"Returns any element found or [[NONE]] if nothing selected. "Returns any element found or [[NONE]] if nothing selected. This is the most
efficient of the various selection operations.
This macro will attempt to do inline factoring and caching of the path, falling This macro will attempt to do inline factoring and caching of the path, falling
back to compiling the path on every invocation it it's not possible to back to compiling the path on every invocation it it's not possible to
factor/cache the path." factor/cache the path."