Neolithic Psychedelic Mushrooms

    level-test

    9.0.0 • Public • Published

    level-test

    Inject temporary and isolated level stores (leveldown, level-js, memdown or custom) into your tests.

    level badge npm Node version Test codecov JavaScript Style Guide Funding

    If you are upgrading: please see UPGRADING.md.

    Usage

    Create a fresh db, without refering to any file system or DOM specifics, so that the same test can be used in the server or the browser! Use whatever test framework you like.

    const level = require('level-test')()
    const db = level({ valueEncoding: 'json' })

    In node it defaults to leveldown for storage, using a unique temporary directory. In the browser it defaults to level-js.

    No database name is needed since level-test generates unique random names. For disk-based systems it uses tempy and in the browser it uses uuid/v4.

    const level = require('level-test')()
    const db = level()

    In either environment use of memdown can be forced with options.mem:

    const level = require('level-test')({ mem: true })
    const db = level({ valueEncoding: 'json' })

    Or use any abstract-leveldown compliant store! In this case level-test assumes the storage is on disk and will thus create a unique temporary directory, unless you pass mem: true.

    const rocksdb = require('rocksdb')
    const level = require('level-test')(rocksdb)
    const db = level({ valueEncoding: 'json' })

    API

    ctor = levelTest([store][, options])

    Returns a function ctor that creates preconfigured levelup instances with temporary storage. The store if provided must be a function and abstract-leveldown compliant. Options:

    • mem: use memdown as store (or assume that store is memdown), default false.
    • Any other option will be merged into ctor options, the latter taking precedence.

    These are equal:

    const db1 = require('level-test')({ valueEncoding: 'json' })()
    const db2 = require('level-test')()({ valueEncoding: 'json' })

    db = ctor([options][, callback])

    Returns a levelup instance via level-packager which wraps the underlying store with encoding-down. In short: the db is functionally equivalent to level. You get deferred open, encodings, Promise support, readable streams and more!

    Options are passed to levelup (which in turn passes them on to the store when opened) as well as encoding-down.

    Please refer to the levelup documentation for usage of the optional callback.

    Contributing

    Level/level-test is an OPEN Open Source Project. This means that:

    Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.

    See the Contribution Guide for more details.

    Donate

    Support us with a monthly donation on Open Collective and help us continue our work. Your logo or avatar will be displayed on our 28+ GitHub repositories and npm packages. 💖

    Active financial contributors

    Open Collective backers Open Collective sponsors

    Past financial contributors

    Open Collective sponsors Open Collective backers

    License

    MIT

    Keywords

    Install

    npm i level-test

    DownloadsWeekly Downloads

    9

    Version

    9.0.0

    License

    MIT

    Unpacked Size

    32.5 kB

    Total Files

    8

    Last publish

    Collaborators

    • vweevers
    • matteo.collina
    • ralphtheninja