RubyGems - lazier - Versions diffs - 1.0.0 - Mend

lazier 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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