startask 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ead4294333d7239733bbaec126396d45172f27bf7d8be258087e49d11b14ed48
+  data.tar.gz: 4c1944a82197e8a32389858b941e801b41048336b6eb3e3993fe7d0893ec12d8
+SHA512:
+  metadata.gz: 2c8efdc52ff696b70f53ca1e4b53dda62a03db3d7ae66f827411a47fc9f7c281edfa2fd72acd77e1d258b951f722a69968df00dafa3088afbdd003e5d221ba65
+  data.tar.gz: 13a7bff394b74bc3455c1bfb6ed6f1ec51daa64967e3d497d6207e0d65adb635460dfc4ae5b6eb3ba43243339d5b69cd6d3d04f28339276716eba41c2d897db5

data/lib/startask.rb

@@ -0,0 +1,229 @@
+!#/usr/bin/env ruby
+
+# file: startask.rb
+# description: An experimental gem representing the STAR technique.
+
+require 'kvx'
+require 'rxfhelper'
+
+class ActionItem
+
+  attr_reader :log
+
+  def initialize(s)
+    @title = s
+    @log = []
+  end
+  
+  def done()
+    logit :completed
+  end
+  
+  alias completed done
+
+  def to_s()
+    @title
+  end
+  
+  def started()
+    logit :started
+  end
+  
+  def status()
+    @log.last
+  end
+  
+  def stopped()
+    logit :stopped
+  end
+  
+  def status=(status)
+    
+    case status
+    when :done
+      done()
+    when :started
+      started()
+    end
+    
+  end
+  
+  private
+  
+  def logit(label)
+    @log << [label, Time.now.strftime("%H:%M%P")]    
+  end
+
+end
+
+class Actions
+
+  def import(a)
+
+    @a = a.map do |x|
+      x.is_a?(String) ? ActionItem.new(x) : Actions.new.import(x)
+    end
+
+    return self
+
+  end
+
+  def [](i)
+    @a[i]
+  end
+  
+  def to_s()
+    @a.each(&:to_s)
+  end
+
+end
+
+class ResultItem
+  
+  def initialize(s)
+    @evidence = s
+  end
+  
+  def to_s()
+    @evidence
+  end
+  
+end
+
+class Results
+  
+  def initialize()
+
+  end
+  
+  def import(a)
+
+    @a = a.map do |x|
+      x.is_a?(String) ? ResultItem.new(x) : Results.new.import(x)
+    end
+
+    return self
+
+  end
+
+  def [](i)
+    @a[i]
+  end
+  
+  def to_s()
+    
+    @a.map.with_index do |x, i|
+      if x.is_a? ResultItem then
+        x.to_s
+      elsif x.is_a? Results
+        x.print_row(i, indent: 0)
+      end
+    end.join("\n")
+  end
+  
+  def print_row(id, indent: 0)
+        
+    @a.map.with_index do |x, i|
+      if x.is_a? ResultItem then
+        ('  ' * indent) + x.to_s
+      elsif x.is_a? Results
+        x.print_row(i, indent: indent+1)
+      end
+    end.join("\n")
+  end
+  
+end
+
+# task dictionary
+# ----------------
+# import (method) Imports a new "task" which includes a STAR document outline
+# done (method) The task has been completed
+# completed - alias of method *done*
+# status (method) returns the most recent status from the task log
+# log (attr) returns an Array object containing a timeline of status messages in chronological order
+# progress (method) returns the most recent action completed or started
+# duration (method) returns the actual duration
+# type (attr) Frequency type e.g. (daily, weekly, monthly)
+# estimate_duration (attr) OPTIONAL. the estimate duration is explicitly declared in the STAR document or is calculated from estimate durations in the actions if declared.
+# actions (method) returns the Actions object
+# location (attr) set or get the current physical location
+# started (method) adds a status message to the log
+
+class StarTask
+
+  attr_reader :situation, :task, :actions, :log, :results
+
+  def initialize(src=nil, debug: false)
+    @debug = debug
+    @log = []
+    import src if src
+  end
+  
+  def done()
+    logit :completed
+  end
+  
+  alias completed done
+
+  def import(raws)
+
+    s, _ = RXFHelper.read raws
+    puts 's: ' + s.inspect if @debug
+    
+    obj = if s.lstrip[0] == '#' then
+    
+      a = s.split(/^#+ /)
+      a.shift
+      
+     rawh =  a.map do |x|
+       
+        rawlabel, body = x.split(/\n/,2)
+        
+        [rawlabel.downcase.gsub(/\s+/, '_').to_sym, 
+         body.strip.gsub(/^(\s*)[\*\+] /,'\1')]
+        
+      end.to_h
+      
+      h = {}
+      h[:situation] = rawh[:situation]
+      h[:task] = rawh[:task]
+      h[:action] = {items: LineTree.new(rawh[:action]).to_a(normalize: true)}
+      h[:result] = {items: LineTree.new(rawh[:result]).to_a(normalize: true)}
+      h
+      
+    else
+      s
+    end
+    
+    puts 'obj: ' + obj.inspect if @debug
+        
+    kvx = Kvx.new obj
+    @situation = kvx.situation
+    @task = kvx.task
+    @actions = Actions.new.import(kvx.action[:items])
+    @results = Results.new.import(kvx.result[:items])
+
+  end
+    
+  # adds a status message to the log
+  #
+  def started()
+    logit :started
+  end
+  
+  def status()
+    @log.last
+  end
+  
+  def stopped()
+    logit :stopped
+  end
+  
+  private
+  
+  def logit(label)
+    @log << [label, Time.now.strftime("%H:%M%P")]    
+    return label
+  end
+
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: startask
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Robertson
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEljCCAv6gAwIBAgIBATANBgkqhkiG9w0BAQsFADBIMRIwEAYDVQQDDAlnZW1t
+  YXN0ZXIxHjAcBgoJkiaJk/IsZAEZFg5qYW1lc3JvYmVydHNvbjESMBAGCgmSJomT
+  8ixkARkWAmV1MB4XDTIyMDkyODE5MDMzN1oXDTIzMDkyODE5MDMzN1owSDESMBAG
+  A1UEAwwJZ2VtbWFzdGVyMR4wHAYKCZImiZPyLGQBGRYOamFtZXNyb2JlcnRzb24x
+  EjAQBgoJkiaJk/IsZAEZFgJldTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoC
+  ggGBANaGk+skiMXtQMWzhWY9rK71LPGXSeaNyPJlQ+W7EkH62eVSb9svV36or8KS
+  adnNWZ01ssCm3jxmZYguwwuYeEwtRYp0QGKMe0vKHa8t6w/JR7ClZ0p8hn/BGP+5
+  BgvANKe5XBmTjVQETGwnSTbAmW+MtN9e8jpCQqEdZMGZpD2NLQMCxcqG7JVFXsji
+  1wDHO2fGVoP2EemROe41S2ytKebLh9+M2CMexwaGoAHLa4aJfjSFDzBddJFPl9+r
+  eL2QHmVQPoqA3NM9OmMeAij3MjulTm9/6ixkHHEpZy+N7JuD1biYaEN08AC618a7
+  7j5sCJk4YlTQciE2Vg9YwBbCF1vQ2EnjXX3JFSLC7RRbL1Fl4CLqrwrDsWNDmxER
+  YGu8eWqY00ytq5tioD6dYa0EpD1CmBlwKO6oSp/nzAKWaFp8N3l8MsH8piKQXL3U
+  6vkozoipVQM7ELQhBJQhnC5/YdsqVlChx6l4MH1QbouxzUij4hDd3dtpen9bcMhV
+  kiYsSwIDAQABo4GKMIGHMAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBRji3azY8202R3gBM0/x0xIyu/dUjAmBgNVHREEHzAdgRtnZW1tYXN0ZXJAamFt
+  ZXNyb2JlcnRzb24uZXUwJgYDVR0SBB8wHYEbZ2VtbWFzdGVyQGphbWVzcm9iZXJ0
+  c29uLmV1MA0GCSqGSIb3DQEBCwUAA4IBgQC+aPFOdtBsXgBP+QspB7aMvc9aNUV6
+  76l0CHHPQSd7OP+FtAA3SoNyt+RBCmTpeBHWU6HLXov7/MYtWx3ftL16uP9goXcA
+  YaBAf4fR3JXaCMHHkgFghdjJtvDyq4ast8rkDb4zpNyLyuecz5o9YArbqQ8vcr+y
+  UK/K2+fKWCG6l8a9eCXoITiXw/wq1VU7pE8XzyiS6yZwPhzAcIvIPrfmlXgd2Foy
+  rQgDTpOKBjg0YuxYf6weC20uR1NmaKiFdo2AX5mt1YTIqgzLOZ0Wr76PHhLUXV0/
+  dxFY4fsIxLg/wDTzLBloJLk4rJ609PtXFRPgYIwt5eafgpzEWB/vEEn2XBqdSHoR
+  wuE5sOkZjdE6PI78COErjIbzpmjUwXv+becBBKnwOPILFGat3GSyANQeazCP0SqT
+  BWN+6F7HF8UfTUHWCQqk9FoCAYtbfQWLUqZwWN+dLzn1CPK0yoPjuSR59/HShliV
+  IUEz9QfhClpwEVu+leXBe7RwfxADwAWYEfI=
+  -----END CERTIFICATE-----
+date: 2022-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rxfreadwrite
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.6
+description: 
+email: digital.robertson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/startask.rb
+homepage: https://github.com/jrobertson/startask
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: An experimental gem representing the STAR technique.
+test_files: []