calendar-assistant 0.6.0 → 0.7.0

data/lib/calendar_assistant/cli/config.rb

@@ -0,0 +1,51 @@
+class CalendarAssistant
+  module CLI
+    class Config < CalendarAssistant::Config
+      class TomlParseFailure < CalendarAssistant::BaseException;
+      end
+      class NoConfigFileToPersist < CalendarAssistant::BaseException;
+      end
+
+      CONFIG_FILE_PATH = File.join (ENV['CA_HOME'] || ENV["HOME"]), ".calendar-assistant"
+      attr_reader :config_file_path
+
+      def initialize options: {},
+                     config_file_path: CONFIG_FILE_PATH,
+                     defaults: DEFAULT_SETTINGS
+
+
+        @config_file_path = config_file_path
+
+        user_config = if File.exist? config_file_path
+                         begin
+                           FileUtils.chmod 0600, config_file_path
+                           TOML.load_file config_file_path
+                         rescue Exception => e
+                           raise TomlParseFailure, "could not parse #{config_file_path}: #{e}"
+                         end
+                       else
+                         Hash.new
+                       end
+        super(options: options, defaults: defaults, user_config: user_config)
+      end
+
+      def profile_name
+        super.tap do |token|
+          persist!
+        end
+      end
+
+      def persist!
+        if config_file_path.nil?
+          raise NoConfigFileToPersist, "Cannot persist config when there's no config file"
+        end
+
+        content = TOML::Generator.new(user_config).body
+
+        File.open(config_file_path, "w") do |f|
+          f.write content
+        end
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/event_presenter.rb

@@ -0,0 +1,71 @@
+class CalendarAssistant
+  module CLI
+    class EventPresenter < SimpleDelegator
+      EMOJI_WARN = "⚠"
+
+      def description
+        s = formatted_event_date
+        s += rainbow.wrap(sprintf(" | %s", view_summary)).bold
+        s += event_attributes unless private?
+        s = rainbow.wrap(Rainbow.uncolor(s)).faint.strike if declined?
+        s
+      end
+
+      def view_summary
+        return "(private)" if private? && (summary.nil? || summary.blank?)
+        return "(no title)" if summary.nil? || summary.blank?
+        summary
+      end
+
+      private
+
+      def event_attributes
+        attributes = []
+
+        attributes << "recurring" if recurring?
+        attributes << "not-busy" unless busy?
+        attributes << "self" if self?
+        attributes << "1:1" if one_on_one?
+        attributes << "awaiting" if awaiting?
+        attributes << "tentative" if tentative?
+        attributes << rainbow.wrap(sprintf(" %s abandoned %s ", EMOJI_WARN, EMOJI_WARN)).red.bold.inverse if abandoned?
+
+        attributes << visibility if explicitly_visible?
+
+        attributes.empty? ? "" : rainbow.wrap(sprintf(" (%s)", attributes.to_a.sort.join(", "))).italic
+      end
+
+      def rainbow
+        @rainbow ||= Rainbow.global
+      end
+
+      def formatted_event_date
+        date = sprintf("%-25.25s", event_date)
+
+        date_ansi_codes = []
+        date_ansi_codes << :bright if current?
+        date_ansi_codes << :faint if past?
+
+        date_ansi_codes.inject(rainbow.wrap(date)) {|text, ansi| text.send ansi}
+      end
+
+      def event_date
+        if all_day?
+          start_date = __getobj__.start_date
+          end_date = __getobj__.end_date
+          if (end_date - start_date) <= 1
+            start.to_s
+          else
+            sprintf("%s - %s", start_date, end_date - 1.day)
+          end
+        else
+          if start_date == end_date
+            sprintf("%s - %s", start.date_time.strftime("%Y-%m-%d  %H:%M"),  __getobj__.end.date_time.strftime("%H:%M"))
+          else
+            sprintf("%s  -  %s", start.date_time.strftime("%Y-%m-%d %H:%M"), __getobj__.end.date_time.strftime("%Y-%m-%d %H:%M"))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/event_set_presenter.rb

@@ -0,0 +1,69 @@
+class CalendarAssistant
+  module CLI
+    class EventSetPresenter < SimpleDelegator
+      def initialize(obj, config:, event_presenter_class: CLI::EventPresenter)
+        super(obj)
+        @config = config
+        @event_presenter_class = event_presenter_class
+      end
+
+      def to_s
+        [
+            title,
+            description
+        ].join("\n")
+      end
+
+      def title
+        rainbow.wrap("#{event_repository.calendar.id} (all times in #{event_repository.calendar.time_zone})\n").italic
+      end
+
+      def description
+        out = StringIO.new
+
+        if __getobj__.is_a?(EventSet::Hash)
+          events.each do |key, value|
+            out.puts rainbow.wrap(key.to_s.capitalize + ":").bold.italic
+            out.puts self.class.new(__getobj__.new(value), config: @config, event_presenter_class: @event_presenter_class).description
+          end
+          return out.string
+        end
+
+        _events = Array(events)
+
+        return "No events in this time range.\n" if _events.empty?
+
+        display_events = _events.select do |event|
+          !@config.setting(CalendarAssistant::Config::Keys::Options::COMMITMENTS) || event.commitment?
+        end
+
+        printed_now = false
+
+        display_events.each_with_object([]) do |event, out|
+          printed_now = now! event, printed_now, out: out, presenter_class: @event_presenter_class
+          out << @event_presenter_class.new(event).description
+          pp event if @config.debug?
+        end.join("\n")
+      end
+
+      def now!(event, printed_now, out:, presenter_class: CLI::EventPresenter)
+        return true if printed_now
+        return false if event.start_date != Date.today
+
+        if event.start_time > Time.now
+          out << presenter_class.new(CalendarAssistant::CLI::Helpers.now).description
+
+          return true
+        end
+
+        false
+      end
+
+      private
+
+      def rainbow
+        @rainbow ||= Rainbow.global
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/helpers.rb

@@ -0,0 +1,54 @@
+# coding: utf-8
+class CalendarAssistant
+  module CLI
+    module Helpers
+      class ChronicParseException < CalendarAssistant::BaseException;
+      end
+
+      def self.parse_datespec userspec
+        start_userspec, end_userspec = userspec.split(/ ?\.\.\.? ?/)
+
+        if end_userspec.nil?
+          time = Chronic.parse(userspec) || raise(ChronicParseException, "could not parse '#{userspec}'")
+          return time.beginning_of_day..time.end_of_day
+        end
+
+        start_time = Chronic.parse(start_userspec) || raise(ChronicParseException, "could not parse '#{start_userspec}'")
+        end_time = Chronic.parse(end_userspec) || raise(ChronicParseException, "could not parse '#{end_userspec}'")
+
+        if start_time.to_date == end_time.to_date
+          start_time..end_time
+        else
+          start_time.beginning_of_day..end_time.end_of_day
+        end
+      end
+
+      def self.now
+        CalendarAssistant::Event.new(
+            Google::Apis::CalendarV3::Event.new(start: Google::Apis::CalendarV3::EventDateTime.new(date_time: Time.now),
+                                                end: Google::Apis::CalendarV3::EventDateTime.new(date_time: Time.now),
+                                                summary: Rainbow("          now          ").inverse.faint)
+        )
+      end
+
+      def self.find_av_uri ca, timespec
+        time = Chronic.parse timespec
+        range = time..(time + 5.minutes)
+        event_set = ca.find_events range
+
+        [CalendarAssistant::Event::Response::ACCEPTED,
+         CalendarAssistant::Event::Response::TENTATIVE,
+         CalendarAssistant::Event::Response::NEEDS_ACTION,
+        ].each do |response|
+          event_set.events.reverse.select do |event|
+            event.response_status == response
+          end.each do |event|
+            return [event_set.new(event), event.av_uri] if event.av_uri
+          end
+        end
+
+        event_set.new(nil)
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/linter_event_presenter.rb

@@ -0,0 +1,56 @@
+class CalendarAssistant
+  module CLI
+    class LinterEventPresenter < EventPresenter
+      EMOJI_ACCEPTED = "👍"
+      EMOJI_DECLINED = "👎"
+      EMOJI_NEEDS_ACTION = "🤷"
+      SUMMARY_THRESHOLD = 5
+
+      def description
+        s = formatted_event_date
+        date_length = s.length
+        s += rainbow.wrap(sprintf(" | %s", view_summary)).bold
+        s += event_attributes unless private?
+        s = rainbow.wrap(Rainbow.uncolor(s)).faint.strike if declined?
+        s += "\n #{' ' * (date_length + 2)}attendees: #{attendees}"
+        s
+      end
+
+      def attendees
+        if required_other_attendees .length > SUMMARY_THRESHOLD
+          summary_attendee_list
+        else
+          detailed_attendee_list
+        end
+      end
+
+      private
+
+      def detailed_attendee_list
+        required_other_attendees.map do |attendee|
+          sprintf "%s %s", response_emoji(attendee.response_status), attendee.email || "<no email>"
+        end.join(", ")
+      end
+
+      def summary_attendee_list
+        summary = required_other_attendees.group_by do |attendee|
+          response_emoji(attendee.response_status)
+        end
+
+        summary.sort.map do |emoji, attendees|
+          "#{emoji} - #{attendees.count}"
+        end.join(", ")
+      end
+
+      def required_other_attendees
+        @required_other_attendees ||= (other_human_attendees || []).select {|a| !a.optional }
+      end
+
+      def response_emoji(response_status)
+        return EMOJI_ACCEPTED if response_status == CalendarAssistant::Event::Response::ACCEPTED
+        return EMOJI_DECLINED if response_status == CalendarAssistant::Event::Response::DECLINED
+        return EMOJI_NEEDS_ACTION
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/linter_event_set_presenter.rb

@@ -0,0 +1,23 @@
+class CalendarAssistant
+  module CLI
+    class LinterEventSetPresenter < EventSetPresenter
+      def initialize(obj, config:, event_presenter_class: CLI::LinterEventPresenter)
+        super(obj, config: config, event_presenter_class: event_presenter_class)
+      end
+
+      def title
+        rainbow.wrap(<<~OUT)
+        #{event_repository.calendar.id}
+        - looking for events that need attention
+        - all times in #{event_repository.calendar.time_zone}
+        OUT
+      end
+
+      private
+
+      def rainbow
+        @rainbow ||= Rainbow.global
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/printer.rb

@@ -0,0 +1,90 @@
+class CalendarAssistant
+  module CLI
+    class Printer
+
+      attr_reader :io
+
+      def initialize io = STDOUT
+        @io = io
+      end
+
+      def launch url
+        Launchy.open url
+      end
+
+      def puts *args
+        io.puts(*args)
+      end
+
+      def prompt query, default = nil
+        loop do
+          message = query
+          message += " [#{default}]" if default
+          message += ": "
+          print Rainbow(message).bold
+          answer = STDIN.gets.chomp.strip
+          if answer.empty?
+            return default if default
+            puts Rainbow("Please provide an answer.").red
+          else
+            return answer
+          end
+        end
+      end
+
+      def print_events ca, event_set, omit_title: false, presenter_class: CLI::EventSetPresenter
+        puts presenter_class.new(event_set, config: ca.config).to_s
+        puts
+      end
+
+      def print_available_blocks ca, event_set, omit_title: false
+        ers = ca.config.attendees.map {|calendar_id| ca.event_repository calendar_id}
+        time_zones = ers.map {|er| er.calendar.time_zone}.uniq
+
+        unless omit_title
+          puts Rainbow(ers.map {|er| er.calendar.id}.join(", ")).italic
+          puts Rainbow(sprintf("- looking for blocks at least %s long",
+                               ChronicDuration.output(
+                                   ChronicDuration.parse(
+                                       ca.config.setting(Config::Keys::Settings::MEETING_LENGTH))))).italic
+          time_zones.each do |time_zone|
+            puts Rainbow(sprintf("- between %s and %s in %s",
+                                 ca.config.setting(Config::Keys::Settings::START_OF_DAY),
+                                 ca.config.setting(Config::Keys::Settings::END_OF_DAY),
+                                 time_zone,
+                         )).italic
+          end
+          puts
+        end
+
+        if event_set.is_a?(EventSet::Hash)
+          event_set.events.each do |key, value|
+            puts(sprintf(Rainbow("Availability on %s:\n").bold,
+                         key.strftime("%A, %B %-d")))
+            print_available_blocks ca, event_set.new(value), omit_title: true
+            puts
+          end
+          return
+        end
+
+        events = Array(event_set.events)
+        if events.empty?
+          puts "  (No available blocks in this time range.)"
+          return
+        end
+
+        events.each do |event|
+          line = []
+          time_zones.each do |time_zone|
+            line << sprintf("%s - %s",
+                            event.start_time.in_time_zone(time_zone).strftime("%l:%M%P"),
+                            event.end_time.in_time_zone(time_zone).strftime("%l:%M%P %Z"))
+          end
+          line.uniq!
+          puts " • " + line.join(" / ") + Rainbow(" (" + event.duration + ")").italic
+          pp event if ca.config.debug?
+        end
+      end
+    end
+  end
+end

data/lib/calendar_assistant/config.rb

@@ -2,13 +2,10 @@ class CalendarAssistant
   class Config
     autoload :TokenStore, "calendar_assistant/config/token_store"
 
-    class TomlParseFailure < CalendarAssistant::BaseException ; end
-    class NoConfigFileToPersist < CalendarAssistant::BaseException ; end
-    class NoTokensAuthorized < CalendarAssistant::BaseException ; end
-    class AccessingHashAsScalar < CalendarAssistant::BaseException ; end
-
-    CONFIG_FILE_PATH = File.join ENV["HOME"], ".calendar-assistant"
-    DEFAULT_CALENDAR_ID = "primary"
+    class NoTokensAuthorized < CalendarAssistant::BaseException;
+    end
+    class AccessingHashAsScalar < CalendarAssistant::BaseException;
+    end
 
     module Keys
       TOKENS = "tokens"
@@ -23,6 +20,7 @@ class CalendarAssistant
         MEETING_LENGTH = "meeting-length" # ChronicDuration
         START_OF_DAY = "start-of-day"     # BusinessTime
         END_OF_DAY = "end-of-day"         # BusinessTime
+        LOCATION_ICONS = "location-icons" # Location Icons
       end
 
       #
@@ -35,45 +33,30 @@ class CalendarAssistant
         ATTENDEES = "attendees"     # array of calendar ids (comma-delimited)
         LOCAL_STORE = "local-store" # filename
         DEBUG = "debug"             # bool
+        FORMATTING = "formatting"   # Rainbow
       end
     end
 
+    DEFAULT_CALENDAR_ID = "primary"
+
     DEFAULT_SETTINGS = {
+      Keys::Settings::LOCATION_ICONS => ["🗺 ", "🌎"],    # Location Icons
       Keys::Settings::MEETING_LENGTH => "30m",            # ChronicDuration
       Keys::Settings::START_OF_DAY => "9am",              # BusinessTime
       Keys::Settings::END_OF_DAY => "6pm",                # BusinessTime
       Keys::Options::ATTENDEES => [DEFAULT_CALENDAR_ID],  # array of calendar ids
+      Keys::Options::FORMATTING => true,                  # Rainbow
     }
 
-    attr_reader :config_file_path, :user_config, :options, :defaults
+    attr_reader :user_config, :options, :defaults
 
     def initialize options: {},
-                   config_file_path: CONFIG_FILE_PATH,
-                   config_io: nil,
+                   user_config: {},
                    defaults: DEFAULT_SETTINGS
-      if config_io.nil?
-        @config_file_path = config_file_path
-      end
-
-      @user_config = if config_io
-                       begin
-                         TOML.load config_io.read
-                       rescue Exception => e
-                         raise TomlParseFailure, "could not parse IO stream: #{e}"
-                       end
-                     elsif File.exist? config_file_path
-                       begin
-                         FileUtils.chmod 0600, config_file_path
-                         TOML.load_file config_file_path
-                       rescue Exception => e
-                         raise TomlParseFailure, "could not parse #{config_file_path}: #{e}"
-                       end
-                     else
-                       Hash.new
-                     end
 
       @defaults = defaults
       @options = options
+      @user_config = user_config
     end
 
     def in_env &block
@@ -101,11 +84,10 @@ class CalendarAssistant
       # finally we'll grab the first configured token and set that as the default
       token_names = tokens.keys
       if token_names.empty?
-        raise NoTokensAuthorized, "Please run `calendar-assistant help authorize` for help."
+        raise CalendarAssistant::Config::NoTokensAuthorized, "Please run `calendar-assistant help authorize` for help."
       end
       token_names.first.tap do |new_default|
         Config.set_in_hash user_config, [Keys::SETTINGS, Keys::Settings::PROFILE], new_default
-        persist!
       end
     end
 
@@ -113,7 +95,7 @@ class CalendarAssistant
       rval = Config.find_in_hash(user_config, keypath)
 
       if rval.is_a?(Hash)
-        raise AccessingHashAsScalar, "keypath #{keypath} is not a scalar"
+        raise CalendarAssistant::Config::AccessingHashAsScalar, "keypath #{keypath} is not a scalar"
       end
 
       rval
@@ -133,6 +115,8 @@ class CalendarAssistant
         Config.find_in_hash(defaults, setting_name)
     end
 
+    alias_method :[], :setting
+
     def settings
       setting_names = CalendarAssistant::Config::Keys::Settings.constants.map do |k|
         CalendarAssistant::Config::Keys::Settings.const_get k
@@ -152,18 +136,6 @@ class CalendarAssistant
       CalendarAssistant::Config::TokenStore.new self
     end
 
-    def persist!
-      if config_file_path.nil?
-        raise NoConfigFileToPersist, "Cannot persist config when initialized with an IO"
-      end
-
-      content = TOML::Generator.new(user_config).body
-
-      File.open(config_file_path, "w") do |f|
-        f.write content
-      end
-    end
-
     #
     #  helper method for Keys::Options::ATTENDEES
     #
@@ -179,6 +151,10 @@ class CalendarAssistant
       setting(Keys::Options::DEBUG)
     end
 
+    def persist!
+      #noop
+    end
+
     private
 
     def self.find_in_hash hash, keypath