uuid-parse

What is uuid-parse?

The uuid-parse npm package provides utilities for parsing and formatting UUIDs. It allows you to convert UUIDs between string and byte array representations, which can be useful for various applications such as database storage, network transmission, and more.

What are uuid-parse's main functionalities?

UUID to Byte Array

This feature allows you to convert a UUID string into a byte array. This can be useful for storing UUIDs in a more compact binary format.

const uuidParse = require('uuid-parse');
const uuid = '550e8400-e29b-41d4-a716-446655440000';
const bytes = uuidParse.parse(uuid);
console.log(bytes);

Byte Array to UUID

This feature allows you to convert a byte array back into a UUID string. This is useful for converting stored binary UUIDs back into their string representation.

const uuidParse = require('uuid-parse');
const bytes = [85, 14, 132, 0, 226, 155, 65, 212, 167, 22, 68, 102, 85, 68, 0, 0];
const uuid = uuidParse.unparse(bytes);
console.log(uuid);

Other packages similar to uuid-parse

uuid

The 'uuid' package is a popular library for generating and validating UUIDs. Unlike uuid-parse, it focuses more on the creation and validation of UUIDs rather than parsing and formatting. It provides methods to generate UUIDs of different versions (v1, v3, v4, v5).

node-uuid

The 'node-uuid' package is another library for generating UUIDs. It is similar to the 'uuid' package but is an older implementation. It also provides methods for generating UUIDs of different versions but does not focus on parsing and formatting like uuid-parse.

uuid-js

The 'uuid-js' package is a JavaScript library for generating and parsing UUIDs. It provides similar functionalities to uuid-parse but also includes additional features like generating UUIDs based on timestamps and random numbers.

README

uuid-parse

NOTE: This module is no longer maintained

Simple, fast parsing and unparsing of RFC4122 UUIDS.

Features:

• Parses and unparses UUIDs to and from Buffer to String

Quickstart

npm install uuid-parse

const uuidParse = require('uuid-parse');

API

uuidParse.parse(id[, buffer[, offset]])

uuidParse.unparse(buffer[, offset])

Parse and unparse UUIDs

• id - (String) UUID(-like) string
• buffer - (Array | Buffer) Array or buffer where UUID bytes are to be written. Default: A new Buffer is used
• offset - (Number) Starting index in buffer at which to begin writing. Default: 0

Example parsing and unparsing a UUID string

const bytes = uuidParse.parse('797ff043-11eb-11e1-80d6-510998755d10'); // -> <Buffer 79 7f f0 43 11 eb 11 e1 80 d6 51 09 98 75 5d 10>
const string = uuidParse.unparse(bytes); // -> '797ff043-11eb-11e1-80d6-510998755d10'

Testing

npm test

Acknowledgments

Please make sure to check out the repository that originated these functions: node-uuid. These functions were removed from a recent version of that library and I wanted to make sure they were still exposed for the packages who were dependent on them.