sixarm_ruby_zid 5.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a2a9308aa73217e6302ad466d756baca1e80e123aa182452b7d704ce37bdfe07
+  data.tar.gz: 3baed1941ef37f4de37990eea1f0756c72f559603dd8b39f6bb0f7336900b88a
+SHA512:
+  metadata.gz: 2d7c724f9b5d6ace9e44e2a36d2b6dd0535be31582299bc2ba97a72ef7eda246677b29678be7526905a229c4b3ff4e620c4264e0b7d4ed23d4d1f2248314d6d8
+  data.tar.gz: 68b1547592adef639511528adccb4cebd73fe9f5989565aa0d322c3d382267943aea571013db6a6f2af3f32ef33f51f2be93aed47e5a0e6d5b8b1ef660309ba1

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+^=�V��,cvhsݐ��DEJi$4�e
���
WA���Ѵ�v�J6�\@e�baV%�!�&v��4@�ԗ��d��t@��
+)r��D�?(p��^j�G*9$b�QPz�*��7��� ldG6�����{��0���5!����VϹ�<x?3�<N�Ж��|AF�%Qk+|���d3f��/%*3y�׶��!���	��d� 'c�-b�`X��@)�=�U���J��H_�� ͂���bR���7w59

data/Rakefile

@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+require "rake"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs.push("lib", "test")
+  t.pattern = "test/**/*.rb"
+end
+
+task :default => [:test]
+task :default => [:test]
+task :default => [:test]

data/lib/sixarm_ruby_zid.rb

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+=begin rdoc
+Please see README
+=end
+
+require_relative "sixarm_ruby_zid/zid"

data/lib/sixarm_ruby_zid/zid.rb

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+=begin rdoc
+ZID class.
+=end
+
+require "securerandom"
+require "digest/sha2"
+
+class ZID
+
+  # Generate a new ZID string.
+  #
+  # Example:
+  #
+  #     string = ZID.generate
+  #     #=> "4bb88af57d4ddc224fecad688442423d"
+  #
+  # Return: [String] A new ZID string
+  #
+  def self.generate
+    SecureRandom.hex
+  end
+
+  # Is a given ZID string valid?
+  #
+  # Example:
+  #
+  #     ZID.valid?("4bb88af57d4ddc224fecad688442423d") #=> true
+  #     ZID.valid?("hello") #=> false
+  #
+  # Implemenation note: this method tests the string class,
+  # then size, then regex. The test of the string size comes
+  # before the regex because the test of the size runs faster,
+  # and is an optimization for fast-fail because when the string
+  # is not size 32, then the regex doesn't need to be run.
+  #
+  # Return: [true/false]
+  #
+  def self.valid?(string)
+    !!(string && string.is_a?(String) && string.size == 32 && string =~ /\A[0-9a-f]+\z/)
+  end
+
+  # Parse any object to an ZID string.
+  #
+  # This does these steps:
+  #
+  #   * Convert the object to a string by calling `#to_s`.
+  #   * Convert the string to lower case by calling `#downcase`.
+  #   * Delete any non-hex characters.
+  #   * Take the first 32 characters.
+  #
+  # Example:
+  #
+  #     string = ZID.parse("***FFAD30A1-BE5E-B511-9ED8-976CAB0281B6***")
+  #     #=> "ffad30a1be5eb5119ed8976cab0281b6"
+  #
+  # Return: [ZID] A new ZID
+  #
+  def self.parse(object)
+    zid = object.to_s.downcase.gsub(/[^0-9a-f]/,'')[0...32]
+    raise ArgumentError if !ZID.valid?(zid)
+    zid
+  end
+
+end

data/test/sixarm_ruby_zid_test.rb

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+require "minitest/autorun"
+require "coveralls"
+require "simplecov"
+Coveralls.wear!
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start
+require "sixarm_ruby_xid"

data/test/sixarm_ruby_zid_test/zid_test.rb

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+require "sixarm_ruby_zid_test"
+
+describe ZID do
+
+  describe "#new" do
+
+    describe "with initialize defaults" do
+
+      it "is a string with the correct length and characters" do
+        zid = ZID.generate
+        zid.must_match /\A[0-9a-f]{32}\z/
+      end
+
+      it "is always different" do
+        seen = Set.new
+        99999.times.each{
+          zid = ZID.generate
+          seen.include?(zid).must_equal false
+          seen.add(zid)
+        }
+      end
+
+    end
+
+  end
+
+  describe "#valid" do
+
+    describe "with valid string" do
+      it "is true" do
+        ZID.valid?("c3d010bbfec046f59c7fe843d32dab32").must_be_same_as true
+      end
+    end
+
+    describe "with invalid string" do
+      it "is false" do
+        ZID.valid?("abc").must_be_same_as false
+      end
+    end
+
+  end
+
+  describe ".parse" do
+
+    it "converts objects to strings" do
+      obj = Minitest::Mock.new
+      obj.expect(:to_s, "!!C3D010BBFEC046F59C7FE843D32DAB32!!")
+      ZID.parse(obj).must_equal "c3d010bbfec046f59c7fe843d32dab32"
+      obj.verify
+    end
+
+    it "converts to lower case" do
+      ZID.parse("C3D010BBFEC046F59C7FE843D32DAB32").must_equal "c3d010bbfec046f59c7fe843d32dab32"
+    end
+
+    it "deletes non-hex characters" do
+      ZID.parse("!!c3d010bb-fec0-46f59c7f-e843d32dab32!!").must_equal "c3d010bbfec046f59c7fe843d32dab32"
+    end
+
+    it "chops at 32 characters" do
+      ZID.parse("c3d010bbfec046f59c7fe843d32dab32aaaaaaaaa").must_equal "c3d010bbfec046f59c7fe843d32dab32"
+    end
+
+    it "raises if the string is invalid" do
+      proc { ZID.parse("abc") }.must_raise ArgumentError
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: sixarm_ruby_zid
+version: !ruby/object:Gem::Version
+  version: 5.0.1
+platform: ruby
+authors:
+- SixArm
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIFPDCCAyQCCQDx7Y5LWGuPPzANBgkqhkiG9w0BAQsFADBgMQswCQYDVQQGEwJV
+  UzETMBEGA1UECAwKQ2FsaWZvcm5pYTEWMBQGA1UEBwwNU2FuIEZyYW5jaXNjbzEP
+  MA0GA1UECgwGU2l4QXJtMRMwEQYDVQQDDApzaXhhcm0uY29tMB4XDTE4MDExMzIy
+  NDYyM1oXDTIwMTAwOTIyNDYyM1owYDELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNh
+  bGlmb3JuaWExFjAUBgNVBAcMDVNhbiBGcmFuY2lzY28xDzANBgNVBAoMBlNpeEFy
+  bTETMBEGA1UEAwwKc2l4YXJtLmNvbTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC
+  AgoCggIBAMMPPjYWd77gRmOEkMb+1H9+ckIHlA325OkES2g5Y58hIDzZYTGIxjSP
+  3N7uYx5qR8qZvuO4F1McGJ/NES2robjQcV/aIRXD+5RjbokyYYGJlJujm5c/wZme
+  Us7pOzQxc8QcogsdInwQ6O9hTQ4zBdOFZt6YBp5y9ycXVIApBnxJHBU3W6Ir1hl6
+  3v6RYBgHFd3g0dCwuBoaYZE5MU/4q91vc48XhioqXdJlaDyw1ZMyvE+loi+8quVg
+  bpUadC/QUZukABYCu6rS6fiRLffmMy/Db7d8b1fP+J1i4bL5atF4xz8c1BDwc2x1
+  mXJDUBznMSDpmjAkUwDjh+330tYT/VTioqobCMSLfwgJI2Uqrr8H8N9yeSsOMAup
+  nJKnJHXeZPEGAr2LBCcok2KUcdugdYq/0C+ec1bU8BHDDoEOM54rhPKKmCJentO6
+  KJRoJfu0ovQj1/BvSksUUWdvhy6jzXviyQq44GKEwsJix6sdNKEpndVDQGOvHPg5
+  gcakte7KrpK2Udwy+dK+caHJWXOouHPPFfdZWr5U9DkNjtvvQrwQUsMxECoByKYA
+  7wmX3SwzodtuzAPGzxuwkqwy1RtHAfbrFINFBxP35G/f16x2mtwEpqsdS4LE+c0C
+  l3eEQ8xIv3ijKUZek87Uxk7/JH76C3/9tSQeFkt0NkEduHOR1H7RAgMBAAEwDQYJ
+  KoZIhvcNAQELBQADggIBALIBNN7zUhFldUaXWGwv6032ZwM2Sm1U8VF8YaH71NLg
+  FhlcuJ0JLkGlxT0/68acS0EwoqOEgaHyPx8eodjyDv2MuJlWJGXIgHgLD66Tu0VA
+  Wt1sgA823Rl35WVSMqiyoxwsrGFwMtayNrrlpdhB8Ny8CMA2NfKyEJkh4+xlE72a
+  D8Eu8NFr9Tt5lHWXdZBI5BhzhQxPPxeIuw0wZ3+kiwxRie7K4XhKsOIrPmu2i6QV
+  Yl/663wZgWpqrroSnc3PE3lsuTW7quUvayjtqMTU2qrh7i21oB+/Nn+I6gcxYJZb
+  UlK+tvsqoM94U6sFTjw9mDt62MLQGrJtHShS+ZZiGmWj1sKreuwGJnCVDoBk15xa
+  oqlvfvLAMBCqlfrHhvGUfbIMgzb9uXNmCjzYMsQxuIgF6IMis6Kq02NBAR91HPMe
+  2RoY7CdBHMxW+O0tgS2xoQbOwb+ti1j4MbsWpCqS9Mteck0Z7jZpRRrUDjXU+/7Z
+  RmW9HX0oLIoCBDChCcEKG0Ma4IvHUgjv47f5iYpkXuhifiK4xMG/s+T5Euw3Wg9J
+  tzpk/VnZXj7Ek/earx+N/Z+Wtnl2xENm5IF8SFPeI1HFa9NH47pqtxF1YKpNIEVc
+  2xa2BNHSePe7tys/2hbmZuyMu8X5ERmovsabSXB3a+YwtJh5c2jhA21wF7986s0q
+  -----END CERTIFICATE-----
+date: 2018-05-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.7.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.7.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: sixarm_ruby_minitest_extensions
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.8
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.8
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '11'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: ZID generates a new random id, suitable for foreign keys, security authentication,
+  unique tracking, etc.
+email: sixarm@sixarm.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- lib/sixarm_ruby_zid.rb
+- lib/sixarm_ruby_zid/zid.rb
+- test/sixarm_ruby_zid_test.rb
+- test/sixarm_ruby_zid_test/zid_test.rb
+homepage: http://sixarm.com/
+licenses:
+- Apache-2.0
+- Artistic-2.0
+- BSD-3-Clause
+- GPL-3.0
+- MIT
+- MPL-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: 'SixArm.com → Ruby → ZID: Xeno Identifier'
+test_files:
+- test/sixarm_ruby_zid_test.rb
+- test/sixarm_ruby_zid_test/zid_test.rb