Module: Hanami::Utils::Files
- Defined in:
- lib/hanami/utils/files.rb
Overview
Files utilities
Class Method Summary collapse
-
.append(path, contents) ⇒ Object
Adds a new line at the bottom of the file.
-
.cp(source, destination) ⇒ Object
Copies source into destination.
-
.delete(path) ⇒ Object
Deletes given path (file).
-
.delete_directory(path) ⇒ Object
Deletes given path (directory).
-
.directory?(path) ⇒ TrueClass, FalseClass
Checks if ‘path` is a directory.
-
.exist?(path) ⇒ TrueClass, FalseClass
Checks if ‘path` exist.
-
.inject_line_after(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after `target`.
-
.inject_line_after_last(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after last `target`.
-
.inject_line_before(path, target, contents) ⇒ Object
Inject ‘contents` in `path` before `target`.
-
.inject_line_before_last(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after last `target`.
-
.mkdir(path) ⇒ Object
Creates a directory for the given path.
-
.mkdir_p(path) ⇒ Object
Creates a directory for the given path.
-
.remove_block(path, target) ⇒ Object
Removes ‘target` block from `path`.
-
.remove_line(path, target) ⇒ Object
Removes line from ‘path`, matching `target`.
-
.replace_first_line(path, target, replacement) ⇒ Object
Replace first line in ‘path` that contains `target` with `replacement`.
-
.replace_last_line(path, target, replacement) ⇒ Object
Replace last line in ‘path` that contains `target` with `replacement`.
-
.rewrite(path, *content) ⇒ Object
Rewrites the contents of an existing file.
-
.touch(path) ⇒ Object
Creates an empty file for the given path.
-
.unshift(path, line) ⇒ Object
Adds a new line at the top of the file.
-
.write(path, *content) ⇒ Object
Creates a new file for the given path and content.
Class Method Details
.append(path, contents) ⇒ Object
Adds a new line at the bottom of the file
164 165 166 167 168 169 170 171 172 |
# File 'lib/hanami/utils/files.rb', line 164 def self.append(path, contents) mkdir_p(path) content = ::File.readlines(path) content << "\n" if _append_newline?(content) content << "#{contents}\n" write(path, content) end |
.cp(source, destination) ⇒ Object
Copies source into destination. All the intermediate directories are created. If the destination already exists, it overrides the contents.
63 64 65 66 |
# File 'lib/hanami/utils/files.rb', line 63 def self.cp(source, destination) mkdir_p(destination) FileUtils.cp(source, destination) end |
.delete(path) ⇒ Object
Deletes given path (file).
122 123 124 |
# File 'lib/hanami/utils/files.rb', line 122 def self.delete(path) FileUtils.rm(path) end |
.delete_directory(path) ⇒ Object
Deletes given path (directory).
133 134 135 |
# File 'lib/hanami/utils/files.rb', line 133 def self.delete_directory(path) FileUtils.remove_entry_secure(path) end |
.directory?(path) ⇒ TrueClass, FalseClass
Checks if ‘path` is a directory
377 378 379 |
# File 'lib/hanami/utils/files.rb', line 377 def self.directory?(path) File.directory?(path) end |
.exist?(path) ⇒ TrueClass, FalseClass
Checks if ‘path` exist
358 359 360 |
# File 'lib/hanami/utils/files.rb', line 358 def self.exist?(path) File.exist?(path) end |
.inject_line_after(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after `target`.
262 263 264 |
# File 'lib/hanami/utils/files.rb', line 262 def self.inject_line_after(path, target, contents) _inject_line_after(path, target, contents, method(:index)) end |
.inject_line_after_last(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after last `target`.
281 282 283 |
# File 'lib/hanami/utils/files.rb', line 281 def self.inject_line_after_last(path, target, contents) _inject_line_after(path, target, contents, method(:rindex)) end |
.inject_line_before(path, target, contents) ⇒ Object
Inject ‘contents` in `path` before `target`.
226 227 228 |
# File 'lib/hanami/utils/files.rb', line 226 def self.inject_line_before(path, target, contents) _inject_line_before(path, target, contents, method(:index)) end |
.inject_line_before_last(path, target, contents) ⇒ Object
Inject ‘contents` in `path` after last `target`.
244 245 246 |
# File 'lib/hanami/utils/files.rb', line 244 def self.inject_line_before_last(path, target, contents) _inject_line_before(path, target, contents, method(:rindex)) end |
.mkdir(path) ⇒ Object
Creates a directory for the given path. It assumes that all the tokens in ‘path` are meant to be a directory. All the intermediate directories are created.
87 88 89 |
# File 'lib/hanami/utils/files.rb', line 87 def self.mkdir(path) FileUtils.mkdir_p(path) end |
.mkdir_p(path) ⇒ Object
Creates a directory for the given path. It assumes that all the tokens, but the last, in ‘path` are meant to be a directory, whereas the last is meant to be a file. All the intermediate directories are created.
111 112 113 |
# File 'lib/hanami/utils/files.rb', line 111 def self.mkdir_p(path) Pathname.new(path).dirname.mkpath end |
.remove_block(path, target) ⇒ Object
Removes ‘target` block from `path`
329 330 331 332 333 334 335 336 337 338 339 340 341 |
# File 'lib/hanami/utils/files.rb', line 329 def self.remove_block(path, target) content = ::File.readlines(path) starting = index(content, path, target) line = content[starting] size = line[/\A[[:space:]]*/].bytesize closing = (" " * size) + (target =~ /{/ ? "}" : "end") ending = starting + index(content[starting..-1], path, closing) content.slice!(starting..ending) write(path, content) remove_block(path, target) if match?(content, target) end |
.remove_line(path, target) ⇒ Object
Removes line from ‘path`, matching `target`.
294 295 296 297 298 299 300 |
# File 'lib/hanami/utils/files.rb', line 294 def self.remove_line(path, target) content = ::File.readlines(path) i = index(content, path, target) content.delete_at(i) write(path, content) end |
.replace_first_line(path, target, replacement) ⇒ Object
Replace first line in ‘path` that contains `target` with `replacement`.
186 187 188 189 190 191 |
# File 'lib/hanami/utils/files.rb', line 186 def self.replace_first_line(path, target, replacement) content = ::File.readlines(path) content[index(content, path, target)] = "#{replacement}\n" write(path, content) end |
.replace_last_line(path, target, replacement) ⇒ Object
Replace last line in ‘path` that contains `target` with `replacement`.
205 206 207 208 209 210 |
# File 'lib/hanami/utils/files.rb', line 205 def self.replace_last_line(path, target, replacement) content = ::File.readlines(path) content[-index(content.reverse, path, target) - 1] = "#{replacement}\n" write(path, content) end |
.rewrite(path, *content) ⇒ Object
Rewrites the contents of an existing file. If the path already exists, it replaces the contents.
46 47 48 49 50 51 52 53 |
# File 'lib/hanami/utils/files.rb', line 46 def self.rewrite(path, *content) Hanami::Utils::Deprecation.new( "`.rewrite' is deprecated, please use `.write'" ) raise Errno::ENOENT unless File.exist?(path) write(path, *content) end |
.touch(path) ⇒ Object
Creates an empty file for the given path. All the intermediate directories are created. If the path already exists, it doesn’t change the contents
20 21 22 23 |
# File 'lib/hanami/utils/files.rb', line 20 def self.touch(path) mkdir_p(path) FileUtils.touch(path) end |
.unshift(path, line) ⇒ Object
Adds a new line at the top of the file
147 148 149 150 151 152 |
# File 'lib/hanami/utils/files.rb', line 147 def self.unshift(path, line) content = ::File.readlines(path) content.unshift("#{line}\n") write(path, content) end |
.write(path, *content) ⇒ Object
Creates a new file for the given path and content. All the intermediate directories are created.
32 33 34 35 |
# File 'lib/hanami/utils/files.rb', line 32 def self.write(path, *content) mkdir_p(path) open(path, ::File::CREAT | ::File::WRONLY | ::File::TRUNC, *content) # rubocop:disable Security/Open - this isn't a call to `::Kernel.open`, but to `self.open` end |