rbs-relaxed 3.9.0.1

data/core/file_test.rbs

@@ -0,0 +1,331 @@
+# <!-- rdoc-file=file.c -->
+# FileTest implements file test operations similar to those used in File::Stat.
+# It exists as a standalone module, and its methods are also insinuated into the
+# File class. (Note that this is not done by inclusion: the interpreter cheats).
+#
+module FileTest
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.blockdev?(filepath) -> true or false
+  # -->
+  # Returns `true` if `filepath` points to a block device, `false` otherwise:
+  #
+  #     File.blockdev?('/dev/sda1')       # => true
+  #     File.blockdev?(File.new('t.tmp')) # => false
+  #
+  def self?.blockdev?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.chardev?(filepath) -> true or false
+  # -->
+  # Returns `true` if `filepath` points to a character device, `false` otherwise.
+  #
+  #     File.chardev?($stdin)     # => true
+  #     File.chardev?('t.txt')     # => false
+  #
+  def self?.chardev?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.directory?(path) -> true or false
+  # -->
+  # With string `object` given, returns `true` if `path` is a string path leading
+  # to a directory, or to a symbolic link to a directory; `false` otherwise:
+  #
+  #     File.directory?('.')              # => true
+  #     File.directory?('foo')            # => false
+  #     File.symlink('.', 'dirlink')      # => 0
+  #     File.directory?('dirlink')        # => true
+  #     File.symlink('t,txt', 'filelink') # => 0
+  #     File.directory?('filelink')       # => false
+  #
+  # Argument `path` can be an IO object.
+  #
+  def self?.directory?: (path | io file_name) -> bool
+
+  # <!-- rdoc-file=file.c -->
+  # Returns `true` if the named file exists and has a zero size.
+  #
+  # *file_name* can be an IO object.
+  #
+  alias empty? zero?
+
+  alias self.empty? self.zero?
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.executable?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is executable by the effective user and group
+  # id of this process. See eaccess(3).
+  #
+  # Windows does not support execute permissions separately from read permissions.
+  # On Windows, a file is only considered executable if it ends in .bat, .cmd,
+  # .com, or .exe.
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not executable by the effective user/group.
+  #
+  def self?.executable?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.executable_real?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is executable by the real user and group id
+  # of this process. See access(3).
+  #
+  # Windows does not support execute permissions separately from read permissions.
+  # On Windows, a file is only considered executable if it ends in .bat, .cmd,
+  # .com, or .exe.
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not executable by the real user/group.
+  #
+  def self?.executable_real?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.exist?(file_name)    ->  true or false
+  # -->
+  # Return `true` if the named file exists.
+  #
+  # *file_name* can be an IO object.
+  #
+  # "file exists" means that stat() or fstat() system call is successful.
+  #
+  def self?.exist?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.file?(file) -> true or false
+  # -->
+  # Returns `true` if the named `file` exists and is a regular file.
+  #
+  # `file` can be an IO object.
+  #
+  # If the `file` argument is a symbolic link, it will resolve the symbolic link
+  # and use the file referenced by the link.
+  #
+  def self?.file?: (path | io file) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.grpowned?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file exists and the effective group id of the
+  # calling process is the owner of the file. Returns `false` on Windows.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.grpowned?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.identical?(file_1, file_2)   ->  true or false
+  # -->
+  # Returns `true` if the named files are identical.
+  #
+  # *file_1* and *file_2* can be an IO object.
+  #
+  #     open("a", "w") {}
+  #     p File.identical?("a", "a")      #=> true
+  #     p File.identical?("a", "./a")    #=> true
+  #     File.link("a", "b")
+  #     p File.identical?("a", "b")      #=> true
+  #     File.symlink("a", "c")
+  #     p File.identical?("a", "c")      #=> true
+  #     open("d", "w") {}
+  #     p File.identical?("a", "d")      #=> false
+  #
+  def self?.identical?: (path | io file_1, path | io file_2) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.owned?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file exists and the effective used id of the
+  # calling process is the owner of the file.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.owned?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.pipe?(filepath) -> true or false
+  # -->
+  # Returns `true` if `filepath` points to a pipe, `false` otherwise:
+  #
+  #     File.mkfifo('tmp/fifo')
+  #     File.pipe?('tmp/fifo') # => true
+  #     File.pipe?('t.txt')    # => false
+  #
+  def self?.pipe?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.readable?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is readable by the effective user and group
+  # id of this process. See eaccess(3).
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not readable by the effective user/group.
+  #
+  def self?.readable?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.readable_real?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is readable by the real user and group id of
+  # this process. See access(3).
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not readable by the real user/group.
+  #
+  def self?.readable_real?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.setgid?(file_name)   ->  true or false
+  # -->
+  # Returns `true` if the named file has the setgid bit set.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.setgid?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.setuid?(file_name)   ->  true or false
+  # -->
+  # Returns `true` if the named file has the setuid bit set.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.setuid?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.size(file_name)   -> integer
+  # -->
+  # Returns the size of `file_name`.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.size: (path | io file_name) -> Integer
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.size?(file_name)   -> Integer or nil
+  # -->
+  # Returns `nil` if `file_name` doesn't exist or has zero size, the size of the
+  # file otherwise.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.size?: (path | io file_name) -> Integer?
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.socket?(filepath)   ->  true or false
+  # -->
+  # Returns `true` if `filepath` points to a socket, `false` otherwise:
+  #
+  #     require 'socket'
+  #     File.socket?(Socket.new(:INET, :STREAM)) # => true
+  #     File.socket?(File.new('t.txt'))          # => false
+  #
+  def self?.socket?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.sticky?(file_name)   ->  true or false
+  # -->
+  # Returns `true` if the named file has the sticky bit set.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.sticky?: (path | io file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.symlink?(filepath) -> true or false
+  # -->
+  # Returns `true` if `filepath` points to a symbolic link, `false` otherwise:
+  #
+  #     symlink = File.symlink('t.txt', 'symlink')
+  #     File.symlink?('symlink') # => true
+  #     File.symlink?('t.txt')   # => false
+  #
+  def self?.symlink?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.world_readable?(file_name)   -> integer or nil
+  # -->
+  # If *file_name* is readable by others, returns an integer representing the file
+  # permission bits of *file_name*. Returns `nil` otherwise. The meaning of the
+  # bits is platform dependent; on Unix systems, see `stat(2)`.
+  #
+  # *file_name* can be an IO object.
+  #
+  #     File.world_readable?("/etc/passwd")           #=> 420
+  #     m = File.world_readable?("/etc/passwd")
+  #     sprintf("%o", m)                              #=> "644"
+  #
+  def self?.world_readable?: (path | io file_name) -> Integer?
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.world_writable?(file_name)   -> integer or nil
+  # -->
+  # If *file_name* is writable by others, returns an integer representing the file
+  # permission bits of *file_name*. Returns `nil` otherwise. The meaning of the
+  # bits is platform dependent; on Unix systems, see `stat(2)`.
+  #
+  # *file_name* can be an IO object.
+  #
+  #     File.world_writable?("/tmp")                  #=> 511
+  #     m = File.world_writable?("/tmp")
+  #     sprintf("%o", m)                              #=> "777"
+  #
+  def self?.world_writable?: (path | io file_name) -> Integer?
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.writable?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is writable by the effective user and group
+  # id of this process. See eaccess(3).
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not writable by the effective user/group.
+  #
+  def self?.writable?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.writable_real?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file is writable by the real user and group id of
+  # this process. See access(3).
+  #
+  # Note that some OS-level security features may cause this to return true even
+  # though the file is not writable by the real user/group.
+  #
+  def self?.writable_real?: (path file_name) -> bool
+
+  # <!--
+  #   rdoc-file=file.c
+  #   - File.zero?(file_name)   -> true or false
+  # -->
+  # Returns `true` if the named file exists and has a zero size.
+  #
+  # *file_name* can be an IO object.
+  #
+  def self?.zero?: (path | io file_name) -> bool
+end