ramaze 2008.06 → 2008.11

data/lib/ramaze/snippets/kernel/constant.rb

@@ -1,26 +1,41 @@
 #          Copyright (c) 2008 Michael Fellinger m.fellinger@gmail.com
 # All files in this distribution are subject to the terms of the Ruby license.
 
-# Extensions for Kernel
-
-module Kernel
-  # Original from Trans (Facets 1.4.5)
-  # This is similar to +Module#const_get+ but is accessible at all levels,
-  # and, unlike +const_get+, can handle module hierarchy.
-  #
-  #   constant("Fixnum")                  # -> Fixnum
-  #   constant(:Fixnum)                   # -> Fixnum
-  #
-  #   constant("Process::Sys")            # -> Process::Sys
-  #   constant("Regexp::MULTILINE")       # -> 4
-  #
-  #   require 'test/unit'
-  #   Test.constant("Unit::Assertions")   # -> Test::Unit::Assertions
-  #   Test.constant("::Test::Unit")       # -> Test::Unit
-
-  def constant(const)
-    const = const.to_s.dup
-    base = const.sub!(/^::/, '') ? Object : ( self.kind_of?(Module) ? self : self.class )
-    const.split(/::/).inject(base){ |mod, name| mod.const_get(name) }
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Kernel
+
+    module Object
+
+      # Original from Trans (Facets 1.4.5)
+      # This is similar to +Module#const_get+ but is accessible at all levels,
+      # and, unlike +const_get+, can handle module hierarchy.
+      #
+      #   constant("Fixnum")                  # -> Fixnum
+      #   constant(:Fixnum)                   # -> Fixnum
+      #
+      #   constant("Process::Sys")            # -> Process::Sys
+      #   constant("Regexp::MULTILINE")       # -> 4
+      #
+      #   require 'test/unit'
+      #   Test.constant("Unit::Assertions")   # -> Test::Unit::Assertions
+      #   Test.constant("::Test::Unit")       # -> Test::Unit
+
+      def constant(const)
+        const = const.to_s.dup
+
+        if const.sub!(/^::/, '')
+          base = Object
+        elsif self.kind_of?(Module)
+          base = self
+        else
+          base = self.class
+        end
+
+        const.split(/::/).inject(base){ |mod, name| mod.const_get(name) }
+      end
+    end
+
   end
 end

data/lib/ramaze/snippets/kernel/pretty_inspect.rb

@@ -3,13 +3,19 @@
 
 require 'pp'
 
-# Extensions for Kernel
+module Ramaze
+  module CoreExtensions
 
-module Kernel
-  unless defined?(pretty_inspect)
-    # returns a pretty printed object as a string.
-    def pretty_inspect
-      PP.pp(self, '')
+    # Extensions for Kernel
+
+    module Kernel
+      unless defined?(pretty_inspect)
+        # returns a pretty printed object as a string.
+        def pretty_inspect
+          PP.pp(self, '')
+        end
+      end
     end
+
   end
 end

data/lib/ramaze/snippets/numeric/filesize_format.rb

@@ -1,25 +1,32 @@
 #          Copyright (c) 2008 Michael Fellinger m.fellinger@gmail.com
 # All files in this distribution are subject to the terms of the Ruby license.
 
-class Numeric
-  FILESIZE_FORMAT = [
-    ['%.1fT', 1 << 40],
-    ['%.1fG', 1 << 30],
-    ['%.1fM', 1 << 20],
-    ['%.1fK', 1 << 10],
-  ]
+module Ramaze
+  module CoreExtensions
 
-  # Output this number as easily readable filesize.
-  # Usage:
-  #   100_000.filesize_format             # => "97.7K"
-  #   100_000_000.filesize_format         # => "95.4M"
-  #   100_000_000_000.filesize_format     # => "93.1G"
-  #   100_000_000_000_000.filesize_format # => "90.9T"
-  def filesize_format
-    FILESIZE_FORMAT.each do |format, size|
-      return format % (self.to_f / size) if self >= size
+    # Extensions for Numeric
+    module Numeric
+      FILESIZE_FORMAT = [
+        ['%.1fT', 1 << 40],
+        ['%.1fG', 1 << 30],
+        ['%.1fM', 1 << 20],
+        ['%.1fK', 1 << 10],
+      ]
+
+      # Output this number as easily readable filesize.
+      # Usage:
+      #   100_000.filesize_format             # => "97.7K"
+      #   100_000_000.filesize_format         # => "95.4M"
+      #   100_000_000_000.filesize_format     # => "93.1G"
+      #   100_000_000_000_000.filesize_format # => "90.9T"
+      def filesize_format
+        FILESIZE_FORMAT.each do |format, size|
+          return format % (self.to_f / size) if self >= size
+        end
+
+        self.to_s
+      end
     end
 
-    self.to_s
   end
 end

data/lib/ramaze/snippets/numeric/time.rb

@@ -0,0 +1,63 @@
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Numeric
+
+    module Numeric
+      def seconds
+        self
+      end
+      alias second seconds
+
+      # 60 seconds in a minute
+      def minutes
+        self * 60
+      end
+      alias minute minutes
+
+      # 60 minutes in an hour
+      def hours
+        self * 3600
+      end
+      alias hour hours
+
+      # 24 hours in a day
+      def days
+        self * 86400
+      end
+      alias day days
+
+      # 7 days in a week
+      def weeks
+        self * 604800
+      end
+      alias week weeks
+
+      # 30 days in a month
+      def months
+        self * 2592000
+      end
+      alias month months
+
+      # 365.25 days in a year
+      def years
+        self * 883612800
+      end
+      alias year years
+
+      # Time in the past, i.e. 3.days.ago
+      def ago t = Time.now
+        t - self
+      end
+      alias before ago
+
+      # Time in the future, i.e. 3.days.from_now
+      def from_now t = Time.now
+        t + self
+      end
+      alias since from_now
+
+    end
+
+  end
+end

data/lib/ramaze/snippets/object/__dir__.rb

@@ -0,0 +1,29 @@
+#          Copyright (c) 2008 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Object
+
+    module Object
+      unless defined?(__DIR__)
+
+        # This is similar to +__FILE__+ and +__LINE__+, and returns a String
+        # representing the directory of the current file is.
+        # Unlike +__FILE__+ the path returned is absolute.
+        #
+        # This method is convenience for the
+        #  File.expand_path(File.dirname(__FILE__))
+        # idiom.
+        #
+
+        def __DIR__()
+          filename = caller[0][/^(.*):/, 1]
+          File.expand_path(File.dirname(filename))
+        end
+      end
+    end
+
+  end
+end

data/lib/ramaze/snippets/object/acquire.rb

@@ -0,0 +1,40 @@
+#          Copyright (c) 2008 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Kernel
+
+    module Object
+
+      # Require all .rb and .so files on the given globs, utilizes Dir::[].
+      #
+      # Examples:
+      #   # Given following directory structure:
+      #   # src/foo.rb
+      #   # src/bar.so
+      #   # src/foo.yaml
+      #   # src/foobar/baz.rb
+      #   # src/foobar/README
+      #
+      #   # requires all files in 'src':
+      #   acquire 'src/*'
+      #
+      #   # requires all files in 'src' recursive:
+      #   acquire 'src/**/*'
+      #
+      #   # require 'src/foo.rb' and 'src/bar.so' and 'src/foobar/baz.rb'
+      #   acquire 'src/*', 'src/foobar/*'
+
+      def acquire *globs
+        globs.flatten.each do |glob|
+          Dir[glob].each do |file|
+            require file if file =~ /\.(rb|so)$/
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/ramaze/snippets/object/instance_variable_defined.rb

@@ -1,8 +1,19 @@
-class Object
-  # Available in 1.8.6 and later.
-  unless method_defined?(:instance_variable_defined?)
-    def instance_variable_defined?(variable)
-      instance_variables.include?(variable.to_s)
+#          Copyright (c) 2008 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Object
+    module Object
+      # Available in 1.8.6 and later.
+
+      unless ::Object.method_defined?(:instance_variable_defined?)
+        def instance_variable_defined?(variable)
+          instance_variables.include?(variable.to_s)
+        end
+      end
     end
+
   end
 end

data/lib/ramaze/snippets/object/pretty.rb

@@ -1,6 +1,16 @@
-class Object
-  def pretty s = ''
-    PP.pp(self, s)
-    s
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Object
+    module Object
+
+      # Returns the string that #pretty_inspect would yield
+
+      def pretty s = ''
+        PP.pp(self, s)
+        s
+      end
+    end
+
   end
 end

data/lib/ramaze/snippets/object/scope.rb

@@ -1,11 +1,18 @@
-class Object
+module Ramaze
+  module CoreExtensions
 
-  # returns a new clean binding for this object
-  #   usage: eval 'self', object.scope  #=> returns object
-  #
+    # Extensions for Object
+    module Object
 
-  def scope
-    lambda{}
-  end
+      # returns a new clean binding for this object
+      #   usage: eval 'self', object.scope  #=> returns object
+      #
+
+      def scope
+        lambda{}
+      end
 
+    end
+
+  end
 end

data/lib/ramaze/snippets/ordered_set.rb

@@ -5,6 +5,10 @@ require(File.join(File.dirname(__FILE__), 'blankslate'))
 
 # Basically an Set, but with Order, ain't that obivous?
 class OrderedSet < BlankSlate
+  def self.[](*args)
+    new(*args)
+  end
+
   # Create new instances, optionally pass the first set
   def initialize(*args)
     if args.size == 1
@@ -18,23 +22,30 @@ class OrderedSet < BlankSlate
     @set.uniq!
   end
 
+  %w[ push unshift << ].each do |meth|
+    class_eval %[
+      def #{meth} *args
+        @set.delete(*args)
+        @set.#{meth}(*args)
+      end
+    ]
+  end
+
+  def []= *args
+    @set.map! do |e|
+      if ::Array === args.last
+        args.last.include?(e) ? nil : e
+      else
+        args.last == e ? nil : e
+      end
+    end
+    @set.__send__(:[]=, *args)
+    @set.compact!
+  end
+
   # Delegate everything, but controlled, keep elements unique.
   # Warning, this is not really atomic.
   def method_missing(meth, *args, &block)
-    case meth.to_s
-    when /push|unshift|\<\</
-      @set.delete(*args)
-    when '[]='
-      @set.map! do |e|
-        if ::Array === args.last
-          args.last.include?(e) ? nil : e
-        else
-          args.last == e ? nil : e
-        end
-      end
-    end
     @set.__send__(meth, *args, &block)
-  ensure
-    @set.compact! if meth == :[]=
   end
 end

data/lib/ramaze/snippets/proc/locals.rb

@@ -1,11 +1,19 @@
-class Proc
-
-  # returns a hash of localvar/localvar-values from proc, useful for template
-  # engines that do not accept bindings/proc and force passing locals via
-  # hash
-  #   usage: x = 42; p Proc.new.locals #=> {'x'=> 42}
-  def locals
-    instance_eval('binding').locals
-  end
+module Ramaze
+  module CoreExtensions
+
+    # Extensions for Proc
+
+    module Proc
 
+      # returns a hash of localvar/localvar-values from proc, useful for template
+      # engines that do not accept bindings/proc and force passing locals via
+      # hash
+      #   usage: x = 42; p Proc.new.locals #=> {'x'=> 42}
+
+      def locals
+        instance_eval('binding').locals
+      end
+
+    end
+  end
 end

data/lib/ramaze/snippets/ramaze/deprecated.rb

@@ -1,7 +1,20 @@
 module Ramaze
+  DEPRECATED_CONSTANTS = {
+    :ThreadAccessor => :StateAccessor
+  }
+
   def self.deprecated(from, to = nil)
     message = "%s is deprecated"
     message << ", use %s instead" unless to.nil?
     Log.warn(message % [from, to])
   end
+
+  def self.const_missing(name)
+    if to = DEPRECATED_CONSTANTS[name]
+      Log.warn "Ramaze::#{name} is deprecated, use #{to} instead"
+      constant(to)
+    else
+      super
+    end
+  end
 end