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

[#80] Clarify docstrings for low-level freeze/thaw utils

Browse source
This commit is contained in:
Peter Taoussanis 2016-03-10 20:55:51 +07:00
parent d327f0ff38
commit 892937eb34
1 changed files with 6 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
src/taoensso/nippy.clj
View file

@ -216,7 +216,8 @@
(.writeLong out n)))) (.writeLong out n))))
(defn freeze-to-out! (defn freeze-to-out!
"Serializes arg (any Clojure data type) to a DataOutput" "Serializes arg (any Clojure data type) to a DataOutput. Please note that
this is a low-level util: in most cases you'll want `freeze` instead."
;; Basically just wraps `-freeze-to-out` with different arg order + metadata support ;; Basically just wraps `-freeze-to-out` with different arg order + metadata support
[^DataOutput data-output x] [^DataOutput data-output x]
(when-let [m (meta x)] (when-let [m (meta x)]
@ -532,7 +533,8 @@
(defn thaw-from-in! (defn thaw-from-in!
"Deserializes a frozen object from given DataInput to its original Clojure "Deserializes a frozen object from given DataInput to its original Clojure
data type" data type. Please note that this is a low-level util: in most cases you'll
want `thaw` instead."
[^DataInput data-input] [^DataInput data-input]
(let [in data-input (let [in data-input
type-id (.readByte in)] type-id (.readByte in)]
@ -689,8 +691,8 @@
"Unrecognized (but apparently well-formed) header. Data frozen with newer Nippy version?") "Unrecognized (but apparently well-formed) header. Data frozen with newer Nippy version?")
(defn thaw (defn thaw
"Deserializes a frozen object from given byte array to its original Clojure "Deserializes a frozen Nippy byte array to its original Clojure data type.
data type. To thaw custom types, extend the Clojure reader or see `extend-thaw`. To thaw custom types, extend the Clojure reader or see `extend-thaw`.
** By default, supports data frozen with Nippy v2+ ONLY ** ** By default, supports data frozen with Nippy v2+ ONLY **
Add `{:v1-compatibility? true}` option to support thawing of data frozen with Add `{:v1-compatibility? true}` option to support thawing of data frozen with