time-sheet 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35406dddfbbe1e74c061171bea36962f3d5632a6cedc75e846a66e53fc2fbd9e
-  data.tar.gz: deab85ae87457cab458141d8a4987ca592a07d0860405d2ecea1190a316e2b9e
+  metadata.gz: fe61ceab6f7a30eaeb9a0e54854776f8dc09b1ba55f4578e98937b9ad7669388
+  data.tar.gz: 3fed81fb509d8df3d81118364bad0e6deaec9163ad75ecd7adfe128e432534ae
 SHA512:
-  metadata.gz: e262b17d41fbc239710af28d16d6fa00334d5cb691489e0b017f8864db76ce7b4b5ac7ba7fec53d39b821cda78522bd7fc234680ece63c184adf7b9275dcddee
-  data.tar.gz: 03eb5990ebcae8f95d4931a1dcaa7b5469e54f6eac61fcfe20a752c8e0c75146028b066153fed8bb8d46afeff5fa417235418db7ea82120694f224626c9ccbcc
+  metadata.gz: 3f7bf35eb5afa3c311ccc945b4db80365425e0d5547e1e62d2ddd79942a25022b3604f950651892052d84b87a741ee196b1feb5129bd49642e1f9d771b21bde0
+  data.tar.gz: e8aef98393c7845993e87fc39703981891943e01847edd74451d5eabe9edb138218a5fdfcacdcaf822ffe0567809167639cca27c60512da56d57981d82dba299

data/README.md

@@ -31,6 +31,24 @@ The gem bundles an executable which includes a help command, just run
 A config file at `~/.time-sheet.conf` is read if it exists. The only possible
 option is `location: /path/to/excel/sheets`. It can be specified multiple times.
 
+The spreadsheet may carry a `tags` column holding a comma-separated list of tags
+per row. A blank `tags` cell is inherited from the previous row when the project,
+activity and description are unchanged, so a run of rows describing one task only
+needs to be tagged once. The `report` and `invoice` commands append a `Tags:`
+section showing how much of the reported time falls on each tag.
+
+Tag times can be scaled per tag with `-b` / `--tag-boosts`, e.g.
+`time-sheet.rb -b ai:1.4,physical:0.75`. Each entry's time is multiplied by the
+product of the factors of the tags it carries; untagged or unboosted entries are
+left unchanged. The `Tags:` section always reports unboosted time.
+
+The rendered descriptions can be cleaned up with `--filter-descriptions`, a
+single unanchored regular expression whose matches are removed from the output
+(reapplied until no match remains):
+`time-sheet.rb --filter-descriptions "mail to (Tom|Lana)"` turns *"mail to Tom
+about the report"* into *" about the report"*. It only affects what is printed;
+no rows are excluded.
+
 ### Processing data with other tools
 
 You can simply let the tool output a full list of time entries that are easy to

data/lib/time_sheet/time/cmd.rb

@@ -5,6 +5,8 @@ require 'time'
 
 class TimeSheet::Time::Cmd
   def run
+    options[:tag_boosts] = parse_tag_boosts(options[:tag_boosts])
+
     if d = options[:from]
       if d.match(/^\d\d?-\d\d?$/)
         d = "#{TimeSheet::Time::Util.now.year}-#{d}"
@@ -126,7 +128,9 @@ class TimeSheet::Time::Cmd
       o.string '-p', '--project', 'take only entries of this project into account'
       o.string '-a', '--activity', 'take only entries of this activity into account'
       o.string '--tags', 'filter by tag (comma separated, not case sensitive, prefix tag with ! to exclude)'
+      o.string '-b', '--tag-boosts', 'multiply the time of entries by a factor per tag, e.g. ai:1.4,physical:0.75'
       o.string '-d', '--description', 'consider only entries matching this description'
+      o.string '--filter-descriptions', 'drop the parts of output descriptions matching this unanchored regex'
       o.string '-e', '--employee', 'consider only entries for this employee'
       o.string(
         '--carry-over-activity',
@@ -149,6 +153,15 @@ class TimeSheet::Time::Cmd
     options.arguments.shift || 'default'
   end
 
+  def parse_tag_boosts(value)
+    return {} if value.nil? || value.to_s.strip.empty?
+
+    value.split(/\s*,\s*/).each_with_object({}) do |pair, result|
+      tag, factor = pair.split(/\s*:\s*/, 2)
+      result[tag.to_s.downcase] = factor.to_f
+    end
+  end
+
   def convert_to_time
     if options[:from]
       options[:from] = options[:from].to_time
@@ -183,7 +196,8 @@ class TimeSheet::Time::Cmd
   def invoice
     convert_to_time
 
-    data = TimeSheet::Time.invoice(options)
+    entries = TimeSheet::Time.matching_entries(options)
+    data = TimeSheet::Time.invoice_entries(entries, options)
 
     data.each do |package|
       tp = TimeSheet::TablePrinter.new package, options
@@ -191,7 +205,7 @@ class TimeSheet::Time::Cmd
       puts "\n"
     end
 
-    if options[:package]
+    if options[:package].to_f > 0
       package = (data.last.nil? ? 0 : data.last.map{|entry| entry[1]}.sum)
       total = options[:package] * 60
       percent = (package / total.to_f * 100)
@@ -202,6 +216,8 @@ class TimeSheet::Time::Cmd
         "#{percent.round 2}%)"
       ].join(' ')
     end
+
+    print_tags(TimeSheet::Time.tag_totals(entries), entries.sum(&:raw_duration))
   end
 
   def report
@@ -261,6 +277,18 @@ class TimeSheet::Time::Cmd
         "h/month(30 days): #{data['averages']['hours_per_month'].round(2)}"
       ].join(', ')
     end
+
+    print_tags(data['tags'], data['raw_total'])
+  end
+
+  def print_tags(tags, total)
+    tags ||= {}
+    return if tags.empty?
+
+    puts "\nTags:"
+    tags.sort_by{|tag, minutes| [-minutes, tag]}.each do |tag, minutes|
+      puts "#{tag}: #{TimeSheet::Time::Util.hours(minutes)} h (#{TimeSheet::Time::Util.share(minutes, total)}%)"
+    end
   end
 
 end

data/lib/time_sheet/time/entry.rb

@@ -109,11 +109,37 @@ class TimeSheet::Time::Entry
   # end
 
   def duration
+    raw_duration * factor
+  end
+
+  def raw_duration
     (self.end - self.start) / 60
   end
 
+  # Multiplier applied to this entry's time: the product of the boost factors of
+  # all its tags. Tags without a boost factor leave the time unchanged.
+  def factor
+    boosts = (TimeSheet.options && TimeSheet.options[:tag_boosts]) || {}
+    tags.inject(1.0){|f, tag| f * (boosts[tag] || 1.0)}
+  end
+
   def tags
-    self.class.parse_tags(@data['tags'])
+    self.class.parse_tags(tag_source)
+  end
+
+  # Tags carry over from the previous entry when project, activity and
+  # description are the same, so a group of rows describing one task only needs
+  # to be tagged on its first row. Any other row has no tags.
+  def tag_source
+    raw = @data['tags']
+    return raw if raw && !raw.to_s.strip.empty?
+
+    if self.prev &&
+       self.prev.project == project &&
+       self.prev.activity == activity &&
+       self.prev.description == description
+      self.prev.tag_source
+    end
   end
 
   def working_day?
@@ -165,7 +191,7 @@ class TimeSheet::Time::Entry
       raise TimeSheet::Time::Exception.new('time entry has no start')
     end
 
-    if duration <= 0
+    if raw_duration <= 0
       raise TimeSheet::Time::Exception.new('time entry duration is 0 or less')
     end
 
@@ -181,10 +207,28 @@ class TimeSheet::Time::Entry
   def to_row
     [
       employee, date, start, self.end, duration.to_i, project, activity,
-      description
+      self.class.filter_description(description, TimeSheet.options)
     ]
   end
 
+  # Drops the parts of a description matching the --filter-descriptions regex,
+  # repeating until no further match remains. The match is unanchored; rows are
+  # never excluded, only the rendered text is changed.
+  def self.filter_description(value, options)
+    pattern = options && options[:filter_descriptions]
+    return value if pattern.nil? || pattern.to_s.empty?
+
+    regexp = Regexp.new(pattern)
+    result = value.to_s
+    loop do
+      filtered = result.gsub(regexp, '')
+      break if filtered == result
+
+      result = filtered
+    end
+    result
+  end
+
   def to_s
     values = [
       employee,

data/lib/time_sheet/time/util.rb

@@ -58,4 +58,10 @@ module TimeSheet::Time::Util
     (self.hours(duration) * rate).round(2)
   end
 
+  def self.share(part, whole)
+    return 0.0 if whole.nil? || whole.to_f.zero?
+
+    (part / whole.to_f * 100).round(1)
+  end
+
 end

data/lib/time_sheet/time.rb

@@ -8,35 +8,52 @@ module TimeSheet::Time
   autoload :Util, 'time_sheet/time/util'
 
   def self.report(options)
-    TimeSheet.options = options
-
     results = {
       'entries' => [],
       'total' => 0.0,
-      'projects' => {}
+      'raw_total' => 0.0,
+      'projects' => {},
+      'tags' => {}
     }
 
-    x = nil
-    Parser.new(options[:location]).entries.each do |e|
-      unless x
-        x = true
-      end
-      if e.matches?(options)
-        results['total'] += e.duration
-        results['projects'][e.project] ||= {'total' => 0.0, 'activities' => {}}
-        results['projects'][e.project]['total'] += e.duration
-        results['projects'][e.project]['activities'][e.activity] ||= 0.0
-        results['projects'][e.project]['activities'][e.activity] += e.duration
-
-        results['entries'] << e.to_row
-      end
+    matching = matching_entries(options)
+    matching.each do |e|
+      results['total'] += e.duration
+      results['projects'][e.project] ||= {'total' => 0.0, 'activities' => {}}
+      results['projects'][e.project]['total'] += e.duration
+      results['projects'][e.project]['activities'][e.activity] ||= 0.0
+      results['projects'][e.project]['activities'][e.activity] += e.duration
+
+      results['entries'] << e.to_row
     end
 
+    results['tags'] = tag_totals(matching)
+    results['raw_total'] = matching.sum(&:raw_duration)
+
     averages(results, options)
 
     results
   end
 
+  # All entries matching the given filters. Sets TimeSheet.options first so that
+  # the carry-over rules apply while the entries are read.
+  def self.matching_entries(options)
+    TimeSheet.options = options
+    Parser.new(options[:location]).entries.select { |e| e.matches?(options) }
+  end
+
+  # Sums the unboosted duration of entries carrying a tag, so the tag breakdown
+  # reflects actual time regardless of any --tag-boosts factors. An entry with
+  # several tags contributes its full duration to each of them, so the per-tag
+  # totals do not necessarily add up to the overall total.
+  def self.tag_totals(entries)
+    totals = Hash.new(0.0)
+    entries.each do |e|
+      e.tags.each { |tag| totals[tag] += e.raw_duration }
+    end
+    totals
+  end
+
   def self.averages(results, options)
     days = 1
 
@@ -67,17 +84,17 @@ module TimeSheet::Time
   end
 
   def self.invoice(options)
-    TimeSheet.options = options
-    
+    invoice_entries(matching_entries(options), options)
+  end
+
+  def self.invoice_entries(entries, options)
     grouped = {}
-    Parser.new(options[:location]).entries.each do |e|
-      if e.matches?(options)
-        grouped[[e.date, e.description]] ||= 0
-        grouped[[e.date, e.description]] += e.duration.to_i
-      end
+    entries.each do |e|
+      grouped[[e.date, e.description]] ||= 0
+      grouped[[e.date, e.description]] += e.duration.to_i
     end
     rows = []
-    grouped.each{|k, d| rows << [k.first, d, k.last]}
+    grouped.each{|k, d| rows << [k.first, d, Entry.filter_description(k.last, options)]}
     packages = [[]]
     ptotal = 0
 

data/lib/time_sheet/version.rb

@@ -1,3 +1,3 @@
 module TimeSheet
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: time-sheet
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Moritz Schepp
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-17 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: roo