Module Haml::Version
In: lib/haml/version.rb

Handles Haml version-reporting. Haml not only reports the standard three version numbers, but its Git revision hash as well, if it was installed from Git.

Methods

Included Modules

Haml::Util

Public Instance methods

Returns a hash representing the version of Haml. The `:major`, `:minor`, and `:teeny` keys have their respective numbers as Fixnums. 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. If Haml 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",
      :major  => 2, :minor => 1, :teeny => 0
    }

If a prerelease version of Haml 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",
      :major => 3, :minor => 0, :teeny => -1,
      :prerelease => "beta",
      :prerelease_number => 1
    }

@return [{Symbol => String/Fixnum}] The version hash

[Source]

    # File lib/haml/version.rb, line 42
42:     def version
43:       return @@version if defined?(@@version)
44:       numbers = File.read('/usr/lib/ruby/1.8/haml/VERSION').strip.split('.').
45:         map {|n| n =~ /^[0-9]+$/ ? n.to_i : n}
46:       name = File.read('/usr/lib/ruby/1.8/haml/VERSION_NAME').strip
47:       @@version = {
48:         :major => numbers[0],
49:         :minor => numbers[1],
50:         :teeny => numbers[2],
51:         :name => name
52:       }
53: 
54:       if numbers[3].is_a?(String)
55:         @@version[:teeny] = -1
56:         @@version[:prerelease] = numbers[3]
57:         @@version[:prerelease_number] = numbers[4]
58:       end
59: 
60:       @@version[:number] = numbers.join('.')
61:       @@version[:string] = @@version[:number].dup
62: 
63:       if rev = revision_number
64:         @@version[:rev] = rev
65:         unless rev[0] == ?(
66:           @@version[:string] << "." << rev[0...7]
67:         end
68:       end
69: 
70:       @@version[:string] << " (#{name})"
71:       @@version
72:     end

Private Instance methods

[Source]

    # File lib/haml/version.rb, line 76
76:     def revision_number
77:       if File.exists?(scope('REVISION'))
78:         rev = File.read(scope('REVISION')).strip
79:         return rev unless rev =~ /^([a-f0-9]+|\(.*\))$/ || rev == '(unknown)'
80:       end
81: 
82:       return unless File.exists?(scope('.git/HEAD'))
83:       rev = File.read(scope('.git/HEAD')).strip
84:       return rev unless rev =~ /^ref: (.*)$/
85: 
86:       ref_name = $1
87:       ref_file = scope(".git/#{ref_name}")
88:       info_file = scope(".git/info/refs")
89:       return File.read(ref_file).strip if File.exists?(ref_file)
90:       return unless File.exists?(info_file)
91:       File.open(info_file) do |f|
92:         f.each do |l|
93:           sha, ref = l.strip.split("\t", 2)
94:           next unless ref == ref_name
95:           return sha
96:         end
97:       end
98:       return nil
99:     end

[Validate]