File: README.rdoc [simple_uuid-0.4.0 Documentation]

### Home Classes Methods

### Files

- CHANGELOG
- LICENSE
- README.rdoc

### Class Index

Quicksearch

- SimpleUUID
- SimpleUUID::UUID
- Time

No matching classes.

# simple_uuid

Simple, scalable UUID generation.

## License

Copyright 2009-2010 Twitter, Inc. See included LICENSE file.

## Features

- pure-Ruby

- no MAC address scraping

- no file-based locking

This library implements UUID format version 1, as specified in RFC 4122, with jitter in place of the mac address and sequence counter.

## Installation

Install the gem:

    sudo gem install simple_uuid

## Usage

    # Creating and getting a timestamp from the UUID
    uuid = SimpleUUID::UUID.new => <UUID#2278170300  .... >
    uuid.to_time => Thu Aug 18 19:15:16 -0400 2011

    # Given raw bytes from a source such as cassandra (using bytes from an existing UUID as an example)
    bytes = SimpleUUID::UUID.new.bytes
    SimpleUUID::UUID.to_time(bytes) => Thu Aug 18 19:15:16 -0400 2011

## Reporting problems

The support forum is here.

Patches and contributions are very welcome.

[Validate]

Generated with the Darkfish Rdoc Generator 2.