Module: Puppet::FileSystem
- Defined in:
- lib/puppet/file_system.rb,
lib/puppet/file_system/path_pattern.rb
Defined Under Namespace
Classes: AbsolutePathPattern, FileImpl, JRuby, MemoryFile, MemoryImpl, PathPattern, Posix, RelativePathPattern, Uniquefile, Windows
Class Method Summary collapse
-
.assert_path(path) ⇒ Object
Asserts that the given path is of the expected type produced by #pathname.
-
.basename(path) ⇒ Object
The name of the file as a opaque handle.
-
.basename_string(path) ⇒ String
The name of the file.
-
.binread(path) ⇒ String
The binary contents of the file.
-
.children(path) ⇒ Array<Object>
References to all of the children of the given directory path, excluding ‘.` and `..`.
-
.chmod(mode, path) ⇒ Object
Changes permission bits on the named path to the bit pattern represented by mode.
-
.compare_stream(path, stream) ⇒ Boolean
Compares the contents of this file against the contents of a stream.
-
.dir(path) ⇒ Object
The directory of this file as an opaque handle.
-
.dir_exist?(path) ⇒ Boolean
Does the directory of the given path exist?.
-
.dir_mkpath(path) ⇒ Object
Creates all directories down to (inclusive) the dir of the given path.
-
.dir_string(path) ⇒ String
The directory of this file as a String.
-
.directory?(path) ⇒ Boolean
Determines if a file is a directory.
-
.each_line(path, &block) ⇒ Object
Processes each line of the file by yielding it to the given block.
-
.exclusive_create(path, mode, &block) ⇒ Object
Create and open a file for write only if it doesn’t exist.
-
.exclusive_open(path, mode, options = 'r', timeout = 300) { ... } ⇒ Void
Allows exclusive updates to a file to be made by excluding concurrent access using flock.
-
.executable?(path) ⇒ Boolean
Determines if a file is executable.
-
.exist?(path) ⇒ Boolean
Determines if a file exists by verifying that the file can be stat’d.
-
.expand_path(path, dir_string = nil) ⇒ String
Produces a string representation of the opaque path handle, with expansions performed on ~.
-
.file?(path) ⇒ Boolean
Determines if a file is a file.
-
.lstat(path) ⇒ File::Stat
link.
-
.mkpath(path) ⇒ Object
Creates directories for all parts of the given path.
-
.open(path, mode, options) { ... } ⇒ Void
Opens the given path with given mode, and options and optionally yields it to the given block.
-
.overlay(*files, &block) ⇒ Object
private
Allows overriding the filesystem for the duration of the given block.
-
.path_string(path) ⇒ String
Produces a string representation of the opaque path handle.
-
.pathname(path) ⇒ Object
Produces an opaque pathname “handle” object representing the given path.
-
.read(path, opts = {}) ⇒ String
The contents of the file.
-
.read_preserve_line_endings(path) ⇒ String
Read a file keeping the original line endings intact.
-
.readlink(path) ⇒ String
The name of the file referenced by the given link.
-
.replace_file(path, mode = nil, &block) ⇒ Object
Replace the contents of a file atomically, creating the file if necessary.
-
.size(path) ⇒ Integer
The size of the file.
-
.stat(path) ⇒ File::Stat
Object for the named file.
-
.symlink(path, dest, options = {}) ⇒ Integer
Creates a symbolic link dest which points to the current file.
-
.symlink?(path) ⇒ Boolean
True if the file is a symbolic link.
-
.touch(path) ⇒ Object
Touches the file.
-
.unlink(*paths) ⇒ Integer
Deletes the given paths, returning the number of names passed as arguments.
-
.writable?(path) ⇒ Boolean
Whether the file is writable by the current process.
Class Method Details
.assert_path(path) ⇒ Object
Asserts that the given path is of the expected type produced by #pathname
369 370 371 |
# File 'lib/puppet/file_system.rb', line 369 def self.assert_path(path) @impl.assert_path(path) end |
.basename(path) ⇒ Object
Returns the name of the file as a opaque handle.
83 84 85 |
# File 'lib/puppet/file_system.rb', line 83 def self.basename(path) @impl.basename(assert_path(path)) end |
.basename_string(path) ⇒ String
Returns the name of the file.
91 92 93 |
# File 'lib/puppet/file_system.rb', line 91 def self.basename_string(path) @impl.path_string(@impl.basename(assert_path(path))) end |
.binread(path) ⇒ String
Returns The binary contents of the file.
162 163 164 |
# File 'lib/puppet/file_system.rb', line 162 def self.binread(path) @impl.binread(assert_path(path)) end |
.children(path) ⇒ Array<Object>
Returns references to all of the children of the given directory path, excluding ‘.` and `..`.
234 235 236 |
# File 'lib/puppet/file_system.rb', line 234 def self.children(path) @impl.children(assert_path(path)) end |
.chmod(mode, path) ⇒ Object
Changes permission bits on the named path to the bit pattern represented by mode.
404 405 406 |
# File 'lib/puppet/file_system.rb', line 404 def self.chmod(mode, path) @impl.chmod(mode, path) end |
.compare_stream(path, stream) ⇒ Boolean
Compares the contents of this file against the contents of a stream.
330 331 332 |
# File 'lib/puppet/file_system.rb', line 330 def self.compare_stream(path, stream) @impl.compare_stream(assert_path(path), stream) end |
.dir(path) ⇒ Object
Returns The directory of this file as an opaque handle.
57 58 59 |
# File 'lib/puppet/file_system.rb', line 57 def self.dir(path) @impl.dir(assert_path(path)) end |
.dir_exist?(path) ⇒ Boolean
Returns Does the directory of the given path exist?.
70 71 72 |
# File 'lib/puppet/file_system.rb', line 70 def self.dir_exist?(path) @impl.exist?(@impl.dir(assert_path(path))) end |
.dir_mkpath(path) ⇒ Object
Creates all directories down to (inclusive) the dir of the given path
75 76 77 |
# File 'lib/puppet/file_system.rb', line 75 def self.dir_mkpath(path) @impl.mkpath(@impl.dir(assert_path(path))) end |
.dir_string(path) ⇒ String
Returns The directory of this file as a String.
65 66 67 |
# File 'lib/puppet/file_system.rb', line 65 def self.dir_string(path) @impl.path_string(@impl.dir(assert_path(path))) end |
.directory?(path) ⇒ Boolean
Determines if a file is a directory.
182 183 184 |
# File 'lib/puppet/file_system.rb', line 182 def self.directory?(path) @impl.directory?(assert_path(path)) end |
.each_line(path, &block) ⇒ Object
Processes each line of the file by yielding it to the given block
133 134 135 |
# File 'lib/puppet/file_system.rb', line 133 def self.each_line(path, &block) @impl.each_line(assert_path(path), &block) end |
.exclusive_create(path, mode, &block) ⇒ Object
Create and open a file for write only if it doesn’t exist.
390 391 392 |
# File 'lib/puppet/file_system.rb', line 390 def self.exclusive_create(path, mode, &block) @impl.exclusive_create(assert_path(path), mode, &block) end |
.exclusive_open(path, mode, options = 'r', timeout = 300) { ... } ⇒ Void
Allows exclusive updates to a file to be made by excluding concurrent access using flock. This means that if the file is on a filesystem that does not support flock, this method will provide no protection.
While polling to acquire the lock the process will wait ever increasing amounts of time in order to prevent multiple processes from wasting resources.
125 126 127 |
# File 'lib/puppet/file_system.rb', line 125 def self.exclusive_open(path, mode, = 'r', timeout = 300, &block) @impl.exclusive_open(assert_path(path), mode, , timeout, &block) end |
.executable?(path) ⇒ Boolean
Should this take into account extensions on the windows platform?
Determines if a file is executable.
203 204 205 |
# File 'lib/puppet/file_system.rb', line 203 def self.executable?(path) @impl.executable?(assert_path(path)) end |
.exist?(path) ⇒ Boolean
Determines if a file exists by verifying that the file can be stat’d. Will follow symlinks and verify that the actual target path exists.
173 174 175 |
# File 'lib/puppet/file_system.rb', line 173 def self.exist?(path) @impl.exist?(assert_path(path)) end |
.expand_path(path, dir_string = nil) ⇒ String
Produces a string representation of the opaque path handle, with expansions performed on ~. For Windows, this means that C:UsersAdmini~1AppData will be expanded to C:UsersAdministratorAppData. On POSIX filesystems, the value ~ will be expanded to something like /Users/Foo
This method exists primarlily to resolve a Ruby deficiency where File.expand_path doesn’t handle ~ in each segment on a Windows path
359 360 361 |
# File 'lib/puppet/file_system.rb', line 359 def self.(path, dir_string = nil) @impl.(path, dir_string) end |
.file?(path) ⇒ Boolean
Determines if a file is a file.
191 192 193 |
# File 'lib/puppet/file_system.rb', line 191 def self.file?(path) @impl.file?(assert_path(path)) end |
.lstat(path) ⇒ File::Stat
link. Instead, reports on the link itself.
319 320 321 |
# File 'lib/puppet/file_system.rb', line 319 def self.lstat(path) @impl.lstat(assert_path(path)) end |
.mkpath(path) ⇒ Object
Creates directories for all parts of the given path.
227 228 229 |
# File 'lib/puppet/file_system.rb', line 227 def self.mkpath(path) @impl.mkpath(assert_path(path)) end |
.open(path, mode, options) { ... } ⇒ Void
Opens the given path with given mode, and options and optionally yields it to the given block.
49 50 51 |
# File 'lib/puppet/file_system.rb', line 49 def self.open(path, mode, , &block) @impl.open(assert_path(path), mode, , &block) end |
.overlay(*files, &block) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Allows overriding the filesystem for the duration of the given block. The filesystem will only contain the given file(s).
28 29 30 31 32 33 34 |
# File 'lib/puppet/file_system.rb', line 28 def self.(*files, &block) old_impl = @impl @impl = Puppet::FileSystem::MemoryImpl.new(*files) yield ensure @impl = old_impl end |
.path_string(path) ⇒ String
Produces a string representation of the opaque path handle.
378 379 380 |
# File 'lib/puppet/file_system.rb', line 378 def self.path_string(path) @impl.path_string(path) end |
.pathname(path) ⇒ Object
Produces an opaque pathname “handle” object representing the given path. Different implementations of the underlying file system may use different runtime objects. The produced “handle” should be used in all other operations that take a “path”. No operation should be directly invoked on the returned opaque object
344 345 346 |
# File 'lib/puppet/file_system.rb', line 344 def self.pathname(path) @impl.pathname(path) end |
.read(path, opts = {}) ⇒ String
Returns The contents of the file.
141 142 143 |
# File 'lib/puppet/file_system.rb', line 141 def self.read(path, opts = {}) @impl.read(assert_path(path), opts) end |
.read_preserve_line_endings(path) ⇒ String
Read a file keeping the original line endings intact. This attempts to open files using binary mode using some encoding overrides and falling back to IO.read when none of the encodings are valid.
154 155 156 |
# File 'lib/puppet/file_system.rb', line 154 def self.read_preserve_line_endings(path) @impl.read_preserve_line_endings(assert_path(path)) end |
.readlink(path) ⇒ String
Returns the name of the file referenced by the given link.
281 282 283 |
# File 'lib/puppet/file_system.rb', line 281 def self.readlink(path) @impl.readlink(assert_path(path)) end |
.replace_file(path, mode = nil, &block) ⇒ Object
Replace the contents of a file atomically, creating the file if necessary. If a ‘mode` is specified, then it will always be applied to the file. If a `mode` is not specified and the file exists, its mode will be preserved. If the file doesn’t exist, the mode will be set to a platform-specific default.
421 422 423 |
# File 'lib/puppet/file_system.rb', line 421 def self.replace_file(path, mode = nil, &block) @impl.replace_file(assert_path(path), mode, &block) end |
.size(path) ⇒ Integer
Returns the size of the file.
99 100 101 |
# File 'lib/puppet/file_system.rb', line 99 def self.size(path) @impl.size(assert_path(path)) end |
.stat(path) ⇒ File::Stat
Returns object for the named file.
302 303 304 |
# File 'lib/puppet/file_system.rb', line 302 def self.stat(path) @impl.stat(assert_path(path)) end |
.symlink(path, dest, options = {}) ⇒ Integer
Creates a symbolic link dest which points to the current file. If dest already exists:
-
and is a file, will raise Errno::EEXIST
-
and is a directory, will return 0 but perform no action
-
and is a symlink referencing a file, will raise Errno::EEXIST
-
and is a symlink referencing a directory, will return 0 but perform no action
With the :force option set to true, when dest already exists:
-
and is a file, will replace the existing file with a symlink (DANGEROUS)
-
and is a directory, will return 0 but perform no action
-
and is a symlink referencing a file, will modify the existing symlink
-
and is a symlink referencing a directory, will return 0 but perform no action
265 266 267 |
# File 'lib/puppet/file_system.rb', line 265 def self.symlink(path, dest, = {}) @impl.symlink(assert_path(path), dest, ) end |
.symlink?(path) ⇒ Boolean
Returns true if the file is a symbolic link.
273 274 275 |
# File 'lib/puppet/file_system.rb', line 273 def self.symlink?(path) @impl.symlink?(assert_path(path)) end |
.touch(path) ⇒ Object
Touches the file. On most systems this updates the mtime of the file.
219 220 221 |
# File 'lib/puppet/file_system.rb', line 219 def self.touch(path) @impl.touch(assert_path(path)) end |
.unlink(*paths) ⇒ Integer
Deletes the given paths, returning the number of names passed as arguments. See also Dir::rmdir.
294 295 296 |
# File 'lib/puppet/file_system.rb', line 294 def self.unlink(*paths) @impl.unlink(*(paths.map {|p| assert_path(p) })) end |
.writable?(path) ⇒ Boolean
Returns Whether the file is writable by the current process.
211 212 213 |
# File 'lib/puppet/file_system.rb', line 211 def self.writable?(path) @impl.writable?(assert_path(path)) end |