Spec-Zone.ru › Ruby 2.6

класс Pathname

Родитель:
Объект

Pathname представляет имя файла или каталога в файловой системе, но не сам файл.

Путь зависит от операционной системы: Unix, Windows и т. д. Эта библиотека работает с путями локальной ОС, однако пути, отличные от Unix, поддерживаются экспериментально.

Объект Pathname может быть относительным или абсолютным. Только при попытке обратиться к файлу имеет значение, существует ли файл или нет.

Объект Pathname неизменяем. У него нет методов для деструктивного обновления.

Цель этого класса — манипулировать информацией о путях к файлам более удобным способом, чем стандартная библиотека Ruby. Примеры ниже демонстрируют разницу.

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

Примеры

Пример 1: Использование Pathname

require 'pathname'
pn = Pathname.new("/usr/bin/ruby")
size = pn.size              # 27662
isdir = pn.directory?       # false
dir  = pn.dirname           # Pathname:/usr/bin
base = pn.basename          # Pathname:ruby
dir, base = pn.split        # [Pathname:/usr/bin, Pathname:ruby]
data = pn.read
pn.open { |f| _ }
pn.each_line { |line| _ }

Пример 2: Использование стандартного Ruby

pn = "/usr/bin/ruby"
size = File.size(pn)        # 27662
isdir = File.directory?(pn) # false
dir  = File.dirname(pn)     # "/usr/bin"
base = File.basename(pn)    # "ruby"
dir, base = File.split(pn)  # ["/usr/bin", "ruby"]
data = File.read(pn)
File.open(pn) { |f| _ }
File.foreach(pn) { |line| _ }

Пример 3: Специальные возможности

p1 = Pathname.new("/usr/lib")   # Pathname:/usr/lib
p2 = p1 + "ruby/1.8"            # Pathname:/usr/lib/ruby/1.8
p3 = p1.parent                  # Pathname:/usr
p4 = p2.relative_path_from(p3)  # Pathname:lib/ruby/1.8
pwd = Pathname.pwd              # Pathname:/home/gavin
pwd.absolute?                   # true
p5 = Pathname.new "."           # Pathname:.
p5 = p5 + "music/../articles"   # Pathname:music/../articles
p5.cleanpath                    # Pathname:articles
p5.realpath                     # Pathname:/home/gavin/articles
p5.children                     # [Pathname:/home/gavin/articles/linux, ...]

Детализация функциональности

Основные методы

Эти методы фактически манипулируют String, так как путь к файлу — это просто строка. Ни один из них не обращается к файловой системе, за исключением mountpoint?, children, each_child, realdirpath и realpath.

  • +

  • join

  • parent

  • root?

  • absolute?

  • relative?

  • relative_path_from

  • each_filename

  • cleanpath

  • realpath

  • realdirpath

  • children

  • each_child

  • mountpoint?

File методы проверки состояния

Эти методы являются фасадом для FileTest:

  • blockdev?

  • chardev?

  • directory?

  • executable?

  • executable_real?

  • exist?

  • file?

  • grpowned?

  • owned?

  • pipe?

  • readable?

  • world_readable?

  • readable_real?

  • setgid?

  • setuid?

  • size

  • size?

  • socket?

  • sticky?

  • symlink?

  • writable?

  • world_writable?

  • writable_real?

  • zero?

File свойства и методы манипулирования

Эти методы являются фасадом для File:

  • atime

  • birthtime

  • ctime

  • mtime

  • chmod(mode)

  • lchmod(mode)

  • chown(владелец, группа)

  • lchown(владелец, группа)

  • fnmatch(шаблон, *аргументы)

  • fnmatch?(шаблон, *аргументы)

  • ftype

  • make_link(old)

  • open(*аргументы, &блок)

  • readlink

  • rename(to)

  • stat

  • lstat

  • make_symlink(old)

  • truncate(length)

  • utime(atime, mtime)

  • basename(*args)

  • dirname

  • extname

  • expand_path(*args)

  • split

Методы каталога

Эти методы являются фасадом для Dir:

  • Pathname.glob(*args)

  • Pathname.getwd / Pathname.pwd

  • rmdir

  • entries

  • each_entry(&блок)

  • mkdir(*args)

  • opendir(*args)

IO

Эти методы являются фасадом для IO:

  • each_line(*аргументы, &блок)

  • read(*args)

  • binread(*args)

  • readlines(*args)

  • sysopen(*args)

Утилиты

Эти методы являются смесью Find, FileUtils и других:

  • find(&блок)

  • mkpath

  • rmtree

  • unlink / delete

Method документация

Как показано выше, большинство методов в Pathname являются фасадами. Документация к этим методам обычно просто указывает, например, «См. FileTest.writable?», так как вы должны быть знакомы с исходным методом, а его документация (например, через ri) содержит более подробную информацию. В некоторых случаях следует короткое описание.

Методы открытого класса

getwd() Показать исходный код
static VALUE
path_s_getwd(VALUE klass)
{
    VALUE str;
    str = rb_funcall(rb_cDir, id_getwd, 0);
    return rb_class_new_instance(1, &str, klass);
}

Возвращает текущую рабочую директорию в виде Pathname.

Pathname.getwd
    #=> #<Pathname:/home/zzak/projects/ruby>

См. Dir.getwd.

glob(p1, p2 = v2) Показать исходный код
static VALUE
path_s_glob(int argc, VALUE *argv, VALUE klass)
{
    VALUE args[2];
    int n;

    n = rb_scan_args(argc, argv, "11", &args[0], &args[1]);
    if (rb_block_given_p()) {
        return rb_block_call(rb_cDir, id_glob, n, args, s_glob_i, klass);
    }
    else {
        VALUE ary;
        long i;
        ary = rb_funcallv(rb_cDir, id_glob, n, args);
        ary = rb_convert_type(ary, T_ARRAY, "Array", "to_ary");
        for (i = 0; i < RARRAY_LEN(ary); i++) {
            VALUE elt = RARRAY_AREF(ary, i);
            elt = rb_class_new_instance(1, &elt, klass);
            rb_ary_store(ary, i, elt);
        }
        return ary;
    }
}

Возвращает или генерирует объекты Pathname.

Pathname.glob("lib/i*.rb")
    #=> [#<Pathname:lib/ipaddr.rb>, #<Pathname:lib/irb.rb>]

См. Dir.glob.

new(p1) Показать исходный код
static VALUE
path_initialize(VALUE self, VALUE arg)
{
    VALUE str;
    if (RB_TYPE_P(arg, T_STRING)) {
        str = arg;
    }
    else {
        str = rb_check_funcall(arg, id_to_path, 0, NULL);
        if (str == Qundef)
            str = arg;
        StringValue(str);
    }
    if (memchr(RSTRING_PTR(str), '\0', RSTRING_LEN(str)))
        rb_raise(rb_eArgError, "pathname contains null byte");
    str = rb_obj_dup(str);

    set_strpath(self, str);
    OBJ_INFECT(self, str);
    return self;
}

Создает объект Pathname из заданного String (или объекта, подобного строке). Если path содержит нулевой символ (\0), генерируется исключение ArgumentError.

pwd() Показать исходный код
static VALUE
path_s_getwd(VALUE klass)
{
    VALUE str;
    str = rb_funcall(rb_cDir, id_getwd, 0);
    return rb_class_new_instance(1, &str, klass);
}

Возвращает текущую рабочую директорию в виде Pathname.

Pathname.getwd
    #=> #<Pathname:/home/zzak/projects/ruby>

См. Dir.getwd.

Публичные методы экземпляра

+(other) Показать исходный код
# File ext/pathname/lib/pathname.rb, line 349
def +(other)
  other = Pathname.new(other) unless Pathname === other
  Pathname.new(plus(@path, other.to_s))
end

Добавляет фрагмент пути к self для создания нового объекта Pathname.

p1 = Pathname.new("/usr")      # Pathname:/usr
p2 = p1 + "bin/ruby"           # Pathname:/usr/bin/ruby
p3 = p1 + "/etc/passwd"        # Pathname:/etc/passwd

# / is aliased to +.
p4 = p1 / "bin/ruby"           # Pathname:/usr/bin/ruby
p5 = p1 / "/etc/passwd"        # Pathname:/etc/passwd

Этот метод не обращается к файловой системе; это чистая манипуляция строками.

Также известен как: /
/(other)
Псевдоним для: +
<=>(p1) Показать исходный код
static VALUE
path_cmp(VALUE self, VALUE other)
{
    VALUE s1, s2;
    char *p1, *p2;
    char *e1, *e2;
    if (!rb_obj_is_kind_of(other, rb_cPathname))
        return Qnil;
    s1 = get_strpath(self);
    s2 = get_strpath(other);
    p1 = RSTRING_PTR(s1);
    p2 = RSTRING_PTR(s2);
    e1 = p1 + RSTRING_LEN(s1);
    e2 = p2 + RSTRING_LEN(s2);
    while (p1 < e1 && p2 < e2) {
        int c1, c2;
        c1 = (unsigned char)*p1++;
        c2 = (unsigned char)*p2++;
        if (c1 == '/') c1 = '\0';
        if (c2 == '/') c2 = '\0';
        if (c1 != c2) {
            if (c1 < c2)
                return INT2FIX(-1);
            else
                return INT2FIX(1);
        }
    }
    if (p1 < e1)
        return INT2FIX(1);
    if (p2 < e2)
        return INT2FIX(-1);
    return INT2FIX(0);
}

Предоставляет оператор сравнения с учётом регистра для путей.

Pathname.new('/usr') <=> Pathname.new('/usr/bin')
    #=> -1
Pathname.new('/usr/bin') <=> Pathname.new('/usr/bin')
    #=> 0
Pathname.new('/usr/bin') <=> Pathname.new('/USR/BIN')
    #=> 1

Он вернёт -1, 0 или 1 в зависимости от значения левого аргумента относительно правого аргумента. Или вернёт nil, если аргументы не сравнимы.

==(p1) Показать исходный код
static VALUE
path_eq(VALUE self, VALUE other)
{
    if (!rb_obj_is_kind_of(other, rb_cPathname))
        return Qfalse;
    return rb_str_equal(get_strpath(self), get_strpath(other));
}

Сравнивает этот путь с other. Сравнение выполняется на основе строк. Имейте в виду, что два разных пути (foo.txt и ./foo.txt) могут ссылаться на один и тот же файл.

===(p1) Показать исходный код
static VALUE
path_eq(VALUE self, VALUE other)
{
    if (!rb_obj_is_kind_of(other, rb_cPathname))
        return Qfalse;
    return rb_str_equal(get_strpath(self), get_strpath(other));
}

Сравнивает этот путь с other. Сравнение выполняется на основе строк. Имейте в виду, что два разных пути (foo.txt и ./foo.txt) могут ссылаться на один и тот же файл.

absolute?() Показать исходный код
# File ext/pathname/lib/pathname.rb, line 224
def absolute?
  !relative?
end

Метод-предикат для проверки, является ли путь абсолютным.

Возвращает true, если имя пути начинается со слеша.

p = Pathname.new('/im/sure')
p.absolute?
    #=> true

p = Pathname.new('not/so/sure')
p.absolute?
    #=> false
ascend() { |self| ... } Показать исходный код
# File ext/pathname/lib/pathname.rb, line 325
def ascend
  return to_enum(__method__) unless block_given?
  path = @path
  yield self
  while r = chop_basename(path)
    path, = r
    break if path.empty?
    yield self.class.new(del_trailing_separator(path))
  end
end

Перебирает и возвращает новый объект Pathname для каждого элемента в заданном пути в восходящем порядке.

Pathname.new('/path/to/some/file.rb').ascend {|v| p v}
   #<Pathname:/path/to/some/file.rb>
   #<Pathname:/path/to/some>
   #<Pathname:/path/to>
   #<Pathname:/path>
   #<Pathname:/>

Pathname.new('path/to/some/file.rb').ascend {|v| p v}
   #<Pathname:path/to/some/file.rb>
   #<Pathname:path/to/some>
   #<Pathname:path/to>
   #<Pathname:path>

Возвращает Enumerator, если блок не был указан.

enum = Pathname.new("/usr/bin/ruby").ascend
  # ... do stuff ...
enum.each { |e| ... }
  # yields Pathnames /usr/bin/ruby, /usr/bin, /usr, and /.

Он не обращается к файловой системе.

atime → time Показать исходный код
static VALUE
path_atime(VALUE self)
{
    return rb_funcall(rb_cFile, id_atime, 1, get_strpath(self));
}

Возвращает время последнего доступа к файлу.

См. File.atime.

basename(p1 = v1) Показать исходный код
static VALUE
path_basename(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE fext;
    if (rb_scan_args(argc, argv, "01", &fext) == 0)
        str = rb_funcall(rb_cFile, id_basename, 1, str);
    else
        str = rb_funcall(rb_cFile, id_basename, 2, str, fext);
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает последний компонент пути.

См. File.basename.

binread([length [, offset]]) → string Показать исходный код
static VALUE
path_binread(int argc, VALUE *argv, VALUE self)
{
    VALUE args[3];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "02", &args[1], &args[2]);
    return rb_funcallv(rb_cFile, id_binread, 1+n, args);
}

Возвращает все байты из файла или первые N, если указано.

См. File.binread.

binwrite(string, [offset] ) → fixnum Показать исходный код
binwrite(string, [offset], open_args ) → fixnum
static VALUE
path_binwrite(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    return rb_funcallv(rb_cFile, id_binwrite, 1+n, args);
}

Записывает contents в файл, открывая его в бинарном режиме.

См. File.binwrite.

birthtime → time Показать исходный код
static VALUE
path_birthtime(VALUE self)
{
    return rb_funcall(rb_cFile, id_birthtime, 1, get_strpath(self));
}

Возвращает время создания файла. Если платформа не поддерживает время создания, вызывает NotImplementedError.

См. File.birthtime.

blockdev?() Показать исходный код
static VALUE
path_blockdev_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_blockdev_p, 1, get_strpath(self));
}

См. FileTest.blockdev?.

chardev?() Показать исходный код
static VALUE
path_chardev_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_chardev_p, 1, get_strpath(self));
}

См. FileTest.chardev?.

children(with_directory=true) Показать исходный код
# File ext/pathname/lib/pathname.rb, line 440
def children(with_directory=true)
  with_directory = false if @path == '.'
  result = []
  Dir.foreach(@path) {|e|
    next if e == '.' || e == '..'
    if with_directory
      result << self.class.new(File.join(@path, e))
    else
      result << self.class.new(e)
    end
  }
  result
end

Возвращает дочерние элементы каталога (файлы и подкаталоги, не рекурсивно) в виде массива объектов Pathname.

По умолчанию возвращаемые имена путей будут содержать достаточно информации для доступа к файлам. Если вы установите with_directory в false, то возвращаемые имена путей будут содержать только имя файла.

Например:

pn = Pathname("/usr/lib/ruby/1.8")
pn.children
    # -> [ Pathname:/usr/lib/ruby/1.8/English.rb,
           Pathname:/usr/lib/ruby/1.8/Env.rb,
           Pathname:/usr/lib/ruby/1.8/abbrev.rb, ... ]
pn.children(false)
    # -> [ Pathname:English.rb, Pathname:Env.rb, Pathname:abbrev.rb, ... ]

Обратите внимание, что результаты никогда не содержат элементов . и .. в каталоге, поскольку они не являются дочерними.

chmod → integer Показать исходный код
static VALUE
path_chmod(VALUE self, VALUE mode)
{
    return rb_funcall(rb_cFile, id_chmod, 2, mode, get_strpath(self));
}

Изменяет права доступа к файлу.

См. File.chmod.

chown → integer Показать исходный код
static VALUE
path_chown(VALUE self, VALUE owner, VALUE group)
{
    return rb_funcall(rb_cFile, id_chown, 3, owner, group, get_strpath(self));
}

Изменяет владельца и группу файла.

См. File.chown.

cleanpath(consider_symlink=false) Показать исходный код
# File ext/pathname/lib/pathname.rb, line 85
def cleanpath(consider_symlink=false)
  if consider_symlink
    cleanpath_conservative
  else
    cleanpath_aggressive
  end
end

Возвращает очищенное имя пути self с удалёнными последовательными слешами и бесполезными точками. Файловая система не используется.

Если consider_symlink равно true, то используется более консервативный алгоритм, чтобы избежать нарушения символических ссылок. Это может сохранить больше записей .., чем абсолютно необходимо, но без доступа к файловой системе этого избежать нельзя.

См. Pathname#realpath.

ctime → time Показать исходный код
static VALUE
path_ctime(VALUE self)
{
    return rb_funcall(rb_cFile, id_ctime, 1, get_strpath(self));
}

Возвращает время последнего изменения, используя информацию о каталоге, а не сам файл.

См. File.ctime.

delete() Показать исходный код
static VALUE
path_unlink(VALUE self)
{
    VALUE eENOTDIR = rb_const_get_at(rb_mErrno, id_ENOTDIR);
    VALUE str = get_strpath(self);
    return rb_rescue2(unlink_body, str, unlink_rescue, str, eENOTDIR, (VALUE)0);
}

Удаляет файл или каталог, используя File.unlink, если self является файлом, или Dir.unlink по мере необходимости.

descend() { |v| ... } Показать исходный код
# File ext/pathname/lib/pathname.rb, line 292
def descend
  return to_enum(__method__) unless block_given?
  vs = []
  ascend {|v| vs << v }
  vs.reverse_each {|v| yield v }
  nil
end

Перебирает и возвращает новый объект Pathname для каждого элемента в заданном пути в порядке убывания.

Pathname.new('/path/to/some/file.rb').descend {|v| p v}
   #<Pathname:/>
   #<Pathname:/path>
   #<Pathname:/path/to>
   #<Pathname:/path/to/some>
   #<Pathname:/path/to/some/file.rb>

Pathname.new('path/to/some/file.rb').descend {|v| p v}
   #<Pathname:path>
   #<Pathname:path/to>
   #<Pathname:path/to/some>
   #<Pathname:path/to/some/file.rb>

Возвращает Enumerator, если блок не был передан.

enum = Pathname.new("/usr/bin/ruby").descend
  # ... do stuff ...
enum.each { |e| ... }
  # yields Pathnames /, /usr, /usr/bin, and /usr/bin/ruby.

Не обращается к файловой системе.

directory?() Показать исходный код
static VALUE
path_directory_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_directory_p, 1, get_strpath(self));
}

См. FileTest.directory?.

dirname() Показать исходный код
static VALUE
path_dirname(VALUE self)
{
    VALUE str = get_strpath(self);
    str = rb_funcall(rb_cFile, id_dirname, 1, str);
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает все компоненты пути, кроме последнего.

См. File.dirname.

each_child(with_directory=true, &b) Показать исходный код
# File ext/pathname/lib/pathname.rb, line 490
def each_child(with_directory=true, &b)
  children(with_directory).each(&b)
end

Перебирает дочерние элементы каталога (файлы и подкаталоги, без рекурсии).

Возвращает объект Pathname для каждого дочернего элемента.

По умолчанию возвращаемые пути содержат достаточно информации для доступа к файлам.

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

Pathname("/usr/local").each_child {|f| p f }
#=> #<Pathname:/usr/local/share>
#   #<Pathname:/usr/local/bin>
#   #<Pathname:/usr/local/games>
#   #<Pathname:/usr/local/lib>
#   #<Pathname:/usr/local/include>
#   #<Pathname:/usr/local/sbin>
#   #<Pathname:/usr/local/src>
#   #<Pathname:/usr/local/man>

Pathname("/usr/local").each_child(false) {|f| p f }
#=> #<Pathname:share>
#   #<Pathname:bin>
#   #<Pathname:games>
#   #<Pathname:lib>
#   #<Pathname:include>
#   #<Pathname:sbin>
#   #<Pathname:src>
#   #<Pathname:man>

Обратите внимание, что результаты никогда не содержат записи . и .. в каталоге, так как они не являются дочерними элементами.

См. Pathname#children

each_entry() Показать исходный код
static VALUE
path_each_entry(VALUE self)
{
    VALUE args[1];

    args[0] = get_strpath(self);
    return rb_block_call(rb_cDir, id_foreach, 1, args, each_entry_i, rb_obj_class(self));
}

Перебирает записи (файлы и подкаталоги) в каталоге, возвращая объект Pathname для каждой записи.

each_filename() { |filename| ... } Показать исходный код
# File ext/pathname/lib/pathname.rb, line 260
def each_filename # :yield: filename
  return to_enum(__method__) unless block_given?
  _, names = split_names(@path)
  names.each {|filename| yield filename }
  nil
end

Перебирает каждый компонент пути.

Pathname.new("/usr/bin/ruby").each_filename {|filename| ... }
  # yields "usr", "bin", and "ruby".

Возвращает Enumerator, если блок не был передан.

enum = Pathname.new("/usr/bin/ruby").each_filename
  # ... do stuff ...
enum.each { |e| ... }
  # yields "usr", "bin", and "ruby".
each_line {|line| ... } Показать исходный код
each_line(sep=$/ [, open_args]) {|line| block } → nil
each_line(limit [, open_args]) {|line| block } → nil
each_line(sep, limit [, open_args]) {|line| block } → nil
each_line(...) → an_enumerator
static VALUE
path_each_line(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    if (rb_block_given_p()) {
        return rb_block_call(rb_cFile, id_foreach, 1+n, args, 0, 0);
    }
    else {
        return rb_funcallv(rb_cFile, id_foreach, 1+n, args);
    }
}

Перебирает каждую строку в файле и возвращает объект String для каждой из них.

empty?() Показать исходный код
static VALUE
path_empty_p(VALUE self)
{

    VALUE path = get_strpath(self);
    if (RTEST(rb_funcall(rb_mFileTest, id_directory_p, 1, path)))
        return rb_funcall(rb_cDir, id_empty_p, 1, path);
    else
        return rb_funcall(rb_mFileTest, id_empty_p, 1, path);
}

Проверяет, является ли файл пустым.

См. Dir#empty? и FileTest.empty?.

entries() Показать исходный код
static VALUE
path_entries(VALUE self)
{
    VALUE klass, str, ary;
    long i;
    klass = rb_obj_class(self);
    str = get_strpath(self);
    ary = rb_funcall(rb_cDir, id_entries, 1, str);
    ary = rb_convert_type(ary, T_ARRAY, "Array", "to_ary");
    for (i = 0; i < RARRAY_LEN(ary); i++) {
        VALUE elt = RARRAY_AREF(ary, i);
        elt = rb_class_new_instance(1, &elt, klass);
        rb_ary_store(ary, i, elt);
    }
    return ary;
}

Возвращает записи (файлы и подкаталоги) в каталоге, каждый как объект Pathname.

Результаты содержат только имена в каталоге без каких-либо последующих слэшей или рекурсивного поиска.

pp Pathname.new('/usr/local').entries
#=> [#<Pathname:share>,
#    #<Pathname:lib>,
#    #<Pathname:..>,
#    #<Pathname:include>,
#    #<Pathname:etc>,
#    #<Pathname:bin>,
#    #<Pathname:man>,
#    #<Pathname:games>,
#    #<Pathname:.>,
#    #<Pathname:sbin>,
#    #<Pathname:src>]

Результат может содержать текущий каталог #<Pathname:.> и родительский каталог #<Pathname:..>.

Если вам не нужны . и .., а нужны каталоги, рассмотрите Pathname#children.

eql?(p1) Показать исходный код
static VALUE
path_eq(VALUE self, VALUE other)
{
    if (!rb_obj_is_kind_of(other, rb_cPathname))
        return Qfalse;
    return rb_str_equal(get_strpath(self), get_strpath(other));
}

Сравнивает этот путь с other. Сравнение выполняется на основе строк. Имейте в виду, что два разных пути (foo.txt и ./foo.txt) могут ссылаться на один и тот же файл.

executable?() Показать исходный код
static VALUE
path_executable_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_executable_p, 1, get_strpath(self));
}

См. FileTest.executable?.

executable_real?() Показать исходный код
static VALUE
path_executable_real_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_executable_real_p, 1, get_strpath(self));
}

См. FileTest.executable_real?.

exist?() Показать исходный код
static VALUE
path_exist_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_exist_p, 1, get_strpath(self));
}

См. FileTest.exist?.

expand_path(p1 = v1) Показать исходный код
static VALUE
path_expand_path(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE dname;
    if (rb_scan_args(argc, argv, "01", &dname) == 0)
        str = rb_funcall(rb_cFile, id_expand_path, 1, str);
    else
        str = rb_funcall(rb_cFile, id_expand_path, 2, str, dname);
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает абсолютный путь к файлу.

См. File.expand_path.

extname() Показать исходный код
static VALUE
path_extname(VALUE self)
{
    VALUE str = get_strpath(self);
    return rb_funcall(rb_cFile, id_extname, 1, str);
}

Возвращает расширение файла.

См. File.extname.

file?() Показать исходный код
static VALUE
path_file_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_file_p, 1, get_strpath(self));
}

См. FileTest.file?.

find(ignore_error: true) { |pathname| ... } Показать исходный код
# File ext/pathname/lib/pathname.rb, line 559
def find(ignore_error: true) # :yield: pathname
  return to_enum(__method__, ignore_error: ignore_error) unless block_given?
  require 'find'
  if @path == '.'
    Find.find(@path, ignore_error: ignore_error) {|f| yield self.class.new(f.sub(%r{\A\./}, '')) }
  else
    Find.find(@path, ignore_error: ignore_error) {|f| yield self.class.new(f) }
  end
end

Перебирает древовидную структуру каталогов в порядке обхода в глубину, возвращая Pathname для каждого файла в подкаталогах “этого” каталога.

Возвращает Enumerator, если блок не указан.

Поскольку реализовано стандартным модулем библиотеки Find, можно использовать Find.prune для управления обходом.

Если self имеет значение ., возвращаемые пути начинаются с имени файла в текущем каталоге, а не с ./.

См. Find.find

fnmatch(pattern, [flags]) → string Показать исходный код
fnmatch?(pattern, [flags]) → string
static VALUE
path_fnmatch(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE pattern, flags;
    if (rb_scan_args(argc, argv, "11", &pattern, &flags) == 1)
        return rb_funcall(rb_cFile, id_fnmatch, 2, pattern, str);
    else
        return rb_funcall(rb_cFile, id_fnmatch, 3, pattern, str, flags);
}

Возвращает true , если получатель соответствует заданному шаблону.

См. File.fnmatch.

fnmatch?(pattern, [flags]) → string Показать исходный код
static VALUE
path_fnmatch(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE pattern, flags;
    if (rb_scan_args(argc, argv, "11", &pattern, &flags) == 1)
        return rb_funcall(rb_cFile, id_fnmatch, 2, pattern, str);
    else
        return rb_funcall(rb_cFile, id_fnmatch, 3, pattern, str, flags);
}

Возвращает true , если получатель соответствует заданному шаблону.

См. File.fnmatch.

END_OF_DOCUMENT_MARKER
freeze → obj Показать исходный код
static VALUE
path_freeze(VALUE self)
{
    rb_call_super(0, 0);
    rb_str_freeze(get_strpath(self));
    return self;
}

Замораживает этот Pathname.

См. Object.freeze.

ftype → string Показать исходный код
static VALUE
path_ftype(VALUE self)
{
    return rb_funcall(rb_cFile, id_ftype, 1, get_strpath(self));
}

Возвращает «тип» файла («файл», «каталог» и т.д.).

См. File.ftype.

glob(p1, p2 = v2) Показать исходный код
static VALUE
path_glob(int argc, VALUE *argv, VALUE self)
{
    VALUE args[3];
    int n;

    n = rb_scan_args(argc, argv, "11", &args[0], &args[1]);
    if (n == 1)
      args[1] = INT2FIX(0);

    args[2] = rb_hash_new();
    rb_hash_aset(args[2], ID2SYM(id_base), get_strpath(self));

    n = 3;

    if (rb_block_given_p()) {
        return rb_block_call(rb_cDir, id_glob, n, args, glob_i, self);
    }
    else {
        VALUE ary;
        long i;
        ary = rb_funcallv(rb_cDir, id_glob, n, args);
        ary = rb_convert_type(ary, T_ARRAY, "Array", "to_ary");
        for (i = 0; i < RARRAY_LEN(ary); i++) {
            VALUE elt = RARRAY_AREF(ary, i);
            elt = rb_funcall(self, '+', 1, elt);
            rb_ary_store(ary, i, elt);
        }
        return ary;
    }
}

Возвращает или итерирует объекты Pathname.

Pathname("ruby-2.4.2").glob("R*.md")
#=> [#<Pathname:ruby-2.4.2/README.md>, #<Pathname:ruby-2.4.2/README.ja.md>]

См. Dir.glob. Этот метод использует ключевой аргумент base метода Dir.glob.

grpowned?() Показать исходный код
static VALUE
path_grpowned_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_grpowned_p, 1, get_strpath(self));
}

См. FileTest.grpowned?.

join(*args) Показать исходный код
# File ext/pathname/lib/pathname.rb, line 407
def join(*args)
  return self if args.empty?
  result = args.pop
  result = Pathname.new(result) unless Pathname === result
  return result if result.absolute?
  args.reverse_each {|arg|
    arg = Pathname.new(arg) unless Pathname === arg
    result = arg + result
    return result if result.absolute?
  }
  self + result
end

Объединяет указанные пути с self для создания нового объекта Pathname.

path0 = Pathname.new("/usr")                # Pathname:/usr
path0 = path0.join("bin/ruby")              # Pathname:/usr/bin/ruby
    # is the same as
path1 = Pathname.new("/usr") + "bin/ruby"   # Pathname:/usr/bin/ruby
path0 == path1
    #=> true
lchmod → integer Показать исходный код
static VALUE
path_lchmod(VALUE self, VALUE mode)
{
    return rb_funcall(rb_cFile, id_lchmod, 2, mode, get_strpath(self));
}

То же, что и Pathname.chmod, но не следует за символическими ссылками.

См. File.lchmod.

lchown → integer Показать исходный код
static VALUE
path_lchown(VALUE self, VALUE owner, VALUE group)
{
    return rb_funcall(rb_cFile, id_lchown, 3, owner, group, get_strpath(self));
}

То же, что и Pathname.chown, но не следует за символическими ссылками.

См. File.lchown.

lstat() Показать исходный код
static VALUE
path_lstat(VALUE self)
{
    return rb_funcall(rb_cFile, id_lstat, 1, get_strpath(self));
}

См. File.lstat.

make_link(old) Показать исходный код
static VALUE
path_make_link(VALUE self, VALUE old)
{
    return rb_funcall(rb_cFile, id_link, 2, old, get_strpath(self));
}

Создаёт жёсткую ссылку в pathname.

См. File.link.

make_symlink(old) Показать исходный код
static VALUE
path_make_symlink(VALUE self, VALUE old)
{
    return rb_funcall(rb_cFile, id_symlink, 2, old, get_strpath(self));
}

Создаёт символическую ссылку.

См. File.symlink.

mkdir(p1 = v1) Показать исходный код
static VALUE
path_mkdir(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE vmode;
    if (rb_scan_args(argc, argv, "01", &vmode) == 0)
        return rb_funcall(rb_cDir, id_mkdir, 1, str);
    else
        return rb_funcall(rb_cDir, id_mkdir, 2, str, vmode);
}

Создаёт указанную директорию.

См. Dir.mkdir.

mkpath() Показать исходный код
# File ext/pathname/lib/pathname.rb, line 576
def mkpath
  require 'fileutils'
  FileUtils.mkpath(@path)
  nil
end

Создаёт весь путь, включая любые промежуточные директории, которых ещё нет.

См. FileUtils.mkpath и FileUtils.mkdir_p

mountpoint?() Показать исходный код
# File ext/pathname/lib/pathname.rb, line 192
def mountpoint?
  begin
    stat1 = self.lstat
    stat2 = self.parent.lstat
    stat1.dev != stat2.dev || stat1.ino == stat2.ino
  rescue Errno::ENOENT
    false
  end
end

Возвращает true если self указывает на точку монтирования.

mtime → time Показать исходный код
static VALUE
path_mtime(VALUE self)
{
    return rb_funcall(rb_cFile, id_mtime, 1, get_strpath(self));
}

Возвращает время последнего изменения файла.

См. File.mtime.

open(p1 = v1, p2 = v2, p3 = v3) Показать исходный код
static VALUE
path_open(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    if (rb_block_given_p()) {
        return rb_block_call(rb_cFile, id_open, 1+n, args, 0, 0);
    }
    else {
        return rb_funcallv(rb_cFile, id_open, 1+n, args);
    }
}

Открывает файл для чтения или записи.

См. File.open.

opendir() Показать исходный код
static VALUE
path_opendir(VALUE self)
{
    VALUE args[1];

    args[0] = get_strpath(self);
    return rb_block_call(rb_cDir, id_open, 1, args, 0, 0);
}

Открывает указанную директорию.

См. Dir.open.

owned?() Показать исходный код
static VALUE
path_owned_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_owned_p, 1, get_strpath(self));
}

См. FileTest.owned?.

parent() Показать исходный код
# File ext/pathname/lib/pathname.rb, line 187
def parent
  self + '..'
end

Возвращает родительский каталог.

Это то же, что и self + '..'.

pipe?() Показать исходный код
static VALUE
path_pipe_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_pipe_p, 1, get_strpath(self));
}

См. FileTest.pipe?.

read([length [, offset]]) → string Показать исходный код
read([length [, offset]], open_args) → string
static VALUE
path_read(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    return rb_funcallv(rb_cFile, id_read, 1+n, args);
}

Возвращает все данные из файла, или первые N байт, если задано.

См. File.read.

readable?() Показать исходный код
static VALUE
path_readable_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_readable_p, 1, get_strpath(self));
}

См. FileTest.readable?.

readable_real?() Показать исходный код
static VALUE
path_readable_real_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_readable_real_p, 1, get_strpath(self));
}

См. FileTest.readable_real?.

readlines(sep=$/ [, open_args]) → массив Показать исходный код
readlines(limit [, open_args]) → массив
readlines(sep, limit [, open_args]) → массив
static VALUE
path_readlines(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    return rb_funcallv(rb_cFile, id_readlines, 1+n, args);
}

Возвращает все строки из файла.

См. File.readlines.

readlink() Показать исходный код
static VALUE
path_readlink(VALUE self)
{
    VALUE str;
    str = rb_funcall(rb_cFile, id_readlink, 1, get_strpath(self));
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Считывает символическую ссылку.

См. File.readlink.

realdirpath(p1 = v1) Show source
static VALUE
path_realdirpath(int argc, VALUE *argv, VALUE self)
{
    VALUE basedir, str;
    rb_scan_args(argc, argv, "01", &basedir);
    str = rb_funcall(rb_cFile, id_realdirpath, 2, get_strpath(self), basedir);
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает реальный (абсолютный) путь к self в реальной файловой системе.

Не содержит символических ссылок или бесполезных точек, .. и ..

Последний компонент реального пути может отсутствовать.

realpath(p1 = v1) Show source
static VALUE
path_realpath(int argc, VALUE *argv, VALUE self)
{
    VALUE basedir, str;
    rb_scan_args(argc, argv, "01", &basedir);
    str = rb_funcall(rb_cFile, id_realpath, 2, get_strpath(self), basedir);
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает реальный (абсолютный) путь к self в реальной файловой системе.

Не содержит символических ссылок или бесполезных точек, .. и ..

Все компоненты пути должны существовать при вызове этого метода.

relative?() Show source
# File ext/pathname/lib/pathname.rb, line 239
def relative?
  path = @path
  while r = chop_basename(path)
    path, = r
  end
  path == ''
end

Противоположность Pathname#absolute?

Возвращает false, если путь начинается со слеша.

p = Pathname.new('/im/sure')
p.relative?
    #=> false

p = Pathname.new('not/so/sure')
p.relative?
    #=> true
relative_path_from(base_directory) Show source
# File ext/pathname/lib/pathname.rb, line 505
def relative_path_from(base_directory)
  base_directory = Pathname.new(base_directory) unless base_directory.is_a? Pathname
  dest_directory = self.cleanpath.to_s
  base_directory = base_directory.cleanpath.to_s
  dest_prefix = dest_directory
  dest_names = []
  while r = chop_basename(dest_prefix)
    dest_prefix, basename = r
    dest_names.unshift basename if basename != '.'
  end
  base_prefix = base_directory
  base_names = []
  while r = chop_basename(base_prefix)
    base_prefix, basename = r
    base_names.unshift basename if basename != '.'
  end
  unless SAME_PATHS[dest_prefix, base_prefix]
    raise ArgumentError, "different prefix: #{dest_prefix.inspect} and #{base_directory.inspect}"
  end
  while !dest_names.empty? &&
        !base_names.empty? &&
        SAME_PATHS[dest_names.first, base_names.first]
    dest_names.shift
    base_names.shift
  end
  if base_names.include? '..'
    raise ArgumentError, "base_directory has ..: #{base_directory.inspect}"
  end
  base_names.fill('..')
  relpath_names = base_names + dest_names
  if relpath_names.empty?
    Pathname.new('.')
  else
    Pathname.new(File.join(*relpath_names))
  end
end

Возвращает относительный путь от заданного base_directory к получателю.

Если self является абсолютным, то base_directory также должен быть абсолютным.

Если self является относительным, то base_directory также должен быть относительным.

Этот метод не обращается к файловой системе. Он предполагает отсутствие символических ссылок.

ArgumentError возникает, когда не удается найти относительный путь.

rename(p1) Show source
static VALUE
path_rename(VALUE self, VALUE to)
{
    return rb_funcall(rb_cFile, id_rename, 2, get_strpath(self), to);
}

Переименовывает файл.

См. File.rename.

rmdir() Show source
static VALUE
path_rmdir(VALUE self)
{
    return rb_funcall(rb_cDir, id_rmdir, 1, get_strpath(self));
}

Удаляет указанный каталог.

См. Dir.rmdir.

rmtree() Show source
# File ext/pathname/lib/pathname.rb, line 585
def rmtree
  # The name "rmtree" is borrowed from File::Path of Perl.
  # File::Path provides "mkpath" and "rmtree".
  require 'fileutils'
  FileUtils.rm_r(@path)
  nil
end

Рекурсивно удаляет каталог, включая все подкаталоги.

См. FileUtils.rm_r

root?() Show source
# File ext/pathname/lib/pathname.rb, line 209
def root?
  !!(chop_basename(@path) == nil && /#{SEPARATOR_PAT}/o.match?(@path))
end

Метод-предикат для корневых каталогов. Возвращает true, если путь состоит из последовательных слешей.

Он не обращается к файловой системе. Поэтому он может вернуть false для некоторых путей, указывающих на корни, таких как /usr/...

setgid?() Show source
static VALUE
path_setgid_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_setgid_p, 1, get_strpath(self));
}

См. FileTest.setgid?.

setuid?() Show source
static VALUE
path_setuid_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_setuid_p, 1, get_strpath(self));
}

См. FileTest.setuid?.

size() Show source
static VALUE
path_size(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_size, 1, get_strpath(self));
}

См. FileTest.size.

size?() Show source
static VALUE
path_size_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_size_p, 1, get_strpath(self));
}

См. FileTest.size?.

socket?() Show source
static VALUE
path_socket_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_socket_p, 1, get_strpath(self));
}

См. FileTest.socket?.

split() Show source
static VALUE
path_split(VALUE self)
{
    VALUE str = get_strpath(self);
    VALUE ary, dirname, basename;
    ary = rb_funcall(rb_cFile, id_split, 1, str);
    ary = rb_check_array_type(ary);
    dirname = rb_ary_entry(ary, 0);
    basename = rb_ary_entry(ary, 1);
    dirname = rb_class_new_instance(1, &dirname, rb_obj_class(self));
    basename = rb_class_new_instance(1, &basename, rb_obj_class(self));
    return rb_ary_new3(2, dirname, basename);
}

Возвращает dirname и basename в Array.

См. File.split.

stat() Show source
static VALUE
path_stat(VALUE self)
{
    return rb_funcall(rb_cFile, id_stat, 1, get_strpath(self));
}

Возвращает объект File::Stat.

См. File.stat.

sticky?() Show source
static VALUE
path_sticky_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_sticky_p, 1, get_strpath(self));
}

См. FileTest.sticky?.

sub(*args) Show source
static VALUE
path_sub(int argc, VALUE *argv, VALUE self)
{
    VALUE str = get_strpath(self);

    if (rb_block_given_p()) {
        str = rb_block_call(str, id_sub, argc, argv, 0, 0);
    }
    else {
        str = rb_funcallv(str, id_sub, argc, argv);
    }
    return rb_class_new_instance(1, &str, rb_obj_class(self));
}

Возвращает путь, который заменен с помощью String#sub.

path1 = Pathname.new('/usr/bin/perl')
path1.sub('perl', 'ruby')
    #=> #<Pathname:/usr/bin/ruby>
sub_ext(p1) Show source
static VALUE
path_sub_ext(VALUE self, VALUE repl)
{
    VALUE str = get_strpath(self);
    VALUE str2;
    long extlen;
    const char *ext;
    const char *p;

    StringValue(repl);
    p = RSTRING_PTR(str);
    extlen = RSTRING_LEN(str);
    ext = ruby_enc_find_extname(p, &extlen, rb_enc_get(str));
    if (ext == NULL) {
        ext = p + RSTRING_LEN(str);
    }
    else if (extlen <= 1) {
        ext += extlen;
    }
    str2 = rb_str_subseq(str, 0, ext-p);
    rb_str_append(str2, repl);
    OBJ_INFECT(str2, str);
    return rb_class_new_instance(1, &str2, rb_obj_class(self));
}

Возвращает путь с repl добавленным в качестве суффикса к базовому имени.

Если self не имеет части расширения, repl добавляется.

Pathname.new('/usr/bin/shutdown').sub_ext('.rb')
    #=> #<Pathname:/usr/bin/shutdown.rb>
symlink?() Show source
static VALUE
path_symlink_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_symlink_p, 1, get_strpath(self));
}

См. FileTest.symlink?.

sysopen([mode, [perm]]) → fixnum Show source
static VALUE
path_sysopen(int argc, VALUE *argv, VALUE self)
{
    VALUE args[3];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "02", &args[1], &args[2]);
    return rb_funcallv(rb_cIO, id_sysopen, 1+n, args);
}

См. IO.sysopen.

taint → obj Show source
static VALUE
path_taint(VALUE self)
{
    rb_call_super(0, 0);
    rb_obj_taint(get_strpath(self));
    return self;
}

Заражает этот Pathname.

См. Object.taint.

to_path → string Show source
static VALUE
path_to_s(VALUE self)
{
    return rb_obj_dup(get_strpath(self));
}

Возвращает путь в виде String.

to_path реализован так, что объекты Pathname могут использоваться с File.open и т.д.

to_s → строка Показать исходный код
static VALUE
path_to_s(VALUE self)
{
    return rb_obj_dup(get_strpath(self));
}

Возвращает путь в виде String.

to_path реализован таким образом, чтобы объекты Pathname можно было использовать с File.open и т. д.

truncate(p1) Показать исходный код
static VALUE
path_truncate(VALUE self, VALUE length)
{
    return rb_funcall(rb_cFile, id_truncate, 2, get_strpath(self), length);
}

Обрезает файл до length байтов.

См. File.truncate.

unlink() Показать исходный код
static VALUE
path_unlink(VALUE self)
{
    VALUE eENOTDIR = rb_const_get_at(rb_mErrno, id_ENOTDIR);
    VALUE str = get_strpath(self);
    return rb_rescue2(unlink_body, str, unlink_rescue, str, eENOTDIR, (VALUE)0);
}

Удаляет файл или директорию, используя File.unlink, если self — файл, или Dir.unlink в необходимых случаях.

untaint → obj Показать исходный код
static VALUE
path_untaint(VALUE self)
{
    rb_call_super(0, 0);
    rb_obj_untaint(get_strpath(self));
    return self;
}

Снимает метку «загрязнён» с этого Pathname.

См. Object.untaint.

utime(p1, p2) Показать исходный код
static VALUE
path_utime(VALUE self, VALUE atime, VALUE mtime)
{
    return rb_funcall(rb_cFile, id_utime, 3, atime, mtime, get_strpath(self));
}

Обновляет время доступа и изменения файла.

См. File.utime.

world_readable?() Показать исходный код
static VALUE
path_world_readable_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_world_readable_p, 1, get_strpath(self));
}

См. FileTest.world_readable?.

world_writable?() Показать исходный код
static VALUE
path_world_writable_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_world_writable_p, 1, get_strpath(self));
}

См. FileTest.world_writable?.

writable?() Показать исходный код
static VALUE
path_writable_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_writable_p, 1, get_strpath(self));
}

См. FileTest.writable?.

writable_real?() Показать исходный код
static VALUE
path_writable_real_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_writable_real_p, 1, get_strpath(self));
}

См. FileTest.writable_real?.

write(строка, [смещение] ) → целое Показать исходный код
write(строка, [смещение], open_args ) → целое
static VALUE
path_write(int argc, VALUE *argv, VALUE self)
{
    VALUE args[4];
    int n;

    args[0] = get_strpath(self);
    n = rb_scan_args(argc, argv, "03", &args[1], &args[2], &args[3]);
    return rb_funcallv(rb_cFile, id_write, 1+n, args);
}

Записывает contents в файл.

См. File.write.

zero?() Показать исходный код
static VALUE
path_zero_p(VALUE self)
{
    return rb_funcall(rb_mFileTest, id_zero_p, 1, get_strpath(self));
}

См. FileTest.zero?.

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API