module Sass::Version
Handles Sass
version-reporting. Sass
not only reports the standard three version numbers, but its Git revision hash as well, if it was installed from Git.
Public Instance Methods
Returns a hash representing the version of Sass
. The ‘:major`, `:minor`, and `:teeny` keys have their respective numbers as Integers. The `:name` key has the name of the version. The `:string` key contains a human-readable string representation of the version. The `:number` key is the major, minor, and teeny keys separated by periods. The `:date` key, which is not guaranteed to be defined, is the `DateTime`
at which this release was cut.
If Sass
is checked out from Git, the ‘:rev` key will have the revision hash. For example:
{ :string => "2.1.0.9616393", :rev => "9616393b8924ef36639c7e82aa88a51a24d16949", :number => "2.1.0", :date => DateTime.parse("Apr 30 13:52:01 2009 -0700"), :major => 2, :minor => 1, :teeny => 0 }
If a prerelease version of Sass
is being used, the ‘:string` and `:number` fields will reflect the full version (e.g. `“2.2.beta.1”`), and the `:teeny` field will be `-1`. A `:prerelease` key will contain the name of the prerelease (e.g. `“beta”`), and a `:prerelease_number` key will contain the rerelease number. For example:
{ :string => "3.0.beta.1", :number => "3.0.beta.1", :date => DateTime.parse("Mar 31 00:38:04 2010 -0700"), :major => 3, :minor => 0, :teeny => -1, :prerelease => "beta", :prerelease_number => 1 }
@return [{Symbol => String/Integer}] The version hash
# File lib/sass/version.rb, line 45 def version return @@version if defined?(@@version) numbers = File.read(Sass::Util.scope('VERSION')).strip.split('.'). map {|n| n =~ /^[0-9]+$/ ? n.to_i : n} name = File.read(Sass::Util.scope('VERSION_NAME')).strip @@version = { :major => numbers[0], :minor => numbers[1], :teeny => numbers[2], :name => name } if (date = version_date) @@version[:date] = date end if numbers[3].is_a?(String) @@version[:teeny] = -1 @@version[:prerelease] = numbers[3] @@version[:prerelease_number] = numbers[4] end @@version[:number] = numbers.join('.') @@version[:string] = @@version[:number].dup if (rev = revision_number) @@version[:rev] = rev unless rev[0] == ?( @@version[:string] << "." << rev[0...7] end end @@version end
Private Instance Methods
# File lib/sass/version.rb, line 83 def revision_number if File.exist?(Sass::Util.scope('REVISION')) rev = File.read(Sass::Util.scope('REVISION')).strip return rev unless rev =~ /^([a-f0-9]+|\(.*\))$/ || rev == '(unknown)' end return unless File.exist?(Sass::Util.scope('.git/HEAD')) rev = File.read(Sass::Util.scope('.git/HEAD')).strip return rev unless rev =~ /^ref: (.*)$/ ref_name = $1 ref_file = Sass::Util.scope(".git/#{ref_name}") info_file = Sass::Util.scope(".git/info/refs") return File.read(ref_file).strip if File.exist?(ref_file) return unless File.exist?(info_file) File.open(info_file) do |f| f.each do |l| sha, ref = l.strip.split("\t", 2) next unless ref == ref_name return sha end end nil end
# File lib/sass/version.rb, line 108 def version_date return unless File.exist?(Sass::Util.scope('VERSION_DATE')) DateTime.parse(File.read(Sass::Util.scope('VERSION_DATE')).strip) end