easycompile 1.0.9

data/lib/easycompile/constants/programs_directory.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/constants/programs_directory.rb'
+# =========================================================================== #
+module Easycompile
+
+module Constants # === Easycompile::Constants
+
+  # ========================================================================= #
+  # === PROGRAMS_DIRECTORY
+  # ========================================================================= #
+  if ENV['MY_PROGRAMS']
+    PROGRAMS_DIRECTORY = ENV['MY_PROGRAMS'].to_s+'/'
+  else
+    PROGRAMS_DIRECTORY = '/home/Programs/'
+  end
+
+end
+
+# =========================================================================== #
+# === @programs_directory
+#
+# This toplevel instance variable keeps track of the programs directory
+# in use for easycompile.
+# =========================================================================== #
+@programs_directory = Constants::PROGRAMS_DIRECTORY
+
+# =========================================================================== #
+# === Easycompile.set_programs_directory
+# =========================================================================== #
+def self.set_programs_directory(i)
+  i = i.dup if i.frozen?
+  i << '/' unless i.end_with? '/'
+  @programs_directory = i
+end
+
+# =========================================================================== #
+# === Easycompile.programs_directory?
+# =========================================================================== #
+def self.programs_directory?
+  @programs_directory
+end; self.instance_eval { alias programs_dir? programs_directory? } # === Easycompile.programs_dir?
+
+end

data/lib/easycompile/easycompile/easycompile.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Easycompile::Easycompile
+#
+# This will extract an archive, then compile into the given prefix,
+# which defaults to /usr/ for this class.
+# =========================================================================== #
+require 'easycompile/base/easycompile.rb'
+
+module Easycompile # === Easycompile::Easycompile
+
+class Easycompile < Base
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # We can use more advanced compile instructions such as:
+  #
+  #   Easycompile::Easycompile.new(i, extract_to: EXTRACT_TO)
+  #
+  # The first argument is the name of the program in question.
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true,
+      &block
+    )
+    set_prefix '/usr' # This is the default prefix anyway.
+    super(i, :dont_run_yet)
+    if run_already.is_a? Hash
+      set_hash(run_already) # Here the prefix can be overruled.
+      run_already = true
+    end
+    if i.is_a? Array
+      i = i.first
+    end
+    if i.end_with? '.yml'
+      i = return_yaml_file(i)
+      set_original_input(i)
+    end
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # === Handle Hashes next
+      # ===================================================================== #
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === { :prefix => :appdir }
+        #
+        # This is the default entry point for programs that are compiled
+        # via an AppDir prefix.
+        # =================================================================== #
+        if yielded.has_key? :prefix
+          set_prefix(
+            yielded[:prefix]
+          )
+        end
+      end
+    end
+    set_original_input(i)
+    run if run_already # Call the parent method.
+  end
+
+  # ========================================================================= #
+  # === Easycompile[]
+  # ========================================================================= #
+  def self.[](i)
+    new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === Easycompile.new
+# =========================================================================== #
+def self.new(i = ARGV)
+  ::Easycompile::Easycompile.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  puts Easycompile::Easycompile.new(ARGV)
+end # ecompile

data/lib/easycompile/project/project.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/project/project.rb'
+# =========================================================================== #
+module Easycompile
+
+  # ========================================================================= #
+  # === Easycompile::PROJECT_BASE_DIRECTORY
+  # ========================================================================= #
+  PROJECT_BASE_DIRECTORY = 
+    File.absolute_path("#{__dir__}/..")+'/'
+
+  # ========================================================================= #
+  # === Easycompile::PROJECT_BASE_DIR
+  #
+  # This is simply an "alias" to the above constant.
+  # ========================================================================= #
+  PROJECT_BASE_DIR = PROJECT_BASE_DIRECTORY
+  
+  # ========================================================================= #
+  # === Easycompile.project_base_dir?
+  # ========================================================================= #
+  def self.project_base_dir?
+    PROJECT_BASE_DIRECTORY
+  end
+
+end

data/lib/easycompile/requires/require_the_easycompile_project.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/requires/require_the_easycompile_project.rb'
+# =========================================================================== #
+require 'easycompile/constants/constants.rb'
+require 'easycompile/project/project.rb'
+require 'easycompile/version/version.rb'
+require 'easycompile/base/easycompile.rb'
+require 'easycompile/requires/require_the_toplevel_methods.rb'
+require 'easycompile/easycompile/easycompile.rb'
+require 'easycompile/compile_as_appdir/compile_as_appdir.rb'

data/lib/easycompile/requires/require_the_toplevel_methods.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/requires/require_the_toplevel_methods.rb'
+# =========================================================================== #
+require 'easycompile/project/project.rb'
+
+Dir["#{Easycompile.project_base_dir?}toplevel_methods/*.rb"].each {|this_file|
+  require "easycompile/toplevel_methods/#{File.basename(this_file)}"
+}

data/lib/easycompile/toplevel_methods/copy_file.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/toplevel_methods/copy_file.rb'
+# =========================================================================== #
+module Easycompile
+
+  require 'fileutils'
+
+  # ========================================================================= #
+  # === Easycompile.copy_file
+  #
+  # The second argument to this method specifies the target-location
+  # where the file should be copied onto.
+  # ========================================================================= #
+  def self.copy_file(
+      from, to = Dir.pwd
+    )
+    FileUtils.cp(from, to)
+  end
+
+end

data/lib/easycompile/toplevel_methods/misc.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Here we collect methods which are directly available on the module
+# level of the project.
+# =========================================================================== #
+# require 'easycompile/toplevel_methods/misc.rb'
+# =========================================================================== #
+module Easycompile
+
+  require 'easycompile/constants/constants.rb'
+  # ========================================================================= #
+  # We wish to include these constants onto the toplevel module next.
+  # ========================================================================= #
+  include Easycompile::Constants
+
+  require 'easycompile/easycompile/easycompile.rb'
+  require 'easycompile/compile_as_appdir/compile_as_appdir.rb'
+  # ========================================================================= #
+  # === Easycompile.compile
+  #
+  # This method must be able to tap into CompileAsAppdir, as well
+  # as invoke Easycompile, so both .rb files are required here.
+  #
+  # If no input is given then a random entry will be fetched.
+  #
+  # Invocation example:
+  #
+  #   Easycompile.compile('wv.yml', :appdir)
+  #
+  # ========================================================================= #
+  def self.compile(
+      i = nil, optional_compile_as_appdir = false
+    )
+    if i.nil?
+      i = try_to_randomly_fetch_an_archive_from_the_current_directory
+    end
+    case optional_compile_as_appdir
+    when :appdir
+      # ===================================================================== #
+      # Make it more explicit in this case.
+      # ===================================================================== #
+      optional_compile_as_appdir = true
+    end
+    if optional_compile_as_appdir
+      ::Easycompile::CompileAsAppdir[i]
+    else
+      ::Easycompile::Easycompile.new(i)
+    end
+  end; self.instance_eval { alias easycompile compile } # === Easycompile.easycompile
+       self.instance_eval { alias []          compile } # === Easycompile[]
+
+end

data/lib/easycompile/toplevel_methods/rinstall2.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/toplevel_methods/rinstall2.rb'
+# =========================================================================== #
+module Easycompile
+
+  require 'easycompile/constants/file_and_directory_constants.rb'
+  require 'easycompile/toplevel_methods/copy_file.rb'
+
+  # ========================================================================= #
+  # === Easycompile.rinstall2
+  #
+  # How to install ruby-stuff without gems, by using good oldschool
+  # setup.rb.
+  # ========================================================================= #
+  def self.rinstall2
+    copy_file ::Easycompile::Constants::LOCATION_OF_SETUP_RB,
+              Dir.pwd
+    esystem 'ruby setup.rb --quiet config'
+    esystem 'ruby setup.rb --quiet setup'
+    esystem 'ruby setup.rb --quiet install'
+    File.delete('setup.rb')       if File.exist? 'setup.rb'
+    File.delete('InstalledFiles') if File.exist? 'InstalledFiles'
+    File.delete('.config')        if File.exist? '.config'
+  end
+
+end

data/lib/easycompile/version/version.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'easycompile/version/version.rb'
+# =========================================================================== #
+module Easycompile
+
+  # ========================================================================= #
+  # === VERSION
+  # ========================================================================= #
+  VERSION = '1.0.9'
+
+  # ========================================================================= #
+  # === LAST_UPDATE
+  # ========================================================================= #
+  LAST_UPDATE = '02.05.2022'
+
+  # ========================================================================= #
+  # === version?
+  # ========================================================================= #
+  def self.version?
+    Easycompile::VERSION
+  end
+  
+end

data/lib/easycompile/yaml/name_of_the_build_directory.yml

@@ -0,0 +1 @@
+BUILD_DIRECTORY

data/lib/easycompile.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'easycompile/requires/require_the_easycompile_project.rb'

data/test/testing_easycompile.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'colours/colours_e_autoinclude.rb'
+require 'easycompile'
+
+# =========================================================================== #
+# Denote which program to use.
+# =========================================================================== #
+_ = '/home/x/src/htop/htop-2.2.0.tar.xz'
+_ = ARGV.first unless ARGV.empty? # Overrule if argument was given.
+
+e
+e 'Welcome to testing some components of the project called Easycompile.'
+e
+e 'The version in use is:'
+e
+e sfancy("  #{Easycompile.version?}")
+e
+e 'Next testing support for yaml files through '+
+  sfancy('Easycompile.compile("wv.yaml", :appdir)')+':'
+Easycompile.compile('wv.yml', :appdir)
+e 'Next testing app-dir compilation:'
+Easycompile::CompileAsAppdir[_]
+e "Next testing #{sfancy('Easycompile.compile(_)')}"
+Easycompile.compile(_)
+e 'Next testing support for yaml files:'
+Easycompile.compile('wv.yml')

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: easycompile
+version: !ruby/object:Gem::Version
+  version: 1.0.9
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-05-02 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'
+- !ruby/object:Gem::Dependency
+  name: extracter
+  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 project is called easycompile.
+
+  It allows you to compile a given source archive, such as a file
+  like "php-7.2.0.tar.xz". By default this will compile into the
+  prefix /usr/. In order for this to work, the file at hand
+  has to exist; in the case above, the file php-7.2.0.tar.xz
+  has to exist locally.
+
+  For more documentation, have a look at the link called
+  Documentation on the bottom right side of this webpage.
+
+email: shevy@inbox.lt
+executables:
+- easycompile
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/easycompile
+- doc/DESIGN_DECISIONS.md
+- doc/README.gen
+- doc/todo/todo_for_the_easycompile_project.md
+- easycompile.gemspec
+- lib/easycompile.rb
+- lib/easycompile/base/change_directory.rb
+- lib/easycompile/base/cmake.rb
+- lib/easycompile/base/colours.rb
+- lib/easycompile/base/commandline_arguments.rb
+- lib/easycompile/base/constants.rb
+- lib/easycompile/base/easycompile.rb
+- lib/easycompile/base/esystem.rb
+- lib/easycompile/base/gem.rb
+- lib/easycompile/base/help.rb
+- lib/easycompile/base/initialize.rb
+- lib/easycompile/base/menu.rb
+- lib/easycompile/base/meson_and_ninja.rb
+- lib/easycompile/base/misc.rb
+- lib/easycompile/base/opn.rb
+- lib/easycompile/base/process_the_input.rb
+- lib/easycompile/base/remove.rb
+- lib/easycompile/base/reset.rb
+- lib/easycompile/base/run.rb
+- lib/easycompile/compile_as_appdir/compile_as_appdir.rb
+- lib/easycompile/constants/array_possible_archives.rb
+- lib/easycompile/constants/constants.rb
+- lib/easycompile/constants/file_and_directory_constants.rb
+- lib/easycompile/constants/misc.rb
+- lib/easycompile/constants/namespace.rb
+- lib/easycompile/constants/programs_directory.rb
+- lib/easycompile/easycompile/easycompile.rb
+- lib/easycompile/images/logo/EASYCOMPILE_LOGO.png
+- lib/easycompile/project/project.rb
+- lib/easycompile/requires/require_the_easycompile_project.rb
+- lib/easycompile/requires/require_the_toplevel_methods.rb
+- lib/easycompile/toplevel_methods/copy_file.rb
+- lib/easycompile/toplevel_methods/misc.rb
+- lib/easycompile/toplevel_methods/rinstall2.rb
+- lib/easycompile/version/version.rb
+- lib/easycompile/yaml/name_of_the_build_directory.yml
+- test/testing_easycompile.rb
+homepage: https://rubygems.org/gems/easycompile
+licenses:
+- GPL-2.0
+metadata: {}
+post_install_message: "\n  You can run this project by issuing:\n\n      ecompile\n\n
+  \ on the commandline.\n    \n  See\n\n      ecompile --help\n\n  for the available
+  options.\n\n"
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.8
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.12
+requirements: []
+rubygems_version: 3.3.12
+signing_key:
+specification_version: 4
+summary: This project is called easycompile.  It allows you to compile a given source
+  archive, such as a file like "php-7.2.0.tar.xz". By default this will compile into
+  the prefix /usr/. In order for this to work, the file at hand has to exist; in the
+  case above, the file php-7.2.0.tar.xz has to exist locally.  For more documentation,
+  have a look at the link called Documentation on the bottom right side of this webpage.
+test_files: []
+...