Skip to content

A clojure wrapper for the fressian library, lifted from fressian tests

Notifications You must be signed in to change notification settings

vitalreactor/fressian-clojure

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fressian-clojure

A simple wrapper for the fressian binary encoding protocol that makes it easy to use from and for clojure. No attention paid to performance yet.

Support clojure keywords, symbols, and maps in addition to the default fressian options.

Usage

:dependencies [fressian-clojure "0.2.0"]

(:use [org.fressian.clojure :only [decode encode add-handler]])

Very simple to use

(def byte-array (fr/encode obj) ;; returns byte[]

(fr/decode byte-array)          ;; returns obj

Can add your own global handlers for new types:

(fr/add-handler org.type.MyType "mytag" <writer> <reader>)

This is a critical facility if you wish to retain the types of defrecords or deftype values during decoding. For defrecords, the decoded result is a plain map. See the file clojure.clj for examples of writers and readers and other methods of interest.

Caveats

  • Should be reasonably efficient, but no guarantees about encoding/decoding optimality, especially for collection types
  • Default serializer handlers do not distinguish between array and hash maps
  • Records are deserialized as maps by default (see above)
  • Structs are always deserialized as maps
  • Collection metadata is ignored
  • Functions cannot be serialized
  • No support for persistent queues yet

License

Copyright (c) Metadata Partners, 2013. All rights reserved.

The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php). By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.

About

A clojure wrapper for the fressian library, lifted from fressian tests

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published