Class: UnpackStrategy::Tar Private

Inherits:
Object show all
Extended by:
SystemCommand::Mixin, ClassMethods
Includes:
UnpackStrategy
Defined in:
unpack_strategy/tar.rb

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

Strategy for unpacking tar archives.

Direct Known Subclasses

Compress

Constant Summary

Constants included from UnpackStrategy

UnpackStrategyType

Instance Attribute Summary

Attributes included from UnpackStrategy

#merge_xattrs, #path

Class Method Summary collapse

Methods included from ClassMethods

can_extract?, extensions

Methods included from SystemCommand::Mixin

system_command, system_command!

Methods included from UnpackStrategy

#dependencies, detect, #each_directory, #extract, #extract_nestedly, from_extension, from_magic, from_type, #initialize

Class Method Details

.can_extract?(path) ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

  • (Boolean) 


26
27
28
29
30
31
32
33
34
 
# File 'unpack_strategy/tar.rb', line 26

def self.can_extract?(path)
  return true if path.magic_number.match?(/\A.{257}ustar/n)

  return false unless [Bzip2, Gzip, Lzip, Xz, Zstd].any? { |s| s.can_extract?(path) }

  # Check if `tar` can list the contents, then it can also extract it.
  stdout, _, status = system_command("tar", args: ["--list", "--file", path], print_stderr: false)
  status.success? && !stdout.empty?
end

.extensions ⇒ Array<String>

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



13
14
15
16
17
18
19
20
21
22
23
 
# File 'unpack_strategy/tar.rb', line 13

def self.extensions
  [
    ".tar",
    ".tbz", ".tbz2", ".tar.bz2",
    ".tgz", ".tar.gz",
    ".tlzma", ".tar.lzma",
    ".txz", ".tar.xz",
    ".tar.zst",
    ".crate"
  ]
end