Class: RBS::Collection::Sources::Git
Relationships & Source Files | |
Namespace Children | |
Exceptions:
| |
Super Chains via Extension / Inclusion / Inheritance | |
Instance Chain:
self,
Base
|
|
Inherits: | Object |
Defined in: | lib/rbs/collection/sources/git.rb |
Constant Summary
-
METADATA_FILENAME =
# File 'lib/rbs/collection/sources/git.rb', line 12'.rbs_meta.yaml'
Class Method Summary
- .new(name:, revision:, remote:, repo_dir:) ⇒ Git constructor
Instance Attribute Summary
- #name readonly
- #remote readonly
- #repo_dir readonly
- #revision readonly
- #commit_hash? ⇒ Boolean readonly private
Instance Method Summary
- #has?(name, version) ⇒ Boolean
- #install(dest:, name:, version:, stdout:)
- #load_metadata(dir:)
- #manifest_of(name, version)
- #metadata_content(name:, version:)
- #resolved_revision
- #to_lockfile
- #versions(name)
- #write_metadata(dir:, name:, version:)
- #_install(dest:, name:, version:) private
- #cp_r(src, dest) private
- #format_config_entry(name, version) private
- #gem_repo_dir private
- #gems_versions private
- #git(*cmd, **opt) private
- #git?(*cmd, **opt) ⇒ Boolean private
- #git_dir private
- #need_to_fetch?(revision) ⇒ Boolean private
- #setup! private
- #sh!(*cmd, **opt) private
Base
- Included
Constructor Details
.new(name:, revision:, remote:, repo_dir:) ⇒ Git
Instance Attribute Details
#commit_hash? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/rbs/collection/sources/git.rb', line 188
private def commit_hash? revision.match?(/\A[a-f0-9]{40}\z/) end
#name (readonly)
[ GitHub ]#remote (readonly)
[ GitHub ]#repo_dir (readonly)
[ GitHub ]#revision (readonly)
[ GitHub ]Instance Method Details
#_install(dest:, name:, version:) (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 87
private def _install(dest:, name:, version:) # Should checkout that revision to support symlinks git("reset", "--hard", resolved_revision) dir = dest.join(name, version) dir.mkpath src = gem_repo_dir.join(name, version) cp_r(src, dir) (dir: dir, name: name, version: version) end
#cp_r(src, dest) (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 99
private def cp_r(src, dest) Find.find(src) do |file_src| file_src = Pathname(file_src) # Skip file if it starts with _, such as _test/ Find.prune if file_src.basename.to_s.start_with?('_') file_src_relative = file_src.relative_path_from(src) file_dest = dest.join(file_src_relative) file_dest.dirname.mkpath FileUtils.copy_entry(file_src, file_dest, false, true) unless file_src.directory? end end
#format_config_entry(name, version) (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 123
private def format_config_entry(name, version) rev = resolved_revision[0..10] desc = "#{name}@#{rev}" "#{name}:#{version} (#{desc})" end
#gem_repo_dir (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 173
private def gem_repo_dir git_dir.join @repo_dir end
#gems_versions (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 234
private def gems_versions @gems_versions ||= begin repo_path = Pathname(repo_dir) paths = git('ls-tree', '--full-tree', '-dr', '--name-only', '-z', resolved_revision, File.join(repo_dir, "")).split("\0").map {|line| Pathname(line) } # @type var versions: Hash[String, Set[String]] versions = {} paths.each do |full_path| path = full_path.relative_path_from(repo_path) gem_name, version = path.descend.take(2) if gem_name versions[gem_name.to_s] ||= Set[] if version && !version.basename.to_s.start_with?('_') versions[gem_name.to_s] << version.basename.to_s end end end versions end end
#git(*cmd, **opt) (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 192
private def git(*cmd, **opt) sh! 'git', *cmd, **opt end
#git?(*cmd, **opt) ⇒ Boolean
(private)
# File 'lib/rbs/collection/sources/git.rb', line 196
private def git?(*cmd, **opt) git(*cmd, **opt) rescue CommandError nil end
#git_dir (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 163
private def git_dir @git_dir ||= ( base = Pathname(ENV['XDG_CACHE_HOME'] || File. ("~/.cache")) cache_key = remote.start_with?('.') ? "#{remote}\0#{Dir.pwd}" : remote dir = base.join('rbs', Digest::SHA256.hexdigest(cache_key)) dir.mkpath dir ) end
#has?(name, version) ⇒ Boolean
# File 'lib/rbs/collection/sources/git.rb', line 26
def has?(name, version) setup! do if version (gems_versions[name] || Set[]).include?(version) else gems_versions.key?(name) end end end
#install(dest:, name:, version:, stdout:)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 43
def install(dest:, name:, version:, stdout:) setup!() gem_dir = dest.join(name, version) colored_io = CLI::ColoredIO.new(stdout: stdout) case when gem_dir.symlink? colored_io.puts_green("Updating to #{format_config_entry(name, version)} from a local source") gem_dir.unlink _install(dest: dest, name: name, version: version) when gem_dir.directory? prev = (dir: gem_dir) if prev == (name: name, version: version) colored_io.puts "Using #{format_config_entry(name, version)}" else colored_io.puts_green("Updating to #{format_config_entry(name, version)} from #{format_config_entry(prev["name"], prev["version"])}") FileUtils.remove_entry_secure(gem_dir.to_s) _install(dest: dest, name: name, version: version) end when !gem_dir.exist? colored_io.puts_green("Installing #{format_config_entry(name, version)}") _install(dest: dest, name: name, version: version) else raise end end
#load_metadata(dir:)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 228
def (dir:) # @type var content: Hash[String, untyped] content = YAML.load_file(dir.join(METADATA_FILENAME).to_s) _ = content.slice("name", "version", "source") end
#manifest_of(name, version)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 73
def manifest_of(name, version) setup! do path = File.join(repo_dir, name, version, 'manifest.yaml') content = git('cat-file', '-p', "#{resolved_revision}:#{path}") YAML.safe_load(content) rescue CommandError if has?(name, version) nil else raise end end end
#metadata_content(name:, version:)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 212
def (name:, version:) { "name" => name, "version" => version, "source" => to_lockfile } end
#need_to_fetch?(revision) ⇒ Boolean
(private)
# File 'lib/rbs/collection/sources/git.rb', line 152
private def need_to_fetch?(revision) return true unless commit_hash? begin git('cat-file', '-e', revision) false rescue CommandError true end end
#resolved_revision
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 177
def resolved_revision @resolved_revision ||= begin if commit_hash? revision else setup! { git('rev-parse', "refs/remotes/origin/#{revision}").chomp } end end end
#setup! (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 130
private def setup! if @need_setup git_dir.mkpath if git_dir.join('.git').directory? if need_to_fetch?(revision) git 'fetch', 'origin' end else begin # git v2.27.0 or greater git 'clone', '--filter=blob:none', remote, git_dir.to_s, chdir: nil rescue CommandError git 'clone', remote, git_dir.to_s, chdir: nil end end @need_setup = false end yield if block_given? end
#sh!(*cmd, **opt) (private)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 202
private def sh!(*cmd, **opt) RBS.logger.debug "$ #{cmd.join(' ')}" opt = { chdir: git_dir }.merge(opt).compact (__skip__ = Open3.capture3(*cmd, **opt)).then do |out, err, status| raise CommandError, "Unexpected status #{status.exitstatus}\n\n#{err}" unless status.success? out end end
#to_lockfile
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 113
def to_lockfile { 'type' => 'git', 'name' => name, 'revision' => resolved_revision, 'remote' => remote, 'repo_dir' => repo_dir, } end
#versions(name)
[ GitHub ]#write_metadata(dir:, name:, version:)
[ GitHub ]# File 'lib/rbs/collection/sources/git.rb', line 220
def (dir:, name:, version:) dir.join(METADATA_FILENAME).write( YAML.dump( (name: name, version: version) ) ) end