PackStream implementation in Swift

PackStream implementation in Swift

PackStream is a binary message format very similar to MessagePack. It can be used stand-alone, but it has been built as a message format for use in the Bolt protocol to communicate between the Neo4j server and its clients.

This implementation is written in Swift, primarily as a dependency for the Swift Bolt implementation. That implementation will in turn provide Theo, the Neo4j Swift driver, with Bolt support.


Through PackStream you can encode Bool, Int, Float (Double in Swift lingo), String, List, Map and Structure. They all implement the PackProtocol, so if you want to have a collection of packable items, you can specify them as implementing PackProtocol.


First, remember to

import PackStream

Then you can use it, like for instance so:

let map = Map(dictionary: [
    "alpha": 42,
    "beta": 39.3,
    "gamma": "",
    "delta": List(items: [1,2,3,4])
let result = try map.pack()
let restored = try Map.unpack(result)

A list of the numbers 1 to 40

let items = Array(Int8(1)...Int8(40))
let value = List(items: items)

gets encoded to the following bytes


Getting started

To use directly with Xcode, type "swift package generate-xcodeproj"

Swift Package Manager

Add the following to your dependencies array in Package.swift:

.Package(url: "",
 majorVersion: 0),

and you can now do a

swift build


Add the

pod "PackStream"

to your Podfile, and you can now do

pod install

to have PackStream included in your Xcode project via CocoaPods



github "niklassaers/PackStream-swift"

in your Cartfile. If this is your entire Cartfile, do

carthage bootstrap

If you have already done that, do

carthage update


Then do

cd Carthage/Checkouts/PackStream-swift
swift package generate-xcodeproj
cd -

And Carthage is now set up. You can now do

carthage build

and you should find a build for macOS, iOS, tvOS and watchOS in Carthage/Build

Protocol documentation

For reference, please see in Boltkit


  • Swift Tools 5.0.0
View More Packages from this Author


  • None
Last updated: Thu Nov 10 2022 09:24:44 GMT-0500 (GMT-05:00)