hexdump.js/README.md

hexdump.js
==========

Given an ArrayBuffer, will create similar output to the unix `hexdump` command.

```
        0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F
0000000 48 65 6c 6c 6f 2c 20 57 6f 72 6c 64 21 0a
000000e
```

Usage
-----

So far it just does one thing: print an ArrayBuffer in hex, with a header:

### JavaScript

```bash
var hexdump = require('hexdump.js').hexdump;

var str = hexdump(new Uint8Array([ 0, 1, 2, 127, 254, 255 ]));

console.log(str);
```

### Browser

```javascript
console.log(window.hexdump(new Uint8Array([ 0, 1, 2, 127, 254, 255 ])));
```

### CLI

```bash
hexdump.js <filepath>
```

Install
-------

Decentralized:

```bash
# As a library
npm install --save 'git+https://git.daplie.com/Daplie/hexdump.js.git'

# As a global CLI (useful on windows)
npm install --global 'git+https://git.daplie.com/Daplie/hexdump.js.git'
```

Centralized:

```bash
# As a library
npm install --save hexdump.js

# As a global CLI (useful on windows)
npm install --global hexdump.js
```