opensecret 0.0.8 → 0.0.913

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e67c23773cbe174123307c2867d43bb87eadeb52
-  data.tar.gz: a609ac281671d31a31347f3b4b495624a0943627
+  metadata.gz: 26149681c5b0cbb089a8c9d82953c4e8981147c1
+  data.tar.gz: 3a2cac8d536acc786fbd1343a694f14ff2b0d73e
 SHA512:
-  metadata.gz: 5a4ad46b55c31d1ee53b712d16614a1bc037e5530ade7a3cee1d1f36ac7a810ab24acfd477a80f1ae8f61a0b304fcf6fb6a00a93138b9c92eee7ec1feec8a56a
-  data.tar.gz: d234147703779a54e450edd86dacb66dc47f2fa651d8ff310d4baf32813a3a7e3dd632d1da2abe917b090d552fafe0f9196edfb56c94188687dda0d29c633c8a
+  metadata.gz: 79409037388746addf1d6574813a84ab3dedb19761009c56f447b24cfc0ad36262859cf7832f3ff3366847abb912fb81e412893466c9f2489f13e837e6058ea9
+  data.tar.gz: 79eb02b2befae0c6c0432ed1d065be7b7ea960dc43c64767062ab68419ee49036414376acba0e40047b2d1731422bbd9f9179fc7c6a04a4d8ff92177babdbf9c

data/README.md

@@ -4,9 +4,9 @@ opensecret [![Build Status](https://secure.travis-ci.org/TwP/inifile.png)](http:
 Description
 -----------
 
-+opensecret+ stashes uncrackable secrets into your +Git+, +S3+, DropBox, Google Drive and filesystems backends. You interface with its intuitive Linux, Windows, iOS front ends and it offers SDKs and plugins for +Ruby+, +Python+, +Go+, +Java+, Jenkins, CodeShip, Ansible, Terraform, Puppet and Chef. Soon, support will be added for database and keystore backends such as +MySQL+, +MongoDB+, +PostgreSQL+, Redis, Memcached and etcd.
+opensecret stashes uncrackable secrets into your Git, S3, DropBox, Google Drive and filesystems backends. You interface with its intuitive Linux, Windows, iOS front ends and it offers SDKs and plugins for Ruby, Python, Go, Java, Jenkins, CodeShip, Ansible, Terraform, Puppet and Chef. Soon, support will be added for database and keystore backends such as MySQL, MongoDB, PostgreSQL, Redis, Memcached and etcd.
 
-opensecret never accesses the cloud for anything - it is designed to operate on a single non-networked laptop if you so wish. opensecret takes a fresh approach to security and challenges common misconceptions - in order to deliver a simple, highly secure credentials management system.
+**opensecret never accesses the cloud.** It can operate on a wee non-networked laptop if you so wish. opensecret takes a fresh approach to security and challenges common misconceptions - in order to deliver a simple, highly secure credentials management system.
 
 
 ### opensecret | Install It

data/lib/opensecret.rb

@@ -1,8 +1,10 @@
-require "opensecret/version"
-require "opensecret/plugins.io/cipher/crypto"
 require "thor"
+require "session/time.stamp"
+require "session/session"
 
-# ### This command line processor will
+#
+# This command line processor extends Thor's functionality in
+# order to
 #
 # - read the posted commands, options and switches
 # - maps the incoming string data to objects
@@ -11,17 +13,58 @@ require "thor"
 # - ensure that the parameter values are in range
 # - delegate processing to the registered handlers
 #
-# @note the Thor ruby gem is used for the heavy lifting
-#
-# @example opensecret initdomain create friends.joebloggs --secure
-# @example opensecret user create id=joe email=joebloggs@opensecret.io
-# @example opensecret user create id=joe email=joebloggs@opensecret.io
-#
-#
 class CommandProcessor < Thor
 
-  desc "init DOMAIN", "DOMAIN eg lecturers@harvard names your friends, family or work group."
-  desc "init STORE_URL", "STORE_URL is backend Git/S3/SSH crypt store. Use https://www.eco-platform.co.uk/crypt.store.git"
+  #
+  # This class option allows every CLI call the option to include
+  # a --debug  boolean switch which will up the verbosity of the
+  # content logged to the file .opensecret/opensecret.log
+  #
+  class_option :debug, :type => :boolean
+  
+  #
+  # Thor method describing the mandatory directory path parameter
+  # in the keydir cli interface call.
+  #
+  desc "keydir KEYPATH", "KEYPATH path to USB key for storing private keys"
+
+  #
+  # A USB key drive is the ideal store for the encrypted private
+  # key and the tamper proof configuration file. This method collects
+  # the usb drive path and then
+  #
+  # - checks the path exists
+  # - if not, it attempts to create the path
+  # - if successful it's written into HOME/.opensecret/opensecret.keydir.txt
+  #
+  # @example opensecret keydir /path/to/usb/key/dir
+  #
+  # Alternate Use Case Flows
+  #
+  # - if file exists with equal (case sensitive) content this is logged
+  # - if file exists with different content that content is logged and changed
+  #
+  # @param keypath [String] the path to USB key for storing private keys
+  #
+  def keydir keypath
+
+    if( File.exists?( keypath ) && !(File.directory? keypath) )
+      abort "The path cannot be a file => #{keypath}"
+    end
+    
+    FileUtils.mkdir_p keypath unless File.exists? keypath
+
+    secret_session = OpenSession::Session.new
+    secret_session.write_keyvalue "opensecret", "key_folder", keypath
+    session_file = secret_session.get_filepath "opensecret"
+
+    puts ""
+    puts "private key directory  => [ #{keypath} ]"
+    puts "session configuration  => [ #{session_file} ]"
+    puts "session time stamp is  => [ #{OpenSession::Stamp.yyjjj_hhmm_sst} ]"
+    puts ""
+
+  end
 
   #
   # Initialize (configure) two fundamental crypt pointers
@@ -38,15 +81,15 @@ class CommandProcessor < Thor
   # @param domain [String] the DOMAIN eg lecturers@harvard for your family or work group.
   # @param store_url [String] the STORE_URL for connecting to the backend storage service
   #
-  def init domain, store_url
+# --->  def init domain, store_url
 
-    OpenSecret::Crypto.register_domain domain, store_url
+# --->    OpenSecret::Crypto.register_domain domain, store_url
 
-    puts ""
-    puts "New domain configured  => [ #{domain} ]"
-    puts "Crypt store configured => [ #{store_url} ]"
-    puts ""
+# --->    puts ""
+# --->    puts "New domain configured  => [ #{domain} ]"
+# --->    puts "Crypt store configured => [ #{store_url} ]"
+# --->    puts ""
 
-  end
+# --->  end
 
 end

data/lib/session/session.rb

@@ -0,0 +1,219 @@
+#!/usr/bin/ruby
+# coding: utf-8
+
+# opensession contains basic behaviour for managing a client only
+# (serverless) session. Configuration directives are read and written
+# from an INI off the home directory that is created when the session
+# is first initiated.
+#
+# The session is expected to be formally closed down and that is
+# reflected by explicitly deleting the configuration file. If this
+# "session over" command is not issued a reasonable time limit is
+# then invoked when the next session command is issued.
+#
+# This "session awakening" wipes the slate clean and starts afresh
+# with regard to the two dimensional array of configuration directive
+# pointers.
+module OpenSession
+
+  require 'inifile'
+
+
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+ ## ---> Cleaning User Input - Use Me
+
+
+  def generate_username(fullname)
+    ActiveSupport::Inflector.transliterate(fullname) # change ñ => n
+      .downcase              # only lower case
+      .strip                 # remove spaces around the string
+      .gsub(/[^a-z]/, '_')   # any character that is not a letter or a number will be _
+      .gsub(/\A_+/, '')      # remove underscores at the beginning
+      .gsub(/_+\Z/, '')      # remove underscores at the end
+      .gsub(/_+/, '_')       # maximum an underscore in a row
+  end
+
+
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+ ## ---> Cleaning User Input - Did You Use Me?
+
+
+  # opensession contains basic behaviour for managing a client only
+  # (serverless) session. Configuration directives are read and written
+  # from an INI off the home directory that is created when the session
+  # is first initiated.
+  #
+  # The session is expected to be formally closed down and that is
+  # reflected by explicitly deleting the configuration file. If this
+  # "session over" command is not issued a reasonable time limit is
+  # then invoked when the next session command is issued.
+  #
+  # This "session awakening" wipes the slate clean and starts afresh
+  # with regard to the two dimensional array of configuration directive
+  # pointers.
+  class Session
+
+
+    @@filename_tail = "-session.ini"
+    attr_reader :time_stamp
+
+
+    # This singleton (one instance) class initializes by getting
+    # the current timestamp.
+    def initialize
+
+      @time_stamp = OpenSession::Stamp.instance
+
+    end
+
+
+    #
+    # Write the key/value pair in the parameter into the session's
+    # configuration INI file that lives in a context-named folder
+    # off the home directory.
+    #
+    # The session file will be in a folder whose name is simply
+    # the dot prefixed context_name. The session file itself will
+    # be named using context_name + @@filename_tail
+    #
+    # @example ~/.openbox/openbox-session.ini is the filepath for context "openbox"
+    #
+    # If neither the folder nor file exist, both are created.
+    # If the file did not exist a new one will with the contents
+    # (if the key is length and the value is 2m).
+    #
+    # [openbox]
+    # length = 2m
+    #
+    # If the file does already exist, an appropriate merge will be
+    # performed to create or update the section name, key name and
+    # value. The file may end up looking like
+    #
+    # [closedbox]
+    # shape = cuboid
+    # color = blue
+    #
+    # [openbox]
+    # length = 2m
+    # width = 3m
+    #
+    # @param context_name [String] name of program writing a session attribute
+    # @param key [String] the key name of config directive to be written into the file
+    # @param value [String] value of the config directive to be written into the file
+    #
+    def write_keyvalue context_name, key, value
+
+      config_file_dir = get_filedir(context_name)
+      FileUtils.mkdir_p config_file_dir unless File.exists? config_file_dir
+      config_filepath = get_filepath(context_name)
+
+      config_map = IniFile.new( :filename => config_filepath, :encoding => 'UTF-8' )
+      config_map = IniFile.load( config_filepath ) if File.exists? config_filepath
+
+      config_map[context_name][key] = value
+      config_map.write
+
+    end
+
+
+    #
+    # Get the path to the session context file.
+    # This file will be in a folder whose name is simply the dot
+    # prefixed context_name. The session context file itself will
+    # be named using context_name + @@filename_tail
+    #
+    # @example ~/.openbox/openbox-session.ini is the filepath for context "openbox"
+    #
+    # @param context_name [String] name of program writing a session attribute
+    #
+    def get_filepath context_name
+
+      return File.join( get_filedir(context_name), "#{context_name}#{@@filename_tail}" )
+
+    end
+
+
+    #
+    # Get the directory that the session context file either does
+    # or will sit inside.
+    #
+    # The directory hangs off the home directory and is named simply
+    # as the dot prefixed context_name.
+    #
+    # @example ~/.openbox is the directory for context "openbox"
+    #
+    # @param context_name [String] name of program (or use case) context
+    #
+    def get_filedir context_name
+
+      return File.join home_directory, ".#{context_name}"
+
+    end
+
+
+    #
+    # On non-windows systems the home directory is defined
+    # perfectly by Ruby's Dir object.
+    #
+    # On Windows we sometimes get /AppData/Roaming appended
+    # onto the actual home directory. In these cases this
+    # method removes it.
+    #
+    def home_directory
+
+      return Dir.home unless Gem.win_platform?
+
+      extraneous_path = "/AppData/Roaming"
+      if Dir.home.end_with? extraneous_path then
+        return Dir.home.gsub( extraneous_path, "" )
+      end
+
+      return Dir.home
+
+    end
+
+
+    #
+    # Get the username of the logged in user. This name should
+    # not contain spaces (and should be just alphanumeric).
+    #
+    # The current implementation uses environment variables and
+    # crudely states that the username is
+    #
+    # - ENV['USERNAME'] for the Windows platform
+    # - ENV['USER'] for Linux (and everything else)
+    #
+    def username
+
+      return ENV['USERNAME'] if Gem.win_platform?
+      return ENV['USER']
+
+    end
+
+
+  end
+
+
+end

data/lib/session/time.stamp.rb

@@ -0,0 +1,384 @@
+#!/usr/bin/ruby
+
+module OpenSession
+
+  require 'singleton'
+
+  #
+  # This stamp sits at the centre of a fundamental DevOps pattern concerned
+  # with infrastructure provisioning and configuraion management.
+  #
+  # The central idea behind the pattern is to link every infrastructure
+  # object created for an eco-system with an embedded reference that
+  # contains time stamps that are accurate to the nearest
+  #
+  # - month
+  # - day
+  # - hour of day
+  # - minute
+  # - second
+  # - tenth of second
+  # - hundredth of second
+  # - thousandth of second
+  #
+  # Which newly created or updated infrastructure objects are stamped?
+  #
+  # - files and folders
+  # - database user names
+  # - Docker containers
+  # - virtual machines
+  # - s3 buckets and their contents
+  # - aws ec2 machines
+  # - aws acl lists
+  # - hostnames and urls
+  #
+  class Stamp
+    include Singleton
+
+    attr_reader :time_now
+
+    #
+    # Return two digit [mo] month index from 01 to 12.
+    # @example 02 => in February
+    #
+    def self.mo
+      return Stamp.instance.time_now.strftime "%m"
+    end
+
+
+    #
+    # Return three character abbreviated month name.
+    # @example feb => in February
+    #
+    def self.mmm
+      return Stamp.instance.time_now.strftime( "%b" ).downcase
+    end
+
+
+    #
+    # Return three character abbreviated day of week.
+    # @example tue => on Tuesday
+    #
+    def self.ddd
+      return Stamp.instance.time_now.strftime( "%a" ).downcase
+    end
+
+
+    #
+    # Return two digit (character) hour of day from 00 to 23.
+    # @example 22 => between 22.00.00 and 22.59.59 inclusive
+    #
+    def self.hh
+      return Stamp.instance.time_now.strftime "%H"
+    end
+
+
+    #
+    # Return two digit minute of hour from [00] to [59].
+    #
+    def self.mm
+      return Stamp.instance.time_now.strftime "%M"
+    end
+
+
+    #
+    # Return two digit second of minute from [00] to [59].
+    #
+    def self.ss
+      return Stamp.instance.time_now.strftime "%S"
+    end
+
+
+    #
+    # Return a [3 digit] second and tenth of second
+    # representation.
+    #
+    # The final digit is derived from the 1000 sliced
+    # millisecond of second running from 000 to 999.
+    #
+    # ---------------------------
+    # Truncation (Not Rounding)
+    # ---------------------------
+    #
+    # The [final] digit is acquired by TRUNCATING
+    # (chopping off) the last 2 of the 3 millisecond
+    # digits. No rounding is applied.
+    #
+    # The 3 returned digits comprise of the
+    #
+    #  - second of minute => 2 digits | [00] to [59] (and)
+    #  - tenth of second  => 1 digit from [0] to [9]
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => The time at the 562nd millisecond  of the 49th
+    #     second of the minute.
+    #
+    #  => 3 chars
+    #  => 495
+    #
+    #
+    def self.sst
+      millisec_string = Stamp.instance.time_now.strftime "%L"
+      return "#{ss}#{millisec_string[0]}"
+    end
+
+
+    #
+    # Return the [two] digit year (eg 19 for 2019).
+    # that we are currently in.
+    #
+    def self.yy
+      return Stamp.instance.time_now.strftime("%Y")[2..-1]
+    end
+
+
+    #
+    # Return the [four] digit year (eg 2019)
+    # that we are currently in.
+    #
+    def self.yyyy
+      return Stamp.instance.time_now.strftime("%Y")
+    end
+
+
+    # ------------------------------------------------- -- #
+    # Return 3 digit julian day of year [001] to [366]. -- #
+    # ------------------------------------------------- -- #
+    def self.jjj
+      return Stamp.instance.time_now.strftime "%j"
+    end
+
+
+    #
+    # [yymo_mmm] returns an amalgam of
+    #
+    #    => the two-digit year
+    #    => the two-digit month index (starting at 01)
+    #    => a period (separator)
+    #    => the abbreviated month name
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => 1908.aug
+    #  => for August 2019
+    #
+    def self.yymo_mmm
+      return "#{yy}#{mo}.#{mmm}"
+    end
+
+
+    #
+    # Given two integer parameters (month index and 4 digit year) representing
+    # the month in question this method returns the [PREVIOUS MONTHS] character
+    # amalgam in the format [yymo_mmm] where
+    #
+    #    => yy  | previous month's two-digit year
+    #    => mo  | previous month's two-digit month index
+    #    => .   | a period (separator)
+    #    => mmm | previous month's abbreviated month name
+    #
+    # -------------------
+    # Example 1 (Simple)
+    # -------------------
+    #
+    #  returns char => 1907.jul
+    #  4 parameters => 8, 2019
+    #  representing => August, 2019
+    #
+    # ----------------------
+    # Example 2 (Last Year)
+    # ----------------------
+    #
+    #  returns char => 1812.dec
+    #  4 parameters => 1, 2019
+    #  representing => January, 2019
+    #
+    def self.previous_month_chars this_month_index, this_4digit_year
+
+      prev_month_index = this_month_index == 1 ? 12 : ( this_month_index - 1 )
+      prev_2dig_mn_pad = sprintf '%02d', prev_month_index
+      prev_4digit_year = this_month_index == 1 ? ( this_4digit_year - 1 ) : this_4digit_year
+      prev_twodigit_yr = "#{prev_4digit_year.to_s}"[2..-1]
+      prev_months_name = Date::ABBR_MONTHNAMES[prev_month_index].downcase
+
+      return "#{prev_twodigit_yr}#{prev_2dig_mn_pad}.#{prev_months_name}"
+
+    end
+
+    #
+    # Using the current class time this method returns
+    # the character amalgam for the [PREVIOUS MONTH] in
+    # the format [yymo_mmm] where
+    #
+    #    => yy  | last month's two-digit year
+    #    => mo  | last month's two-digit month index
+    #    => .   | a period (separator)
+    #    => mmm | last month's abbreviated month name
+    #
+    # -------------------
+    # Example 1 (Simple)
+    # -------------------
+    #
+    #  returns => 1907.jul
+    #  if this month is => August 2019
+    #
+    # ----------------------
+    # Example 2 (Last Year)
+    # ----------------------
+    #
+    #  returns => 1812.dec
+    #  if this month is => January 2019
+    #
+    def self.yymo_mmm_prev
+      return previous_month_chars mo.to_i, yyyy.to_i
+    end
+
+
+    # ---------------------------------------------- -- #
+    # Return 5 digit amalgam of year and julian day. -- #
+    #  eg [19003] for [January 3rd 2019]             -- #
+    # ---------------------------------------------- -- #
+    def self.yyjjj
+      return "#{yy}#{jjj}"
+    end
+
+
+    #
+    # Return the 4 digit amalgam of the hour and minute
+    # using the 24 hour clock.
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => 1525
+    #  => 03:25 pm
+    #
+    def self.hhmm
+      return "#{hh}#{mm}"
+    end
+
+
+    #
+    # Return the time of day to a TENTH of a second accuracy.
+    # [8] characters will always be returned with the 5th one
+    # being the (period) separator.
+    #
+    # The first (separated) segment delivers a hhmm 24 hour
+    # clock representation of the stamped time.
+    #
+    # The 3 digits of the second segment comprise of
+    #
+    #   second of minute => 2 digits | [00] to [59]
+    #   tenth of second  => 1 digit from [0] to [9]
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => The time at the 562nd millisecond  of the 49th
+    #     second of the 23rd minute of the 17th hour of
+    #     the day ( 17:23:49.562 )
+    #
+    #  => 8 chars
+    #  => 1723.495
+    #
+    def self.hhmm_sst
+      return "#{hhmm}.#{sst}"
+    end
+
+
+    #
+    # Return a period separated amalgam of the
+    #
+    #  => 2 digit year and 3 digit julian day
+    #  => 4 digit hour/minute
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => 19003.1025
+    #  => 10:25 am on January 3rd 2019
+    #
+    #
+    # Return the time of day to a TENTH of a second accuracy.
+    # [8] characters will always be returned with the 5th one
+    # being the (period) separator.
+    #
+    # The first (separated) segment delivers a hhmm 24 hour
+    # clock representation of the stamped time.
+    #
+    # The 3 digits of the second segment comprise of
+    #
+    #   second of minute => 2 digits | [00] to [59]
+    #   tenth of second  => 1 digit from [0] to [9]
+    #
+    # ---------
+    # Example
+    # ---------
+    #  => The time at the 562nd millisecond  of the 49th
+    #     second of the 23rd minute of the 17th hour of
+    #     the day ( 17:23:49.562 )
+    #
+    #  => 8 chars
+    #  => 1723.495
+    #
+    def self.yyjjj_hhmm_sst
+      return "#{yyjjj}.#{hhmm}.#{sst}"
+    end
+
+
+    # ----------------------------------------- -- #
+    # Return the Rubyfied time zone being used. -- #
+    # ----------------------------------------- -- #
+    def self.zone
+      return Stamp.instance.time_now.zone
+    end
+
+
+    # -------------------------------------------------- -- #
+    # Log segments of time pertaining to the time stamp. -- #
+    # -------------------------------------------------- -- #
+    def self.log_instance_time
+
+      log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
+      log.info(ere) { "[stamp] eco time stamp => [#{Stamp.instance.time_now.ctime}]" }
+      log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
+      log.info(ere) { "[stamp] Univ Time Zone => #{zone}"  }
+      log.info(ere) { "[stamp] Month Index is => #{mo}"    }
+      log.info(ere) { "[stamp] Month Name is  => #{mmm}"   }
+      log.info(ere) { "[stamp] Day Of Week is => #{ddd}"   }
+      log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
+      log.info(ere) { "[stamp] Two Digit Year => #{yy}"    }
+      log.info(ere) { "[stamp] Julian Cal Day => #{jjj}"   }
+      log.info(ere) { "[stamp] Yr and Jul Day => #{yyjjj}" }
+      log.info(ere) { "[stamp] Hour of Theday => #{hh}"    }
+      log.info(ere) { "[stamp] Minute of Hour => #{mm}"    }
+      log.info(ere) { "[stamp] Hour + Minute  => #{hhmm}"  }
+      log.info(ere) { "[stamp] Second of Min  => #{ss}"    }
+      log.info(ere) { "[stamp] 600 Min Slices => #{sst}"   }
+      log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
+      log.info(ere) { "[stamp] The Time Stamp => #{yyjjj_hhmm_sst}" }
+      log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
+
+    end
+
+
+    # ------------------------------------------------------------ -- #
+    # This singleton (one instance) class sets the time just once. -- #
+    # ------------------------------------------------------------ -- #
+    def initialize
+
+      @time_now = Time.now;
+
+    end
+
+
+############    Stamp.log_instance_time
+
+
+  end
+
+
+end

data/lib/{opensecret/version.rb → version.rb}

@@ -1,3 +1,3 @@
 module OpenSecret
-  VERSION = "0.0.8"
+  VERSION = "0.0.913"
 end

data/opensecret.gemspec

@@ -1,8 +1,7 @@
 lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
-require 'opensecret/version'
-require 'opensecret/delegate'
+require 'version'
 
 Gem::Specification.new do |spec|
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opensecret
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.913
 platform: ruby
 authors:
 - Apollo Akora
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-10 00:00:00.000000000 Z
+date: 2018-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inifile
@@ -108,7 +108,6 @@ files:
 - lib/opensecret/commons/eco.faculty.rb
 - lib/opensecret/commons/eco.system.rb
 - lib/opensecret/commons/eco.systems.rb
-- lib/opensecret/delegate.rb
 - lib/opensecret/eco.do.rb
 - lib/opensecret/executors/crypt.keys/crypt.keys.ini
 - lib/opensecret/executors/crypt.keys/crypt.keys.rb
@@ -135,8 +134,9 @@ files:
 - lib/opensecret/plugins.io/git/git.flow.rb
 - lib/opensecret/plugins.io/logs/log.object.rb
 - lib/opensecret/plugins.io/logs/logging.rb
-- lib/opensecret/plugins.io/time/time.stamp.rb
-- lib/opensecret/version.rb
+- lib/session/session.rb
+- lib/session/time.stamp.rb
+- lib/version.rb
 - opensecret.gemspec
 homepage: https://www.eco-platform.co.uk
 licenses:

data/lib/opensecret/delegate.rb

@@ -1,20 +0,0 @@
-
-module OpenSecret
-
-  class Delegate
-
-    def command
-
-      return "hello world"
-
-      time = Time.now
-      minute = time.min
-      hour = time.hour % 12
-      meridian_indicator = time.hour < 12 ? 'AM' : 'PM'
-      "You locked me at #{minute} minutes past #{hour} o'clock, #{meridian_indicator}"
-
-    end
-
-  end
-
-end

data/lib/opensecret/plugins.io/time/time.stamp.rb

@@ -1,425 +0,0 @@
-#!/usr/bin/ruby
-
-# -- ----------------------------------------------------------------- -- #
-# -- the eco stamp                                                       -- #
-# -- ----------------------------------------------------------          -- #
-# --                                                                     -- #
-# -- The eco-system stamp is at the centre of a fundamental iaas pattern. -- #
-# -- known as the "infrastructure provisioning reference pattern (iprp)". -- #
-# -- The central idea behind the pattern is to link every infrastructure -- #
-# -- object created for an eco-system with an embedded reference that -- #
-# -- contains a "minute accurate" time.                                  -- #
-# --                                                                     -- #
-# -- ----------------------------------------------------------          -- #
-# -- which infrastructure [objects] are eco-stamped?                       -- #
-# -- ----------------------------------------------------------          -- #
-# -- eco-system stamps are used when referencing provisioned            -- #
-# --   - files and folders                                            -- #
-# --   - database user names                                            -- #
-# --   - Docker containers                                            -- #
-# --   - virtual machines                                            -- #
-# --   - s3 buckets and their contents                                  -- #
-# --   - aws ec2 machines                                              -- #
-# --   - aws acl lists                                              -- #
-# --   - hostnames and urls                                              -- #
-# --
-# -- --------------------------
-# -- the eco-stamp [segments]
-# -- --------------------------
-# --
-# -- Typical eco-system stamps comprise of a few of the [segments] that
-# -- are listed below. Periods (and at times underscores) are used to
-# -- delineate each segment.
-# --
-# --   | mo       | months index      | from 01 to 12   | 2 |
-# --   | mmm      | abbrv month name  | eg feb          | 3 |
-# --   | ddd      | abbrv day of week | eg tue          | 3 |
-# --   | yy       | two digit year    | eg 19 for 2019  | 2 |
-# --   | jjj      | julian day        | from 001 to 366 | 3 |
-# --   | hh       | hour of day       | from 001 to 366 | 2 |
-# --   | mm       | minute of hour    | from 00 to 59   | 2 |
-# --
-# -- -----------------------------------
-# -- eco-stamp [prefix] and [postfix]
-# -- -----------------------------------
-# --
-# -- eco stamps are not just about time. Yes time is at the core but
-# -- the eco reference will usually be pre or post-fixed with
-# --
-# --    - an eco plugin descriptor
-# --    - a repository [revision]
-# --    - the executors [username]
-# --    - the machine's [hostname]
-# --    - middleware service name
-# --
-class Stamp
-  include Singleton
-
-  attr_reader :time_now
-
-  # --
-  # -- Return two digit [mo] month index from [01] to [12].
-  # --
-  def self.mo
-    return Stamp.instance.time_now.strftime "%m"
-  end
-
-
-  # -- ------------------------------------------------------- -- #
-  # -- Return three character abbreviated month name (eg feb). -- #
-  # -- ------------------------------------------------------- -- #
-  def self.mmm
-    return Stamp.instance.time_now.strftime( "%b" ).downcase
-  end
-
-
-  # -- -------------------------------------------------------- -- #
-  # -- Return three character abbreviated day of week (eg wed). -- #
-  # -- -------------------------------------------------------- -- #
-  def self.ddd
-    return Stamp.instance.time_now.strftime( "%a" ).downcase
-  end
-
-
-  # --
-  # -- Return two digit hour of day from [00] to [23].
-  # --
-  def self.hh
-    return Stamp.instance.time_now.strftime "%H"
-  end
-
-
-  # --
-  # -- Return two digit minute of hour from [00] to [59].
-  # --
-  def self.mm
-    return Stamp.instance.time_now.strftime "%M"
-  end
-
-
-  # --
-  # -- Return two digit second of minute from [00] to [59].
-  # --
-  def self.ss
-    return Stamp.instance.time_now.strftime "%S"
-  end
-
-
-  # --
-  # -- Return a [3 digit] second and tenth of second
-  # -- representation.
-  # --
-  # -- The final digit is derived from the 1000 sliced
-  # -- millisecond of second running from 000 to 999.
-  # --
-  # -- ---------------------------
-  # -- Truncation (Not Rounding)
-  # -- ---------------------------
-  # --
-  # -- The [final] digit is acquired by TRUNCATING
-  # -- (chopping off) the last 2 of the 3 millisecond
-  # -- digits. No rounding is applied.
-  # --
-  # -- The 3 returned digits comprise of the
-  # --
-  # --  - second of minute => 2 digits | [00] to [59] (and)
-  # --  - tenth of second  => 1 digit from [0] to [9]
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => The time at the 562nd millisecond  of the 49th
-  # --     second of the minute.
-  # --
-  # --  => 3 chars
-  # --  => 495
-  # --
-  # --
-  def self.sst
-    millisec_string = Stamp.instance.time_now.strftime "%L"
-    return "#{ss}#{millisec_string[0]}"
-  end
-
-
-  # --
-  # -- Return the [two] digit year (eg 19 for 2019).
-  # -- that we are currently in.
-  # --
-  def self.yy
-    return Stamp.instance.time_now.strftime("%Y")[2..-1]
-  end
-
-
-  # --
-  # -- Return the [four] digit year (eg 2019)
-  # -- that we are currently in.
-  # --
-  def self.yyyy
-    return Stamp.instance.time_now.strftime("%Y")
-  end
-
-
-  # -- ------------------------------------------------- -- #
-  # -- Return 3 digit julian day of year [001] to [366]. -- #
-  # -- ------------------------------------------------- -- #
-  def self.jjj
-    return Stamp.instance.time_now.strftime "%j"
-  end
-
-
-  # --
-  # -- [yymo_mmm] returns an amalgam of
-  # --
-  # --    => the two-digit year
-  # --    => the two-digit month index (starting at 01)
-  # --    => a period (separator)
-  # --    => the abbreviated month name
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => 1908.aug
-  # --  => for August 2019
-  # --
-  def self.yymo_mmm
-    return "#{yy}#{mo}.#{mmm}"
-  end
-
-
-  # --
-  # -- Given two integer parameters (month index and 4 digit year) representing
-  # -- the month in question this method returns the [PREVIOUS MONTHS] character
-  # -- amalgam in the format [yymo_mmm] where
-  # --
-  # --    => yy  | previous month's two-digit year
-  # --    => mo  | previous month's two-digit month index
-  # --    => .   | a period (separator)
-  # --    => mmm | previous month's abbreviated month name
-  # --
-  # -- -------------------
-  # -- Example 1 (Simple)
-  # -- -------------------
-  # --
-  # --  returns char => 1907.jul
-  # --  4 parameters => 8, 2019
-  # --  representing => August, 2019
-  # --
-  # -- ----------------------
-  # -- Example 2 (Last Year)
-  # -- ----------------------
-  # --
-  # --  returns char => 1812.dec
-  # --  4 parameters => 1, 2019
-  # --  representing => January, 2019
-  # --
-  def self.previous_month_chars this_month_index, this_4digit_year
-
-    prev_month_index = this_month_index == 1 ? 12 : ( this_month_index - 1 )
-    prev_2dig_mn_pad = sprintf '%02d', prev_month_index
-    prev_4digit_year = this_month_index == 1 ? ( this_4digit_year - 1 ) : this_4digit_year
-    prev_twodigit_yr = "#{prev_4digit_year.to_s}"[2..-1]
-    prev_months_name = Date::ABBR_MONTHNAMES[prev_month_index].downcase
-
-    return "#{prev_twodigit_yr}#{prev_2dig_mn_pad}.#{prev_months_name}"
-
-  end
-
-  # --
-  # -- Using the current class time this method returns
-  # -- the character amalgam for the [PREVIOUS MONTH] in
-  # -- the format [yymo_mmm] where
-  # --
-  # --    => yy  | last month's two-digit year
-  # --    => mo  | last month's two-digit month index
-  # --    => .   | a period (separator)
-  # --    => mmm | last month's abbreviated month name
-  # --
-  # -- -------------------
-  # -- Example 1 (Simple)
-  # -- -------------------
-  # --
-  # --  returns => 1907.jul
-  # --  if this month is => August 2019
-  # --
-  # -- ----------------------
-  # -- Example 2 (Last Year)
-  # -- ----------------------
-  # --
-  # --  returns => 1812.dec
-  # --  if this month is => January 2019
-  # --
-  def self.yymo_mmm_prev
-    return previous_month_chars mo.to_i, yyyy.to_i
-  end
-
-
-  # -- ---------------------------------------------- -- #
-  # -- Return 5 digit amalgam of year and julian day. -- #
-  # --  eg [19003] for [January 3rd 2019]             -- #
-  # -- ---------------------------------------------- -- #
-  def self.yyjjj
-    return "#{yy}#{jjj}"
-  end
-
-
-  # --
-  # -- Return the 4 digit amalgam of the hour and minute
-  # -- using the 24 hour clock.
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => 1525
-  # --  => 03:25 pm
-  # --
-  def self.hhmm
-    return "#{hh}#{mm}"
-  end
-
-
-  # --
-  # -- Return the time of day to a TENTH of a second accuracy.
-  # -- [8] characters will always be returned with the 5th one
-  # -- being the (period) separator.
-  # --
-  # -- The first (separated) segment delivers a hhmm 24 hour
-  # -- clock representation of the stamped time.
-  # --
-  # -- The 3 digits of the second segment comprise of
-  # --
-  # --   second of minute => 2 digits | [00] to [59]
-  # --   tenth of second  => 1 digit from [0] to [9]
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => The time at the 562nd millisecond  of the 49th
-  # --     second of the 23rd minute of the 17th hour of
-  # --     the day ( 17:23:49.562 )
-  # --
-  # --  => 8 chars
-  # --  => 1723.495
-  # --
-  def self.hhmm_sst
-    return "#{hhmm}.#{sst}"
-  end
-
-
-  # --
-  # -- Return a period separated amalgam of the
-  # --
-  # --  => 2 digit year and 3 digit julian day
-  # --  => 4 digit hour/minute
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => 19003.1025
-  # --  => 10:25 am on January 3rd 2019
-  # --
-  # --
-  # -- Return the time of day to a TENTH of a second accuracy.
-  # -- [8] characters will always be returned with the 5th one
-  # -- being the (period) separator.
-  # --
-  # -- The first (separated) segment delivers a hhmm 24 hour
-  # -- clock representation of the stamped time.
-  # --
-  # -- The 3 digits of the second segment comprise of
-  # --
-  # --   second of minute => 2 digits | [00] to [59]
-  # --   tenth of second  => 1 digit from [0] to [9]
-  # --
-  # -- ---------
-  # -- Example
-  # -- ---------
-  # --  => The time at the 562nd millisecond  of the 49th
-  # --     second of the 23rd minute of the 17th hour of
-  # --     the day ( 17:23:49.562 )
-  # --
-  # --  => 8 chars
-  # --  => 1723.495
-  # --
-  def self.yyjjj_hhmm_sst
-    return "#{yyjjj}.#{hhmm}.#{sst}"
-  end
-
-
-  # -- ----------------------------------------- -- #
-  # -- Return the Rubyfied time zone being used. -- #
-  # -- ----------------------------------------- -- #
-  def self.zone
-    return Stamp.instance.time_now.zone
-  end
-
-
-  # -- -------------------------------------------------- -- #
-  # -- Log segments of time pertaining to the time stamp. -- #
-  # -- -------------------------------------------------- -- #
-  def self.log_instance_time
-
-    log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
-    log.info(ere) { "[stamp] eco time stamp => [#{Stamp.instance.time_now.ctime}]" }
-    log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
-    log.info(ere) { "[stamp] Univ Time Zone => #{zone}"  }
-    log.info(ere) { "[stamp] Month Index is => #{mo}"    }
-    log.info(ere) { "[stamp] Month Name is  => #{mmm}"   }
-    log.info(ere) { "[stamp] Day Of Week is => #{ddd}"   }
-    log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
-    log.info(ere) { "[stamp] Two Digit Year => #{yy}"    }
-    log.info(ere) { "[stamp] Julian Cal Day => #{jjj}"   }
-    log.info(ere) { "[stamp] Yr and Jul Day => #{yyjjj}" }
-    log.info(ere) { "[stamp] Hour of Theday => #{hh}"    }
-    log.info(ere) { "[stamp] Minute of Hour => #{mm}"    }
-    log.info(ere) { "[stamp] Hour + Minute  => #{hhmm}"  }
-    log.info(ere) { "[stamp] Second of Min  => #{ss}"    }
-    log.info(ere) { "[stamp] 600 Min Slices => #{sst}"   }
-    log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
-    log.info(ere) { "[stamp] The Time Stamp => #{yyjjj_hhmm_sst}" }
-    log.info(ere) { "[stamp] -------------- => -------------------------------- #" }
-
-  end
-
-
-  # -- ------------------------------------------------------------ -- #
-  # -- This singleton (one instance) class sets the time just once. -- #
-  # -- ------------------------------------------------------------ -- #
-  def initialize
-
-    @time_now = Time.now;
-
-  end
-
-
-  # --
-  # -- This method tests the previous month behaviour.
-  # -- Simply set the year index to the desired integer and roll.
-  # --
-  # -- Example Call
-  # --
-  # --   Stamp.test_previous_month 2015
-  # --
-  def self.test_previous_month year_index
-
-    month_index = 1
-
-    log.info(ere) { "This Month Char Amalgam => #{yymo_mmm}" }
-    log.info(ere) { "Prev Month Char Amalgam => #{yymo_mmm_prev}" }
-
-    until month_index == 13  do
-      prev_month_chars = Stamp.previous_month_chars month_index, year_index
-      log.info(ere) { "Char Amalgam | #{prev_month_chars} => month #{month_index} | year #{year_index}" }
-      month_index +=1
-    end
-
-  end
-
-
-  # -- -------------------------------------------------------------------- -- #
-  # -- [Cold Call Pattern] - If class has no [internal] dependencies it can -- #
-  # --                       initialize itself ignoring any require [order] -- #
-  # -- -------------------------------------------------------------------- -- #
-  Stamp.log_instance_time
-  Stamp.test_previous_month yyyy.to_i
-
-end