safedb 0.5.1005 → 0.7.1001

data/lib/utils/time/timestamp.rb

@@ -107,6 +107,15 @@ module SafeDb
     end
 
 
+    #
+    # Return the [one] digit year (eg 9 for 2019).
+    # that we are currently in.
+    #
+    def self.y
+      return TimeStamp.instance.time_now.strftime("%Y")[3..-1]
+    end
+
+
     #
     # Return the [four] digit year (eg 2019)
     # that we are currently in.
@@ -214,6 +223,13 @@ module SafeDb
     end
 
 
+    # Return 4 digit amalgam of year and julian day.
+    #  eg [9003] for [January 3rd 2019]
+    def self.yjjj
+      return "#{y}#{jjj}"
+    end
+
+
     # Return the 4 digit amalgam of the hour and minute
     # using the 24 hour clock.
     #
@@ -282,6 +298,81 @@ module SafeDb
     end
 
 
+    # Return the time of day to a TENTH of a second accuracy
+    # via a string timestamp with zero separation.
+    #
+    # The timestampt returned is an amalgam of
+    #
+    # - a 2 digit year
+    # - a 3 digit julian day
+    # - a 2 digit hourn
+    # - a 2 digit minute
+    # - a 2 digit second and finally
+    # - a 1 digit (rounded down) tenth of a second
+    #
+    # 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.yyjjjhhmmsst
+      return "#{yyjjj}#{hhmm}#{sst}"
+    end
+
+
+    # Return the time of day to a TENTH of a second accuracy
+    # via a string timestamp with zero separation.
+    #
+    # The timestampt returned is an amalgam of
+    #
+    # - a 1 digit year
+    # - a 3 digit julian day
+    # - a 2 digit hourn
+    # - a 2 digit minute
+    # - a 2 digit second and finally
+    # - a 1 digit (rounded down) tenth of a second
+    #
+    # 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 ( 72349562 )
+    #
+    #   => 8 chars
+    #   => 1723.495
+    #
+    def self.yjjjhhmmsst
+      return "#{yjjj}#{hhmm}#{sst}"
+    end
+
+
+    # Return the time of day to a single minute accuracy
+    # via a string timestamp with zero separation.
+    #
+    # The timestampt returned is an amalgam of
+    #
+    # - a 2 digit year
+    # - a 3 digit julian day
+    # - a 2 digit hourn
+    # - a 2 digit minute
+    #
+    def self.yyjjjhhmm
+      return "#{yyjjj}#{hhmm}"
+    end
+
+
     # Return a string timestampt that is a period separated
     # amalgam of the 2 digit year, 3 digit julian day, 2 digit
     # hour, 2 digit minute, 2 digit second and <b>9 digit</b>

data/lib/version.rb

@@ -1,3 +1,3 @@
 module SafeDb
-  VERSION = "0.5.1005"
+  VERSION = "0.7.1001"
 end

data/safedb.gemspec

@@ -28,6 +28,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'bcrypt',  '~> 3.1'
   spec.add_dependency 'thor',    '~> 0.20'
   spec.add_dependency 'inifile', '~> 3.0'
+  spec.add_dependency 'octokit', '~> 4.14'
+  spec.add_dependency 'net-ssh', '~> 5.2'
 
   spec.add_development_dependency "bundler", "~> 0"
   spec.add_development_dependency "cucumber", "~> 2.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safedb
 version: !ruby/object:Gem::Version
-  version: 0.5.1005
+  version: 0.7.1001
 platform: ruby
 authors:
 - Apollo Akora
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-05 00:00:00.000000000 Z
+date: 2019-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bcrypt
@@ -52,6 +52,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.14'
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -127,24 +155,22 @@ files:
 - README.md
 - Rakefile
 - bin/safe
+- genius-decision.txt
 - lib/cli.rb
-- lib/controller/admin/README.md
-- lib/controller/admin/auth.rb
-- lib/controller/admin/commit.rb
-- lib/controller/admin/diff.rb
-- lib/controller/admin/export.rb
-- lib/controller/admin/goto.rb
-- lib/controller/admin/import.rb
-- lib/controller/admin/init.rb
-- lib/controller/admin/login.rb
-- lib/controller/admin/logout.rb
-- lib/controller/admin/open.rb
-- lib/controller/admin/refresh.rb
-- lib/controller/admin/token.rb
-- lib/controller/admin/use.rb
-- lib/controller/admin/view.rb
+- lib/controller/abstract/authenticate.rb
+- lib/controller/abstract/controller.rb
+- lib/controller/abstract/edit_verse.rb
+- lib/controller/abstract/query_verse.rb
+- lib/controller/access/README.md
+- lib/controller/access/banner.txt
+- lib/controller/access/init.rb
+- lib/controller/access/login.rb
+- lib/controller/access/logout.rb
+- lib/controller/access/token.rb
+- lib/controller/access/use.rb
 - lib/controller/api/docker/README.md
 - lib/controller/api/docker/docker.rb
+- lib/controller/api/git/git.rb
 - lib/controller/api/jenkins/README.md
 - lib/controller/api/jenkins/jenkins.rb
 - lib/controller/api/terraform/README.md
@@ -152,11 +178,21 @@ files:
 - lib/controller/api/vpn/README.md
 - lib/controller/api/vpn/vpn.ini
 - lib/controller/api/vpn/vpn.rb
+- lib/controller/book/commit.rb
+- lib/controller/book/diff.rb
+- lib/controller/book/export.rb
+- lib/controller/book/import.rb
+- lib/controller/book/refresh.rb
+- lib/controller/book/view.rb
 - lib/controller/config/README.md
-- lib/controller/controller.rb
+- lib/controller/db/model_git_service.rb
+- lib/controller/db/pull.rb
+- lib/controller/db/push.rb
+- lib/controller/db/remote.rb
 - lib/controller/edit/README.md
-- lib/controller/edit/editverse.rb
 - lib/controller/edit/generate.rb
+- lib/controller/edit/keys.rb
+- lib/controller/edit/paste.rb
 - lib/controller/edit/put.rb
 - lib/controller/edit/remove.rb
 - lib/controller/edit/rename.md
@@ -165,38 +201,44 @@ files:
 - lib/controller/files/read.rb
 - lib/controller/files/write.rb
 - lib/controller/id.rb
+- lib/controller/misc/wipe.rb
+- lib/controller/navigate/at.rb
+- lib/controller/navigate/goto.rb
+- lib/controller/navigate/open.rb
 - lib/controller/query/copy.rb
 - lib/controller/query/print.rb
-- lib/controller/query/queryverse.rb
 - lib/controller/query/show.rb
+- lib/controller/query/tell.rb
 - lib/controller/requirer.rb
 - lib/controller/set.rb
-- lib/controller/verse.rb
 - lib/controller/visit/README.md
 - lib/controller/visit/visit.rb
 - lib/factbase/facts.safedb.net.ini
 - lib/manual/copy-paste.md
+- lib/manual/crypto-math.md
 - lib/manual/dir-structure.md
 - lib/manual/drag-drop.md
 - lib/manual/login-logout.md
+- lib/manual/push-pull.md
+- lib/manual/remote.md
 - lib/model/README.md
 - lib/model/book.rb
 - lib/model/branch.rb
 - lib/model/checkin.feature
 - lib/model/configs.md
 - lib/model/content.rb
+- lib/model/coordinates.rb
+- lib/model/file_tree.rb
 - lib/model/indices.rb
-- lib/model/safe_tree.rb
-- lib/model/state.inspect.rb
-- lib/model/state.migrate.rb
+- lib/model/master.rb
+- lib/model/state_evolve.rb
+- lib/model/state_query.rb
 - lib/model/text_chunk.rb
-- lib/modules/README.md
-- lib/modules/cryptology/aes-256.rb
-- lib/modules/cryptology/blowfish.rb
-- lib/modules/cryptology/cipher.rb
-- lib/modules/cryptology/crypt.io.rb
-- lib/modules/storage/coldstore.rb
-- lib/modules/storage/git.store.rb
+- lib/plugin/github.rb
+- lib/utils/ciphers/aes-256.rb
+- lib/utils/ciphers/blowfish.rb
+- lib/utils/ciphers/cipher.rb
+- lib/utils/ciphers/crypt.io.rb
 - lib/utils/clipboard/clip.rb
 - lib/utils/extend/array.rb
 - lib/utils/extend/dir.rb
@@ -216,15 +258,16 @@ files:
 - lib/utils/key.pass.rb
 - lib/utils/keys/key.64.rb
 - lib/utils/keys/key.rb
+- lib/utils/keys/keypair.rb
 - lib/utils/keys/random.iv.rb
 - lib/utils/logs/logger.rb
 - lib/utils/store/datamap.rb
 - lib/utils/store/datastore.rb
+- lib/utils/store/github.rb
 - lib/utils/store/merge-boys-school.json
 - lib/utils/store/merge-girls-school.json
 - lib/utils/store/merge-merged-data.json
 - lib/utils/store/struct.rb
-- lib/utils/store/test-commands.sh
 - lib/utils/time/timestamp.rb
 - lib/version.rb
 - safedb.gemspec

data/lib/controller/verse.rb

@@ -1,20 +0,0 @@
-#!/usr/bin/ruby
-	
-module SafeDb
-
-  class Verse < Controller
-
-    def execute
-
-      return unless ops_key_exists?
-      master_db = get_master_database()
-      return if unopened_envelope?( master_db )
-      print master_db[ KEY_PATH ]
-
-    end
-
-
-  end
-
-
-end

data/lib/modules/storage/coldstore.rb

@@ -1,186 +0,0 @@
-#!/usr/bin/ruby
-# coding: utf-8
-
-module SafeDb
-
-  module Store
-
-    # Cold storage can sync repositories with a <b>bias during conflicts</b>
-    # either to the <em>remote repository</em> <b>when pulling</b>, and then
-    # conversely to the <em>local reposiory</em> <b>when pushing</b>.
-    #
-    # In between the sync operations a ColdStore can create, read, update and
-    # delete to and from the local mirror.
-    #
-    # == ColdStore | Use Cases
-    #
-    # Any <b>self-respecting coldstore</b> must, after initialization, provide
-    # some basic (and mandatory) behaviour.
-    #
-    # These include
-    #
-    # - <b>read</b> - reading text from a (possibly unavailable) frozen path
-    # - <b>write</b> - writing text (effectively freezing it) to a path
-    # - <b>pull</b> - sync with a <b>collision bias</b> that favours the remote mirror 
-    # - <b>push</b> - sync with a <b>collision bias</b> that favours the local mirror
-    #
-    # <b>Cold Storage</b> is borrowed from BitCoin and represents offline storage
-    # for keys and crypts. safe separates keys and crypts so that you can
-    # transfer and share secrets by moving keys (not the crypts).
-    #
-    # == Houses and Gold Bullion
-    #
-    # You don't carry houses or gold bullion around to rent, share or transfer
-    # their ownership.
-    #
-    # You copy keys to rent secrets and when the tenure is up (or you change your
-    # mind) you revoke access with a metaphorical lock change.
-    #
-    # safe embodies concepts like an owner who rents as opposed to a change
-    # in ownership.
-    #
-    # == trade secrets | commoditizing secrets
-    #
-    # safe is a conduit through which secrets can be bought and sold.
-    #
-    # It commoditizes secrets so that they can be owned, traded, leased and
-    # auctioned. Options to acquire or relinquish them at set prices can easily
-    # be taken out.
-    class ColdStore
-
-      # @param base_path [String]
-      #    path to the store's (mirror) base directory.
-      #    If the denoted directory does not exist an attempt will be made to
-      #    create it. If a file exists at this path an error will be thrown.
-      #
-      # @param domain [String]
-      #    the domain is an identifier (and namespace) denoting which safe
-      #    "account" is being accessed. safe allows the creation and use of
-      #    multiple domains.
-      def initialize local_path
-
-        @store_path = local_path
-        FileUtils.mkdir_p @store_path
-
-      end
-
-
-      # Read the file frozen (in this store mirror) at this path and
-      # return its contents.
-      #
-      # Coldstores are usually frozen offline (offmachine) so for this
-      # to work the {ColdStore.pull} behaviour must have executed to
-      # create a local store mirror. This method reads from that mirror.
-      #
-      # @param from_path [String]
-      #    read the file frozen at this path and return its contents
-      #    so that the defreeze process can begin.
-      #
-      #    This path is relative to the base of the store defined in
-      #    the constructor.
-      #
-      # @return [String]
-      #    return the text frozen in a file at the denoted local path
-      #
-      #    nil is reurned if no file can be found in the local mirror
-      #    at the configured path
-      #
-      # @raise [RuntimeError]
-      #    unless the path exists in this coldstore and that path is
-      #    a directory (as opposed to a file).
-      #
-      # @raise [ArgumentError]
-      #    if more than one file match is made at the path specified.
-      def read from_path
-
-        frozen_filepath = File.join @store_path, from_path
-        frozen_dir_path = File.dirname(frozen_filepath)
-
-        log.info(x) { "Coldstore will search in folder [#{frozen_dir_path.hr_path}]" }
-
-        exists_msg = "Directory #{frozen_dir_path} does not exist in store."
-        is_dir_msg = "Path #{frozen_dir_path} should be a directory (not a file)."
-        raise RuntimeError, exists_msg unless File.exists? frozen_dir_path
-        raise RuntimeError, is_dir_msg unless File.directory? frozen_dir_path
-
-        full_filepath = ""
-        file_matched = false
-
-        Dir.glob("#{frozen_dir_path}/**/*.os.txt").each do |matched_path|
-
-          log.info(x) { "Coldstore search with [#{from_path}] has matched [#{matched_path.hr_path}]" }
-          log.info(x) { "Ignore directory at [#{matched_path.hr_path}]." } if File.directory? matched_path
-          next if File.directory? matched_path
-
-          two_match_msg = "More than one file matched. The second is #{matched_path}."
-          raise ArgumentError, two_match_msg if file_matched
-          file_matched = true
-
-          full_filepath = matched_path
-
-        end
-
-        no_file_msg = "Coldstore could not find path [#{from_path}] from [#{@store_path}]."
-        raise RuntimeError, no_file_msg unless file_matched
-
-        log.info(x) { "Coldstore matched exactly one envelope at [#{full_filepath.hr_path}]." }
-        return File.read full_filepath
-
-      end
-
-
-      # Write (freeze) the text into a file at the denoted path. The
-      # folder path will be created if need be.
-      #
-      # Coldstores are usually frozen offline (offmachine) so after
-      # this method completes the {ColdStore.push} behaviour must be
-      # executed to synchronize the local coldstore freezer with the
-      # remote mirror.
-      #
-      # @param this_text [String]
-      #    this is the text that needs to be frozen into the local and
-      #    subsequently the remote coldstore freezer.
-      #
-      # @param to_path [String]
-      #    write the text (effectively freezing it) into the file at
-      #    this path. An attempt will be made to put down the necessary
-      #    directory structure.
-      #
-      #    This path is relative to the base of the store defined in
-      #    the constructor.
-      def write this_text, to_path
-
-        freeze_filepath = File.join @store_path, to_path
-
-        log.info(x) { "ColdStore freezing #{this_text.length} characters of worthless text."}
-        log.info(x) { "ColdStore freeze file path => #{freeze_filepath.hr_path}"}
-
-        FileUtils.mkdir_p(File.dirname(freeze_filepath))
-        File.write freeze_filepath, this_text
-
-      end
-
-
-      private
-
-      # @todo - write sync (with a local bias during conflicts)
-      #     The open up to the public (published) api.
-      def push
-
-
-      end
-
-      # @todo - write sync (with a rmote bias during conflicts)
-      #     The open up to the public (published) api.
-      def pull
-
-      end
-
-
-    end
-
-
-  end
-
-
-end

data/lib/utils/store/test-commands.sh

@@ -1,24 +0,0 @@
-
-
-First On Shell A
-########################
-
-safe init school
-safe login school
-
-
-safe open grounds football.pitch
-safe put size "250sq/m"
-safe put owner school
-safe read boys.school.json projects/safedb.net/lib/utils/store/merge-boys-school.json
-safe view
-
-safe import ~/projects/safedb.net/lib/utils/store/merge-boys-school.json
-safe show
-safe checkin
-
-
-
-Then On Shell B
-########################
-