suid 1.0.0

data/README.markdown

@@ -0,0 +1,33 @@
+## SUID : A gem to generate sorta unique IDs
+
+    github: http://github.com/dburkes/suid
+  
+## Intro
+
+SUIDs are sorta unique IDs. A SUID is similar to a UUID, except that SUIDs
+
+* Are only 11 characters long
+
+* Are semi human-readable
+
+* Don't make URLs look ridiculous
+
+A SUID consists of 11 characters from the set [A-Za-z0-9], so the resulting namespace can hold 62^11 unique values.  That's a lot smaller
+namespace than UUIDs, but, if it's good enough for YouTube URLs, I'm willing to bet it's good enough for a lot of other things too.
+
+## Installation
+
+    gem install suid
+    
+## Usage
+
+    SUID.generate => "bEsrB0H2yw1"
+    
+    suid = SUID.new
+    suid.to_s => "kwNr8FMYAaO"
+    suit.to_i => 17229968328302299310
+    
+## Notes
+
+* You can seed the random number generator if you want with `srand`, but ruby does that automatically when it starts up, so, unless
+you purposefully want to create duplicate SUIDs, don't bother.

data/spec/suid_spec.rb

@@ -0,0 +1,21 @@
+require 'lib/suid'
+
+describe SUID do
+  it "should generate sorta unique ids" do
+    lambda { SUID.generate }.should_not raise_error
+  end
+  
+  it "should not generate duplicates in a decent size set" do 
+    suids = []
+    1000.times { suids << SUID.generate }
+    suids.size.should == suids.uniq.size
+  end
+  
+  it "should generate duplicate suids if instructed to do so" do
+    srand(0xf00)
+    s1 = SUID.generate
+    srand(0xf00)
+    s2 = SUID.generate
+    s1.should == s1
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification 
+name: suid
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Danny Burkes
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-20 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Sorta Unique ID
+email: dburkes@netable.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+has_rdoc: true
+homepage: http://github.com/dburkes/suid
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Sorta Unique ID
+test_files: 
+- spec/suid_spec.rb