Support running test suite on a levelup db

README.md

@@ -520,6 +520,7 @@ This also serves as a signal to users of your implementation. The following opti
   - Reads don't operate on a [snapshot](#iterator)
   - Snapshots are created asynchronously
 - `createIfMissing` and `errorIfExists`: set to `false` if `db._open()` does not support these options.
+- `legacyRange`: set to `false` if your iterator does not support the legacy `start` and `end` range options.
 
 This metadata will be moved to manifests (`db.supports`) in the future.
 

test/batch-test.js

@@ -11,7 +11,7 @@ exports.setUp = function (test, testCommon) {
 }
 
 exports.args = function (test, testCommon) {
-  test('test callback-less, 2-arg, batch() throws', function (t) {
+  testCommon.promises || test('test callback-less, 2-arg, batch() throws', function (t) {
     t.throws(
       db.batch.bind(db, 'foo', {}),
       /Error: batch\(array\) requires a callback argument/,
@@ -215,7 +215,11 @@ exports.batch = function (test, testCommon) {
       db.get('foo', function (err, value) {
         t.error(err)
         var result
-        if (isTypedArray(value)) {
+
+        if (testCommon.encodings) {
+          t.is(typeof value, 'string')
+          result = value
+        } else if (isTypedArray(value)) {
           result = String.fromCharCode.apply(null, new Uint16Array(value))
         } else {
           t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)
@@ -244,7 +248,10 @@ exports.batch = function (test, testCommon) {
       db.get('foobatch1', function (err, value) {
         t.error(err)
         var result
-        if (isTypedArray(value)) {
+        if (testCommon.encodings) {
+          t.is(typeof value, 'string')
+          result = value
+        } else if (isTypedArray(value)) {
           result = String.fromCharCode.apply(null, new Uint16Array(value))
         } else {
           t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)
@@ -264,7 +271,10 @@ exports.batch = function (test, testCommon) {
       db.get('foobatch3', function (err, value) {
         t.error(err)
         var result
-        if (isTypedArray(value)) {
+        if (testCommon.encodings) {
+          t.is(typeof value, 'string')
+          result = value
+        } else if (isTypedArray(value)) {
           result = String.fromCharCode.apply(null, new Uint16Array(value))
         } else {
           t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)

test/chained-batch-test.js

@@ -123,7 +123,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test batch#write() with no callback', function (t) {
+  testCommon.promises || test('test batch#write() with no callback', function (t) {
     try {
       db.batch().write()
     } catch (err) {
@@ -186,7 +186,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test serialize object', function (t) {
+  testCommon.serialize && test('test serialize object', function (t) {
     var batch = db.batch()
     var ops = collectBatchOps(batch)
 
@@ -202,7 +202,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test custom _serialize*', function (t) {
+  testCommon.serialize && test('test custom _serialize*', function (t) {
     t.plan(4)
 
     var _db = Object.create(db)

test/clear-test.js

@@ -10,7 +10,7 @@ exports.setUp = function (test, testCommon) {
 }
 
 exports.args = function (test, testCommon) {
-  test('test argument-less clear() throws', function (t) {
+  testCommon.promises || test('test argument-less clear() throws', function (t) {
     t.throws(
       db.clear.bind(db),
       /Error: clear\(\) requires a callback argument/,

test/close-test.js

@@ -10,12 +10,12 @@ exports.setUp = function (test, testCommon) {
 
 exports.close = function (test, testCommon) {
   test('test close()', function (t) {
-    t.throws(
+    testCommon.promises || t.throws(
       db.close.bind(db),
       /Error: close\(\) requires a callback argument/,
       'no-arg close() throws'
     )
-    t.throws(
+    testCommon.promises || t.throws(
       db.close.bind(db, 'foo'),
       /Error: close\(\) requires a callback argument/,
       'non-callback close() throws'

test/common.js

@@ -24,7 +24,25 @@ function testCommon (options) {
     errorIfExists: options.errorIfExists !== false,
     snapshots: options.snapshots !== false,
     seek: options.seek !== false,
-    clear: !!options.clear
+    clear: !!options.clear,
+
+    // Allow skipping 'start' and 'end' tests
+    // TODO (next major): drop legacy range options
+    legacyRange: options.legacyRange !== false,
+
+    // Support running test suite on a levelup db. All options below this line
+    // are undocumented and should not be used by abstract-leveldown db's (yet).
+    promises: !!options.promises,
+    status: options.status !== false,
+    serialize: options.serialize !== false,
+
+    // If true, the test suite assumes a default encoding of utf8 (like levelup)
+    // and that operations return strings rather than buffers by default.
+    encodings: !!options.encodings,
+
+    // Not yet used, only here for symmetry with levelup's test suite.
+    deferredOpen: !!options.deferredOpen,
+    streams: !!options.streams
   }
 }
 

test/del-test.js

@@ -10,7 +10,7 @@ exports.setUp = function (test, testCommon) {
 }
 
 exports.args = function (test, testCommon) {
-  test('test argument-less del() throws', function (t) {
+  testCommon.promises || test('test argument-less del() throws', function (t) {
     t.throws(
       db.del.bind(db),
       /Error: del\(\) requires a callback argument/,
@@ -19,7 +19,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test callback-less, 1-arg, del() throws', function (t) {
+  testCommon.promises || test('test callback-less, 1-arg, del() throws', function (t) {
     t.throws(
       db.del.bind(db, 'foo'),
       /Error: del\(\) requires a callback argument/,
@@ -28,7 +28,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test callback-less, 3-arg, del() throws', function (t) {
+  testCommon.promises || test('test callback-less, 3-arg, del() throws', function (t) {
     t.throws(
       db.del.bind(db, 'foo', {}),
       /Error: del\(\) requires a callback argument/,
@@ -37,7 +37,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test custom _serialize*', function (t) {
+  testCommon.serialize && test('test custom _serialize*', function (t) {
     t.plan(3)
     var db = testCommon.factory()
     db._serializeKey = function (data) { return data }

test/get-test.js

@@ -11,7 +11,7 @@ exports.setUp = function (test, testCommon) {
 }
 
 exports.args = function (test, testCommon) {
-  test('test argument-less get() throws', function (t) {
+  testCommon.promises || test('test argument-less get() throws', function (t) {
     t.throws(
       db.get.bind(db),
       /Error: get\(\) requires a callback argument/,
@@ -20,7 +20,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test callback-less, 1-arg, get() throws', function (t) {
+  testCommon.promises || test('test callback-less, 1-arg, get() throws', function (t) {
     t.throws(
       db.get.bind(db, 'foo'),
       /Error: get\(\) requires a callback argument/,
@@ -29,7 +29,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test callback-less, 3-arg, get() throws', function (t) {
+  testCommon.promises || test('test callback-less, 3-arg, get() throws', function (t) {
     t.throws(
       db.get.bind(db, 'foo', {}),
       /Error: get\(\) requires a callback argument/,
@@ -38,7 +38,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test custom _serialize*', function (t) {
+  testCommon.serialize && test('test custom _serialize*', function (t) {
     t.plan(3)
     var db = testCommon.factory()
     db._serializeKey = function (data) { return data }
@@ -61,29 +61,12 @@ exports.get = function (test, testCommon) {
       t.error(err)
       db.get('foo', function (err, value) {
         t.error(err)
-        t.ok(typeof value !== 'string', 'should not be string by default')
 
-        var result
-        if (isTypedArray(value)) {
-          result = String.fromCharCode.apply(null, new Uint16Array(value))
-        } else {
-          t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)
-          try {
-            result = value.toString()
-          } catch (e) {
-            t.error(e, 'should not throw when converting value to a string')
-          }
-        }
-
-        t.equal(result, 'bar')
-
-        db.get('foo', {}, function (err, value) { // same but with {}
-          t.error(err)
+        if (!testCommon.encodings) {
           t.ok(typeof value !== 'string', 'should not be string by default')
 
-          var result
           if (isTypedArray(value)) {
-            result = String.fromCharCode.apply(null, new Uint16Array(value))
+            var result = String.fromCharCode.apply(null, new Uint16Array(value))
           } else {
             t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)
             try {
@@ -92,6 +75,31 @@ exports.get = function (test, testCommon) {
               t.error(e, 'should not throw when converting value to a string')
             }
           }
+        } else {
+          result = value
+        }
+
+        t.equal(result, 'bar')
+
+        db.get('foo', {}, function (err, value) { // same but with {}
+          t.error(err)
+
+          if (!testCommon.encodings) {
+            t.ok(typeof value !== 'string', 'should not be string by default')
+
+            if (isTypedArray(value)) {
+              var result = String.fromCharCode.apply(null, new Uint16Array(value))
+            } else {
+              t.ok(typeof Buffer !== 'undefined' && value instanceof Buffer)
+              try {
+                result = value.toString()
+              } catch (e) {
+                t.error(e, 'should not throw when converting value to a string')
+              }
+            }
+          } else {
+            result = value
+          }
 
           t.equal(result, 'bar')
 

test/iterator-range-test.js

@@ -35,6 +35,10 @@ exports.setUp = function (test, testCommon) {
 
 exports.range = function (test, testCommon) {
   function rangeTest (name, opts, expected) {
+    if (!testCommon.legacyRange && ('start' in opts || 'end' in opts)) {
+      return
+    }
+
     opts.keyAsBuffer = false
     opts.valueAsBuffer = false
     test(name, function (t) {

test/iterator-test.js

@@ -11,7 +11,8 @@ exports.setUp = function (test, testCommon) {
 exports.args = function (test, testCommon) {
   test('test iterator has db reference', function (t) {
     var iterator = db.iterator()
-    t.ok(iterator.db === db)
+    // For levelup compat: may return iterator of an underlying db, that's okay.
+    t.ok(iterator.db === db || iterator.db)
     iterator.end(t.end.bind(t))
   })
 
@@ -132,14 +133,19 @@ exports.iterator = function (test, testCommon) {
       var fn = function (err, key, value) {
         t.error(err)
         if (key && value) {
-          t.ok(Buffer.isBuffer(key), 'key argument is a Buffer')
-          t.ok(Buffer.isBuffer(value), 'value argument is a Buffer')
+          if (testCommon.encodings) {
+            t.is(typeof key, 'string', 'key argument is a string')
+            t.is(typeof value, 'string', 'value argument is a string')
+          } else {
+            t.ok(Buffer.isBuffer(key), 'key argument is a Buffer')
+            t.ok(Buffer.isBuffer(value), 'value argument is a Buffer')
+          }
           t.is(key.toString(), data[idx].key, 'correct key')
           t.is(value.toString(), data[idx].value, 'correct value')
           process.nextTick(next)
           idx++
         } else { // end
-          t.ok(typeof err === 'undefined', 'err argument is undefined')
+          t.ok(err == null, 'err argument is nullish')
           t.ok(typeof key === 'undefined', 'key argument is undefined')
           t.ok(typeof value === 'undefined', 'value argument is undefined')
           t.is(idx, data.length, 'correct number of entries')

test/manifest-test.js

@@ -5,7 +5,7 @@ module.exports = function (test, testCommon) {
 
   suite(test, testCommon)
 
-  test('manifest has status', function (t) {
+  testCommon.status && test('manifest has status', function (t) {
     var db = testCommon.factory()
     t.is(db.supports.status, true)
 

test/open-test.js

@@ -3,7 +3,7 @@ exports.setUp = function (test, testCommon) {
 }
 
 exports.args = function (test, testCommon) {
-  test('test database open no-arg throws', function (t) {
+  testCommon.promises || test('test database open no-arg throws', function (t) {
     var db = testCommon.factory()
     t.throws(
       db.open.bind(db),
@@ -13,7 +13,7 @@ exports.args = function (test, testCommon) {
     t.end()
   })
 
-  test('test callback-less, 1-arg, open() throws', function (t) {
+  testCommon.promises || test('test callback-less, 1-arg, open() throws', function (t) {
     var db = testCommon.factory()
     t.throws(
       db.open.bind(db, {}),