module Bundler::BuildMetadata

Represents metadata from when the Bundler gem was built.

Public Class Methods

built_at() click to toggle source

A string representing the date the bundler gem was built.

# File lib/bundler/build_metadata.rb, line 20
def self.built_at
  @built_at ||= Time.now.utc.strftime("%Y-%m-%d").freeze
end
git_commit_sha() click to toggle source

The SHA for the git commit the bundler gem was built from.

# File lib/bundler/build_metadata.rb, line 25
def self.git_commit_sha
  return @git_commit_sha if instance_variable_defined? :@git_commit_sha

  # If Bundler has been installed without its .git directory and without a
  # commit instance variable then we can't determine its commits SHA.
  git_dir = File.join(File.expand_path("../../..", __FILE__), ".git")
  if File.directory?(git_dir)
    return @git_commit_sha = Dir.chdir(git_dir) { `git rev-parse --short HEAD`.strip.freeze }
  end

  # If Bundler is a submodule in RubyGems, get the submodule commit
  git_sub_dir = File.join(File.expand_path("../../../..", __FILE__), ".git")
  if File.directory?(git_sub_dir)
    return @git_commit_sha = Dir.chdir(git_sub_dir) do
      `git ls-tree --abbrev=8 HEAD bundler`.split(/\s/).fetch(2, "").strip.freeze
    end
  end

  @git_commit_sha ||= "unknown"
end
release?() click to toggle source

Whether this is an official release build of Bundler.

# File lib/bundler/build_metadata.rb, line 47
def self.release?
  @release
end
to_h() click to toggle source

A hash representation of the build metadata.

# File lib/bundler/build_metadata.rb, line 11
def self.to_h
  {
    "Built At" => built_at,
    "Git SHA" => git_commit_sha,
    "Released Version" => release?,
  }
end