jamescook-uuid 2.0.3

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2005-2008 Assaf Arkin, Eric Hodel
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,96 @@
+= 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
+<tt>:compact</tt> format omits the hyphens, while the <tt>:urn</tt> format
+adds the <tt>:urn:uuid</tt> 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 <tt>/var/tmp/ruby-uuid</tt> or the Windows
+common application data directory using mode 0644.  If that directory is not
+writable, the file is created as <tt>.ruby-uuid</tt> in the home directory.
+If you need to create the file with a different mode, use UUID#state_file
+before running the UUID generator.
+
+State files are not portable across machines.
+
+
+== Latest and Greatest
+
+Stable release are made through RubyForge, to upgrade simply:
+
+  gem upgrade uuid
+
+You can subscribe for notifications of new releases through the reliable-msg
+project page at http://rubyforge.org/projects/reliable-msg
+
+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
+

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: jamescook-uuid
+version: !ruby/object:Gem::Version 
+  version: 2.0.3
+platform: ruby
+authors: 
+- Assaf Arkin
+- Eric Hodel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-16 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: macaddr
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+description: UUID generator for producing universally unique identifiers based on RFC 4122 (http://www.ietf.org/rfc/rfc4122.txt).
+email: assaf@labnotes.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- MIT-LICENSE
+files: []
+
+has_rdoc: true
+homepage: http://github.com/assaf/uuid
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+- --title
+- UUID generator
+- --line-numbers
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: reliable-msg
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: UUID generator
+test_files: []
+