fewald-worklog 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a96472b19aed7c8be5089c026c81feb764d2b48a2694fd77d7cbbe10cc116639
-  data.tar.gz: 879af891f9009e3c0afe477d4cab68404970647e35a4d82cc8f30f2e3d54964d
+  metadata.gz: 58355177c4287e00546bceb657e475a665a6a0ee374d57e836f220c1e7e57762
+  data.tar.gz: a071e07481282a7e9d857a32ec7e7fe01d71aff05ed1ededf456a5bef253dca1
 SHA512:
-  metadata.gz: 5a2e2329393e493c533cd092eda4ca1a3db201a36224d80a332eca08f0a1355c1aa61df608388c9d316410715aed7bfdc1b01298004a7a9f24d9fb440d49c69f
-  data.tar.gz: a16ffafc2dafae3796d013f01ec860c1a5b79fd61c81569c1f15ead531632a055c3455d9720c2c295d1bad8cdc32cb6d311db6fec32ca0606517effa953db3ce
+  metadata.gz: d2b996725ae935188acdfff6c1e71c81ceae62afe2386259a5687e8726967003fad557b0ba8d71bb28d91a13f50138b67a8165643c7a0ce75c33cce4bf5a2cf0
+  data.tar.gz: 5c5bb1134e3eda63975de71857401d7ae1aae24e264e65be97cee2de9fcf75c0407405478e44afc4238bd4cf6c2aab6615204b7617a25967e32d9978b2382ff3

data/.version

@@ -1 +1 @@
-0.2.3
+0.2.5

data/bin/wl

@@ -8,7 +8,8 @@ if ENV['WL_PATH']
   # This is used during development to avoid having to rely on the order of the $PATH.
   puts "Loading worklog from #{ENV['WL_PATH']}. This should only be used during development."
   puts 'To use the installed worklog, unset the WL_PATH environment variable.'
-  require_relative File.join(ENV['WL_PATH'], 'lib', 'cli')
+  $LOAD_PATH.unshift File.join(ENV['WL_PATH'], 'lib')
+  require 'cli'
 else
   require_relative '../lib/cli'
 end

data/lib/cli.rb

@@ -16,7 +16,6 @@ require 'printer'
 require 'statistics'
 require 'storage'
 require 'string_helper'
-require 'summary'
 require 'version'
 require 'webserver'
 
@@ -104,9 +103,22 @@ class WorklogCLI < Thor
   end
 
   desc 'tags', 'Show all tags used in the work log'
-  def tags
+  option :date, type: :string, default: DateTime.now.strftime('%Y-%m-%d'),
+                desc: <<~DESC
+                  Show the work log for a specific date. If this option is provided, --from and --to and --days should not be used.
+                DESC
+  option :from, type: :string, desc: <<~EOF
+    Inclusive start date of the range. Takes precedence over --date, if defined.
+  EOF
+  option :to, type: :string, desc: <<~EOF
+    Inclusive end date of the range. Takes precedence over --date, if defined.
+  EOF
+  option :days, type: :numeric, desc: <<~EOF
+    Number of days to show starting from --date. Takes precedence over --from and --to if defined.
+  EOF
+  def tags(tag = nil)
     worklog = Worklog.new
-    worklog.tags(options)
+    worklog.tags(tag, options)
   end
 
   desc 'server', 'Start the work log server'

data/lib/log_entry.rb

@@ -31,7 +31,7 @@ class LogEntry
   end
 
   # Returns the message string with formatting without the time.
-  # @param people Hash[String, Person] A hash of people with their handles as keys.
+  # @param known_people Hash[String, Person] A hash of people with their handles as keys.
   def message_string(known_people = nil)
     # replace all mentions of people with their names.
     msg = @message.dup

data/lib/worklog.rb

@@ -14,6 +14,7 @@ require 'worklogger'
 require 'string_helper'
 require 'printer'
 require 'statistics'
+require 'summary'
 
 # Main class providing all worklog functionality.
 # This class is the main entry point for the application.
@@ -138,9 +139,25 @@ class Worklog
     end
   end
 
-  def tags(_options = {})
-    all_logs = @storage.all_days
+  # Show all tags used in the work log or details for a specific tag
+  #
+  # @param tag [String, nil] the tag to show details for, or nil to show all tags
+  # @param options [Hash] the options hash containing date range
+  # @return [void]
+  #
+  # @example
+  #   worklog.tags('example_tag', from: '2023-10-01', to: '2023-10-31')
+  #   worklog.tags(nil) # Show all tags for all time
+  def tags(tag = nil, options = {})
+    if tag.nil? || tag.empty?
+      tag_overview
+    else
+      tag_detail(tag, options)
+    end
+  end
 
+  def tag_overview
+    all_logs = @storage.all_days
     puts Rainbow('Tags used in the work log:').gold
 
     # Count all tags used in the work log
@@ -153,6 +170,29 @@ class Worklog
     tags.sort.each { |k, v| puts "#{Rainbow(k.ljust(max_len)).gold}: #{v} #{pluralize(v, 'occurrence')}" }
   end
 
+  # Show detailed information about a specific tag
+  #
+  # @param tag [String] the tag to show details for
+  # @param options [Hash] the options hash containing date range
+  # @return [void]
+  #
+  # @example
+  #   worklog.tag_detail('example_tag', from: '2023-10-01', to: '2023-10-31')
+  def tag_detail(tag, options)
+    printer = Printer.new(@storage.load_people!)
+    start_date, end_date = start_end_date(options)
+
+    @storage.days_between(start_date, end_date).each do |daily_log|
+      next unless daily_log.tags.include?(tag)
+
+      daily_log.entries.each do |entry|
+        next unless entry.tags.include?(tag)
+
+        printer.print_entry(daily_log, entry, true)
+      end
+    end
+  end
+
   def stats(_options = {})
     stats = Statistics.new(@config).calculate
     puts "#{format_left('Total days')}: #{stats.total_days}"
@@ -207,9 +247,11 @@ class Worklog
     elsif options[:from]
       start_date = DateParser.parse_date_string!(options[:from], true)
       end_date = DateParser.parse_date_string!(options[:to], false) if options[:to]
-    else
+    elsif options[:date]
       start_date = Date.strptime(options[:date], '%Y-%m-%d')
       end_date = start_date
+    else
+      raise ArgumentError, 'No date range specified. Use --days, --from, --to or --date options.'
     end
     [start_date, end_date]
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fewald-worklog
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.5
 platform: ruby
 authors:
 - Friedrich Ewald