npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@crshnburn/hexyz

v1.0.2

Published

hexdump, binary pretty-printing, ebcdic

Downloads

9

Readme

hexyz -- utility to create hex dumps from mainframe data

Build Status

hexyz is a javascript library that's easy to use to create hex dumps. It works well in node and has cursory browser (more below) support. It contains a number of options to configure how the hex dump will end up looking. This library has been forked from hexy.js to add support for ebcdic encoded bytes.

It should create a pleasant looking hex dumb by default:

var hexyz = require('hexyz'),
b = Buffer.from("\000\001\003\005\037\012\011bcdefghijklmnopqrstuvwxyz0123456789")
// or String or Array containing numbers ( bytes, i.e. < 0xFF )

console.log(hexyz.hexyz(b))

results in this dump:

00000000: 0001 0305 1f0a 0962 6364 6566 6768 696a  .......bcdefghij
00000010: 6b6c 6d6e 6f70 7172 7374 7576 7778 797a  klmnopqrstuvwxyz
00000020: 3031 3233 3435 3637 3839                 0123456789

but it's also possible to configure:

  • Line numbering
  • Line width
  • Format of byte grouping
  • Case of hex decimals
  • Presence of the ASCII and or EBCDIC annotation in the right column.

This means it's easy to generate exciting dumps like:

0000000: 0001 0305 1f0a 0962  .... ...b
0000008: 6364 6566 6768 696a  cdef ghij
0000010: 6b6c 6d6e 6f70 7172  klmn opqr
0000018: 7374 7576 7778 797a  stuv wxyz
0000020: 3031 3233 3435 3637  0123 4567
0000028: 3839                 89

or even:

0000000: 00 01 03 05 1f 0a 09 62   63 64 65 66 67 68 69 6a
0000010: 6b 6c 6d 6e 6f 70 71 72   73 74 75 76 77 78 79 7a
0000020: 30 31 32 33 34 35 36 37   38 39

with hexyz!

Accepted Input

Currently, input should be one of the following:

  • a Buffer
  • a String
  • an Array containing Numbers. These should fit into 8 bits, i.e. be smaller than 255. Larger values are truncated (specifically val & 0xff)

Formatting Options

Formatting options are configured by passing a format object to the hexyz function:

var format = {}
format.width = width // how many bytes per line, default 16
format.numbering = n // ["hex_bytes" | "none"],  default "hex_bytes"
format.format = f    // ["eights"|"fours"|"twos"|"none"], how many nibbles per group
                     //                          default "fours"
format.caps = c      // ["lower"|"upper"],       default lower
format.annotate=a    // ["ascii"|"ebcdic"|"ascii_ebcdic"|"none"], ascii, ebcdic or
                     // both annotations at end of line?
                     //                          default "ascii"
format.prefix=p      // <string> something pretty to put in front of each line
                     //                          default ""
format.indent=i      // <num> number of spaces to indent
                     //                          default 0
format.html=true     // funky html divs 'n stuff! experimental.
                     //                          default: false
format.offset = X    // generate hexdump based on X byte offset
                     // into the provided source
                     //                          default 0
format.length = Y    // process Y bytes of the provide source
                     // starting at `offset`. -1 for all
                     //                          default -1
format.display_offset = Z
                     // add Z to the address prepended to each line
                     // (note, even if `offset` is provided, addressing
                     // is started at 0)
                     //                          default 0

console.log(hexyz.hexyz(buffer, format))

In case you're really nerdy, you'll have noticed that the defaults correspond to how xxd formats it's output.

Installing

Either use npm (or whatever compatible npm thingy people are using these days) :

npm install @crshnburn/hexyz

This will install the lib which you'll be able to use like so:

var hexyz = require("hexyz"),
buf  = // get Buffer from somewhere,
str  = hexy.hexy(buf)

If you don't like npm, grab the source from github:

https://github.com/crshnburn/hexyz

Typescript

import {hexyz} from "@crshnburn/hexyz";
const buff = ...
console.log(hexyz(buff));

Thanks

  • a2800276 For publishing the original hexy.js