Программирование на языке Ruby

10.1.17. Манипулирование путевыми именами

Основными методами для работы с путевыми именами являются методы класса File.dirname и File.basename; они работают, как одноименные команды UNIX, то есть возвращают имя каталога и имя файла соответственно. Если вторым параметром методу basename передана строка с расширением имени файла, то это расширение исключается.

 str = "/home/dave/podbay.rb"
 dir = File.dirname(str) # "/home/dave"
 file1 = File.basename(str) # "podbay.rb"
 file2 = File.basename(str,".rb") # "podbay"

Хотя это методы класса File, на самом деле они просто манипулируют строками.

Упомянем также метод File.split, который возвращает обе компоненты (имя каталога и имя файла) в массиве из двух элементов:

 info = File.split(str) # ["/home/dave","podbay.rb"]

Метод класса expand_path преобразует путевое имя в абсолютный путь. Если операционная система понимает сокращения ~ и ~user, то они тоже учитываются.

 Dir.chdir("/home/poole/personal/docs")
 abs = File.expand_path("../../misc") # "/home/poole/misc"

Если передать методу path открытый файл, то он вернет путевое имя, по которому файл был открыт.

 file = File.new("../../foobar")
 name = file.path # "../../foobar"

Константа File::Separator равна символу, применяемому для разделения компонентов путевого имени (в Windows это обратная косая черта, а в UNIX — прямая косая черта). Имеется также синоним File::SEPARATOR.

Метод класса join использует этот разделитель для составления полного путевого имени из переданного списка компонентов:

 path = File.join("usr","local","bin","someprog")
 # path равно "usr/local/bin/someprog".
 # Обратите внимание, что в начало имени разделитель не добавляется!

Не думайте, что методы File.join и File.split взаимно обратны, — это не так.

10.1.18. Класс Pathname

Следует знать о существовании стандартной библиотеки pathname, которая предоставляет класс Pathname. В сущности, это обертка вокруг классов Dir, File, FileTest и FileUtils, поэтому он комбинирует многие их функции логичным и интуитивно понятным способом.

 path = Pathname.new("/home/hal")
 file = Pathname.new("file.txt")
 p2 = path + file
 path.directory? # true
 path.file? # false
 p2.directory? # false
 p2.file? # true

 parts = path2.split # [Путевое имя:/home/hal, Путевое имя:file.txt]
 ext = path2.extname # .txt

Как и следовало ожидать, имеется ряд вспомогательных методов. Метод root? пытается выяснить, относится ли данный путь к корневому каталогу, но его можно «обмануть», так как он просто анализирует строку, не обращаясь к файловой системе. Метод parent? возвращает путевое имя родительского каталога данного пути. Метод children возвращает непосредственных потомков каталога, заданного своим путевым именем; в их число включаются как файлы, так и каталоги, но рекурсивного спуска не производится.

 p1 = Pathname.new("//") # Странно, но допустимо.
 p1.root? # true
 р2 = Pathname.new("/home/poole")
 p3 = p2.parent # Путевое имя:/home
 items = p2.children # Массив объектов Pathname
  # (все файлы и каталоги, являющиеся
  # непосредственными потомками р2).

Как и следовало ожидать, методы relative и absolute пытаются определить, является ли путь относительным или абсолютным (проверяя, есть ли в начале имени косая черта):

 p1 = Pathname.new("/home/dave")
 p1.absolute? # true
 p1.relative? # false

Многие методы, например size, unlink и пр., просто делегируют работу классам File, FileTest и FileUtils; повторно функциональность не реализуется.

Дополнительную информацию о классе Pathname вы найдете на сайте ruby-doc.org или в любом другом справочном руководстве.

10.1.19. Манипулирование файлами на уровне команд

Часто приходится манипулировать файлами так, как это делается с помощью командной строки: копировать, удалять, переименовывать и т.д.

Многие из этих операций реализованы встроенными методами, некоторые находятся в модуле FileUtils из библиотеки fileutils. Имейте в виду, что раньше функциональность модуля FileUtils подмешивалась прямо в класс File; теперь эти методы помещены в отдельный модуль.

Для удаления файла служит метод File.delete или его синоним File.unlink:

 File.delete("history")
 File.unlink("toast")

Переименовать файл позволяет метод File.rename:

 File.rename("Ceylon","SriLanka")

Создать ссылку на файл (физическую или символическую) позволяют методы File.link и File.symlink соответственно:

 File.link("/etc/hosts","/etc/hostfile") # Физическая ссылка.
 File.symlink("/etc/hosts","/tmp/hosts") # Символическая ссылка.

Файл можно усечь до нулевой длины (или до любой другой), воспользовавшись методом экземпляра truncate:

 File.truncate("myfile",1000) # Теперь не более 1000 байтов.

Два файла можно сравнить с помощью метода compare_file. У него есть синонимы cmp и compare_stream:

 require "fileutils"

 same = FileUtils.compare_file("alpha","beta") # true