Class: Train::File

Inherits:
Object
  • Object
show all
Defined in:
lib/train/file.rb,
lib/train/file/local.rb,
lib/train/file/remote.rb,
lib/train/file/local/unix.rb,
lib/train/file/remote/aix.rb,
lib/train/file/remote/qnx.rb,
lib/train/file/remote/unix.rb,
lib/train/file/remote/linux.rb,
lib/train/file/local/windows.rb,
lib/train/file/remote/windows.rb

Overview

rubocop:disable Metrics/ClassLength

Direct Known Subclasses

Local, Remote, Transports::Mock::Connection::File

Defined Under Namespace

Classes: Local, Remote

Constant Summary collapse

DATA_FIELDS =

interface methods: these fields should be implemented by every backend File

%w{
  exist? mode owner group uid gid content mtime size selinux_label path
}.freeze

Instance Method Summary collapse

Constructor Details

#initialize(backend, path, follow_symlink = true) ⇒ File

Returns a new instance of File.



11
12
13
14
15
16
17
 
# File 'lib/train/file.rb', line 11

def initialize(backend, path, follow_symlink = true)
  @backend = backend
  @path = path || ""
  @follow_symlink = follow_symlink

  sanitize_filename(path)
end

Instance Method Details

#block_device? ⇒ Boolean

Returns:

  • (Boolean) 


81
82
83
 
# File 'lib/train/file.rb', line 81

def block_device?
  type.to_s == "block_device"
end

#character_device? ⇒ Boolean

Returns:

  • (Boolean) 


85
86
87
 
# File 'lib/train/file.rb', line 85

def character_device?
  type.to_s == "character_device"
end

#directory? ⇒ Boolean

Returns:

  • (Boolean) 


101
102
103
 
# File 'lib/train/file.rb', line 101

def directory?
  type.to_s == "directory"
end

#file? ⇒ Boolean

Returns:

  • (Boolean) 


93
94
95
 
# File 'lib/train/file.rb', line 93

def file?
  type.to_s == "file"
end

#file_version ⇒ Object

file_version is primarily used by Windows operating systems only and will be overwritten in Windows-related classes. Since this field is returned for all file objects, the acceptable default value is nil



72
73
74
 
# File 'lib/train/file.rb', line 72

def file_version
  nil
end

#md5sum ⇒ Object 



134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
 
# File 'lib/train/file.rb', line 134

def md5sum
  # Skip processing rest of method if fallback method is selected
  return perform_checksum_ruby(:md5) if defined?(@ruby_checksum_fallback)

  checksum = if @backend.os.family == "windows"
               perform_checksum_windows(:md5)
             else
               @md5_command ||= case @backend.os.family
                                when "darwin"
                                  "md5 -r"
                                when "solaris"
                                  "digest -a md5"
                                else
                                  "md5sum"
                                end

               perform_checksum_unix(@md5_command)
             end

  checksum || perform_checksum_ruby(:md5)
end

#mounted? ⇒ Boolean

if the OS-specific file class supports inquirying as to whether the file/device is mounted, the #mounted method should return a command object whose stdout will not be nil if indeed the device is mounted.

if the OS-specific file class does not support checking for mount status, the method should not be implemented and this method will return false.

Returns:

  • (Boolean) 


128
129
130
131
132
 
# File 'lib/train/file.rb', line 128

def mounted?
  return false unless respond_to?(:mounted)

  !mounted.nil? && !mounted.stdout.nil? && !mounted.stdout.empty?
end

#owned_by?(sth) ⇒ Boolean

Returns:

  • (Boolean) 


109
110
111
 
# File 'lib/train/file.rb', line 109

def owned_by?(sth)
  owner == sth
end

#path ⇒ Object 



113
114
115
116
117
118
119
 
# File 'lib/train/file.rb', line 113

def path
  if symlink? && @follow_symlink
    link_path
  else
    @path
  end
end

#pipe? ⇒ Boolean

Returns:

  • (Boolean) 


89
90
91
 
# File 'lib/train/file.rb', line 89

def pipe?
  type.to_s == "pipe"
end

#product_version ⇒ Object

product_version is primarily used by Windows operating systems only and will be overwritten in Windows-related classes. Since this field is returned for all file objects, the acceptable default value is nil



65
66
67
 
# File 'lib/train/file.rb', line 65

def product_version
  nil
end

#sanitize_filename(_path) ⇒ Object

This method gets override by particular os class.



20
21
22
 
# File 'lib/train/file.rb', line 20

def sanitize_filename(_path)
  nil
end

#sha256sum ⇒ Object 



156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
 
# File 'lib/train/file.rb', line 156

def sha256sum
  # Skip processing rest of method if fallback method is selected
  return perform_checksum_ruby(:sha256) if defined?(@ruby_checksum_fallback)

  checksum = if @backend.os.family == "windows"
               perform_checksum_windows(:sha256)
             else
               @sha256_command ||= case @backend.os.family
                                   when "darwin", "hpux", "qnx"
                                     "shasum -a 256"
                                   when "solaris"
                                     "digest -a sha256"
                                   else
                                     "sha256sum"
                                   end

               perform_checksum_unix(@sha256_command)
             end

  checksum || perform_checksum_ruby(:sha256)
end

#socket? ⇒ Boolean

Returns:

  • (Boolean) 


97
98
99
 
# File 'lib/train/file.rb', line 97

def socket?
  type.to_s == "socket"
end

#source ⇒ Object 



50
51
52
53
54
55
56
 
# File 'lib/train/file.rb', line 50

def source
  if @follow_symlink
    self.class.new(@backend, @path, false)
  else
    self
  end
end

#source_path ⇒ Object 



58
59
60
 
# File 'lib/train/file.rb', line 58

def source_path
  @path
end

#symlink? ⇒ Boolean

Returns:

  • (Boolean) 


105
106
107
 
# File 'lib/train/file.rb', line 105

def symlink?
  source.type.to_s == "symlink"
end

#to_json ⇒ Object 



38
39
40
41
42
43
44
 
# File 'lib/train/file.rb', line 38

def to_json
  res = Hash[DATA_FIELDS.map { |x| [x, method(x).call] }]
  # additional fields provided as input
  res["type"] = type
  res["follow_symlink"] = @follow_symlink
  res
end

#type ⇒ Object 



46
47
48
 
# File 'lib/train/file.rb', line 46

def type
  :unknown
end

#version?(version) ⇒ Boolean

Returns:

  • (Boolean) 


76
77
78
79
 
# File 'lib/train/file.rb', line 76

def version?(version)
  (product_version == version) ||
    (file_version == version)
end