init commit

Author: jamestalmage

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+indent_style = tab
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[{package.json,*.yml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1 @@
+* text=auto

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+.nyc_output
+coverage

.travis.yml

@@ -0,0 +1,5 @@
+language: node_js
+node_js:
+  - 'stable'
+  - '0.12'
+  - '0.10'

index.js

@@ -0,0 +1,18 @@
+'use strict';
+module.exports = function (buffer, limit) {
+	limit = limit || 20;
+	return buffer.toString('hex').split('')
+		.reduce(function (arr, char) {
+			if (arr.length && arr[arr.length - 1].length === 1) {
+				arr[arr.length - 1] += char;
+				if (arr.length && arr.length % limit === 0) {
+					arr[arr.length - 1] += '\n';
+				} else {
+					arr[arr.length - 1] += ' ';
+				}
+			} else {
+				arr.push(char);
+			}
+			return arr;
+		}, []).join('').trim();
+};

license

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Copyright (c) Isaac Z. Schlueter <i@izs.me>, James Talmage <james@talmage.io> (github.com/jamestalmage), and Contributors
+
+Extracted from code in node-tap http://www.node-tap.org/
+
+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.

package.json

@@ -0,0 +1,34 @@
+{
+  "name": "buffer-to-string",
+  "version": "0.0.0",
+  "description": "A better Buffer.toString()",
+  "license": "MIT",
+  "repository": "tapjs/buffer-to-string",
+  "author": {
+    "name": "James Talmage",
+    "email": "james@talmage.io",
+    "url": "github.com/jamestalmage"
+  },
+  "engines": {
+    "node": ">=0.10.0"
+  },
+  "scripts": {
+    "test": "xo && nyc --cache --reporter lcov --reporter text ava"
+  },
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "buffer",
+    "string",
+    "beautify",
+    "pretty",
+    "print"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "ava": "^0.10.0",
+    "nyc": "^5.3.0",
+    "xo": "^0.12.1"
+  }
+}

readme.md

@@ -0,0 +1,47 @@
+# buffer-to-string [![Build Status](https://travis-ci.org/tapjs/buffer-to-string.svg?branch=master)](https://travis-ci.org/tapjs/buffer-to-string)
+
+> A better Buffer.toString() 
+
+Displays buffer content in hex. Characters are grouped into two-character bytes, with a customizable line wrap width.
+
+## Install
+
+```
+$ npm install --save buffer-to-string
+```
+
+
+## Usage
+
+```js
+const bufferToString = require('buffer-to-string');
+
+bufferToString(new Buffer([0, 1, 2, 3, 4, 5, 6]), 3);
+/*
+00 01 02
+03 04 05
+06
+ */
+```
+
+
+## API
+
+### bufferToString(buffer, [width])
+
+#### input
+
+Type: `Buffer`
+
+The Buffer to stringify.
+
+#### width
+
+Type: `number`  
+Default: `20`
+
+The maximum width before wrapping a newline. It is measured in bytes displayed. The maximum character width can be determined by computing `(3 * width) - 1`.
+
+## License
+
+MIT © [Isaac Z. Schlueter](http://github.com/isaacs), [James Talmage](http://github.com/jamestalmage)

test.js

@@ -0,0 +1,27 @@
+import test from 'ava';
+import fn from './';
+
+test('defaults to width of 20', t => {
+	const arr = [];
+	for (var i = 0; i < 50; i++) {
+		arr[i] = i;
+	}
+	t.is(fn(new Buffer(arr)), [
+		'00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13',
+		'14 15 16 17 18 19 1a 1b 1c 1d 1e 1f 20 21 22 23 24 25 26 27',
+		'28 29 2a 2b 2c 2d 2e 2f 30 31'
+	].join('\n'));
+});
+
+test('width is customizable', t => {
+	const arr = [];
+	for (var i = 0; i < 10; i++) {
+		arr[i] = i;
+	}
+	t.is(fn(new Buffer(arr), 3), [
+		'00 01 02',
+		'03 04 05',
+		'06 07 08',
+		'09'
+	].join('\n'));
+});