lewt 0.5.12

data/lib/config/templates/style.css

@@ -0,0 +1,461 @@
+body {
+  font-family: Helvetica, arial, sans-serif;
+  font-size: 14px;
+  line-height: 1.6;
+  padding-top: 10px;
+  padding-bottom: 10px;
+  background-color: white;
+  padding: 30px;
+  color: #333;
+}
+
+body > *:first-child {
+  margin-top: 0 !important;
+}
+
+body > *:last-child {
+  margin-bottom: 0 !important;
+}
+
+a {
+  color: #4183C4;
+  text-decoration: none;
+}
+
+a.absent {
+  color: #cc0000;
+}
+
+a.anchor {
+  display: block;
+  padding-left: 30px;
+  margin-left: -30px;
+  cursor: pointer;
+  position: absolute;
+  top: 0;
+  left: 0;
+  bottom: 0;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  margin: 20px 0 10px;
+  padding: 0;
+  font-weight: bold;
+  -webkit-font-smoothing: antialiased;
+  cursor: text;
+  position: relative;
+}
+
+h2:first-child, h1:first-child, h1:first-child + h2, h3:first-child, h4:first-child, h5:first-child, h6:first-child {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor {
+  text-decoration: none;
+}
+
+h1 tt, h1 code {
+  font-size: inherit;
+}
+
+h2 tt, h2 code {
+  font-size: inherit;
+}
+
+h3 tt, h3 code {
+  font-size: inherit;
+}
+
+h4 tt, h4 code {
+  font-size: inherit;
+}
+
+h5 tt, h5 code {
+  font-size: inherit;
+}
+
+h6 tt, h6 code {
+  font-size: inherit;
+}
+
+h1 {
+  font-size: 28px;
+  color: black;
+}
+
+h2 {
+  font-size: 24px;
+  border-bottom: 1px solid #cccccc;
+  color: black;
+}
+
+h3 {
+  font-size: 18px;
+}
+
+h4 {
+  font-size: 16px;
+}
+
+h5 {
+  font-size: 14px;
+}
+
+h6 {
+  color: #777777;
+  font-size: 14px;
+}
+
+p, blockquote, ul, ol, dl, li, table, pre {
+  margin: 15px 0;
+}
+
+hr {
+/*  background: transparent url("http://tinyurl.com/bq5kskr") repeat-x 0 0; */
+  border: 0 none;
+  color: #cccccc;
+  height: 4px;
+  padding: 0;
+}
+
+body > h2:first-child {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+body > h1:first-child {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+body > h1:first-child + h2 {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+body > h3:first-child, body > h4:first-child, body > h5:first-child, body > h6:first-child {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
+  margin-top: 0;
+  padding-top: 0;
+}
+
+h1 p, h2 p, h3 p, h4 p, h5 p, h6 p {
+  margin-top: 0;
+}
+
+li p.first {
+  display: inline-block;
+}
+
+ul, ol {
+  padding-left: 30px;
+}
+
+ul :first-child, ol :first-child {
+  margin-top: 0;
+}
+
+ul :last-child, ol :last-child {
+  margin-bottom: 0;
+}
+
+dl {
+  padding: 0;
+}
+
+dl dt {
+  font-size: 14px;
+  font-weight: bold;
+  font-style: italic;
+  padding: 0;
+  margin: 15px 0 5px;
+}
+
+dl dt:first-child {
+  padding: 0;
+}
+
+dl dt > :first-child {
+  margin-top: 0;
+}
+
+dl dt > :last-child {
+  margin-bottom: 0;
+}
+
+dl dd {
+  margin: 0 0 15px;
+  padding: 0 15px;
+}
+
+dl dd > :first-child {
+  margin-top: 0;
+}
+
+dl dd > :last-child {
+  margin-bottom: 0;
+}
+
+blockquote {
+  border-left: 4px solid #dddddd;
+  padding: 0 15px;
+  color: #777777;
+}
+
+blockquote > :first-child {
+  margin-top: 0;
+}
+
+blockquote > :last-child {
+  margin-bottom: 0;
+}
+
+table {
+  padding: 0;
+}
+table tr {
+  border-top: 1px solid #cccccc;
+  background-color: white;
+  margin: 0;
+  padding: 0;
+}
+
+table tr:nth-child(2n) {
+  background-color: #f8f8f8;
+}
+
+table tr th {
+  font-weight: bold;
+  border: 1px solid #cccccc;
+  text-align: left;
+  margin: 0;
+  padding: 6px 13px;
+}
+
+table tr td {
+  border: 1px solid #cccccc;
+  text-align: left;
+  margin: 0;
+  padding: 6px 13px;
+}
+
+table tr th :first-child, table tr td :first-child {
+  margin-top: 0;
+}
+
+table tr th :last-child, table tr td :last-child {
+  margin-bottom: 0;
+}
+
+img {
+  max-width: 100%;
+}
+
+span.frame {
+  display: block;
+  overflow: hidden;
+}
+
+span.frame > span {
+  border: 1px solid #dddddd;
+  display: block;
+  float: left;
+  overflow: hidden;
+  margin: 13px 0 0;
+  padding: 7px;
+  width: auto;
+}
+
+span.frame span img {
+  display: block;
+  float: left;
+}
+
+span.frame span span {
+  clear: both;
+  color: #333333;
+  display: block;
+  padding: 5px 0 0;
+}
+
+span.align-center {
+  display: block;
+  overflow: hidden;
+  clear: both;
+}
+
+span.align-center > span {
+  display: block;
+  overflow: hidden;
+  margin: 13px auto 0;
+  text-align: center;
+}
+
+span.align-center span img {
+  margin: 0 auto;
+  text-align: center;
+}
+
+span.align-right {
+  display: block;
+  overflow: hidden;
+  clear: both;
+}
+
+span.align-right > span {
+  display: block;
+  overflow: hidden;
+  margin: 13px 0 0;
+  text-align: right;
+}
+
+span.align-right span img {
+  margin: 0;
+  text-align: right;
+}
+
+span.float-left {
+  display: block;
+  margin-right: 13px;
+  overflow: hidden;
+  float: left;
+}
+
+span.float-left span {
+  margin: 13px 0 0;
+}
+
+span.float-right {
+  display: block;
+  margin-left: 13px;
+  overflow: hidden;
+  float: right;
+}
+
+span.float-right > span {
+  display: block;
+  overflow: hidden;
+  margin: 13px auto 0;
+  text-align: right;
+}
+
+code, tt {
+  margin: 0 2px;
+  padding: 0 5px;
+  white-space: nowrap;
+  border: 1px solid #eaeaea;
+  background-color: #f8f8f8;
+  border-radius: 3px;
+}
+
+pre code {
+  margin: 0;
+  padding: 0;
+  white-space: pre;
+  border: none;
+  background: transparent;
+}
+
+.highlight pre {
+  background-color: #f8f8f8;
+  border: 1px solid #cccccc;
+  font-size: 13px;
+  line-height: 19px;
+  overflow: auto;
+  padding: 6px 10px;
+  border-radius: 3px;
+}
+
+pre {
+  background-color: #f8f8f8;
+  border: 1px solid #cccccc;
+  font-size: 13px;
+  line-height: 19px;
+  overflow: auto;
+  padding: 6px 10px;
+  border-radius: 3px;
+}
+
+pre code, pre tt {
+  background-color: transparent;
+  border: none;
+}
+
+
+/* generic helper syles */
+ul.unstyled {
+    list-style-type: none;
+    margin: 0;
+    padding: 0;
+}
+
+
+/* invoice styles */
+ul.invoice-items {
+    
+}
+
+ul.invoice-items li {
+    margin: 10px 0;
+    padding: 5px 0;
+/*    border-bottom: 1px solid #CCC;*/
+    page-break-inside  : avoid;
+}
+
+ul.invoice-items li table {
+    width: 100%;
+    font-size: 14px;
+}
+
+ul.invoice-items td {
+    border : none;
+    outline : none;
+}
+
+ul.invoice-items .invoice-item-description {
+    padding-bottom: 15px;
+    border: 1px dashed #ccc;
+}
+
+.invoice-items .full-row {
+    width: 100%;
+}
+
+body, html {
+    margin: 0;
+    padding: 0;
+    font-size: 14px;
+}
+
+h1, h2, h3, h4 {
+    page-break-after: avoid;
+}
+
+h1 {
+    font-size: 22px;
+}
+
+h2 {
+    font-size: 18px;
+}
+
+h3 {
+    font-size: 16px;
+}
+
+h4 {
+    font-size: 14px;
+}
+
+#logo {
+    width : 100px;
+    height : auto;
+    position : absolute;
+    top: 0;
+    right: 0;
+}

data/lib/extension.rb

@@ -0,0 +1,158 @@
+# Author::    Jason Wijegooneratne  (mailto:code@jwije.com)
+# Copyright:: Copyright (c) 2014 Jason Wijegooneratne
+# License::   MIT. See LICENSE.md distributed with the source code for more information.
+
+# =THE LEWT EXTENSION BASE CLASS
+#
+# This class provides some basic structuring for LEWT extensions 
+# and additionally adds some meta features to extensions which 
+# implement it in order to streamline development of LEWT
+# extensions.
+
+require "yaml"
+
+# This module acts as a container for the LEWT namespace
+module LEWT
+
+  class Extension
+    
+    # LEWT Stash is the user configured stash path where all extensions, config file, templates etc are stored.
+    attr_reader :lewt_stash, :lewt_settings, :customers, :enterprise, :options, :command_name
+
+    # @@extensions is a registry shared between all extensions that impliment this class
+    # containing there class names for invocation by the core system.
+    @@lewt_extensions = Array.new
+    @options = nil
+    
+    # This method is inoked by subclasses to initialise themselves within Lewt's extension registry.
+    # ext_init [Hash]:: contains the keys <tt>:cmd</tt>, <tt>:options</tt> - which are the command name (String) and options (Hash) for the extension respectively.
+    def initialize ( ext_init = { :cmd => "lewt_base_extension" } )
+      core_settings = YAML.load_file( File.expand_path( '../config/settings.yml', __FILE__) )
+      if File.exists? File.expand_path( '~/.lewt_settings', __FILE__)
+        core_settings.merge! YAML.load_file( File.expand_path( '~/.lewt_settings', __FILE__) )
+      end
+
+      @lewt_stash = core_settings['lewt_stash'] || File.expand_path('../', __FILE__) + "/config/"
+      load_lewt_settings()
+      @command_name = ext_init[:cmd]
+      @options = ext_init[:options] || nil
+      register_extension
+    end
+
+    # returns all registered extensions as an array of class names
+    def lewt_extensions
+      @@lewt_extensions
+    end
+
+    # This method mathes customers wth query strings provided by users in the CLI
+    # query [String]:: A search string to query against.
+    # suppress [String]:: A list of clients to exclude. Defaults to nil ie: none.
+    def get_matched_customers( query, suppress = nil )
+      requestedClients = Array.new
+      if query == nil
+        @customers.each do |client|
+          client_match = [ client["alias"], client["name"] ].join("|")
+          if suppress == nil or client_match.match(suppress.gsub(Lewt::OPTION_DELIMITER_REGEX,"|")) == nil
+            requestedClients.push(client)
+          end
+        end
+      else
+        @customers.each do |client|
+          client_match = [ client["alias"], client["name"] ].join("|")
+          if client_match.match( query.gsub(Lewt::OPTION_DELIMITER_REGEX,"|") ) != nil
+            if suppress == nil or client_match.match(suppress.gsub(Lewt::OPTION_DELIMITER_REGEX,"|")) == nil
+              requestedClients.push(client)
+            end
+          end
+        end
+      end
+      return requestedClients
+    end
+
+    protected
+
+    # This method loads the core LEWT settings files
+    def load_lewt_settings 
+      @lewt_settings = load_settings( "settings.yml")
+      # Start by loading the local config files
+      @customers = load_settings("customers.yml")
+      @enterprise = load_settings("enterprise.yml")
+    end
+
+    # Writes a key/value pair to the settings file. This can then be accessed with lewt_settings[key] and is persisted
+    # on the user's file system in a YAML settings file.
+    # key [String]:: The key to write to the settings file
+    # value:: The value to assign to this key.
+    def write_settings ( file, key, value )
+      settings = load_settings(file)
+      settings[key] = value
+      File.open( @lewt_stash + file, 'w') {|f| f.write settings.to_yaml } #Store
+      load_lewt_settings() # reload settings vars
+      return settings
+    end
+
+
+    
+    # Formats the --save-name parameter if specified as a template into a string for usage with a File.write method.
+    # options [Hash]:: The options hash passed to this function by the Lewt program.
+    # i [Integer]:: The current data array index to match the :targets option against
+    def format_save_name(o, i)
+      match_client = /\#alias/
+      match_date = /\#date/
+      t = o[:save_file].dup
+      c = t.match match_client
+      d = t.match match_date
+
+      if c != nil
+        clients = get_matched_customers(o[:target])
+        client_alias = clients[i]["alias"]
+        t.gsub! match_client, client_alias
+      end
+
+      if d != nil
+        t.gsub! match_date, Date.today.to_s
+      end
+      
+      return t
+    end
+
+    # Loads the specified settings file
+    # property:: The variable you would like to assign the loaded YAML to
+    # file [String]:: The settings file to load from lewt stash.
+    def load_settings ( file )
+      return YAML.load_file( @lewt_stash + file )
+    end
+
+    # register the given extensions' class name with the system for later invocation
+    def register_extension
+      # only register subclass of this basclass
+      if self.class != LEWT::Extension
+        @@lewt_extensions << self.clone    
+      end
+    end
+
+    # This method is used by extensions to hook into the command line
+    # call and set some user customisable at runtime.
+    # It will be passed the options object from the ruby OptParse class.
+    # def register_options opts end
+    
+    # The extract method can be implemented to extract data from custom sources.
+    def extract 
+      raise Exception "An extraction method is not defined by the #{self.class.name} class"
+    end
+
+    # The process method can be implemented to process extracted data.
+    # It is passed the extracted data from the previous stage.
+    def process extraced_data
+      raise Exception "A processing method is not defined by the #{self.class.name} class"
+    end
+
+    # The render method can be implemented to create views for data.
+    # It is passed the processed data from the previous stage.
+    def render
+      raise Exception "A rendering method is not defined by the #{self.class.name} class"
+    end
+    
+  end
+
+end

data/lib/extensions/calendar-timekeeping/apple_extractor.rb

@@ -0,0 +1,63 @@
+require 'icalendar'
+
+# Author::    Jason Wijegooneratne  (mailto:code@jwije.com)
+# Copyright:: Copyright (c) 2014 Jason Wijegooneratne
+# License::   MIT. See LICENSE.md distributed with the source code for more information.
+
+
+module CalendarExtractors
+
+  # This class handles extraction from iCal sources.
+  #
+  # ===Usage:
+  # - Add the key <tt>osxcal_path</tt> to your settings file and set its value to the location of your calender directory. This must
+  #   be the full path.
+
+  class AppleExtractor < CalExtractor
+
+    # Initialises the object and calls the parent class' super() method.
+    def initialize( dateStart, dateEnd, targets, lewt_settings, suppressTargets ) 
+      @calendarPath = lewt_settings["osxcal_path"]
+      @suppressTargets = suppressTargets
+      super( dateStart, dateEnd, targets )
+    end
+
+    
+    # Scans the apple calender storage directory and compiles a mashup of ical data it finds
+    def aggregateAppleCalenders
+      calenders = Array.new
+      Dir.glob("#{@calendarPath}**/*.ics").each do |path|
+        calenders += Icalendar.parse( File.open(path) )
+      end
+      return calenders
+    end
+
+    # Open iCalender file, parses it, then check events with the regular CalExtractor methods.
+    # Sets the data property of this object if match data is found.
+    def extractCalendarData
+      calendars = aggregateAppleCalenders()
+      calendars.each do |calendar|
+        calendar.events.each do |e|
+          target = self.isTargetCustomer?( e.summary )
+          dstart = Time.parse( e.dtstart.to_s )
+          dend = Time.parse( e.dtend.to_s )
+          if  self.isTargetDate?(dstart) == true &&  target != false
+            timeDiff = (dend - dstart) /60/60
+            row = LEWT::LEWTLedger.new({
+                                         :date_start => e.dtstart, 
+                                         :date_end => e.dtend, 
+                                         :category => @category, 
+                                         :entity => target["name"], 
+                                         :description => e.description.to_s,
+                                         :quantity => timeDiff, 
+                                         :unit_cost => target["rate"]
+                                       })
+            @data.push(row)
+          end
+        end
+      end
+    end
+
+  end
+
+end