hat / 0.0.3 last updated 7 months ago created on Aug 6th 2011

Install

npm install --save hat

Clone

git clone git@github.com:substack/node-hat.git

dependencies

No dependencies listed.

maintainers

substack substack

versions

690 Downloads yesterday.

readme

hat

Generate random IDs and avoid collisions.

hat

examples

hat

var hat = require('hat');
var id = hat();
console.log(id);

output:

0c82a54f22f775a3ed8b97b2dea74036

rack

var hat = require('hat');
var rack = hat.rack();
console.log(rack());
console.log(rack());

output:

1c24171393dc5de04ffcb21f1182ab28
fabe2323acc1b559dee43d4a1e16cbeb

methods

var hat = require('hat');

hat(bits=128, base=16)

Generate a random ID string with bits of data in a base.

Leading zeros are appended such that all outputs for a given number of bits have equal length.

var rack = hat.rack(bits=128, base=16, expandBy)

Make a new hat rack. Call rack() repeatedly to generate new IDs which are checked for collisions.

If expandBy is specified, increment bits by this amount if too many collisions occur. If expandBy isn't specified, rack() will throw if too many collisions occur during generation.

Optionally call var id = rack(data) to store data at the new ID.

You can get the data out again with rack.get(id) and set the data with rack.set(id, value).

how to make a hat

First you will need a large square of cloth or paper. These materials work well:

  • large napkin
  • newspaper

If you find yourself at a fancy restaurant, large napkins are in abundant supply.

Tie a knot in each corner. Place the hat on your head and enjoy!

Resolving all dependencies.. This could take a while as our cache is not yet fully warmed up.