boopickle


License

License

GroupId

GroupId

io.suzaku
ArtifactId

ArtifactId

boopickle_2.11
Last Version

Last Version

1.3.1
Release Date

Release Date

Type

Type

jar
Description

Description

boopickle
boopickle
Project URL

Project URL

https://github.com/suzaku-io/boopickle
Project Organization

Project Organization

io.suzaku
Source Code Management

Source Code Management

https://github.com/suzaku-io/boopickle

Download boopickle_2.11

How to add to project

<!-- https://jarcasting.com/artifacts/io.suzaku/boopickle_2.11/ -->
<dependency>
    <groupId>io.suzaku</groupId>
    <artifactId>boopickle_2.11</artifactId>
    <version>1.3.1</version>
</dependency>
// https://jarcasting.com/artifacts/io.suzaku/boopickle_2.11/
implementation 'io.suzaku:boopickle_2.11:1.3.1'
// https://jarcasting.com/artifacts/io.suzaku/boopickle_2.11/
implementation ("io.suzaku:boopickle_2.11:1.3.1")
'io.suzaku:boopickle_2.11:jar:1.3.1'
<dependency org="io.suzaku" name="boopickle_2.11" rev="1.3.1">
  <artifact name="boopickle_2.11" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.suzaku', module='boopickle_2.11', version='1.3.1')
)
libraryDependencies += "io.suzaku" % "boopickle_2.11" % "1.3.1"
[io.suzaku/boopickle_2.11 "1.3.1"]

Dependencies

compile (1)

Group / Artifact Type Version
org.scala-lang : scala-library jar 2.11.12

provided (1)

Group / Artifact Type Version
org.scala-lang : scala-reflect jar 2.11.12

test (1)

Group / Artifact Type Version
com.lihaoyi : utest_2.11 jar 0.6.7

Project Modules

There are no modules declared in this project.

BooPickle

Join the chat at https://gitter.im/ochrons/boopickle

Build Status Scala.js

BooPickle is the fastest and most size efficient serialization (aka pickling) library that works on both Scala and Scala.js. It encodes into a binary format instead of the more customary JSON. A binary format brings efficiency gains in both size and speed, at the cost of legibility of the encoded data. BooPickle borrows heavily from both uPickle and Prickle so special thanks to Li Haoyi and Ben Hutchison for those two great libraries!

Features

  • Supports both Scala, Scala Native and Scala.js (no reflection!)
  • Serialization support for all primitives, collections, options, tuples and case classes (including class hierarchies)
  • User-definable custom serializers
  • Transforming serializers to simplify serializing non-case classes
  • Handles references and deduplication of identical objects
  • Very fast
  • Very efficient coding
  • Low memory usage, no intermediate structures needed
  • Zero dependencies
  • Scala 2.12/2.13
  • All modern browsers are supported (not IE9 and below, though)

Getting started

Add following dependency declaration to your Scala project

"io.suzaku" %% "boopickle" % "1.3.2"

On a Scala.js / Scala Native project the dependency looks like this

"io.suzaku" %%% "boopickle" % "1.3.2"

To use it in your code, simply import the Default object contents. All examples in this document assume this import is present.

import boopickle.Default._

To serialize (pickle) something, just call Pickle.intoBytes with your data. This will produce a binary ByteBuffer containing an encoded version of your data.

val data = Seq("Hello", "World!")
val buf = Pickle.intoBytes(data)

And to deserialize (unpickle) the buffer, call Unpickle.fromBytes, specifying the type of your data. BooPickle doesn't encode any type information, so you must use the same types when pickling and unpickling.

val helloWorld = Unpickle[Seq[String]].fromBytes(buf)

Documentation

Read the full documentation

Change history

See a separate changes document

Contributors

BooPickle was created and is maintained by Otto Chrons - [email protected] - Twitter: @ochrons.

Special thanks to Li Haoyi and Ben Hutchison for their pickling libraries, which provided more than inspiration to BooPickle.

Contributors: @japgolly, @FlorianKirmaier, @guersam, @akshaal, @cquiroz, @cornerman, @notxcain, @lolgab, @Philippus

io.suzaku

Suzaku

Versions

Version
1.3.1
1.3.0
1.2.6