Outdated egg!

This is an egg for CHICKEN 4, the unsupported old release. You're almost certainly looking for the CHICKEN 5 version of this egg, if it exists.

If it does not exist, there may be equivalent functionality provided by another egg; have a look at the egg index. Otherwise, please consider porting this egg to the current version of CHICKEN.


  1. Outdated egg!
  2. sublevel
    1. Description
    2. Example use
    3. API
    4. Source code / issues
    5. Changelog
      1. 4.0.0
      2. 3.0.0
      3. 2.0.0
      4. 1.1.0


Provides easy namespacing of keys inside a single LevelDB database. This is an implementation of the level API.

Example use

(use level leveldb sublevel lazy-seq)

(define db (open-db "./my-database"))

(define books (sublevel db '("books")))
(define cds (sublevel db '("music" "cds")))

(db-put books "book1" "foo")
(db-put books "book2" "bar")

(lazy-seq->list (db-pairs books)) ;; => (("book1" "foo") ("book2" "bar"))
(lazy-seq->list (db-pairs cds)) ;; => ()


[procedure] (sublevel db prefix)

Wraps a level implementation with namespaced access. Keys are generated by joining name space strings with the null character.

[procedure] (expand-sublevels root db ops)

Takes a list of operations (as you would pass to the db-batch procedure) and expands the keys in the list to match the full key that would be written for the provdided sublevel(s). The key namespaces between 'root' and 'db' are expanded. The 'root' argument can be any level implementation (eg, a raw leveldb object or another sublevel).

This can be useful if you find yourself needing to apply a transaction across multiple sublevels. You can use this for each sublevel to build the final batch operations list then use db-batch on the underlying resource.

;; Example
(define db (open-db "./my-database"))
(define sub1 (sublevel db '("one")))
(define sub2 (sublevel sub1 '("two")))

(expand-sublevels db sub2 '((put "example" "value")))
;; => '((put "one\x00two\x00example" "value"))

(expand-sublevels sub1 sub2 '((put "example" "value")))
;; => '((put "two\x00example" "value"))

Source code / issues