program_information 1.1.3

data/lib/program_information/toplevel_methods/return_short_name.rb

@@ -0,0 +1,38 @@
+#!/System/Index/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'program_information/toplevel_methods/return_short_name.rb'
+# =========================================================================== #
+require 'program_information/program_information.rb'
+
+module ProgramInformation
+
+  # ========================================================================= #
+  # === ProgramInformation.return_short_name
+  #
+  # This method will ultimately return the value of @short_name value.
+  #
+  # Usage examples:
+  #
+  #   ProgramInformation.return_short_name('ffmpeg-2.1.tar.xz') # => "ffmpeg"
+  #   ProgramInformation.return_short_name('/Users/x/SRC/gobjectintrospection/gobject-introspection-1.53.4.tar.xz') # => "gobjectintrospection"
+  #
+  # In the first example, it will return 'ffmpeg', but keep in mind that
+  # we allow to keep '-' characters. In the second example, the '-'
+  # MUST be preserved.
+  # ========================================================================= #
+  def self.return_short_name(
+      of_this_program = ''
+    )
+    if of_this_program.nil? or of_this_program.empty?
+      opnn; e 'Please provide some input to the method '\
+              'ProgramInformation.return_short_name.'
+    else
+      _ = ::ProgramInformation::ProgramInformation.new(of_this_program)
+      _.short_name?
+    end 
+  end; self.instance_eval { alias return_name              return_short_name } # === ProgramInformation.return_name
+       self.instance_eval { alias return_program_real_name return_short_name } # === ProgramInformation.return_program_real_name
+
+end

data/lib/program_information/version/version.rb

@@ -0,0 +1,17 @@
+#!/System/Index/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'program_information/version/version.rb'
+# =========================================================================== #
+module ProgramInformation
+
+class ProgramInformation 
+
+  # ========================================================================= #
+  # === VERSION
+  # ========================================================================= #
+  VERSION = '1.1.3'
+    DEFAULT_VERSION = VERSION # Use an "alias" to the above constant.
+
+end; end

data/program_information.gemspec

@@ -0,0 +1,49 @@
+# =========================================================================== #
+# Gemspec for Project ProgramInformation.
+# =========================================================================== #
+require 'program_information'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'program_information'
+  s.version = ProgramInformation::ProgramInformation::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  DESCRIPTION = <<-EOF
+
+This library is called program_information.
+
+It allows you to return the real name and the version of strings
+such as "htop-1.0.2.tar.xz".
+
+The name would be "htop" and the version would be "1.0.2".
+
+This project here was needed for the Cookbooks project and the
+RBT project.
+
+It has since then become somewhat useful on its own.
+
+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.homepage = 'http://rubygems.org/gems/program_information'
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # Add the dependencies next:
+  # ========================================================================= #
+  s.add_dependency 'colours'
+  s.add_dependency 'remove_file_suffix'
+
+}

data/test/testing_program_information.rb

@@ -0,0 +1,49 @@
+#!/System/Index/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'cliner'
+require 'colours/autoinclude'
+require 'program_information'
+
+cliner {
+  e 'Testing project ProgramInformation next.'
+}; e
+
+# =========================================================================== #
+# === TEST_THESE_PROGRAMS
+#
+# It is recommended to move more complicated input to the bottom
+# of this array. That way we can focus on it quickly.
+# =========================================================================== #
+TEST_THESE_PROGRAMS = ProgramInformation::ARRAY_TEST_THIS_AS_INPUT.reject(&:empty?)
+
+# =========================================================================== #
+# === test
+# =========================================================================== #
+def test(i)
+  cliner
+  e
+  e 'Now testing input                              `'+sfancy(i)+'`.'
+  e
+  begin
+    ProgramInformation::ProgramInformation.new(i).report(:do_report)
+  rescue Exception => error
+    pp error
+  end
+  # _ = ProgramInformation::ProgramInformation.new(entry, true, true)
+  e
+  cliner
+  e # Trailing newline.
+end
+
+# =========================================================================== #
+# Iterate over TEST_THESE_PROGRAMS.
+# =========================================================================== #    
+TEST_THESE_PROGRAMS.each {|entry| test(entry) }
+
+TEST_THESE_PROGRAMS.each {|entry|
+  original_entry = entry.dup
+  entry = ProgramInformation.return_proper_pipe_token_to_this_input(entry)
+  e simp(original_entry.ljust(54))+'  ->  '+sfancy(entry)
+}

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: program_information
+version: !ruby/object:Gem::Version
+  version: 1.1.3
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-12-06 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: remove_file_suffix
+  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 program_information.
+
+  It allows you to return the real name and the version of strings
+  such as "htop-1.0.2.tar.xz".
+
+  The name would be "htop" and the version would be "1.0.2".
+
+  This project here was needed for the Cookbooks project and the
+  RBT project.
+
+  It has since then become somewhat useful on its own.
+
+email: shevegen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/program_information
+- doc/CONVENTIONS.md
+- doc/README.gen
+- lib/program_information.rb
+- lib/program_information/constants/array_test_with_this_as_input.rb
+- lib/program_information/constants/colours.rb
+- lib/program_information/constants/constants.rb
+- lib/program_information/constants/regex.rb
+- lib/program_information/initialize.rb
+- lib/program_information/menu.rb
+- lib/program_information/program_information.rb
+- lib/program_information/project/project_base_directory.rb
+- lib/program_information/report.rb
+- lib/program_information/reset.rb
+- lib/program_information/run.rb
+- lib/program_information/toplevel_methods.rb
+- lib/program_information/toplevel_methods/e.rb
+- lib/program_information/toplevel_methods/opnn.rb
+- lib/program_information/toplevel_methods/remove_archive_type.rb
+- lib/program_information/toplevel_methods/return_proper_pipe_token_to_this_input.rb
+- lib/program_information/toplevel_methods/return_short_name.rb
+- lib/program_information/version/version.rb
+- program_information.gemspec
+- test/testing_program_information.rb
+homepage: http://rubygems.org/gems/program_information
+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.5
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.6
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: This library is called program_information.  It allows you to return the
+  real name and the version of strings such as "htop-1.0.2.tar.xz".  The name would
+  be "htop" and the version would be "1.0.2".  This project here was needed for the
+  Cookbooks project and the RBT project.  It has since then become somewhat useful
+  on its own.
+test_files: []