calendar-assistant 0.1.0

data/lib/calendar_assistant/cli_helpers.rb

@@ -0,0 +1,143 @@
+# coding: utf-8
+class CalendarAssistant
+  module CLIHelpers
+    def self.parse_datespec userspec
+      start_userspec, end_userspec = userspec.split(/ ?\.\.\.? ?/)
+
+      if end_userspec.nil?
+        time = Chronic.parse(userspec) || raise("could not parse #{userspec}")
+        return time.beginning_of_day..time.end_of_day
+      end
+
+      start_time = Chronic.parse(start_userspec) || raise("could not parse #{start_userspec}")
+      end_time = Chronic.parse(end_userspec) || raise("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
+      GCal::Event.new start: GCal::EventDateTime.new(date_time: Time.now),
+                      end: GCal::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)
+      events = ca.find_events range
+
+      [Google::Apis::CalendarV3::Event::Response::ACCEPTED,
+       Google::Apis::CalendarV3::Event::Response::TENTATIVE,
+       Google::Apis::CalendarV3::Event::Response::NEEDS_ACTION,
+      ].each do |response|
+        events.reverse.select do |event|
+          event.response_status == response
+        end.each do |event|
+          return [event, event.av_uri] if event.av_uri
+        end
+      end
+
+      nil
+    end
+
+    class Out
+      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 print_now! ca, event, printed_now
+        return true if printed_now
+        return false if event.start_date != Date.today
+
+        if event.start_time > Time.now
+          puts ca.event_description(CLIHelpers.now)
+          return true
+        end
+
+        false
+      end
+
+      def print_events ca, events, options={}
+        unless options[:omit_title]
+          puts Rainbow("#{ca.calendar.id} (all times in #{ca.calendar.time_zone})\n").italic
+          options = options.merge(omit_title: true)
+        end
+
+        if events.is_a?(Hash)
+          events.each do |key, value|
+            puts Rainbow(key.to_s.capitalize + ":").bold.italic
+            print_events ca, value, options
+          end
+          return
+        end
+
+        events = Array(events)
+        if events.empty?
+          puts "No events in this time range."
+          return
+        end
+
+        display_events = events.select do |event|
+          ! options[:commitments] || event.commitment?
+        end
+
+        printed_now = false
+        display_events.each do |event|
+          printed_now = print_now! ca, event, printed_now
+          puts ca.event_description(event)
+          pp event if options[:debug]
+        end
+
+        puts
+      end
+
+      def print_available_blocks ca, events, options={}
+        unless options[:omit_title]
+          puts Rainbow(sprintf("%s\n- all times in %s\n- looking for blocks at least %s long\n",
+                               ca.calendar.id,
+                               ca.calendar.time_zone,
+                               ChronicDuration.output(ChronicDuration.parse(ca.config.setting(Config::Keys::Settings::MEETING_LENGTH))))
+                      ).italic
+          options = options.merge(omit_title: true)
+        end
+
+        if events.is_a?(Hash)
+          events.each do |key, value|
+            puts(sprintf(Rainbow("Availability on %s:\n").bold,
+                         key.strftime("%A, %B %-d")))
+            print_available_blocks ca, value, options
+            puts
+          end
+          return
+        end
+
+        events = Array(events)
+        if events.empty?
+          puts "  (No available blocks in this time range.)"
+          return
+        end
+
+        events.each do |event|
+          puts(sprintf(" • %s - %s",
+                       event.start.date_time.strftime("%-l:%M%P"),
+                       event.end.date_time.strftime("%-l:%M%P")))
+          pp event if options[:debug]
+        end
+      end
+    end
+  end
+end

data/lib/calendar_assistant/config.rb

@@ -0,0 +1,153 @@
+require "toml"
+
+class CalendarAssistant
+  class Config
+    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"
+
+    module Keys
+      TOKENS = "tokens"
+      SETTINGS = "settings"
+
+      module Settings
+        PROFILE = "profile"
+        MEETING_LENGTH = "meeting-length"
+        START_OF_DAY = "start-of-day"
+        END_OF_DAY = "end-of-day"
+      end
+    end
+
+    DEFAULT_SETTINGS = {
+      Keys::Settings::MEETING_LENGTH => "30m", # ChronicDuration
+      Keys::Settings::START_OF_DAY => "9am", # Chronic
+      Keys::Settings::END_OF_DAY => "6pm", # Chronic
+    }
+
+    attr_reader :config_file_path, :user_config, :options, :defaults
+
+    def initialize options: {},
+                   config_file_path: CONFIG_FILE_PATH,
+                   config_io: nil,
+                   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
+                         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
+    end
+
+    def profile_name
+      # CLI option takes precedence
+      return options["profile"] if options["profile"]
+
+      # then a configured preference takes precedence
+      default = get([Keys::SETTINGS, Keys::Settings::PROFILE])
+      return default if default
+
+      # 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."
+      end
+      token_names.first.tap do |new_default|
+        Config.set_in_hash user_config, [Keys::SETTINGS, Keys::Settings::PROFILE], new_default
+        persist!
+      end
+    end
+
+    def get keypath
+      rval = Config.find_in_hash(user_config, keypath)
+
+      if rval.is_a?(Hash)
+        raise AccessingHashAsScalar, "keypath #{keypath} is not a scalar"
+      end
+
+      rval
+    end
+
+    def set keypath, value
+      Config.set_in_hash user_config, keypath, value
+    end
+
+    def setting setting_name
+      Config.find_in_hash(options, setting_name) ||
+        Config.find_in_hash(user_config, [Keys::SETTINGS, setting_name]) ||
+        Config.find_in_hash(defaults, setting_name)
+    end
+
+    def tokens
+      Config.find_in_hash(user_config, Keys::TOKENS) ||
+        Config.set_in_hash(user_config, Keys::TOKENS, {})
+    end
+
+    def token_store
+      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
+
+    private
+
+    def self.find_in_hash hash, keypath
+      current_val = hash
+      keypath = keypath.split(".") unless keypath.is_a?(Array)
+
+      keypath.each do |key|
+        if current_val.has_key?(key)
+          current_val = current_val[key]
+        else
+          current_val = nil
+          break
+        end
+      end
+
+      current_val
+    end
+
+    def self.set_in_hash hash, keypath, new_value
+      current_hash = hash
+      keypath = keypath.split(".") unless keypath.is_a?(Array)
+      *path_parts, key = *keypath
+
+      path_parts.each do |path_part|
+        current_hash[path_part] ||= {}
+        current_hash = current_hash[path_part]
+      end
+
+      current_hash[key] = new_value
+    end
+  end
+end
+
+require "calendar_assistant/config/token_store"

data/lib/calendar_assistant/config/token_store.rb

@@ -0,0 +1,25 @@
+class CalendarAssistant
+  class Config
+    class TokenStore
+      attr_reader :config
+
+      def initialize config
+        @config = config
+      end
+
+      def delete id
+        config.tokens.delete(id)
+        config.persist!
+      end
+
+      def load id
+        config.tokens[id]
+      end
+
+      def store id, token
+        config.tokens[id] = token
+        config.persist!
+      end
+    end
+  end
+end

data/lib/calendar_assistant/event_extensions.rb

@@ -0,0 +1,173 @@
+#
+#  this file extends the Google::Event class found in the "google_calendar" rubygem
+#
+
+require "google/apis/calendar_v3"
+require "time"
+
+class Google::Apis::CalendarV3::Event
+  module RealResponse
+    DECLINED = "declined"
+    ACCEPTED = "accepted"
+    NEEDS_ACTION = "needsAction"
+    TENTATIVE = "tentative"
+  end
+
+  module Response
+    include RealResponse
+    SELF = "self" # not part of Google's API, but useful to represent meetings-for-myself
+  end
+
+  module Transparency
+    TRANSPARENT = "transparent"
+    OPAQUE = "opaque"
+  end
+
+  module Visibility
+    DEFAULT = "default"
+    PUBLIC = "public"
+    PRIVATE = "private"
+  end
+
+  LOCATION_EVENT_REGEX = /^#{CalendarAssistant::EMOJI_WORLDMAP}/
+
+  def update **args
+    # this should be in the google API classes, IMHO
+    update!(**args)
+    self
+  end
+
+  def location_event?
+    !! (summary =~ LOCATION_EVENT_REGEX)
+  end
+
+  def all_day?
+    !! @start.to_date
+  end
+
+  def past?
+    if all_day?
+      Date.today >= self.end.to_date
+    else
+      Time.now >= self.end.date_time
+    end
+  end
+
+  def current?
+    ! (past? || future?)
+  end
+
+  def future?
+    if all_day?
+      self.start.to_date > Date.today
+    else
+      self.start.date_time > Time.now
+    end
+  end
+
+  def accepted?
+    response_status == Response::ACCEPTED
+  end
+
+  def declined?
+    response_status == Response::DECLINED
+  end
+
+  def one_on_one?
+    return false if attendees.nil?
+    return false unless attendees.any? { |a| a.self }
+    return false if human_attendees.length != 2
+    true
+  end
+
+  def busy?
+    transparency != Transparency::TRANSPARENT
+  end
+
+  def commitment?
+    return false if human_attendees.nil? || human_attendees.length < 2
+    return false if declined?
+    true
+  end
+
+  def private?
+    visibility == Visibility::PRIVATE
+  end
+
+  def start_time
+    if all_day?
+      self.start.to_date.beginning_of_day
+    else
+      self.start.date_time
+    end
+  end
+
+  def start_date
+    if all_day?
+      self.start.to_date
+    else
+      self.start.date_time.to_date
+    end
+  end
+
+  def human_attendees
+    return nil if attendees.nil?
+    attendees.select { |a| ! a.resource }
+  end
+
+  def attendee id
+    return nil if attendees.nil?
+    attendees.find do |attendee|
+      attendee.email == id
+    end
+  end
+
+  def response_status
+    return Response::SELF if attendees.nil?
+    attendees.each do |attendee|
+      return attendee.response_status if attendee.self
+    end
+    nil
+  end
+
+  def av_uri
+    @av_uri ||= begin
+                  zoom = CalendarAssistant::StringHelpers.find_uri_for_domain(description, "zoom.us")
+                  return zoom if zoom
+
+                  return hangout_link if hangout_link
+                  nil
+                end
+  end
+
+  def view_summary
+    return "(private)" if private? && (summary.nil? || summary.blank?)
+    return "(no title)" if summary.nil? || summary.blank?
+    summary
+  end
+end
+
+class Google::Apis::CalendarV3::EventDateTime
+  def to_date
+    return nil if @date.nil?
+    return Date.parse(@date) if @date.is_a?(String)
+    @date
+  end
+
+  def to_date!
+    return @date_time.to_date if @date.nil?
+    to_date
+  end
+
+  def to_s
+    return @date.to_s if @date
+    @date_time.strftime "%Y-%m-%d %H:%M"
+  end
+
+  def == lhs
+    if @date
+      return to_date == lhs.to_date
+    end
+    date_time == lhs.date_time
+  end
+end