stat_file 1.0.13

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 63e270a21b1fac3d14e6b2f3059b2d2af31518b439e04540678db3faeabe2100
+  data.tar.gz: ae4524bc6b5758bbacf88b9f9700d7e2a6a5b1895cab75ccb34d5e5562cfa11f
+SHA512:
+  metadata.gz: 771dfcc38b1a5fe2e9350855b5113699fb94feb290326e07fe337cdc60c6513adab7a757fb52762082b336e1c0f1e59aaccbce1db904167099ad8ee79adfeef8
+  data.tar.gz: 34643c90bd90270b043d6f15296d9688bf8a9e377dba647f90480142e1c2243614d5b3f8759701bd31822fc21fe6c6cd4f896227b8938d03ddddc785972fca57

data/lib/stat_file.rb

@@ -0,0 +1 @@
+require 'stat_file/stat_file.rb'

data/lib/stat_file/stat_file.rb

@@ -0,0 +1,237 @@
+#!/System/Index/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === StatFile
+#
+# require 'stat_file/stat_file.rb'
+# =========================================================================== #
+# Bug:
+#   The access entry is not completely correct - the number is ok but 
+#   the rxw--- format is wrong.
+# =========================================================================== #
+require 'etc'
+begin
+  require 'colours'
+rescue LoadError; end
+require 'opn'
+
+class StatFile
+
+  include Colours
+
+  N = "\n" unless defined? N
+
+  # ========================================================================= #
+  # === SHALL_WE_DEBUG
+  # ========================================================================= #
+  SHALL_WE_DEBUG = false unless defined? SHALL_WE_DEBUG
+
+  # ========================================================================= #
+  # === RED_ON_BLACK
+  # ========================================================================= #
+  RED_ON_BLACK   = "\e[31;48m" unless defined? RED_ON_BLACK
+
+  # ========================================================================= #
+  # === REVERT
+  # ========================================================================= #
+  REVERT         = '\e[0m' unless defined? REVERT  
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      this_file,
+      be_verbose  = true,
+      run_already = true
+    )
+    reset # This must be called before set_be_verbose()
+    be_verbose = false if be_verbose == :dont_be_verbose
+    set_be_verbose if be_verbose
+    set_file(this_file)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    @be_verbose = false # Default.
+    @debug = SHALL_WE_DEBUG
+    @padding_left = '  '
+  end
+
+  # ========================================================================= #
+  # === file?
+  # ========================================================================= #
+  def file?
+    @file
+  end
+
+  # ========================================================================= #
+  # === set_file
+  # ========================================================================= #
+  def set_file(i, get_rid_of_slashdot = false)
+    if get_rid_of_slashdot
+      i.delete!('/') if i.include? '/' # Since 06.12.2011 we try to get rid of possible '/' in the string.
+    end
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    @file = i
+  end
+
+  # ========================================================================= #
+  # === set_be_verbose
+  # ========================================================================= #
+  def set_be_verbose
+    @be_verbose = true
+  end
+
+  # ========================================================================= #
+  # === is_on_roebe?
+  # ========================================================================= #
+  def is_on_roebe?
+    ENV['IS_ROEBE'].to_s == '1'
+  end
+
+  # ========================================================================= #
+  # === stat_file
+  # ========================================================================= #
+  def stat_file(f = @file)
+    if f.to_s.empty?
+      opn; e 'No such file could be found. Perhaps you '
+      opn; e 'forgot to pass in a valid filename?'
+    end
+    if f
+      if f.is_a? Array
+        f.each { |this_file| stat_file(this_file) }
+      else
+        @is_symlink = File.symlink?(f) ? true : false
+        if @debug
+          e "Debugging in stat_file.rb: Is `#{f}` a symlink or not? #{@is_symlink}"
+        end
+        if is_on_roebe? and !File.exist?(f)
+          begin
+            require 'beautiful_url'
+            f = BeautifulUrl[f]
+            f = f.first if f.is_a? Array
+          rescue LoadError; end
+        end
+        string = '    File: `'+f+"'"
+        # =================================================================== #
+        # If it is a symlink we have to check whether the target exists
+        # or not.
+        # =================================================================== #
+        if @is_symlink
+          f = File.readlink(f)
+          string << ' -> `'+f+"'"
+        end
+        # =================================================================== #
+        # Now we can retrieve the information.
+        # =================================================================== #
+        if File.exist?(f)
+          _ = File.stat(f)
+          file_type = File.ftype(f)
+          case file_type
+          when 'directory'
+            target_type = 'directory'
+          when 'file'
+            target_type = 'regular file'
+          when 'symlink','link'
+            target_type = 'symlink'
+          end
+          # Prepend a newline to it. I think it looks better that way.
+          @result = N+string+N # reset again here.
+          @result << @padding_left+'  Size: '+
+                     (@size = _.size.to_s).to_s+'         Blocks: '+_.blocks.to_s+'   '+target_type.to_s+N
+          @result << @padding_left+return_device_string+'  Inode: '+_.ino.to_s+N
+          begin
+            gid = File.stat(f).gid.to_s
+            gid_name = Etc.getgrgid(File.stat(f).gid).name # i.e. "root"
+            uid = File.stat(f).uid.to_s
+            uid_name = Etc.getpwuid(File.stat(f).uid).name # i.e. "root"
+            # =============================================================== #
+            # Next we will add the access entry. The Access entry may
+            # have a leading 0 or 1.
+            # =============================================================== #
+            access_mode = File.stat(f).mode.to_s(8)[-4,4] # Get the last 4 chars only.
+            access_entry = 'Access: ('+access_mode+'/-rwxr-xr-x)  Uid: ( '+uid+'/   '+uid_name+')   Gid: ( '+gid+'/   '+gid_name+')'
+            @result << @padding_left+access_entry+N
+          rescue Exception => error; pp error; end
+          @result << @padding_left+'Created at:    '+File.ctime(f).to_s+N
+          @result << @padding_left+'Last accessed: '+File.atime(f).to_s+N
+          @result << @padding_left+'Last modified: '+File.mtime(f).to_s+N
+          e @result if @be_verbose
+        else # Else the file does not exit.
+          if be_verbose?
+            opn; ewarn 'But target file `'+sfile(f)+
+                 swarn('` does not exist.') # File.readlink(@file)
+          end
+        end
+      end
+    end
+  end; alias run stat_file
+
+  # ========================================================================= #
+  # === result?
+  # ========================================================================= #
+  def result?
+    @result
+  end; alias result result? # === result
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @be_verbose
+  end
+
+  # ========================================================================= #
+  # === size?
+  # ========================================================================= #
+  def size?
+    @size
+  end; alias size size? # === size()
+
+  # ========================================================================= #
+  # === return_device_string
+  #
+  # This method is assumed to return an entry such as the following one:
+  #
+  #   Device: 801h/2049d
+  #
+  # Note that this may differ from systemd to non-systemd systems.
+  # ========================================================================= #
+  def return_device_string
+    result = 'Device: '
+    # ======================================================================= #
+    # First, find out the current device:
+    # ======================================================================= #
+    base_dir = File.dirname(file?)
+    cmd = `df #{base_dir}`
+    device_number = cmd.split(N)[1].split(' ')[0]
+    # ======================================================================= #
+    # device_number now has something like /dev/sda1
+    # In order to obtain the major and minor version,
+    # we must do this:
+    # ======================================================================= #
+    cmd = "ls -al #{device_number}"
+    major_minor  = `#{cmd}` # To get major/minor = 8/1
+    # ======================================================================= #
+    # This may however had fail. We assume that it will fail when it
+    # includes the string "by-uuid".
+    # ======================================================================= #
+    applied_match = major_minor.match(/disk (\d, \d)/)
+    if applied_match # Protect against nil values.
+      major, minor = applied_match[1].split(',').map(&:strip)
+      major_and_minor = major+'0'+minor
+      result << major_and_minor+'h/'+major_and_minor.to_i(16).to_s+'d '
+    end
+    result
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  StatFile.new(ARGV.first, true)
+end # sfile $SYSBIN/ruby

data/stat_file.gemspec

@@ -0,0 +1,51 @@
+# =========================================================================== #
+# Gemspec for Project StatFile.
+# =========================================================================== #
+Gem::Specification.new { |s|
+
+  s.name    = 'stat_file'
+  s.version = '1.0.13'
+  s.date    = Time.now.strftime('%Y-%m-%d')
+  
+  s.summary = <<-EOF
+
+    This library is called stat_file. It allows you to
+    do basic stat functionality, like the Unix Tool.
+
+    If you have specific suggestions to make this gem more
+    useful for others, please drop me an email at:
+
+      shevegen@gmail.com
+
+    Thank you.
+
+  EOF
+  
+  s.description = <<-EOF
+
+    This library is called stat_file. It allows you to
+    do basic stat functionality, like the Unix Tool.
+
+    If you have specific suggestions to make this gem more
+    useful for others, please drop me an email at:
+
+      shevegen@gmail.com
+
+    Thank you.
+
+  EOF
+
+  s.authors     = ['Robert A. Heiler']
+  s.email       = 'shevegen@gmail.com'
+  s.files       = Dir['**/*']
+  s.license     = 'GPL-2.0'
+  s.homepage    = 'http://rubygems.org/gems/stat_file'
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  s.add_dependency 'opn'
+  s.add_dependency 'colours'
+
+}

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: stat_file
+version: !ruby/object:Gem::Version
+  version: 1.0.13
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-07-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: opn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colours
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2+
+
+      This library is called stat_file. It allows you to
+      do basic stat functionality, like the Unix Tool.
+
+      If you have specific suggestions to make this gem more
+      useful for others, please drop me an email at:
+
+        shevegen@gmail.com
+
+      Thank you.
+
+email: shevegen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/stat_file.rb
+- lib/stat_file/stat_file.rb
+- stat_file.gemspec
+homepage: http://rubygems.org/gems/stat_file
+licenses:
+- GPL-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.4
+requirements: []
+rubygems_version: 3.0.4
+signing_key: 
+specification_version: 4
+summary: 'This library is called stat_file. It allows you to do basic stat functionality,
+  like the Unix Tool.  If you have specific suggestions to make this gem more useful
+  for others, please drop me an email at:  shevegen@gmail.com  Thank you.'
+test_files: []