RubyGems - lazier - Versions diffs - 1.0.0 - Mend

lazier 1.0.0

Files changed (61) hide show

data/.gitignore +6 -0
data/.travis.yml +8 -0
data/.yardopts +1 -0
data/Gemfile +9 -0
data/Gemfile.lock +82 -0
data/README.md +33 -0
data/Rakefile +18 -0
data/doc/Lazier.html +557 -0
data/doc/Lazier/Boolean.html +297 -0
data/doc/Lazier/DateTime.html +787 -0
data/doc/Lazier/DateTime/ClassMethods.html +1592 -0
data/doc/Lazier/Exceptions.html +125 -0
data/doc/Lazier/Exceptions/Dump.html +133 -0
data/doc/Lazier/Hash.html +393 -0
data/doc/Lazier/Math.html +130 -0
data/doc/Lazier/Math/ClassMethods.html +362 -0
data/doc/Lazier/Object.html +1565 -0
data/doc/Lazier/Pathname.html +225 -0
data/doc/Lazier/Settings.html +1249 -0
data/doc/Lazier/String.html +471 -0
data/doc/Lazier/TimeZone.html +1675 -0
data/doc/Lazier/TimeZone/ClassMethods.html +1055 -0
data/doc/Lazier/Version.html +189 -0
data/doc/_index.html +306 -0
data/doc/class_list.html +53 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +57 -0
data/doc/css/style.css +328 -0
data/doc/file.README.html +107 -0
data/doc/file_list.html +55 -0
data/doc/frames.html +28 -0
data/doc/index.html +107 -0
data/doc/js/app.js +214 -0
data/doc/js/full_list.js +173 -0
data/doc/js/jquery.js +4 -0
data/doc/method_list.html +652 -0
data/doc/top-level-namespace.html +112 -0
data/lazier.gemspec +36 -0
data/lib/lazier.rb +127 -0
data/lib/lazier/boolean.rb +26 -0
data/lib/lazier/datetime.rb +548 -0
data/lib/lazier/exceptions.rb +14 -0
data/lib/lazier/hash.rb +40 -0
data/lib/lazier/math.rb +47 -0
data/lib/lazier/object.rb +163 -0
data/lib/lazier/pathname.rb +26 -0
data/lib/lazier/settings.rb +118 -0
data/lib/lazier/string.rb +54 -0
data/lib/lazier/version.rb +24 -0
data/spec/coverage_helper.rb +19 -0
data/spec/cowtech-extensions/boolean_spec.rb +30 -0
data/spec/cowtech-extensions/datetime_spec.rb +352 -0
data/spec/cowtech-extensions/hash_spec.rb +30 -0
data/spec/cowtech-extensions/math_spec.rb +41 -0
data/spec/cowtech-extensions/object_spec.rb +231 -0
data/spec/cowtech-extensions/pathname_spec.rb +21 -0
data/spec/cowtech-extensions/settings_spec.rb +118 -0
data/spec/cowtech-extensions/string_spec.rb +45 -0
data/spec/lazier_spec.rb +57 -0
data/spec/spec_helper.rb +16 -0
metadata +292 -0

data/doc/top-level-namespace.html ADDED Viewed

@@ -0,0 +1,112 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Top Level Namespace
+    &mdash; Documentation by YARD 0.8.2.1
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!" + escape(window.location.href);
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Top Level Namespace
+</h1>
+<dl class="box">
+</dl>
+<div class="clear"></div>
+<h2>Defined Under Namespace</h2>
+<p class="children">
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Lazier.html" title="Lazier (module)">Lazier</a></span>
+</p>
+</div>
+    <div id="footer">
+  Generated on Wed Aug  1 08:57:55 2012 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.2.1 (ruby-1.9.2).
+</div>
+  </body>
+</html>

data/lazier.gemspec ADDED Viewed

@@ -0,0 +1,36 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2011 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+require File.expand_path('../lib/lazier/version', __FILE__)
+Gem::Specification.new do |gem|
+  gem.name = "lazier"
+  gem.version = Lazier::Version::STRING
+  gem.homepage = "http://github.com/ShogunPanda/lazier"
+  gem.summary = %q{Several Ruby object enhancements.}
+  gem.description = %q{Several Ruby object enhancements.}
+  gem.rubyforge_project = "lazier"
+  gem.authors = ["Shogun"]
+  gem.email = ["shogun_panda@me.com"]
+  gem.files = `git ls-files`.split($\)
+  gem.executables = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.add_dependency("json", "~> 1.7.0")
+  gem.add_dependency("actionpack", "~> 3.0")
+  gem.add_dependency("tzinfo", "~> 0.3.0")
+  gem.add_development_dependency("rspec", "~> 2.11.0")
+  gem.add_development_dependency("rake", "~> 0.9.0")
+  gem.add_development_dependency("simplecov", "~> 0.6.0")
+  gem.add_development_dependency("pry", ">= 0")
+  gem.add_development_dependency("yard", "~> 0.8.0")
+  gem.add_development_dependency("redcarpet", "~> 2.1.0")
+  gem.add_development_dependency("github-markup", "~> 0.7.0")
+end

data/lib/lazier.rb ADDED Viewed

@@ -0,0 +1,127 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2011 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+$KCODE='UTF8' if RUBY_VERSION < '1.9'
+require "json"
+require "tzinfo"
+require "active_support/all"
+require "action_view"
+require "lazier/version" if !defined?(Lazier::Version)
+require "lazier/exceptions"
+require "lazier/settings"
+require "lazier/object"
+require "lazier/boolean"
+require "lazier/string"
+require "lazier/hash"
+require "lazier/datetime"
+require "lazier/math"
+require "lazier/pathname"
+# Several Ruby object enhancements.
+module Lazier
+  # Checks if we are running under Ruby 1.8
+  #
+  # @return [Boolean] `true` for Ruby 1.8, `false` otherwise.
+  def self.is_ruby_18?
+    RUBY_VERSION =~ /^1\.8/
+  end
+  # Returns the settings for the extensions
+  #
+  # @return [Settings] The settings for the extensions.
+  def self.settings
+    ::Lazier::Settings.instance
+  end
+  # Loads the extensions.
+  #
+  # @param what [Array] The modules to load. Valid values are:
+  #   @option object Extensions for all objects.
+  #   @option boolean Extensions for boolean values.
+  #   @option string Extensions for strings.
+  #   @option hash Extensions for hashs.
+  #   @option datetime Extensions date and time objects.
+  #   @option math Extensions for Math module.
+  #   @option pathname Extensions for path objects.
+  # @return [Settings] The settings for the extensions.
+  def self.load!(*what)
+    what = ["object", "boolean", "string", "hash", "datetime", "math", "pathname"] if what.count == 0
+    what.collect! { |w| w.to_s }
+    # Dependency resolving
+    what << "object" if what.include?("datetime")
+    what << "object" if what.include?("math")
+    what.compact.uniq!
+    if what.include?("object") then
+      ::Object.class_eval do
+        include ::Lazier::Object
+      end
+    end
+    if what.include?("boolean") then
+      ::TrueClass.class_eval do
+        include ::Lazier::Object
+        include ::Lazier::Boolean
+      end
+      ::FalseClass.class_eval do
+        include ::Lazier::Object
+        include ::Lazier::Boolean
+      end
+    end
+    if what.include?("string") then
+      ::String.class_eval do
+        include ::Lazier::String
+      end
+    end
+    if what.include?("hash") then
+      ::Hash.class_eval do
+        include ::Lazier::Hash
+      end
+    end
+    if what.include?("datetime") then
+      ::Time.class_eval do
+        include ::Lazier::DateTime
+      end
+      ::Date.class_eval do
+        include ::Lazier::DateTime
+      end
+      ::DateTime.class_eval do
+        include ::Lazier::DateTime
+      end
+      ::ActiveSupport::TimeZone.class_eval do
+        include ::Lazier::TimeZone
+      end
+    end
+    if what.include?("math") then
+      ::Math.class_eval do
+        include ::Lazier::Math
+      end
+    end
+    if what.include?("pathname") then
+      require "pathname"
+      ::Pathname.class_eval do
+        include ::Lazier::Pathname
+      end
+    end
+    yield if block_given?
+    ::Lazier::Settings.instance
+  end
+end

data/lib/lazier/boolean.rb ADDED Viewed

@@ -0,0 +1,26 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2011 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+module Lazier
+  # Extension for the boolean values.
+  module Boolean
+    extend ::ActiveSupport::Concern
+    # Converts the boolean to an integer.
+    #
+    # @return [Fixnum] `1` for `true`, `0` for `false`.
+    def to_i
+      (self == true) ? 1 : 0
+    end
+    # Returns the boolean itself for use in form helpers.
+    #
+    # @return [Boolean] The boolean value.
+    def value
+      self
+    end
+  end
+end

data/lib/lazier/datetime.rb ADDED Viewed

@@ -0,0 +1,548 @@
+# encoding: utf-8
+#
+# This file is part of the lazier gem. Copyright (C) 2011 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+module Lazier
+  # Extensions for date and time objects.
+  module DateTime
+    extend ::ActiveSupport::Concern
+    # General methods.
+    module ClassMethods
+      # Returns strings representations of days.
+      # @see Settings#setup_date_names
+      #
+      # @param short [Boolean] If return the abbreviated representations.
+      # @return [Array] Return string representations of days.
+      def days(short = true)
+        days = ::Lazier.settings.date_names[short ? :short_days : :long_days]
+        (1..7).to_a.collect { |i|
+          {:value => i.to_s, :label=> days[i - 1]}
+        }
+      end
+      # Returns strings representations of months.
+      # @see Settings#setup_date_names
+      #
+      # @param short [Boolean] If return the abbreviated representations.
+      # @return [Array] Return string representations of months.
+      def months(short = true)
+        months = ::Lazier.settings.date_names[short ? :short_months : :long_months]
+        (1..12).collect { |i|
+          {:value => i.to_s.rjust(2, "0"), :label=> months.at(i - 1)}
+        }
+      end
+      # Returns a range of years.
+      #
+      # ```ruby
+      # Date.years(3, false, 2010)
+      # # => [2007, 2008, 2009, 2010]
+      # ```
+      #
+      # ```ruby
+      # Date.years(1, true, 2010, true)
+      # # => [{:value=>2009, :label=>2009}, {:value=>2010, :label=>2010}, {:value=>2011, :label=>2011}]
+      # ```
+      #
+      #
+      # @param offset [Fixnum] The width of the range.
+      # @param also_future [Boolean] If return also future years.
+      # @param reference [Fixnum] The ending (or middle, if `also_future` is `true`) value of the range. Defaults to the current year.
+      # @param as_objects [Boolean] If to return years in hashes with `:value` and `label` keys.
+      # @return [Array] A range of years. Every entry is
+      def years(offset = 10, also_future = true, reference = nil, as_objects = false)
+        y = reference || ::Date.today.year
+        (y - offset..(also_future ? y + offset : y)).collect { |year| as_objects ? {:value => year, :label => year} : year }
+      end
+      # Returns all the availabe timezones.
+      #
+      # @return [Array]All the zone available.
+      def timezones
+        ::ActiveSupport::TimeZone.all
+      end
+      # Returns a list of names of all timezones.
+      #
+      # @param with_dst [Boolean] If include DST version of the zones.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [Array] A list of names of timezones.
+      def list_timezones(with_dst = true, dst_label = nil)
+        ::ActiveSupport::TimeZone.list_all(with_dst, dst_label)
+      end
+      # Find a zone by its name.
+      #
+      # @param name [String] The zone name.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [TimeZone] A timezone or `nil` if no zone was found.
+      def find_timezone(name = true, dst_label = nil)
+        ::ActiveSupport::TimeZone.find(name, dst_label)
+      end
+      # Returns a string representation of a timezone.
+      #
+      # ```ruby
+      # DateTime.parameterize_zone(ActiveSupport::TimeZone["Pacific Time (US & Canada)"])
+      # # => "-0800@pacific-time-us-canada"
+      # ```
+      # @param tz [TimeZone] The zone to represent.
+      # @param with_offset [Boolean] If to include offset into the representation.
+      # @return [String] A string representation which can be used for searches.
+      def parameterize_zone(tz, with_offset = true)
+        ::ActiveSupport::TimeZone::parameterize_zone(tz, with_offset)
+      end
+      # Finds a parameterized timezone.
+      # @see DateTime#parameterize_zone
+      #
+      # @param tz [String] The zone to unparameterize.
+      # @param as_string [Boolean] If return just the zone name.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [String|TimeZone] The found timezone or `nil` if the zone is not valid.
+      def unparameterize_zone(tz, as_string = false, dst_label = nil)
+        ::ActiveSupport::TimeZone::unparameterize_zone(tz, as_string, dst_label)
+      end
+      # Returns an offset in rational value.
+      #
+      # @param offset [Fixnum] The offset to convert.
+      # @return [Rational] The converted offset.
+      def rationalize_offset(offset)
+        ::ActiveSupport::TimeZone.rationalize_offset(offset)
+      end
+      # Returns the Easter (according to Gregorian calendar) date for the year.
+      # @see http://en.wikipedia.org/wiki/Computus#Anonymous_Gregorian_algorithm
+      #
+      # @param year [Fixnum] The year to compute the date for. Defaults to the current year.
+      # @return [Date] The Easter date for the year.
+      def easter(year = nil)
+        year = ::Date.today.year if !year.is_integer?
+        # Compute using Anonymouse Gregorian Algorithm: http://en.wikipedia.org/wiki/Computus#Anonymous_Gregorian_algorithm
+        a = year % 19
+        b = (year / 100.0).floor
+        c = year % 100
+        d = (b / 4.0).floor
+        e = b % 4
+        f = ((b + 8) / 25.0).floor
+        g = ((b - f + 1) / 3.0).floor
+        h = ((19 * a) + b - d - g + 15) % 30
+        i = (c / 4.0).floor
+        k = c % 4
+        l = (32 + (2 * e) + (2 * i) - h - k) % 7
+        m = ((a + (11 * h) + (22 * l)) / 451.0).floor
+        day = ((h + l - (7 * m) + 114) % 31) + 1
+        month = ((h + l - (7 * m) + 114) / 31.0).floor
+        ::Date.civil(year, month, day)
+      end
+      # Lookups a custom datetime format.
+      # @see Settings#setup_date_formats
+      #
+      # @param key [Symbol] The name of the format to search.
+      # @return [String] The format or the name itself (if the format has not been found).
+      def custom_format(key)
+        ::Lazier.settings.date_formats.fetch(key.to_sym, key).ensure_string
+      end
+      # Checks if the date is valid against to a specific format.
+      # @see DateTime#custom_format
+      #
+      # @param value [String] The value to check.
+      # @param format [String] The format to check the value against.
+      # @return [Boolean] `true` if the value is valid against the format, `false` otherwise.
+      def is_valid?(value, format = "%F %T")
+        rv = true
+        format = self.custom_format(format)
+        begin
+          ::DateTime.strptime(value.ensure_string, format)
+        rescue => e
+          rv = false
+        end
+        rv
+      end
+    end
+    # Returns the UTC::Time representation of the current datetime.
+    #
+    # @return [UTC::Time] The UTC::Time representation of the current datetime.
+    def utc_time
+      ua = (self.respond_to?(:utc) ? self : self.to_datetime).utc
+      ::Time.utc(ua.year, ua.month, ua.day, ua.hour, ua.min, ua.sec)
+    end
+    # Returns the number of months passed between the beginning of the base year and the current date.
+    #
+    # ```ruby
+    # DateTime.civil(2012, 6, 1).in_months(2011)
+    # # => 18
+    # ```
+    #
+    # @param base [DateTime] The base year to start computation from. Default to current year.
+    # @return [Fixnum] Returns the number of months passed between the beginning of the base year and the current date.
+    def in_months(base = nil)
+      base ||= ::Date.today.year
+      ((self.year) - base) * 12 + self.month
+    end
+    # Returns the current month number with leading 0.
+    #
+    # @return [String] The current month number with leading 0.
+    def padded_month
+      self.month.to_s.rjust(2, "0")
+    end
+    # Formats a datetime, looking up also custom formats.
+    # @see Settings#setup_date_formats
+    #
+    # @param format [String] A format or a custom format name to use for formatting.
+    # @return [String] The formatted date.
+    def lstrftime(format = nil)
+      rv = nil
+      names = ::Lazier.settings.date_names
+      final_format = ::DateTime.custom_format(format).ensure_string.gsub(/(%{1,2}:?[abz])/i) do |match|
+        mrv = match
+        # Handling of %z is to fix ruby 1.8 bug in OSX: http://bugs.ruby-lang.org/issues/2396
+        if match !~ /^%%/ then
+          case match
+            when "%a"
+              mrv = names[:short_days][self.wday]
+            when "%A"
+              mrv = names[:long_days][self.wday]
+            when "%b"
+              mrv = names[:short_months][self.month - 1]
+            when "%B"
+              mrv = names[:long_months][self.month - 1]
+            when "%z"
+              mrv = ::Lazier.is_ruby_18? ? self.formatted_offset(false) : nil
+            when "%:z"
+              mrv = ::Lazier.is_ruby_18? ? self.formatted_offset(true) : nil
+          end
+        end
+        mrv ? mrv.sub("%", "%%") : match
+      end
+      self.strftime(final_format)
+    end
+    # Formats a datetime in the current timezone.
+    #
+    # @param format [String] The format to use for formatting.
+    # @return [String] The formatted date.
+    def local_strftime(format = nil)
+      (self.respond_to?(:in_time_zone) ? self.in_time_zone : self).strftime(::DateTime.custom_format(format))
+    end
+    # Formats a datetime in the current timezone, looking up also custom formats.
+    # @see Settings#setup_date_formats
+    #
+    # @param format [String] A format or a custom format name.
+    # @return [String] The formatted date.
+    def local_lstrftime(format = nil)
+      (self.respond_to?(:in_time_zone) ? self.in_time_zone : self).lstrftime(format)
+    end
+  end
+  # Extensions for timezone objects.
+  module TimeZone
+    extend ::ActiveSupport::Concern
+    # General methods.
+    module ClassMethods
+      # Returns an offset in rational value.
+      #
+      # @param offset [Fixnum] The offset to convert.
+      # @return [Rational] The converted offset.
+      def rationalize_offset(offset)
+        offset = offset.try(:offset) if !offset.is_a?(::Fixnum)
+        ::TZInfo::OffsetRationals.rational_for_offset(offset.to_integer)
+      end
+      # Returns a +HH:MM formatted representation of the offset.
+      #
+      # @param offset [Rational|Fixnum] The offset to represent, in seconds or as a rational.
+      # @param colon [Boolean] If to put the colon in the output string.
+      # @return [String] The formatted offset.
+      def format_offset(offset, colon = true)
+        offset = (offset * 86400).to_i if offset.is_a?(::Rational)
+        offset.is_a?(::Fixnum) ? self.seconds_to_utc_offset(offset, colon) : nil
+      end
+      # Find a zone by its name.
+      #
+      # @param name [String] The zone name.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [TimeZone] A timezone or `nil` if no zone was found.
+      def find(name, dst_label = nil)
+        catch(:zone) do
+          ::ActiveSupport::TimeZone.all.each do |zone|
+            zone.aliases.each do |zone_alias|
+              throw(:zone, zone) if [zone.to_str(zone_alias), zone.to_str_with_dst(dst_label, nil, zone_alias)].include?(name)
+            end
+          end
+          nil
+        end
+      end
+      # Returns a list of names of all timezones.
+      #
+      # @param with_dst [Boolean] If include DST version of the zones.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [Array] A list of names of timezones.
+      def list_all(with_dst = true, dst_label = nil)
+        dst_label ||= "(DST)"
+        dst_key = "DST-#{dst_label}"
+        @zones_names ||= { "STANDARD" => ::ActiveSupport::TimeZone.all.collect(&:to_s) }
+        if with_dst && @zones_names[dst_key].blank? then
+          @zones_names[dst_key] = []
+          ::ActiveSupport::TimeZone.all.each do |zone|
+            zone.aliases.each do |zone_alias|
+              @zones_names[dst_key] << zone.to_str(zone_alias)
+              @zones_names[dst_key] << zone.to_str_with_dst(dst_label, nil, zone_alias) if zone.uses_dst? && zone_alias !~ /(#{Regexp.quote(dst_label)})$/
+            end
+          end
+          @zones_names[dst_key]= @zones_names[dst_key].uniq.compact.sort { |a,b| ::ActiveSupport::TimeZone.compare(a, b) } # Sort by name
+        end
+        @zones_names[with_dst ? dst_key : "STANDARD"]
+      end
+      # Returns a string representation of a timezone.
+      #
+      # ```ruby
+      # DateTime.parameterize_zone(ActiveSupport::TimeZone["Pacific Time (US & Canada)"])
+      # # => "-0800@pacific-time-us-canada"
+      # ```
+      # @param tz [TimeZone] The zone to represent.
+      # @param with_offset [Boolean] If to include offset into the representation.
+      # @return [String] A string representation which can be used for searches.
+      def parameterize_zone(tz, with_offset = true)
+        tz = tz.to_s if !tz.is_a?(::String)
+        if tz =~ /^(\([a-z]+([+-])(\d{2})(:?)(\d{2})\)\s(.+))$/i then
+          with_offset ? "#{$2}#{$3}#{$5}@#{$6.parameterize}" : $6.parameterize
+        elsif !with_offset then
+          tz.gsub(/^([+-]?(\d{2})(:?)(\d{2})@)/, "")
+        else
+          tz.parameterize
+        end
+      end
+      # Finds a parameterized timezone.
+      # @see DateTime#parameterize_zone
+      #
+      # @param tz [String] The zone to unparameterize.
+      # @param as_string [Boolean] If return just the zone name.
+      # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+      # @return [String|TimeZone] The found timezone or `nil` if the zone is not valid.
+      def unparameterize_zone(tz, as_string = false, dst_label = nil)
+        tz = self.parameterize_zone(tz, false)
+        rv = catch(:zone) do
+          self.list_all(true, dst_label).each do |zone|
+            throw(:zone, zone) if self.parameterize_zone(zone, false) =~ /(#{Regexp.quote(tz)})$/
+          end
+          nil
+        end
+        if rv then
+          (as_string ? rv : self.find(rv, dst_label))
+        else
+          nil
+        end
+      end
+      # Compares two timezones. They are sorted by the location name.
+      #
+      # @param left [String|TimeZone] The first zone name to compare.
+      # @param right [String|TimeZone] The second zone name to compare.
+      # @return [Fixnum] The result of comparison, like Ruby's operator `<=>`.
+      def compare(left, right)
+        left = left.to_str if left.is_a?(::ActiveSupport::TimeZone)
+        right = right.to_str if right.is_a?(::ActiveSupport::TimeZone)
+        left.ensure_string.split(" ", 2)[1] <=> right.ensure_string.split(" ", 2)[1]
+      end
+    end
+    # Returns a list of valid aliases (city names) for this timezone (basing on offset).
+    #
+    # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+    # @return [Array] A list of aliases for this timezone
+    def aliases(dst_label = nil)
+      reference = self.name
+      reference = self.class::MAPPING[self.name] if self.class::MAPPING.has_key?(self.name) # We are an alias
+      reference = reference.gsub("_", " ")
+      if @aliases.blank? then
+        # First we search for aliases by name
+        @aliases = [reference]
+        self.class::MAPPING.each do |name, zone|
+          if zone.gsub("_", " ") == reference then
+            if name == "International Date Line West" || name == "UTC" || name.include?("(US & Canada)")
+              @aliases << name
+            else
+              @aliases << reference.gsub(/\/.*/, "/" + name)
+            end
+          end
+        end
+        @aliases = @aliases.uniq.compact.sort
+      end
+      @aliases
+    end
+    # Returns the current offset for this timezone, taking care of Daylight Saving Time (DST).
+    #
+    # @param rational [Boolean] If to return the offset as a Rational.
+    # @param date [DateTime] The date to consider. Defaults to now.
+    # @return [Fixnum|Rational] The offset of this timezone.
+    def current_offset(rational = false, date = nil)
+      date ||= ::DateTime.now
+      dst_period = self.dst_period
+      rv = (self.period_for_utc(date.utc).dst? ? self.dst_offset : self.offset)
+      rational ? self.class.rationalize_offset(rv) : rv
+    end
+    # Returns the standard offset for this timezone.
+    #
+    # @param rational [Boolean] If to return the offset as a Rational.
+    # @return [Fixnum|Rational] The offset of this timezone.
+    def offset(rational = false)
+      rv = self.utc_offset
+      rational ? self.class.rationalize_offset(rv) : rv
+    end
+    # Gets a period for this timezone when the Daylight Saving Time (DST) is active (it takes care of different hemispheres).
+    #
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @return [TimezonePeriod] A period when the Daylight Saving Time (DST) is active or `nil` if the timezone doesn't use DST for that year.
+    def dst_period(year = nil)
+      year ||= ::Date.today.year
+      nothern_summer = ::DateTime.civil(year, 7, 15).utc # This is a representation of a summer period in the Northern Hemisphere.
+      southern_summer = ::DateTime.civil(year, 1, 15).utc # This is a representation of a summer period in the Northern Hemisphere.
+      period = self.period_for_utc(nothern_summer)
+      period = self.period_for_utc(southern_summer) if !period.dst?
+      period.dst? ? period : nil
+    end
+    # Checks if the timezone uses Daylight Saving Time (DST) for that date or year.
+    #
+    # @param reference [Object] The date or year to check. Defaults to the current year.
+    # @return [Boolean] `true` if the zone uses DST for that date or year, `false` otherwise.
+    def uses_dst?(reference = nil)
+      if reference.respond_to?(:year) && reference.respond_to?(:utc) then # This is a date like object
+        self.dst_period(reference.year).present? && self.period_for_utc(reference.utc).dst?
+      else
+        self.dst_period(reference).present?
+      end
+    end
+    # Return the correction applied to the standard offset the timezone when the Daylight Saving Time (DST) is active.
+    #
+    # @param rational [Boolean] If to return the offset as a Rational.
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @return [Fixnum|Rational] The correction for dst.
+    def dst_correction(rational = false, year = nil)
+      period = self.dst_period(year)
+      rv = period ? period.std_offset : 0
+      rational ? self.class.rationalize_offset(rv) : rv
+    end
+    # Returns the standard offset for this timezone timezone when the Daylight Saving Time (DST) is active.
+    #
+    # @param rational [Boolean] If to return the offset as a Rational.
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @return [Fixnum|Rational] The DST offset for this timezone or `0`, if the timezone doesn't use DST for that year.
+    def dst_offset(rational = false, year = nil)
+      period = self.dst_period(year)
+      rv = period ? period.utc_total_offset : 0
+      rational ? self.class.rationalize_offset(rv) : rv
+    end
+    # Returns the name for this zone with Daylight Saving Time (DST) active.
+    #
+    # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @param name [String] The name to use for this zone. Defaults to the zone name.
+    # @return [String] The name for the zone with DST or `nil`, if the timezone doesn't use DST for that year.
+    def dst_name(dst_label = nil, year = nil, name = nil)
+      dst_label ||= "(DST)"
+      name ||= self.name
+      self.uses_dst?(year) ? "#{name} #{dst_label}" : nil
+    end
+    # Returns the name for this zone with Daylight Saving Time (DST) active.
+    #
+    # @param name [String] The name to use for this zone. Defaults to the zone name.
+    # @param colon [Boolean] If to put the colon in the output string.
+    # @return [String] The name for this zone.
+    def to_str(name = nil, colon = true)
+      name ||= self.aliases.first
+      "(GMT#{self.formatted_offset(colon)}) #{name}"
+    end
+    # Returns a string representation for this zone with Daylight Saving Time (DST) active.
+    #
+    # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @param name [String] The name to use for this zone. Defaults to the zone name.
+    # @return [String] The string representation for the zone with DST or `nil`, if the timezone doesn't use DST for that year.
+    def to_str_with_dst(dst_label = nil, year = nil, name = nil)
+      dst_label ||= "(DST)"
+      name ||= self.aliases.first
+      if self.uses_dst?(year) then
+        period = self.dst_period(year)
+        offset = self.class.seconds_to_utc_offset(period.utc_total_offset)
+        "(GMT#{offset}) #{name} #{dst_label}"
+      else
+        nil
+      end
+    end
+    # Returns a parametized string representation for this zone.
+    #
+    # @param with_offset [Boolean] If to include offset into the representation.
+    # @param name [String] The name to use for this zone. Defaults to the zone name.
+    # @return [String] The parametized string representation for this zone.
+    def to_str_parameterized(with_offset = true, name = nil)
+      ::ActiveSupport::TimeZone.parameterize_zone(name || self.to_str, with_offset)
+    end
+    # Returns a parametized string representation for this zone with Daylight Saving Time (DST) active.
+    #
+    # @param dst_label [String] Label for the DST indication. Defaults to `(DST)`.
+    # @param with_offset [Boolean] If to include offset into the representation.
+    # @param year [Fixnum] The year to which refer to. Defaults to the current year.
+    # @param name [String] The name to use for this zone. Defaults to the zone name.
+    # @return [String] The parametized string representation for this zone with DST or `nil`, if the timezone doesn't use DST for that year.
+    def to_str_with_dst_parameterized(dst_label = nil, with_offset = true, year = nil, name = nil)
+      rv = self.to_str_with_dst(dst_label, year, name)
+      rv ? ::ActiveSupport::TimeZone.parameterize_zone(rv) : nil
+    end
+  end
+end