flycal-cli 0.3.2 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bf3465bededbb5ea79788ae636545efa83710701dfad008317dff95db661cfb
-  data.tar.gz: 9ba431d04731b33bff46b4e6abf19e36f167d9750faf54eb547bf92696664d4c
+  metadata.gz: 61b9a15ce2341c56bbac3c59bd465e02a13082e817a367cc19467dc88e874b76
+  data.tar.gz: d6cf5b95459a56289a5e9d8b22c706be82f85cc51ddcb42dbcb30b4c7b0b1e66
 SHA512:
-  metadata.gz: 2d705bd0ae05ace6e411d6d798d27c80b474d06c5ebc1a9a89ed5adec53c61d2cb928c58d63429b27708ceb3dfef19d439fa96433317e55a983835aa66b41dcc
-  data.tar.gz: ba81a344d0e36865120a84174ade7532bac11bcf86e767e111dcb128196f34fc99adeae2623496dcb1e8e3bc26061d8e6d087ebfe7e886f806f53896b080df49
+  metadata.gz: 58585691471f02638b1490300ce22a722bad34bcb3e53f2069975697385d8e4cb313b7311fd68dbbdd1fbfc38bcd77ee1f95a600f5c2b56394c7317e70b9b029
+  data.tar.gz: 6b2b9fd98a5e629b27e4117ba135c72de9e348cfbba04b494b68b3291554b29b3a5c7233d32a330de4879da213870a17bb537d7e3f23fd39a81219607a8b501c

data/README.md

@@ -1,5 +1,7 @@
 # flycal-cli
 
+[![Gem Version](https://badge.fury.io/rb/flycal-cli.svg)](https://badge.fury.io/rb/flycal-cli) 
+
 A command-line tool to access and search Google Calendar events. Connect your Google account, choose a default calendar, and search events with flexible date ranges and text filters.
 
 ## Requirements
@@ -37,6 +39,13 @@ Before using flycal, you need OAuth credentials from Google Cloud Console:
 
 ## Commands
 
+All commands support a per-invocation locale override:
+
+```bash
+flycal search --locale it --in 7days
+flycal slots --locale en --in "3 days" --duration 1h
+```
+
 ### login
 
 Connect to your Google account. Opens a browser for OAuth authentication when not yet connected.
@@ -55,6 +64,24 @@ Disconnect from your Google account and remove stored tokens.
 flycal logout
 ```
 
+### update
+
+Update `flycal-cli` to the latest published gem version.
+
+```bash
+flycal update
+```
+
+### version
+
+Show the current installed `flycal-cli` version.
+
+```bash
+flycal version
+flycal --version
+flycal -v
+```
+
 ### calendars
 
 List available calendars and set the default one. Uses an interactive scrollable menu (arrow keys to navigate, type to filter).
@@ -78,13 +105,11 @@ flycal search -i 2months -d placeholder
 
 **Options:**
 
-| Option | Short | Description |
-|--------|-------|-------------|
-| `--from` | `-f` | Start date/time. Default: midnight of current day. Format: `2025-01-01` or `2025-01-01T09:00` |
-| `--to` | `-t` | End date/time. Default: 23:59 of the 30th day from today. Format: same as `--from` |
-| `--in` | `-i` | Duration from `--from`, overrides `--to`. Format: `30days`, `48hours`, `2months`, `1year` (no space between number and unit). With space, use quotes: `--in "30 days"` |
-| `--calendar` | `-c` | Calendar name or ID. Default: calendar set via `flycal calendars` |
-| `--description` | `-d` | Filter events by text. Matches events where the string appears in the title or description (case-insensitive, contains) |
+- `--from` / `-f` — Start date/time. Default: midnight of current day. Format: `2025-01-01` or `2025-01-01T09:00`
+- `--to` / `-t` — End date/time. Default: 23:59 of the 30th day from today. Format: same as `--from`
+- `--in` / `-i` — Duration from `--from`, overrides `--to`. Format: `30days`, `48hours`, `2months`, `1year` (no space). With space use quotes: `--in "30 days"`
+- `--calendar` / `-c` — Calendar name or ID. Default: calendar set via `flycal calendars`
+- `--description` / `-d` — Filter events by text. Matches events where the string appears in title or description (case-insensitive, contains)
 
 **Time range behavior:**
 
@@ -103,12 +128,58 @@ The summary shows:
 
 For time frames longer than 7 days, a weekly breakdown is added (week number, start/end dates, hours, working days per week). For time frames longer than 30 days, a monthly breakdown is shown instead (month number, month name, hours, working days per month).
 
+### slots
+
+Find free time slots in your calendar (weekdays, 9:00–18:00). Output is a simple list for copy/paste into email or other tools.
+
+```bash
+flycal slots --in "3 days" --duration 1h
+flycal slots --in 1week --duration 30min
+flycal slots --in "48 hours" --duration 1hour -c Work
+```
+
+**Options:**
+
+- `--duration` — Minimum slot length. Examples: `1h`, `1 hour`, `30 minutes`, `90min`
+- `--in` / `-i` — Search window from now. Examples: `3 days`, `1 week`, `48 hours` (use quotes when the value contains a space)
+- `--calendar` / `-c` — Calendar name or ID (optional; uses default calendar)
+
+Slot search windows are configured in `~/.flycal/config.yml`:
+
+```yaml
+slots:
+  workhours:
+    - 9:30-13:00
+    - 14:00-18:30
+  weekdays-only: true
+locale: en
+```
+
+Missing keys are filled from `config/defaults.yml` in the gem and saved to your `config.yml` on first read.
+
+- `workhours` accepts one or more ranges (`H-H`, `HH:MM-HH:MM`, mixed)
+- `weekdays-only: true` limits slots to Monday-Friday
+- `weekdays-only: false` includes weekends
+- `locale` supports `en` and `it` (default is `en`)
+
+**Output example:**
+
+```
+friday 15/7
+10-12
+13-15.30
+
+monday 21/7
+12-13
+14-15
+```
+
 ## Configuration
 
 Data is stored in `~/.flycal/`:
 
 | File | Purpose |
-|------|---------|
+|:-----|---------|
 | `config.yml` | Default calendar ID and other settings |
 | `credentials.json` | OAuth credentials (created manually from Google Cloud Console) |
 | `tokens.yml` | Access tokens (managed automatically) |

data/config/defaults.yml

@@ -0,0 +1,6 @@
+locale: en
+slots:
+  workhours:
+    - 9:30-13:00
+    - 14:00-18:30
+  weekdays-only: true

data/lib/flycal_cli/cli.rb

@@ -12,6 +12,7 @@ require "tty-spinner"
 module FlycalCli
   class Cli < Thor
     package_name "flycal"
+    class_option :locale, type: :string, desc: "Override locale for this command (e.g. en, it)"
 
     def self.exit_on_failure?
       true
@@ -19,6 +20,7 @@ module FlycalCli
 
     desc "login", "Connect to your Google account"
     def login
+      apply_locale_override
       if Auth.logged_in?
         puts "✓ You are already connected to your Google account."
         puts "\nRun 'flycal calendars' to set the default calendar."
@@ -48,6 +50,7 @@ module FlycalCli
 
     desc "logout", "Disconnect from Google account"
     def logout
+      apply_locale_override
       unless Auth.logged_in?
         puts "You are not connected to any Google account."
         return
@@ -59,6 +62,7 @@ module FlycalCli
 
     desc "calendars", "List available calendars and set the default one"
     def calendars
+      apply_locale_override
       unless Auth.logged_in?
         puts "You are not connected. Run 'flycal login' first."
         exit 1
@@ -125,6 +129,7 @@ module FlycalCli
     option :in, type: :string, aliases: "-i", desc: "Duration: 30days, 48hours, 2months, 1year (overrides --to)"
     option :description, type: :string, aliases: "-d", desc: "Filter by text in event"
     def search
+      apply_locale_override
       unless Auth.logged_in?
         puts "You are not connected. Run 'flycal login' first."
         exit 1
@@ -167,6 +172,88 @@ module FlycalCli
       print_search_summary(events, time_min: time_min, time_max: time_max)
     end
 
+    desc "slots", "Find available time slots in your calendar"
+    long_desc <<-LONGDESC
+      List free time slots long enough for a given duration.
+
+      Examples:
+        flycal slots --in "3 days" --duration 1h
+        flycal slots --in 1week --duration 30min -c Work
+    LONGDESC
+    option :duration, type: :string, required: true,
+           desc: "Minimum slot length (e.g. 1h, 30 minutes, 1 hour)"
+    option :in, type: :string, aliases: "-i", required: true,
+           desc: "Search window from now (e.g. 3 days, 1 week, 48 hours)"
+    option :calendar, type: :string, aliases: "-c", desc: "Calendar name or ID"
+    def slots
+      apply_locale_override
+      unless Auth.logged_in?
+        puts Locale.t("errors.not_connected")
+        exit 1
+      end
+
+      begin
+        slot_duration = DurationParser.to_seconds(options[:duration])
+        time_min = Time.now
+        time_max = DurationParser.add_to_time(options[:in], time_min)
+        slot_cfg = Config.slots_config
+        workhours = parse_workhours(slot_cfg["workhours"])
+        weekdays_only = !!slot_cfg["weekdays-only"]
+      rescue FlycalCli::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+
+      if time_min >= time_max
+        puts Locale.t("errors.duration_positive")
+        exit 1
+      end
+
+      creds = Auth.credentials
+      service = CalendarService.new(creds)
+
+      calendar_id = resolve_single_calendar_id(service, options[:calendar])
+      if calendar_id.nil?
+        puts Locale.t("slots.no_calendar")
+        exit 1
+      end
+
+      events = service.list_events(
+        calendar_id,
+        time_min: time_min,
+        time_max: time_max
+      )
+
+      finder = SlotFinder.new(
+        events: events,
+        time_min: time_min,
+        time_max: time_max,
+        slot_duration_seconds: slot_duration,
+        workhours: workhours,
+        weekdays_only: weekdays_only
+      )
+
+      output = SlotFormatter.format_output(finder.slots_by_day)
+      puts output.empty? ? Locale.t("slots.no_available") : output
+    end
+
+    desc "update", "Update flycal-cli to the latest gem version"
+    def update
+      apply_locale_override
+      puts "Updating flycal-cli..."
+      success = system("gem", "update", "flycal-cli")
+      return if success
+
+      puts "Error: failed to update flycal-cli."
+      exit 1
+    end
+
+    desc "version", "Show current flycal-cli version"
+    def version
+      apply_locale_override
+      puts "flycal #{FlycalCli::VERSION}"
+    end
+
     default_task :help
 
     private
@@ -177,6 +264,10 @@ module FlycalCli
       "\e[1m#{str}\e[0m"
     end
 
+    def apply_locale_override
+      Locale.override!(options[:locale])
+    end
+
     def parse_datetime(str, end_of_day: false)
       return nil if str.nil? || str.empty?
 
@@ -211,6 +302,50 @@ module FlycalCli
       end
     end
 
+    def parse_hour_minute(value)
+      match = value.to_s.strip.match(/\A(\d{1,2}):(\d{2})\z/)
+      raise FlycalCli::Error, "Invalid time format #{value.inspect}. Use HH:MM (e.g. 9:00, 18:30)." unless match
+
+      hour = match[1].to_i
+      minute = match[2].to_i
+      unless hour.between?(0, 23) && minute.between?(0, 59)
+        raise FlycalCli::Error, "Invalid time #{value.inspect}. Hour must be 0-23 and minute 0-59."
+      end
+
+      [hour, minute]
+    end
+
+    def parse_workhours(values)
+      ranges = Array(values).map do |item|
+        start_str, end_str = item.to_s.strip.split("-", 2)
+        raise FlycalCli::Error, "Invalid workhours item #{item.inspect}. Use format like '9-13' or '14:30-18:00'." if start_str.nil? || end_str.nil?
+
+        sh, sm = parse_hour_minute_flexible(start_str)
+        eh, em = parse_hour_minute_flexible(end_str)
+        start_minutes = (sh * 60) + sm
+        end_minutes = (eh * 60) + em
+        raise FlycalCli::Error, "Invalid workhours range #{item.inspect}: end must be after start." if end_minutes <= start_minutes
+
+        [sh, sm, eh, em]
+      end
+
+      raise FlycalCli::Error, "slots.workhours cannot be empty in config.yml." if ranges.empty?
+
+      ranges.sort_by { |sh, sm, _eh, _em| (sh * 60) + sm }
+    end
+
+    def parse_hour_minute_flexible(value)
+      str = value.to_s.strip
+      if str.match?(/\A\d{1,2}\z/)
+        hour = str.to_i
+        raise FlycalCli::Error, "Invalid hour #{value.inspect}. Must be 0-23." unless hour.between?(0, 23)
+
+        return [hour, 0]
+      end
+
+      parse_hour_minute(str)
+    end
+
     def resolve_calendar_ids(service, calendar_name)
       calendar_lists = service.list_calendars
 
@@ -236,6 +371,22 @@ module FlycalCli
       matches.map(&:id)
     end
 
+    def resolve_single_calendar_id(service, calendar_name)
+      if calendar_name && !calendar_name.empty?
+        ids = resolve_calendar_ids(service, calendar_name)
+        return ids.first
+      end
+
+      default_id = Config.calendar_default
+      return default_id if default_id
+
+      calendars = service.list_calendars
+      primary = calendars.find(&:primary)
+      return primary.id if primary
+
+      calendars.first&.id
+    end
+
     def print_events(service, events)
       # Use calendar list for names (avoids extra API calls)
       calendar_list = service.list_calendars
@@ -264,7 +415,7 @@ module FlycalCli
       if dt.is_a?(String)
         dt
       else
-        dt.strftime("%a %Y-%m-%d %H:%M")
+        "#{Locale.day_abbr(dt)} #{dt.strftime("%Y-%m-%d %H:%M")}"
       end
     end
 
@@ -272,7 +423,7 @@ module FlycalCli
       return "-" if dt.nil?
 
       t = dt.respond_to?(:to_time) ? dt.to_time : dt
-      t.strftime("%a %Y-%m-%d")
+      "#{Locale.day_abbr(t)} #{t.strftime("%Y-%m-%d")}"
     end
 
     def print_search_summary(events, time_min:, time_max:)
@@ -362,7 +513,7 @@ module FlycalCli
         mins = minutes_in_period(event_ranges, period_start, period_end)
         hours = (mins / 60).round(1)
         working_days = (mins / 60.0 / HOURS_PER_WORKING_DAY).round(1)
-        month_name = current.strftime("%B %Y")
+        month_name = "#{Locale.month_name(current)} #{current.year}"
         start_str = format_date_with_day(period_start)
         last_day = (period_end.to_date - 1.day)
         end_str = format_date_with_day(last_day)

data/lib/flycal_cli/config.rb

@@ -9,12 +9,20 @@ module FlycalCli
     CONFIG_FILE = File.join(CONFIG_DIR, "config.yml")
     CREDENTIALS_FILE = File.join(CONFIG_DIR, "credentials.json")
     TOKENS_FILE = File.join(CONFIG_DIR, "tokens.yml")
+    DEFAULTS_FILE = File.expand_path("../../config/defaults.yml", __dir__)
 
     class << self
       def load
-        return {} unless File.exist?(CONFIG_FILE)
+        user_data = if File.exist?(CONFIG_FILE)
+                      YAML.load_file(CONFIG_FILE) || {}
+                    else
+                      {}
+                    end
 
-        YAML.load_file(CONFIG_FILE) || {}
+        merged, changed = merge_missing_defaults(user_data, default_values)
+        save(merged) if changed || !File.exist?(CONFIG_FILE)
+
+        merged
       end
 
       def save(data)
@@ -51,6 +59,59 @@ module FlycalCli
       def clear_all
         FileUtils.rm_rf(CONFIG_DIR)
       end
+
+      def slots_config
+        load.fetch("slots", {})
+      end
+
+      def locale
+        load["locale"].to_s
+      end
+
+      def locale=(value)
+        data = load
+        data["locale"] = value.to_s
+        save(data)
+      end
+
+      def default_values
+        @default_values ||= begin
+          raise "Defaults file not found: #{DEFAULTS_FILE}" unless File.exist?(DEFAULTS_FILE)
+
+          YAML.load_file(DEFAULTS_FILE) || {}
+        end
+      end
+
+      def merge_missing_defaults(target, defaults)
+        merged = target.dup
+        changed = false
+
+        defaults.each do |key, default_value|
+          if !merged.key?(key)
+            merged[key] = deep_dup(default_value)
+            changed = true
+          elsif default_value.is_a?(Hash) && merged[key].is_a?(Hash)
+            nested, nested_changed = merge_missing_defaults(merged[key], default_value)
+            merged[key] = nested
+            changed ||= nested_changed
+          end
+        end
+
+        [merged, changed]
+      end
+
+      def deep_dup(value)
+        case value
+        when Hash
+          value.transform_values { |v| deep_dup(v) }
+        when Array
+          value.map { |v| deep_dup(v) }
+        else
+          value
+        end
+      end
+
+      private :default_values, :merge_missing_defaults, :deep_dup
     end
   end
 end

data/lib/flycal_cli/duration_parser.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/numeric/time"
+require "active_support/core_ext/integer/time"
+
+module FlycalCli
+  class DurationParser
+    UNITS = {
+      "s" => :seconds, "sec" => :seconds, "second" => :seconds, "seconds" => :seconds,
+      "m" => :minutes, "min" => :minutes, "mins" => :minutes, "minute" => :minutes, "minutes" => :minutes,
+      "h" => :hours, "hr" => :hours, "hour" => :hours, "hours" => :hours,
+      "d" => :days, "day" => :days, "days" => :days,
+      "w" => :weeks, "week" => :weeks, "weeks" => :weeks
+    }.freeze
+
+    class << self
+      def parse(str)
+        normalized = str.to_s.strip.downcase
+        match = normalized.match(/\A(\d+(?:\.\d+)?)\s*([a-z]+)\z/) ||
+                normalized.match(/\A(\d+(?:\.\d+)?)([a-z]+)\z/)
+        raise FlycalCli::Error, invalid_message(str) unless match
+
+        value = match[1].to_f
+        unit = UNITS[match[2]]
+        raise FlycalCli::Error, invalid_message(str) unless unit
+
+        duration = value.public_send(unit)
+        duration
+      end
+
+      def to_seconds(str)
+        parse(str).to_i
+      end
+
+      def add_to_time(str, from_time)
+        from_time + parse(str)
+      end
+
+      private
+
+      def invalid_message(str)
+        "Invalid duration: #{str.inspect}. Examples: 1h, 1 hour, 30 minutes, 3 days"
+      end
+    end
+  end
+end

data/lib/flycal_cli/locale.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "json"
+
+module FlycalCli
+  module Locale
+    module_function
+
+    FALLBACK_LOCALE = "en"
+
+    def t(key, vars = {})
+      value = lookup(translations(current_locale), key) || lookup(translations(FALLBACK_LOCALE), key) || key
+      interpolate(value, vars)
+    end
+
+    def day_name(date_or_time)
+      idx = date_or_time.to_date.wday
+      days = t("common.weekdays.full")
+      days[idx] || date_or_time.strftime("%A").downcase
+    end
+
+    def day_abbr(date_or_time)
+      idx = date_or_time.to_date.wday
+      days = t("common.weekdays.abbr")
+      days[idx] || date_or_time.strftime("%a")
+    end
+
+    def month_name(date_or_time)
+      idx = date_or_time.to_date.month - 1
+      months = t("common.months.full")
+      months[idx] || date_or_time.strftime("%B")
+    end
+
+    def current_locale
+      Thread.current[:flycal_locale_override] || Config.locale
+    rescue StandardError
+      FALLBACK_LOCALE
+    end
+
+    def override!(locale)
+      Thread.current[:flycal_locale_override] = locale.to_s if locale && !locale.to_s.strip.empty?
+    end
+
+    def translations(locale)
+      @cache ||= {}
+      loc = locale.to_s
+      @cache[loc] ||= begin
+        path = File.expand_path("../../locales/#{loc}.json", __dir__)
+        File.exist?(path) ? JSON.parse(File.read(path)) : {}
+      end
+    end
+
+    def lookup(hash, dotted_key)
+      dotted_key.to_s.split(".").reduce(hash) do |acc, part|
+        acc.is_a?(Hash) ? acc[part] : nil
+      end
+    end
+
+    def interpolate(value, vars)
+      return value unless value.is_a?(String)
+
+      value.gsub(/%\{(\w+)\}/) do
+        vars.fetch(Regexp.last_match(1).to_sym, Regexp.last_match(0)).to_s
+      end
+    end
+  end
+end

data/lib/flycal_cli/slot_finder.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module FlycalCli
+  class SlotFinder
+    DEFAULT_WORKHOURS = [[9, 0, 18, 0]].freeze
+
+    def initialize(
+      events:,
+      time_min:,
+      time_max:,
+      slot_duration_seconds:,
+      workhours: DEFAULT_WORKHOURS,
+      weekdays_only: true
+    )
+      @events = events
+      @time_min = time_min
+      @time_max = time_max
+      @slot_duration_seconds = slot_duration_seconds
+      @workhours = workhours
+      @weekdays_only = weekdays_only
+    end
+
+    def slots_by_day
+      result = {}
+
+      each_workday do |date|
+        slots = []
+        day_intervals(date).each do |day_start, day_end|
+          next if day_end <= day_start
+
+          busy = busy_intervals_for(date, day_start, day_end)
+          gaps = free_gaps(day_start, day_end, busy)
+          slots.concat(gaps.filter_map { |start_at, end_at| slot_if_fits(start_at, end_at) })
+        end
+        result[date] = slots unless slots.empty?
+      end
+
+      result
+    end
+
+    private
+
+    def each_workday
+      date = @time_min.to_date
+      end_date = @time_max.to_date
+
+      while date <= end_date
+        yield date if include_day?(date)
+        date += 1
+      end
+    end
+
+    def include_day?(date)
+      return true unless @weekdays_only
+
+      workday?(date)
+    end
+
+    def workday?(date)
+      !date.saturday? && !date.sunday?
+    end
+
+    def day_intervals(date)
+      @workhours.map do |start_h, start_m, end_h, end_m|
+        start_at = Time.local(date.year, date.month, date.day, start_h, start_m, 0)
+        end_at = Time.local(date.year, date.month, date.day, end_h, end_m, 0)
+        start_at = [@time_min, start_at].max
+        end_at = [@time_max, end_at].min
+        [start_at, end_at]
+      end
+    end
+
+    def busy_intervals_for(date, day_start, day_end)
+      intervals = @events.filter_map do |event|
+        interval_for_event(event, date, day_start, day_end)
+      end
+      merge_intervals(intervals)
+    end
+
+    def interval_for_event(event, date, day_start, day_end)
+      return nil if event.status == "cancelled"
+      return nil if event.transparency == "transparent"
+
+      if event.start&.date
+        event_date = Date.parse(event.start.date.to_s)
+        event_end_date = Date.parse(event.end.date.to_s)
+        return nil unless date >= event_date && date < event_end_date
+
+        return [day_start, day_end]
+      end
+
+      start_at = to_time(event.start.date_time)
+      end_at = to_time(event.end.date_time)
+      return nil if end_at <= day_start || start_at >= day_end
+
+      [[start_at, day_start].max, [end_at, day_end].min]
+    end
+
+    def merge_intervals(intervals)
+      return [] if intervals.empty?
+
+      sorted = intervals.sort_by(&:first)
+      merged = [sorted.first]
+
+      sorted[1..].each do |start_at, end_at|
+        last_start, last_end = merged.last
+        if start_at <= last_end
+          merged[-1] = [last_start, [last_end, end_at].max]
+        else
+          merged << [start_at, end_at]
+        end
+      end
+
+      merged
+    end
+
+    def free_gaps(day_start, day_end, busy)
+      gaps = []
+      cursor = day_start
+
+      busy.each do |start_at, end_at|
+        gaps << [cursor, start_at] if start_at > cursor
+        cursor = [cursor, end_at].max
+      end
+
+      gaps << [cursor, day_end] if cursor < day_end
+      gaps
+    end
+
+    def slot_if_fits(start_at, end_at)
+      rounded_start = round_up_15(start_at)
+      rounded_end = round_down_15(end_at)
+      return nil if rounded_start >= rounded_end
+      return nil if (rounded_end - rounded_start) < @slot_duration_seconds
+
+      [rounded_start, rounded_end]
+    end
+
+    def round_up_15(time)
+      sec = time.to_i
+      remainder = sec % 900
+      return time if remainder.zero?
+
+      Time.at(sec + (900 - remainder))
+    end
+
+    def round_down_15(time)
+      sec = time.to_i
+      Time.at(sec - (sec % 900))
+    end
+
+    def to_time(value)
+      return value if value.is_a?(Time)
+      return value.to_time if value.respond_to?(:to_time) && !value.is_a?(String)
+
+      Time.parse(value.to_s)
+    end
+  end
+end

data/lib/flycal_cli/slot_formatter.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module FlycalCli
+  class SlotFormatter
+    class << self
+      def format_output(slots_by_day)
+        lines = []
+
+        slots_by_day.sort_by(&:first).each do |date, slots|
+          lines << "" unless lines.empty?
+          lines << day_header(date)
+          slots.each do |start_at, end_at|
+            lines << slot_range(start_at, end_at)
+          end
+        end
+
+        lines.join("\n")
+      end
+
+      private
+
+      def day_header(date)
+        "#{Locale.day_name(date)} #{date.day}/#{date.month}"
+      end
+
+      def slot_range(start_at, end_at)
+        "#{format_time(start_at)}-#{format_time(end_at)}"
+      end
+
+      def format_time(time)
+        return time.strftime("%-H") if time.min.zero?
+
+        minutes = sprintf("%02d", time.min)
+        "#{time.hour}.#{minutes}"
+      end
+    end
+  end
+end

data/lib/flycal_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FlycalCli
-  VERSION = '0.3.2'
+  VERSION = '0.4.1'
 end

data/lib/flycal_cli.rb

@@ -2,8 +2,12 @@
 
 require "flycal_cli/version"
 require "flycal_cli/config"
+require "flycal_cli/locale"
 require "flycal_cli/auth"
+require "flycal_cli/duration_parser"
 require "flycal_cli/calendar_service"
+require "flycal_cli/slot_finder"
+require "flycal_cli/slot_formatter"
 require "flycal_cli/cli"
 
 module FlycalCli

data/locales/en.json

@@ -0,0 +1,19 @@
+{
+  "common": {
+    "weekdays": {
+      "full": ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"],
+      "abbr": ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+    },
+    "months": {
+      "full": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"]
+    }
+  },
+  "slots": {
+    "no_available": "No available slots found.",
+    "no_calendar": "No calendar found. Run 'flycal calendars' to set a default."
+  },
+  "errors": {
+    "not_connected": "You are not connected. Run 'flycal login' first.",
+    "duration_positive": "Error: --in must be a positive duration."
+  }
+}

data/locales/it.json

@@ -0,0 +1,19 @@
+{
+  "common": {
+    "weekdays": {
+      "full": ["domenica", "lunedi", "martedi", "mercoledi", "giovedi", "venerdi", "sabato"],
+      "abbr": ["Dom", "Lun", "Mar", "Mer", "Gio", "Ven", "Sab"]
+    },
+    "months": {
+      "full": ["gennaio", "febbraio", "marzo", "aprile", "maggio", "giugno", "luglio", "agosto", "settembre", "ottobre", "novembre", "dicembre"]
+    }
+  },
+  "slots": {
+    "no_available": "Nessuno slot disponibile.",
+    "no_calendar": "Nessun calendario trovato. Esegui 'flycal calendars' per impostare il predefinito."
+  },
+  "errors": {
+    "not_connected": "Non sei connesso. Esegui prima 'flycal login'.",
+    "duration_positive": "Errore: --in deve essere una durata positiva."
+  }
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flycal-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.1
 platform: ruby
 authors:
 - flycal-cli
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: pstore
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: google-apis-calendar_v3
   requirement: !ruby/object:Gem::Requirement
@@ -119,12 +133,19 @@ files:
 - LICENSE
 - README.md
 - bin/flycal
+- config/defaults.yml
 - lib/flycal_cli.rb
 - lib/flycal_cli/auth.rb
 - lib/flycal_cli/calendar_service.rb
 - lib/flycal_cli/cli.rb
 - lib/flycal_cli/config.rb
+- lib/flycal_cli/duration_parser.rb
+- lib/flycal_cli/locale.rb
+- lib/flycal_cli/slot_finder.rb
+- lib/flycal_cli/slot_formatter.rb
 - lib/flycal_cli/version.rb
+- locales/en.json
+- locales/it.json
 homepage: https://github.com/magnum/flycal-cli
 licenses:
 - MIT
@@ -146,7 +167,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.17
 specification_version: 4
 summary: CLI to access Google calendars
 test_files: []