dionysus 1.0.2 → 2.0.0

data/.document

@@ -1,5 +0,0 @@
-README.rdoc
-lib/**/*.rb
-bin/*
-features/**/*.feature
-LICENSE

data/.gitignore

@@ -1,22 +0,0 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-/coverage
-/docs
-/pkg
-/.bundle
-
-## PROJECT::SPECIFIC

data/.rspec

@@ -1 +0,0 @@
---color

data/Gemfile.lock

@@ -1,41 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activesupport (3.0.0)
-    diff-lcs (1.1.2)
-    git (1.2.5)
-    jeweler (1.5.0.pre3)
-      bundler (~> 1.0.0)
-      git (>= 1.2.5)
-      rake
-    json (1.4.6)
-    rake (0.8.7)
-    rcov (0.9.9)
-    rdiscount (1.6.5)
-    rdoc (2.4.3)
-    rspec (2.0.0.beta.22)
-      rspec-core (= 2.0.0.beta.22)
-      rspec-expectations (= 2.0.0.beta.22)
-      rspec-mocks (= 2.0.0.beta.22)
-    rspec-core (2.0.0.beta.22)
-    rspec-expectations (2.0.0.beta.22)
-      diff-lcs (>= 1.1.2)
-    rspec-mocks (2.0.0.beta.22)
-      rspec-core (= 2.0.0.beta.22)
-      rspec-expectations (= 2.0.0.beta.22)
-    sdoc (0.2.20)
-      json (>= 1.1.3)
-      rdoc (= 2.4.3)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activesupport (~> 3.0.0)
-  bundler (~> 1.0)
-  jeweler (~> 1.5.0)
-  rake (~> 0.8.0)
-  rcov (~> 0.9.0)
-  rdiscount (~> 1.6.0)
-  rspec (~> 2.0.0)
-  sdoc (~> 0.2.0)

data/VERSION

@@ -1 +0,0 @@
-1.0.2

data/dionysus.gemspec

@@ -1,121 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{dionysus}
-  s.version = "1.0.2"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Travis D. Warlick, Jr."]
-  s.date = %q{2010-10-03}
-  s.email = %q{warlickt@operissystems.com}
-  s.extra_rdoc_files = [
-    "LICENSE",
-    "README.md"
-  ]
-  s.files = [
-    ".document",
-    ".gitignore",
-    ".rspec",
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE",
-    "README.md",
-    "Rakefile",
-    "VERSION",
-    "dionysus.gemspec",
-    "lib/dionysus.rb",
-    "lib/dionysus/configuration.rb",
-    "lib/dionysus/digest.rb",
-    "lib/dionysus/rdoc/markdown.rb",
-    "lib/dionysus/rdoc/no_markup.rb",
-    "lib/dionysus/security.rb",
-    "lib/dionysus/security/password_salt.rb",
-    "lib/dionysus/security/string.rb",
-    "lib/dionysus/string.rb",
-    "lib/dionysus/version_string.rb",
-    "spec/configuration_spec.rb",
-    "spec/digest_spec.rb",
-    "spec/dionysus_spec.rb",
-    "spec/password_salt_spec.rb",
-    "spec/spec_helper.rb",
-    "spec/string_security_spec.rb",
-    "spec/string_spec.rb",
-    "spec/version_string_spec.rb"
-  ]
-  s.homepage = %q{http://github.com/tekwiz/dionysus}
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{A helpful set of utility classes, generators, and command-line tools.}
-  s.test_files = [
-    "spec/configuration_spec.rb",
-    "spec/digest_spec.rb",
-    "spec/dionysus_spec.rb",
-    "spec/password_salt_spec.rb",
-    "spec/spec_helper.rb",
-    "spec/string_security_spec.rb",
-    "spec/string_spec.rb",
-    "spec/version_string_spec.rb"
-  ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_runtime_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.5.0"])
-      s.add_development_dependency(%q<rake>, ["~> 0.8.0"])
-      s.add_development_dependency(%q<rcov>, ["~> 0.9.0"])
-      s.add_development_dependency(%q<sdoc>, ["~> 0.2.0"])
-      s.add_development_dependency(%q<rdiscount>, ["~> 1.6.0"])
-      s.add_runtime_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_runtime_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.5.0"])
-      s.add_development_dependency(%q<rake>, ["~> 0.8.0"])
-      s.add_development_dependency(%q<rcov>, ["~> 0.9.0"])
-      s.add_development_dependency(%q<sdoc>, ["~> 0.2.0"])
-      s.add_development_dependency(%q<rdiscount>, ["~> 1.6.0"])
-    else
-      s.add_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
-      s.add_dependency(%q<rake>, ["~> 0.8.0"])
-      s.add_dependency(%q<rcov>, ["~> 0.9.0"])
-      s.add_dependency(%q<sdoc>, ["~> 0.2.0"])
-      s.add_dependency(%q<rdiscount>, ["~> 1.6.0"])
-      s.add_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
-      s.add_dependency(%q<rake>, ["~> 0.8.0"])
-      s.add_dependency(%q<rcov>, ["~> 0.9.0"])
-      s.add_dependency(%q<sdoc>, ["~> 0.2.0"])
-      s.add_dependency(%q<rdiscount>, ["~> 1.6.0"])
-    end
-  else
-    s.add_dependency(%q<bundler>, ["~> 1.0"])
-    s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-    s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
-    s.add_dependency(%q<rake>, ["~> 0.8.0"])
-    s.add_dependency(%q<rcov>, ["~> 0.9.0"])
-    s.add_dependency(%q<sdoc>, ["~> 0.2.0"])
-    s.add_dependency(%q<rdiscount>, ["~> 1.6.0"])
-    s.add_dependency(%q<bundler>, ["~> 1.0"])
-    s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-    s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
-    s.add_dependency(%q<rake>, ["~> 0.8.0"])
-    s.add_dependency(%q<rcov>, ["~> 0.9.0"])
-    s.add_dependency(%q<sdoc>, ["~> 0.2.0"])
-    s.add_dependency(%q<rdiscount>, ["~> 1.6.0"])
-  end
-end
-

data/lib/dionysus/configuration.rb

@@ -1,200 +0,0 @@
-require 'dionysus'
-require 'dionysus/version_string'
-
-##
-# = Configuration
-#
-#     require 'dionysus/configuration'
-#
-# A simple configuration system that can work in a "hard-keys" or "soft-keys"
-# mode. In the "hard-keys" mode, the configuration will only allow a specific
-# set of keys given on initialization.  In "soft-keys" mode, the configuration
-# will accept any keys, at any time, as long as they are valid.
-#
-# == Soft Keys Example:
-#
-#    config = Configuration.new(false, :a_key => 'some value')
-#    config.soft_keys? #=> true
-#    config.hard_keys? #=> false
-#    config.a_key = 'new value'
-#    config.a_key #=> 'new value'
-#    config.another_key = 'some value'
-#    config.anoter_key #=> 'some value'
-#
-# == Hard Keys Example:
-#
-#    config = Configuration.new(:foo, :bar, {:wowsers => 'wow', :foo => 'fooey'})
-#    config.hard_keys? #=> true
-#    config.soft_keys? #=> false
-#    config.a_key #=> raises NoMethodError
-#    config[:a_key]  #=> raises ArgumentError
-#    config.foo = 'fooey'
-#    config.bar #=> nil
-#    config.wowsers #=> 'wow'
-# 
-# == Multi Access
-#
-# Values are accessible through the "magic" methods, get() and set() methods, 
-# and hash brackets. These will all give the same result:
-#    config.a_key
-#    config[:a_key]
-#    config['a_key']
-#    config.get(:a_key)
-#    config.get('a_key')
-#
-# == Object Keys
-#
-# All keys are converted to strings and then to symbols:
-#     o = Object.new
-#     config.set(o, 'foo')
-#     config.get(o) #=> 'foo'
-#     config.keys #=> [:'#<Object:0x190544c>']
-class Configuration
-  # Regex to define a valid key
-  VALID_KEY = '[A-Za-z0-9\-_]+'
-  
-  ##
-  # Create the configuration.
-  #
-  # Soft Keys mode:: Pass +false+ as the first argument.
-  # Hard Keys mode:: Default, or pass +true+ as the first argument.
-  def initialize( *args )
-    defaults = (args.last.is_a?(Hash) ? args.pop : {})
-    
-    if _hard_keys?(defaults, args)
-      @keys = _normalize_hard_keys(defaults, args)
-      raise ArgumentError, 'Cannot have a hard keys configuration with no keys' if @keys.empty?
-    else
-      @keys = nil
-      raise ArgumentError, 'Cannot define hard keys in soft keys mode' if args.any?
-    end
-    
-    _initialize_config(defaults)
-  end
-  
-  ##
-  # +true+ if the configuration is limited to a specific set of keys.
-  def hard_keys?() !!@keys; end
-  
-  ##
-  # +true+ if the configuration is NOT limited to a specific set of keys. 
-  # (Inverse) of +hard_keys?+
-  def soft_keys?() !@keys; end
-  
-  ##
-  # The set of keys for the configuration.  If this is a hard keys 
-  # configuration, it returns the possible keys.  Otherwise, it returns the 
-  # set keys.
-  def keys() @keys || @config.keys; end
-  
-  ##
-  # +false+ if there are any values set.
-  def empty?() @config.empty?; end
-  
-  ##
-  # The number of configurations set.
-  def size() @config.size; end
-  
-  ##
-  # Set the configuration key to the given value.
-  def set(key, value) validate_key(key); @config[_normalize_key(key)] = value; end
-  alias_method :'[]=', :set
-  
-  ##
-  # Get the configuration value.
-  def get(key) validate_key(key); @config[_normalize_key(key)]; end
-  alias_method :'[]', :get
-  
-  ##
-  # Delete the configuration value.
-  def delete(key) @config.delete(key); end
-  
-  ##
-  # Convert the configuration to a hash.
-  def to_hash() @config.to_hash; end
-  
-  ##
-  # +true+ if the key is valid.
-  def valid_key?( key )
-    return false if key.blank?
-    key = _normalize_key(key).to_s
-    if RUBY_VERSION.satisfies?('>= 1.9.2')
-      key =~ /^#{VALID_KEY}$/ and !self.methods.include?(key.to_sym)
-    else
-      key =~ /^#{VALID_KEY}$/ and !self.methods.include?(key)
-    end
-  end
-  
-  ##
-  # +true+ if the key is allowed.
-  def allowed_key?( key )
-    @keys.nil? ? true : @keys.include?(_normalize_key(key))
-  end
-  
-  private
-  
-  ##
-  # If the key is invalid, it raises an error.
-  def validate_key( key )
-    return true if valid_key?(key) and allowed_key?(key)
-    raise ArgumentError, "Invalid key: #{key}"
-  end
-  
-  ##
-  # Determine if the set of arguments is requesting a hard keys configuration.
-  #
-  # This is a hard key configuration set if
-  # 1) the first argument is NOT false
-  # 2) there are explicit keys defined
-  # 3) there is a default set of arguments
-  def _hard_keys?( defaults, args )
-    if [false, true].include?(args.first)
-      args.shift
-    else
-      args.any? or (defaults and defaults.any?)
-    end
-  end
-  
-  ##
-  # Normalize the keys and keys from the defaults hash into the hard keys 
-  # array.
-  def _normalize_hard_keys( defaults, keys )
-    [].tap do |keys_|
-      (keys + defaults.keys).uniq.collect {|key_| key_.to_s}.sort.each do |key|
-        raise ArgumentError, "Invalid key: '#{key}'" unless valid_key?(key)
-        keys_ << _normalize_key(key)
-      end
-    end.freeze
-  end
-  
-  ##
-  # Normalize a key by converting it to a string and then a symbol.
-  def _normalize_key( key )
-    key.to_s.to_sym
-  end
-  
-  ##
-  # Initialize the default config hash
-  def _initialize_config( defaults )
-    @config = {}
-    defaults.each { |key, value| set(key, value) }
-    @config
-  end
-  
-  ##
-  # The magic.  Enables +config.foo+ and +config.foo=+ to map to the getters 
-  # and setters.
-  def method_missing( method_name, *args, &block )
-    match = method_name.to_s.match(/^(#{VALID_KEY})(=)??\Z/)
-    key, setter = _normalize_key(match[1]), (match[2] == '=')
-    
-    if allowed_key?(key) and !block_given?
-      if setter and args.length == 1
-        return set(key, args.first)
-      elsif key and !setter and args.empty?
-        return get(key)
-      end
-    end
-    super
-  end
-end

data/lib/dionysus/digest.rb

@@ -1,135 +0,0 @@
-require 'dionysus'
-require 'digest'
-
-##
-# Convenience methods for the Digest module.
-#
-#     require 'dionysus/digest'
-# 
-# The <tt>Digest::DEFAULT_DIGESTS</tt> are automatically registered, if they
-# exist.  You can register additional digests with Digest.register_digest.
-# The given class must give the digest with the <tt>digest(string)</tt>.
-#
-# TODO add digest detection -- by length and by proc on the digests hash
-module Digest
-  DEFAULT_DIGESTS = [:md5, :sha1, :sha2, :sha256, :sha384, :sha512]
-  @digests = {}
-  
-  ##
-  # Register a digest.  Raises an error if the interpreted class doesn't exist.
-  # It will interpret the klass as <tt>Digest::SYM</tt> if it's <tt>nil</tt>, 
-  # and it will run the <tt>digest</tt> method on the klass to determine the 
-  # digests bit length if bits is <tt>nil</tt>.
-  # 
-  # This will register <tt>:my_digest</tt> and automatically determine the bit 
-  # length by executing the class's <tt>digest</tt> method on the string 
-  # <tt>'1'</tt>:
-  #
-  #     Digest.register_digest!( :my_digest, :klass => MyDigestClass )
-  #
-  # Options:
-  # [klass]       The digest class (also can be an arbitrary object).  Default:
-  #               <tt>Digest::#{sym.to_s.upcase}</tt>
-  # [bit_length]  The bit length of the digest.  Default: calculated by 
-  #               running the digest on the string <tt>'1'</tt>.
-  # [method]      The calculation method for the digest.  Default: 
-  #               <tt>:digest</tt>
-  def self.register_digest!( sym, options = {} )
-    options = options.with_indifferent_access
-    options[:method]      ||= :digest
-    options[:klass]       ||= "Digest::#{sym.to_s.upcase}".constantize
-    options[:bit_length]  ||= options[:klass].send(options[:method], '1').length * 8
-    @digests[sym.to_sym] = options
-  end
-  
-  ##
-  # Register a digest.  Returns nil if an error occurs.
-  def self.register_digest( sym, options = {} )
-    self.register_digest!(sym, options)
-  rescue LoadError
-    nil
-  end
-  
-  ##
-  # The hash of registered digests.
-  def self.digests
-    @digests
-  end
-  
-  ##
-  # The available digests.
-  def self.available_digests
-    self.digests.keys
-  end
-  
-  ##
-  # The lengths of the registered digests in the given encoding.
-  def self.digest_lengths( encoding = :binary )
-    if encoding == :bit or encoding == 1
-      _digest_lengths(1)
-    elsif encoding.is_a?(Symbol) and String::ENCODING_BITS_PER_CHAR[encoding]
-      _digest_lengths(String::ENCODING_BITS_PER_CHAR[encoding])
-    elsif encoding.is_a?(Integer) and encoding > 0
-      _digest_lengths(encoding)
-    else
-      raise ArgumentError, "Invalid encoding"
-    end
-  end
-  
-  ##
-  # Calculate the given digest of the given string.
-  #
-  # Examples:
-  #
-  #     Digest.digest(:sha512, 'foobar') #=> binary digest
-  #     Digest.digest(Digest::SHA512, 'foobar') #=> binary digest
-  def self.digest( sym, str )
-    Digest.const_get(sym.to_s.upcase).digest(str)
-  end
-  
-  ##
-  # Detect the digest of the string.  Returns nil if the digest cannot be 
-  # determined.
-  #
-  # Example:
-  #     Digest.detect_digest("wxeCFXPVXePFcpwuFDjonyn1G/w=", :base64) #=> :sha1
-  #     Digest.detect_digest("foobar", :hex) #=> nil
-  def self.detect_digest( string, encoding = :binary )
-    string = string.strip unless encoding == :binary
-    dig = self.digest_lengths(encoding).invert[string.length]
-    dig = :sha256 if dig == :sha2
-    dig
-  end
-  
-  ##
-  # Detect the digest of the string.  Returns nil if the digest cannot be 
-  # determined.
-  #
-  # Example:
-  #     Digest.detect_digest!("wxeCFXPVXePFcpwuFDjonyn1G/w=", :base64) #=> :sha1
-  #     Digest.detect_digest!("foobar", :hex) #=> RuntimeError
-  def self.detect_digest!( string, encoding = :binary )
-    self.detect_digest(string, encoding) or raise("Unknown digest")
-  end
-  
-  private
-  
-  def self._digest_lengths( bits_per_char ) # :nodoc:
-    padding_factor = (bits_per_char.lcm(8) / bits_per_char)
-    
-    {}.tap do |result|
-      self.digests.each do |dig, info|
-        result[dig] = len = info[:bit_length] / bits_per_char
-        if (t_ = len % padding_factor) != 0
-          result[dig] = len + (padding_factor - t_)
-        end
-      end
-    end
-  end
-end
-
-# Register some default digests
-Digest::DEFAULT_DIGESTS.each do |dig|
-  Digest.register_digest(dig)
-end
-