merge

Author: dominictarr

.travis.yml

@@ -21,3 +21,4 @@ notifications:
     - pedro.teixeira@gmail.com
     - mail@substack.net
 script: npm run-script alltests
+

LICENSE

@@ -0,0 +1,13 @@
+The MIT License (MIT)
+=====================
+
+Copyright (c) 2014 LevelUP contributors
+---------------------------------------
+
+*LevelUP contributors listed at <https://github.com/rvagg/node-levelup#contributors>*
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

LICENSE.md

@@ -388,11 +388,13 @@ The standard `pause()`, `resume()` and `destroy()` methods are implemented on th
 
 Additionally, you can supply an options object as the first parameter to `createReadStream()` with the following options:
 
-* `'start'`: the key you wish to start the read at. By default it will start at the beginning of the store. Note that the *start* doesn't have to be an actual key that exists, LevelDB will simply find the *next* key, greater than the key you provide.
+* `'gt'` (greater than), `'gte'` (greater than or equal) define the lower bound of the range to be streamed. Only records where the key is greater than (or equal to) this option will be included in the range. When `reverse=true` the order will be reversed, but the records streamed will be the same.
 
-* `'end'`: the key you wish to end the read on. By default it will continue until the end of the store. Again, the *end* doesn't have to be an actual key as an (inclusive) `<=`-type operation is performed to detect the end. You can also use the `destroy()` method instead of supplying an `'end'` parameter to achieve the same effect.
+* `'lt'` (less than), `'lte'` (less than or equal) define the higher bound of the range to be streamed. Only key/value pairs where the key is less than (or equal to) this option will be included in the range. When `reverse=true` the order will be reversed, but the records streamed will be the same.
 
-* `'reverse'` *(boolean, default: `false`)*: a boolean, set to true if you want the stream to go in reverse order. Beware that due to the way LevelDB works, a reverse seek will be slower than a forward seek.
+* `'start', 'end'` legacy ranges - instead use `'gte', 'lte'`
+
+* `'reverse'` *(boolean, default: `false`)*: a boolean, set true and the stream output will be reversed. Beware that due to the way LevelDB works, a reverse seek will be slower than a forward seek.
 
 * `'keys'` *(boolean, default: `true`)*: whether the `'data'` event should contain keys. If set to `true` and `'values'` set to `false` then `'data'` events will simply be keys, rather than objects with a `'key'` property. Used internally by the `createKeyStream()` method.
 
@@ -652,13 +654,11 @@ A custom encoding may be provided by passing in an object as an value for `keyEn
 {
     encode : function (val) { ... }
   , decode : function (val) { ... }
-  , buffer : boolean // encode returns a buffer-like and decode accepts a buffer
+  , buffer : boolean // encode returns a buffer and decode accepts a buffer
   , type   : String  // name of this encoding type.
 }
 ```
 
-*"buffer-like"* means either a `Buffer` if running in Node, or a Uint8Array if in a browser. Use [bops](https://github.com/chrisdickinson/bops) to get portable binary operations.
-
 <a name="extending"></a>
 Extending LevelUP
 -----------------
@@ -720,13 +720,13 @@ LevelUP is only possible due to the excellent work of the following contributors
 A large portion of the Windows support comes from code by [Krzysztof Kowalczyk](http://blog.kowalczyk.info/) [@kjk](https://twitter.com/kjk), see his Windows LevelDB port [here](http://code.google.com/r/kkowalczyk-leveldb/). If you're using LevelUP on Windows, you should give him your thanks!
 
 
-<a name="licence"></a>
-Licence &amp; copyright
+<a name="license"></a>
+License &amp; copyright
 -------------------
 
-Copyright (c) 2012-2013 LevelUP contributors (listed above).
+Copyright (c) 2012-2014 LevelUP contributors (listed above).
 
-LevelUP is licensed under an MIT +no-false-attribs license. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.
+LevelUP is licensed under the MIT license. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE.md file for more details.
 
 =======
 *LevelUP builds on the excellent work of the LevelDB and Snappy teams from Google and additional contributors. LevelDB and Snappy are both issued under the [New BSD Licence](http://opensource.org/licenses/BSD-3-Clause).*

README.md

@@ -1,7 +1,7 @@
-/* Copyright (c) 2012-2013 LevelUP contributors
+/* Copyright (c) 2012-2014 LevelUP contributors
  * See list at <https://github.com/rvagg/node-levelup#contributing>
- * MIT +no-false-attribs License
- * <https://github.com/rvagg/node-levelup/blob/master/LICENSE>
+ * MIT License
+ * <https://github.com/rvagg/node-levelup/blob/master/LICENSE.md>
  */
 
 var util          = require('./util')

lib/batch.js

@@ -37,6 +37,17 @@ module.exports = (function () {
     , buffer : false
     , type   : 'json'
   }
+  encodings.binary = {
+      encode : function (data) {
+        return isBinary(data) ? data : new Buffer(data)
+      }
+    , decode : function (data) {
+        return data
+      }
+    , buffer : true
+    , type   : 'binary'
+  }
+
   encodingNames.forEach(function (type) {
     if (encodings[type])
       return
@@ -45,7 +56,7 @@ module.exports = (function () {
           return isBinary(data) ? data : new Buffer(data, type)
         }
       , decode : function (buffer) {
-          return new Buffer(buffer, type)
+          return buffer.toString(type)
         }
       , buffer : true
       , type   : type // useful for debugging purposes

lib/encodings.js

@@ -1,7 +1,7 @@
-/* Copyright (c) 2012-2013 LevelUP contributors
+/* Copyright (c) 2012-2014 LevelUP contributors
  * See list at <https://github.com/rvagg/node-levelup#contributing>
- * MIT +no-false-attribs License
- * <https://github.com/rvagg/node-levelup/blob/master/LICENSE>
+ * MIT License
+ * <https://github.com/rvagg/node-levelup/blob/master/LICENSE.md>
  */
 
 var createError   = require('errno').create
@@ -19,4 +19,4 @@ module.exports = {
   , WriteError          : createError('WriteError', LevelUPError)
   , NotFoundError       : NotFoundError
   , EncodingError       : createError('EncodingError', LevelUPError)
-}
+}

lib/errors.js

@@ -1,7 +1,7 @@
-/* Copyright (c) 2012-2013 LevelUP contributors
+/* Copyright (c) 2012-2014 LevelUP contributors
  * See list at <https://github.com/rvagg/node-levelup#contributing>
- * MIT +no-false-attribs License
- * <https://github.com/rvagg/node-levelup/blob/master/LICENSE>
+ * MIT License
+ * <https://github.com/rvagg/node-levelup/blob/master/LICENSE.md>
  */
 
 var EventEmitter   = require('events').EventEmitter

lib/levelup.js

@@ -1,6 +1,6 @@
-/* Copyright (c) 2012-2013 LevelUP contributors
+/* Copyright (c) 2012-2014 LevelUP contributors
  * See list at <https://github.com/rvagg/node-levelup#contributing>
- * MIT +no-false-attribs License <https://github.com/rvagg/node-levelup/blob/master/LICENSE>
+ * MIT License <https://github.com/rvagg/node-levelup/blob/master/LICENSE.md>
  */
 
 // NOTE: we are fixed to readable-stream@1.0.x for now

lib/read-stream.js

@@ -1,7 +1,7 @@
-/* Copyright (c) 2012-2013 LevelUP contributors
+/* Copyright (c) 2012-2014 LevelUP contributors
  * See list at <https://github.com/rvagg/node-levelup#contributing>
- * MIT +no-false-attribs License
- * <https://github.com/rvagg/node-levelup/blob/master/LICENSE>
+ * MIT License
+ * <https://github.com/rvagg/node-levelup/blob/master/LICENSE.md>
  */
 
 var extend        = require('xtend')
@@ -16,7 +16,6 @@ var extend        = require('xtend')
     }
 
   , leveldown
-
   , encodingOpts = (function () {
       var eo = {}
       for(var e in encodings)