This project uses Break Versioning as of Aug 16, 2014.
[com.taoensso/nippy "2.15.0-alpha1"]
This is is a maintenance release, and should be non-breaking but please report any problems - thanks!
[com.taoensso/nippy "2.14.0"]
This is a minor, non-breaking maintenance release.
[com.taoensso/nippy "2.13.0"]
This is a minor, non-breaking maintenance release.
freeze-to-file and thaw-from-file utils (@Engelberg)[com.taoensso/nippy "2.13.0-RC1"]
This should be a minor, non-breaking release.
[com.taoensso/nippy "2.12.2"]
[com.taoensso/nippy "2.12.1"]
[com.taoensso/nippy "2.12.0"]
This is a major release that may involve some breaking API changes in rare cases for users of some low-level or obscure features that have been made private or removed. If your code compiles with this new version of Nippy, you should be fine.
As with all Nippy releases: this version can read data written by older versions but older versions may not be able to read data written by this version.
No changes since
2.12.0-RC2Changes since2.11.1:
*final-freeze-fallback* (rarely used)*default-freeze-compressor-selector* (rarely used)write-<x> and read-<x> fns (rarely used)cache docstring for details)fast-freeze, fast-thaw utils (please see docstrings for details)freeze return val is no longer auto type hinted as ^bytes (had a performance cost, rarely used)fn?s were incorrectly reporting true for serializable?[com.taoensso/nippy "2.12.0-RC2"]
Changes since
2.12.0-RC1:
cache feature now supports metadata[com.taoensso/nippy "2.12.0-RC1"]
This is a major release that may involve some breaking API changes in rare cases for users of some low-level or obscure features that have been made private or removed. If your code compiles with this new version of Nippy, you should be fine.
As with all Nippy releases: this version can read data written by older versions but older versions may not be able to read data written by this version.
PLEASE REPORT ANY PROBLEMS, thank you!
No changes since
2.12.0-beta3. Changes since2.11.1:
*final-freeze-fallback* (rarely used)*default-freeze-compressor-selector* (rarely used)write-<x> and read-<x> fns (rarely used)cache docstring for details)fast-freeze, fast-thaw utils (please see docstrings for details)freeze return val is no longer auto type hinted as ^bytes (had a performance cost, rarely used)fn?s were incorrectly reporting true for serializable?[com.taoensso/nippy "2.12.0-beta3"]
Changes since 2.12.0-beta2:
fn?s were incorrectly reporting true for serializable?[com.taoensso/nippy "2.12.0-beta2"]
This is a major release that may involve some breaking API changes in rare cases for users of some low-level or obscure features that have been made private or removed. If your code compiles with this new version of Nippy, you should be fine.
As with all Nippy releases: this version can read data written by older versions but older versions may not be able to read data written by this version.
*final-freeze-fallback* (rarely used)*default-freeze-compressor-selector* (rarely used)write-<x> and read-<x> fns (rarely used)cache docstring for details)fast-freeze, fast-thaw utils (please see docstrings for details)freeze return val is no longer auto type hinted as ^bytes (had a performance cost, rarely used)PLEASE REPORT ANY PROBLEMS, thank you!
Hotfix for broken Clojure 1.5 support
[com.taoensso/nippy "2.11.1"]
Identical to v2.11.0-beta1 (published December 13 2015)
[com.taoensso/nippy "2.11.0"]
Identical to v2.11.0-beta1 (published December 13 2015)
[com.taoensso/nippy "2.11.0-RC1"]
This is a major performance release that drops default support for thawing Nippy v1 archives but is otherwise non-breaking
thaw now has :v1-compatibility? opt set to false by default (was true before) [1]freeze when using no compression or encryption[com.taoensso/nippy "2.11.0-beta1"]
[1] Use (thaw <frozen-byte-array> {:v1-compatibility? true}) to support thawing of data frozen with Nippy v1 (before ~June 2013)
This is a major feature/performance release that drops support for Clojure 1.4 but is otherwise non-breaking
*default-freeze-compressor-selector*, set-default-freeze-compressor-selector! util*custom-readers*, swap-custom-readers! util*print-level*, *print-length* for safety[com.taoensso/nippy "2.10.0"]
This is a hotfix release with an important fix for Nippy encryption users
[com.taoensso/nippy "2.9.1"]
This is a major non-breaking release that improves performance and makes thawing more resilient to certain failures. Identical to v2.9.0-RC3.
doseq -> (faster) run! callsfreeze compression scheme using :auto compressor (now the default). This can result in significant speed+space improvements for users serializing many small values.[com.taoensso/nippy "2.9.0"]
This is a maintenance release with some minor fixes and some dependency updates.
freezable? should return true for clojure.lang.PersistentVector (@chairmanwow).This is a minor maintenance release & should be a safe upgrade for users of v2.7.0/RC-1.
No changes from v2.7.0-RC1.
Major release with significant performance improvements, a new default compression type (LZ4), and better support for a variety of compression/encryption tools.
The data format is fully backwards-compatible, the API is backwards compatible unless you are using the
:headerless-metathaw option.
thaw :headerless-meta option has been dropped. Its purpose was to provide Nippy v1 compatibility, which is now done automatically. To prevent any surprises, thaw calls with this option will now throw an assertion error.thaw API has been improved (simplified). The default :encryptor and :compressor values are now both :auto, which'll choose intelligently based on data now included with the Nippy header. Behaviour remains the same for data written without a header: you must specify the correct :compressor and :encryptor values manually.taoensso.nippy.compression ns, taoensso.nippy.encryption ns, taoensso.nippy.tools ns, extend-freeze, extend-thaw.ex-infos.extend-thaw now prints a warning when replacing a pre-existing type id.extend-freeze, extend-thaw can now take arbitrary keyword type ids (see docstrings for more info).CRITICAL FIX for v2.6.0 released 9 days ago. Please upgrade ASAP!
Small strings weren't getting a proper UTF-8 encoding:
(.getBytes <string>) was being used here instead of
(.getBytes <string> "UTF-8") as is correct and done elsewhere.
This means that small UTF-8 strings may have been incorrectly stored in environments where UTF-8 is not the default JVM character encoding.
Bug was introduced in Nippy v2.6.0, released 9 days ago (2014 Mar 30).
Please check for possible errors in Unicode text written using Nippy v2.6.0 if your JVM uses an alternative character encoding by default
Really sorry about this! Thanks to @xkihzew for the bug report.
Major release with efficiency improvements, reliability improvements, and some new utils.
freeze-to-out!, thaw-from-in! for operating directly on DataOutputs/DataInputs.:skip-header? freeze option to freeze data without standard Nippy headers (can be useful in very performance sensitive environments).freezable? util fn to main ns.write-bytes, write-biginteger, write-utf8, write-compact-long, and respective readers.Compressable-LZMA2 type has changed (less overhead).freeze-to-stream!, thaw-from-stream! are deprecated in favor of the more general freeze-to-out!, thaw-from-in!.:legacy-mode options. This was being used mainly for headerless freezing, so a new headerless mode is taking its place.BigInteger and BigInt on thawing (previously both thawed to BigInts). (mlacorte).encore dependency.serializable?/readable? for types with gensym-style names (e.g. as used for anonymous fns, etc.).inspect-ba fn for examining data possibly frozen by Nippy.Compressable-LZMA2 type & (replaceable) de/serializer.:read-eval?, :print-dup? options.Thanks to James Reeves (weavejester) for these changes!:
tools.reader.edn for safer reader fallback.Exposed low-level fns: freeze-to-stream!, thaw-from-stream!.
Added extend-freeze and extend-thaw for extending to custom types:
Added support for easily extending Nippy de/serialization to custom types:
(defrecord MyType [data])
(nippy/extend-freeze MyType 1 [x steam] (.writeUTF stream (:data x)))
(nippy/extend-thaw 1 [stream] (->MyType (.readUTF stream)))
(nippy/thaw (nippy/freeze (->MyType "Joe"))) => #taoensso.nippy.MyType{:data "Joe"}
MIGRATION NOTE: Please be sure to use lein clean to clear old (v1) build artifacts!
Refactored for huge performance improvements (~40% roundtrip time).
New header format for better error messages.
New taoensso.nippy.tools ns for easier integration with 3rd-party tools.
DEPRECATED: freeze-to-bytes -> freeze, thaw-from-bytes -> thaw.
See the new fn docstrings for updated opts, etc.
Added pluggable compression support:
(freeze "Hello") ; defaults to:
(freeze "Hello" {:compressor taoensso.nippy.compression/snappy-compressor})
;; The :compressor value above can be replaced with nil (no compressor) or
;; an alternative Compressor implementing the appropriate protocol
Added pluggable crypto support:
(freeze "Hello") ; defaults to:
(freeze "Hello" {:encryptor taoensso.nippy.encryption/aes128-encryptor}
;; The :encryptor value above can be replaced with nil (no encryptor) or
;; an alternative Encryptor implementing the appropriate protocol
See the README for an example using encryption.
Can you improve this documentation?Edit on GitHub
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |