rango 0.0.3 → 0.0.4

data/lib/rango/ext/object.rb

@@ -0,0 +1,56 @@
+# encoding: utf-8
+
+class Object
+  # *Unlike* that method however, a +NoMethodError+ exception will *not* be raised
+  # and +nil+ will be returned instead, if the receiving object is a +nil+ object or NilClass.
+  #
+  # Invokes the method identified by the symbol +method+, passing it any arguments
+  # and/or the block specified, just like the regular Ruby <tt>Object#send</tt> does.
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @return [Object, nil] Return value of object.send(method) if object respond to method or nil
+  # @param [Symbol] Method which will be called on object if object respond to this method
+  # @param [Object, optional] Arguments for +method+ argument
+  # @yield [block, optional] Block for +method+ argument
+  # @example
+  #   @post.try(:name) # instead @post && @post.name
+  #   eBook.try(:find, 1)
+  #   @post.try(:collect) { |p| p.name }
+  def try(method, *args, &block)
+    self.send(method, *args, &block) if self.respond_to?(method)
+  end
+
+  # The opposite of <tt>#nil?</tt>.
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @return [true, false] True if self is nil, false otherwise
+  def not_nil?
+    not self.nil?
+  end
+
+  # Defines a instance method on class of the object.
+  # 
+  # @author Botanicus
+  # @since 0.0.3
+  # @param [Symbol] Method name
+  # @param [Method, Proc, optional] +Method+ or +Proc+ which will be used as body of the method
+  # @yield [block] Block which will be used as body of the method
+  # @return [Object] First (and only) item of the array
+  # @see <tt>Module#define_singleton_method</tt> for define method on singleton class
+  # @example
+  #   class Experiment
+  #     def method_generator
+  #       define_instance_method(:new_method) do |arg|
+  #         puts "Method :new_method called with #{arg}"
+  #       end
+  #     end
+  #   end
+  #   Experiment.new.methods.include?(:new_method) # => false
+  #   Experiment.new.method_generator
+  #   Experiment.new.methods.include?(:new_method) # => true
+  def define_instance_method(*args, &block)
+    self.class.send(:define_method, *args, &block)
+  end
+end

data/lib/rango/ext/object_space.rb

@@ -1,11 +1,16 @@
-# coding: utf-8
+# encoding: utf-8
 
 module ObjectSpace
+  # Returns all classes existing in runtime
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @return [Array<Class>] List of all classes loaded into runtime
   def self.classes
-    classes = Array.new
-    ObjectSpace.each_object(Class) do |klass|
-      classes << klass
+    Array.new.tap do |objects|
+      self.each_object(Class) do |object|
+        objects << object
+      end
     end
-    return classes
   end
 end

data/lib/rango/ext/os.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+
+class OS
+  # Takes ENV or another hash-like object and convert it into OS instance
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @param [ENV, Hash] ENV or another hash-like object
+  # @return [OS] Instance of OS
+  # @example
+  #   OS.parse
+  #   OS.parse("HOME" => "/Users/botanicus")
+  def self.parse(original_env = ENV)
+    input  = original_env.select { |key, value| key.match(/^[a-zA-Z][a-zA-Z_]*$/) }
+    result = Hash.new
+    input.each { |key, value| result[key.downcase.to_sym] = value }
+    self.new(result, original_env)
+  end
+
+  attr_reader :env, :original_env
+  def initialize(env, original_env = env)
+    @env, @original_env = env, original_env
+    self.keys.each do |key|
+      if key.match(/(path|lib)$/)
+        # OS.path
+        # => ["/bin", "/usr/bin", "/sbin", "/usr/sbin"]
+        define_singleton_method(key) do
+          @env[key].split(":").uniq.sort
+        end
+      elsif @env[key].match(/^\d+$/)
+        define_singleton_method(key) { @env[key].to_i }
+      elsif @env[key].empty?
+        define_singleton_method(key) { nil }
+      else
+        # OS.home
+        # => "/Users/botanicus"
+        define_singleton_method(key) do
+          case value = @env[key]
+          when /^\d+$/      then value.to_i
+          when /^\d+\.\d+$/ then value.to_f
+          when /^true$/i    then true
+          when /^false$/i   then false
+          when /^$/         then nil
+          else              value
+          end
+        end
+      end
+    end
+  end
+
+  # Get value for given key or nil
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @param [Symbol] Key
+  # @return [OS] Instance of OS
+  # @example
+  #   os[:home]
+  def [](key)
+    self.send(key) if self.keys.include?(key.to_sym)
+  end
+
+  def ==(other)
+    same_keys = self.keys == other.keys
+    same_values = self.keys.all? { |key| self[key] == other[key] }
+    same_keys && same_values
+  end
+
+  def keys
+    @env.keys.sort
+  end
+
+  def inspect
+    string = "#<OS keys=[%s]>"
+    format = lambda { |key| "#{key}=#{self.send(key).inspect}" }
+    inner  = self.keys.sort.map(&format).join(", ")
+    string % inner
+  end
+
+  # TODO
+  def root?
+    self.uid.eql?(0)
+  end
+
+  private
+  def method_missing(name, *args, &block)
+    super(name, *args, &block) unless args.empty? && block.nil?
+  end
+end

data/lib/rango/ext/platform.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+module Rango
+  class Platform
+    class << self
+      def match?(platform)
+        !! RUBY_PLATFORM.match(/#{platform}/i)
+      end
+
+      def windows?
+        self.match?("mswin|mingw")
+      end
+
+      def linux?
+        self.match?("linux")
+      end
+
+      def macosx?
+        self.match?("-darwin")
+      end
+
+      def unix?
+        self.linux? or self.macosx?
+      end
+    end
+  end
+end

data/lib/rango/ext/random.rb

@@ -1,6 +1,11 @@
-# coding: utf-8
+# encoding: utf-8
 
 class Array
+  # Returns random item from the array
+  #
+  # @author Botanicus
+  # @since 0.0.2
+  # @return [Object] Random item from array
   def rand
     self[Kernel.rand(length)]
   end
@@ -8,15 +13,13 @@ class Array
 end
 
 class Range
+  # Returns random item from the array
+  #
+  # @author Botanicus
+  # @since 0.0.2
+  # @return [Object] Random item from range
   def rand
     self.min + Kernel.rand(self.max)
   end
   alias_method :random, :rand
 end
-
-class Hash
-  def rand
-    self[self.keys.random]
-  end
-  alias_method :random, :rand
-end

data/lib/rango/ext/string.rb

@@ -1,16 +1,30 @@
-# coding: utf-8
+# encoding: utf-8
 
 class String
+  # Transform self into titlecased string.
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @return [String] Titlecased string
+  # @example
+  #   "hello world!".titlecase # => "Hello World!"
+  def titlecase
+    self.gsub(/\b./) { $&.upcase }
+  end
+
+  # Transform self to +ColoredString+
   # @since 0.0.1
   # @example
   #   "message".colorize.red.bold
   # @param [type] name explanation
-  # @return [String] Return duplication of self. In it's metaclass is included +Term::ANSIColor+.
+  # @return [String] Transfrom self to +ColoredString+
   def colorize
+    require_relative "colored_string"
     ColoredString.new(self)
   end
 
-  # rack
+  # For Rack
   # @since 0.0.2
+  # @todo Is it still required?
   alias_method :each, :each_line
 end

data/lib/rango/ext/thor.rb

@@ -1,29 +1,29 @@
-# coding: utf-8
+# encoding: utf-8
 
 require "thor"
+require "extlib"
+require_relative "../ext"
 
 # Hooks
 # Rango::Tasks.hook do
 #   Dir["models/*.rb"].each(&method(:require))
 # end
-class Rango
+module Rango
   class Tasks < Thor
-    class << self
-      attr_accessor :hooks
-      def hook(&block)
-        @hooks ||= Array.new
-        @hooks.push(block)
-      end
+    cattr_accessor :hooks
+    @@hooks ||= Array.new
 
-      def inherited(subclass)
-        subclass.hooks = self.hooks
-      end
+    def self.hook(&block)
+      @@hooks.push(block)
+    end
+
+    def self.inherited(subclass)
+      subclass.hooks = self.hooks
     end
 
     def boot(*args)
       require "rango"
       Rango.boot(*args)
-      p self.class.hooks
       self.class.hooks.each(&:call)
     rescue Exception => exception
       Rango.logger.exception(exception)

data/lib/rango/ext/time.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+class Time
+  # How long it takes to run the block in seconds
+  #
+  # @author Botanicus
+  # @since 0.0.3
+  # @return [Float] How long it takes to run the block in seconds
+  # @example
+  #   Time.timer { sleep 2 } # => 2.030802
+  def self.timer(&block)
+    start = Time.now.tap { block.call }
+    return Time.now - start
+  end
+end

data/lib/rango/ext/time_dsl.rb

@@ -1,9 +1,9 @@
-# coding: utf-8
+# encoding: utf-8
 
 # stolen from merb-helpers
 
 # Provides a a simple way of calling time units and to see the elapsed time between 2 moments
-# ==== Examples
+# @example
 #   142.minutes => returns a value in seconds
 #   7.days => returns a value in seconds
 #   1.week => returns a value in seconds
@@ -11,7 +11,6 @@
 #   1.year.since(time) => returns a date
 #   5.months.since(2.weeks.from_now) => returns a date
 module TimeDSL
-
   def second
     self * 1
   end

data/lib/rango/ext/unique_array.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+
+# Get is using it
+# co treba udelat to pres observery?
+module Rango
+  class UniqueArray < Array
+    def push(*args)
+      args.each do |arg|
+        unless self.include?(arg)
+          super(arg)
+        end
+      end
+    end
+    alias_method :<<, :push
+  end
+end

data/lib/rango/forms/form.rb

@@ -1,4 +1,4 @@
-# coding: utf-8
+# encoding: utf-8
 
 # class ContactForm < Rango::Form
 #   property :subject, String
@@ -7,7 +7,7 @@
 # end
 
 # @future 0.0.3 It's just a prototype now
-class Rango
+module Rango
   class Form
     attribute :media
 

data/lib/rango/generic_views.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+Rango.import("mixins/mini")
+
+module Rango
+  module GenericViews
+    include Rango::Mini
+    def static
+      app do |request, response|
+        template = "#{request.script_name[1..-1]}.html"
+        Rango.logger.debug("Rendering '#{template}'")
+        render template
+      end
+    end
+  end
+end
+
+Rack::Builder.send(:include, Rango::GenericViews)

data/lib/rango/helpers.rb

@@ -1,6 +1,6 @@
-# coding: utf-8
+# encoding: utf-8
 
-class Rango
+module Rango
   module Helpers
     # tag :a, href: "/contact" { anchor }
     # tag :a, "contact", href: "/contact"

data/lib/rango/helpers/assets.rb

@@ -1,6 +1,6 @@
-# coding: utf-8
+# encoding: utf-8
 
-class Rango
+module Rango
   module Helpers
     # stolen from pupu (but it's OK, it's my code)
     # @since 0.0.2

data/lib/rango/helpers/general.rb

@@ -1,7 +1,8 @@
-# coding: utf-8
+# encoding: utf-8
+
 require "uri"
 
-class Rango
+module Rango
   module Helpers
     # @since 0.0.1
     def copyright(from)
@@ -37,5 +38,15 @@ class Rango
         messages.map { |message| tag :li, message }
       end
     end
+
+    def truncate(text, *args)
+      options = args.extract_options!
+      unless args.empty?
+        options[:size]     = args[0] || 75
+        options[:omission] = args[1] || "..."
+      end
+      options.reverse_merge!(:size => 75, :omission => "...")
+      text.scan(/(\S+)(\s+)/)[0..options[:size]].flatten.join << options[:omission] if text
+    end
   end
 end