https://github.com/assaf/uuid

Generates universally unique identifiers (UUIDs) for use in distributed applications.
https://github.com/assaf/uuid

Keywords from Contributors

activerecord activejob mvc mongodb-driver orm-framework

Last synced: about 3 hours ago
JSON representation

Repository metadata

Generates universally unique identifiers (UUIDs) for use in distributed applications.

Host: GitHub
URL: https://github.com/assaf/uuid
Owner: assaf
License: mit
Archived: true
Created: 2008-07-10T20:16:50.000Z (over 17 years ago)
Default Branch: master
Last Pushed: 2023-08-03T08:05:16.000Z (over 2 years ago)
Last Synced: 2026-02-22T10:54:45.611Z (10 days ago)
Language: Ruby
Homepage:
Size: 77.1 KB
Stars: 474
Watchers: 11
Forks: 78
Open Issues: 18
Releases: 0
Metadata Files:
- Readme: README.rdoc
- Changelog: CHANGELOG
- License: MIT-LICENSE

README.rdoc

          = UUID Generator

Generates universally unique identifiers (UUIDs) for use in distributed
applications. Based on {RFC 4122}[http://www.ietf.org/rfc/rfc4122.txt].


== Generating UUIDs

Call #generate to generate a new UUID. The method returns a string in one of
three formats. The default format is 36 characters long, and contains the 32
hexadecimal octets and hyphens separating the various value parts. The
:compact format omits the hyphens, while the :urn format
adds the :urn:uuid prefix.

For example:

  uuid = UUID.new
  10.times do
    p uuid.generate
  end


== UUIDs in Brief

UUID (universally unique identifier) are guaranteed to be unique across time
and space.

A UUID is 128 bit long, and consists of a 60-bit time value, a 16-bit
sequence number and a 48-bit node identifier.

The time value is taken from the system clock, and is monotonically
incrementing.  However, since it is possible to set the system clock
backward, a sequence number is added.  The sequence number is incremented
each time the UUID generator is started.  The combination guarantees that
identifiers created on the same machine are unique with a high degree of
probability.

Note that due to the structure of the UUID and the use of sequence number,
there is no guarantee that UUID values themselves are monotonically
incrementing.  The UUID value cannot itself be used to sort based on order
of creation.

To guarantee that UUIDs are unique across all machines in the network,
the IEEE 802 MAC address of the machine's network interface card is used as
the node identifier.

For more information see {RFC 4122}[http://www.ietf.org/rfc/rfc4122.txt].


== UUID State File

The UUID generator uses a state file to hold the MAC address and sequence
number.

The MAC address is used to generate identifiers that are unique to your
machine, preventing conflicts in distributed applications. The MAC
address is six bytes (48 bit) long. It is automatically extracted from
one of the network cards on your machine.

The sequence number is incremented each time the UUID generator is
first used by the application, to prevent multiple processes from
generating the same set of identifiers, and deal with changes to the
system clock.

The UUID state file is created in #Dir.tmpdir/ruby-uuid or the Windows
common application data directory using mode 0644.  If that directory is not
writable, the file is created as .ruby-uuid in the home directory.
If you need to create the file with a different mode, use UUID#state_file
before running the UUID generator.

Note: If you are running on a shared host where the state file is not shared
between processes, or persisted across restarts (e.g. Heroku, Google App
Engine) you can simple turn it off:

  UUID.state_file = false

State files are not portable across machines.

If you do not use the state file, UUID generation will attempt to use your
server's MAC address using the macaddr gem, which runs system commands to
identify the MAC address and then cache it.  Since this can take a few seconds
on some operating systems, when using UUID.state_file = false, you should add
the following line after disabling the state file:

  UUID.generator.next_sequence

Note: when using a forking server (Unicorn, Resque, Pipemaster, etc) you don't
want your forked processes using the same sequence number.  Make sure to
increment the sequence number each time a worker forks.

For example, in config/unicorn.rb:

  after_fork do |server, worker|
    UUID.generator.next_sequence
  end


== Command Line

You can run uuid from the command line, generating new UUID to stdout:

  $ uuid

Multiple UUIDs in a sequence, separated with a newline:

  $ uuid --count 10

You can also run client and server from the command line

  $ uuid --server &
  $ uuid --socket /var/lib/uuid.sock


== Latest and Greatest

Source code and documentation hosted on Github: http://github.com/assaf/uuid

To get UUID from source:

  git clone git://github.com/assaf/uuid.git


== License

This package is licensed under the MIT license and/or the Creative
Commons Attribution-ShareAlike.

:include: MIT-LICENSE

Owner metadata

Name: Assaf Arkin
Login: assaf
Email:
Kind: user
Description: 👋 Freelance/in-between startups ✍️ Blogging at https://labnotes.org
Website: https://labnotes.org
Location: Oakland, CA
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/5158?u=9079d8a9929cc240f3b2e553032578a6a385e841&v=4
Repositories: 33
Last ynced at: 2024-04-14T22:10:36.037Z
Profile URL: https://github.com/assaf

GitHub Events

Total

Watch event: 1

Last Year

Watch event: 1

Committers metadata

Last synced: 1 day ago

Total Commits: 69
Total Committers: 19
Avg Commits per committer: 3.632
Development Distribution Score (DDS): 0.391

Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0

Name	Email	Commits
Assaf Arkin	a**f@l**g	42
Eric Hodel	d**n@s**t	7
Ryan Bigg	r**g@c**m	2
Vicente Reig	v**e@p**m	2
Jonne Haß	me@m****e	2
Brandon Turner	b**r@b**t	1
Justin Langhorst	j**t@g**m	1
Takeshi Abe	a**e@g**p	1
pinnymz	p**y@m**m	1
Andy Lo-A-Foe	a**e@p**m	1
Jonathan Hyman	j**n@p**u	1
Michael Strüder	m**r@g**m	1
Michael Witrant	m**e@l**r	1
Robert Reiz	r**1@g**m	1
Rodrigo Benenson	r**n@g**m	1
Thomas Eng (Work)	t**g@g**m	1
Tom Lea	c**b@t**k	1
Vasily Kolesnikov	r**v@g**m	1
algrs	a**s@c**t	1

Committer domains:

Issue and Pull Request metadata

Last synced: 9 days ago

Total issues: 31
Total pull requests: 28
Average time to close issues: 10 months
Average time to close pull requests: 5 months
Total issue authors: 27
Total pull request authors: 26
Average comments per issue: 3.55
Average comments per pull request: 1.32
Merged pull request: 14
Bot issues: 0
Bot pull requests: 2

Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/assaf/uuid

Top Issue Authors

pravi (3)
chuckremes (2)
stouset (2)
danielstockton (1)
purpleidea (1)
mushtaq2004 (1)
avinmathew (1)
graaff (1)
charliedavi (1)
chrismo (1)
zeha (1)
ozbillwang (1)
alexey (1)
bobbytables (1)
arturoherrero (1)

Top Pull Request Authors

jballanc (2)
dependabot[bot] (2)
tomlea (1)
pavel-manylov (1)
sigmike (1)
jhass (1)
langhorst (1)
blt04 (1)
tengla (1)
chuckremes (1)
v-kolesnikov (1)
jonhyman (1)
reiz (1)
andy-k (1)
katsuya (1)

Top Issue Labels

Top Pull Request Labels

dependencies (2)