symlink 0.0.23

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3414c65443100ebdbabcb9dc27386fc4fc94203a5156ca43c92b26295949221a
+  data.tar.gz: da7586e51b26e08e5e7550967b34c090b2aab0a5fd914a7e7ee5efd6812c7bd0
+SHA512:
+  metadata.gz: 92a1f0eaf3a7a286850762f213322f934caebafdb04337a8871eba990ce23ccf3ae3e4bc6b1d8267d4dc030ba7ce9c7b108f9efbbebc11781f92c7e04387b348
+  data.tar.gz: d7325df1023399420b041bf43fdab6e5cb46e86baea8916eb911a4a121e5c7691bd2b06602bd79882c2248ea7ac4544da9f5a8d67e52b29db8011af2b4385507

data/lib/symlink.rb

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

data/lib/symlink/constants.rb

@@ -0,0 +1,17 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+class Symlink
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === USE_ABSOLUTE_SYMLINKING
+  # ========================================================================= #
+  USE_ABSOLUTE_SYMLINKING = false
+
+end

data/lib/symlink/symlink.rb

@@ -0,0 +1,306 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+# === Symlink
+#
+# This general class will allow you to symlink one target to the other.
+#
+# Usage example:
+#   Symlink.new
+# =========================================================================== #
+# require 'symlink/symlink.rb'
+# =========================================================================== #
+require 'fileutils'
+require 'opn'
+# =========================================================================== #
+# Add a few colours for support:
+# =========================================================================== #
+require 'colours/e/e.rb'
+require 'colours/requires/require_sdir.rb'
+require 'colours/requires/require_sfile.rb'
+# =========================================================================== #
+# And next pull in .rb files that are specific for Symlink:
+# =========================================================================== #
+require 'symlink/version/version.rb'
+require 'symlink/constants.rb'
+
+class Symlink # === Symlink.new
+
+  include Colours::E
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      old_existing_location,
+      new_location,
+      be_verbose  = true,
+      run_already = true
+    )
+    reset
+    set_existing_location(old_existing_location) # from
+    set_new_location(new_location)               # to
+    set_be_verbose(be_verbose) # Whether we are silent or not.
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Hash
+        if yielded.has_key? :prepend_this_to_namespace
+          prepend_this_to_namespace(yielded.delete(:prepend_this_to_namespace))
+        end
+      end
+    end
+    if run_already == :do_not_run_yet
+      run_already = false
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === prepend_this_to_namespace
+  # ========================================================================= #
+  def prepend_this_to_namespace(i)
+    @namespace.prepend(i.to_s.dup)
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    @use_absolute_symlinking = USE_ABSOLUTE_SYMLINKING
+    @use_opn     = true
+    @be_verbose  = true
+    @use_colours = true
+    @namespace   = NAMESPACE # This can be changed.
+  end
+
+  # ========================================================================= #
+  # === shall_we_use_colours?
+  #
+  # This method requires one mandatory argument.
+  # ========================================================================= #
+  def shall_we_use_colours?(true_or_false)
+    if true_or_false == false
+      disable_colours
+    else
+      enable_colours
+    end
+  end
+
+  # ========================================================================= #
+  # === disable_colours
+  # ========================================================================= #
+  def disable_colours
+    @use_colours = false
+  end
+
+  # ========================================================================= #
+  # === enable_colours
+  # ========================================================================= #
+  def enable_colours
+    @use_colours = true
+  end
+
+  # ========================================================================= #
+  # === use_colours?
+  # ========================================================================= #
+  def use_colours?
+    @use_colours
+  end
+
+  # ========================================================================= #
+  # === use_absolute_symlinking
+  # ========================================================================= #
+  def use_absolute_symlinking
+    @use_absolute_symlinking = true
+    # ======================================================================= #
+    # We must also sync @existing_location.
+    # ======================================================================= #
+    set_existing_location(existing?)
+  end
+
+  # ========================================================================= #
+  # === set_be_verbose
+  # ========================================================================= #
+  def set_be_verbose(i)
+    @be_verbose = i
+  end
+
+  # ========================================================================= #
+  # === use_absolute_symlinking?
+  # ========================================================================= #
+  def use_absolute_symlinking?
+    @use_absolute_symlinking
+  end
+
+  # ========================================================================= #
+  # === set_existing_location
+  #
+  # This must be an existing file.
+  # ========================================================================= #
+  def set_existing_location(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup
+    i = rds(i)
+    if use_absolute_symlinking?
+      i = '../../../..'+i
+    end
+    @existing_location = i
+  end
+    
+  # ========================================================================= #
+  # === delete
+  # ========================================================================= #
+  def delete(i)
+    i = i.dup if i.frozen?
+    i.strip!
+    if (rds(i) == '/')
+      ewarn 'We can never delete /'
+    else
+      File.delete(i)
+    end
+  end; alias remove delete # === remove
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @be_verbose
+  end
+
+  # ========================================================================= #
+  # === rds
+  # ========================================================================= #
+  def rds(i)
+    i.squeeze('/')
+  end
+
+  # ========================================================================= #
+  # === set_new_location
+  # ========================================================================= #
+  def set_new_location(i = '')
+    i = i.to_s.dup
+    i = rds(i)
+    @new_location = i
+  end; alias set_new_target set_new_location # === set_new_target
+
+  # ========================================================================= #
+  # === old?
+  # ========================================================================= #
+  def old?
+    @existing_location
+  end; alias existing?   old? # === existing?
+       alias old_target? old? # === old_target?
+       alias from?       old? # === from?
+
+  # ========================================================================= #
+  # === new?
+  # ========================================================================= #
+  def new?
+    @new_location
+  end; alias new_target? new? # === new_target?
+       alias to?         new? # === to?
+
+  # ========================================================================= #
+  # === do_symlink
+  #
+  # This is the actual method that will perform the symlink-operation in
+  # question.
+  # ========================================================================= #
+  def do_symlink(be_verbose = be_verbose?)
+    # ======================================================================= #
+    # We must first check whether the target at new? exists or whether
+    # it does not.
+    # ======================================================================= #
+    if File.exist? new_target?
+      if File.directory?(new_target?) and File.file?(old_target?) # Silent renaming then.
+        _ = new_target?+File.basename(old_target?)
+        set_new_target(_)
+      end
+      if File.symlink? new_target?
+        delete(new_target?)
+      end
+    end
+    if be_verbose
+      opnn if use_opn?
+      e 'Symlinking '+sfile(existing?)+' into '+sfile(new_target?)+'.'
+    end
+    begin
+      File.symlink(existing?, new_target?)
+    rescue Errno::ENOENT => error # No such file or directory
+      opnn if use_opn?
+      e "Can not symlink - no such file exists, at `#{sfile(new_target?)}`."
+      pp error
+    rescue Errno::EEXIST => error # The file does not exist.
+      opnn if use_opn?
+      e "Can not symlink - the file at `#{sfile(new_target?)}` already exists."
+      pp error
+    end
+  end
+
+  # ========================================================================= #
+  # === do_not_use_opn
+  # ========================================================================= #
+  def do_not_use_opn
+    @use_opn = false
+  end; alias disable_opn do_not_use_opn # === disable_opn
+
+  # ========================================================================= #
+  # === use_opn?
+  # ========================================================================= #
+  def use_opn?
+    @use_opn
+  end
+
+  # ========================================================================= #
+  # === namespace?
+  # ========================================================================= #
+  def namespace?
+    @namespace
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i)
+    return Colours.sfile(i) if use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i)
+    return Colours.sdir(i) if use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn
+    Opn.opn(
+      namespace:   @namespace,
+      use_colours: use_colours?
+    )
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    do_symlink
+  end
+
+  # ========================================================================= #
+  # === Symlink[]
+  # ========================================================================= #
+  def self.[](old, new)
+    self.new(old, new)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Symlink.new(ARGV.first, ARGV[1])
+end # rubysymlink /Depot/j/foo.mp3 /Depot/j/bar.mp3

data/lib/symlink/version/version.rb

@@ -0,0 +1,12 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+class Symlink
+
+  # ========================================================================= #
+  # === Symlink::VERSION
+  # ========================================================================= #
+  VERSION = '0.0.23'
+
+end

data/symlink.gemspec

@@ -0,0 +1,48 @@
+# =========================================================================== #
+# Gemspec for Project Symlink.
+# =========================================================================== #
+require 'symlink/version/version.rb'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'symlink'
+  s.version = Symlink::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF                                                                                                                                                      
+
+    This library is called symlink. It can be used to symlink
+    files or directories, from within ruby.
+
+    General syntax is:
+
+      Symlink.new(from, to)
+
+    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.summary     = DESCRIPTION
+  s.description = DESCRIPTION
+
+  s.extra_rdoc_files = %w()
+
+  s.authors  = ['Robert A. Heiler']
+  s.email    = 'shevegen@gmail.com'
+  s.files    = Dir['**/*']
+
+  s.license  = 'GPL-2.0'
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # Dependencies for the project:
+  s.add_dependency 'colours'
+  s.add_dependency 'opn'
+
+}

data/test/testing_symlink.rb

@@ -0,0 +1,10 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+require 'symlink'
+require 'colour_e/autoinclude'
+Symlink[
+  '/Programs/Applewmproto/1.4.2/',
+  '/Programs/Applewmproto/Current'
+] # $RSRC/symlink/test/testing_symlink.rb

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: symlink
+version: !ruby/object:Gem::Version
+  version: 0.0.23
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-23 00:00:00.000000000 Z
+dependencies:
+- !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'
+- !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'
+description: |2
+
+      This library is called symlink. It can be used to symlink
+      files or directories, from within ruby.
+
+      General syntax is:
+
+        Symlink.new(from, to)
+
+      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/symlink.rb
+- lib/symlink/constants.rb
+- lib/symlink/symlink.rb
+- lib/symlink/version/version.rb
+- symlink.gemspec
+- test/testing_symlink.rb
+homepage: 
+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.3
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: 'This library is called symlink. It can be used to symlink files or directories,
+  from within ruby.  General syntax is:  Symlink.new(from, to)  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: []