icalPal 3.2.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc2cfd940c507b46cafd9c893beb25c47c82850ba7c1e02aaffcb6bc76eda208
-  data.tar.gz: e28610d838feaf2c05b41badd96bad57185501529cd73c7f0b7f5889290a59ef
+  metadata.gz: 3a74d33ac1b8d65466f6ef4820813ad983c7bb539438c11d12eb61daaa2af83f
+  data.tar.gz: 3c2790143a7b5abde6304312099988de264cc767fde30c34dd8b7682a80bd782
 SHA512:
-  metadata.gz: 2cdd430f7a66418a87cccf5c037f24d0e4fe39e594db5b951ea004c13eadafd15f398bfc0beac8b5fe4c987664a1ee56d9e113354a438e06cf2fe9c3d88c3304
-  data.tar.gz: ee2276cb96b75d93727bc9dcf4595cd8bef64ccd0893e4e3647f0c5a74d559cddf86434bf0a392176e3a05f7339d8b9651347e5c6098c45467aaf8c163349b62
+  metadata.gz: 031fae41c01699e5eb757dd0f838e702fccd0d65fb3ab1aca3a6dde20083ed5ec43c88a1bc2c43e11e0a77399aea21e860d3f13f7590d90a00f912d3d87bff1b
+  data.tar.gz: 9e1cfa76f56f735406553d40d13e16ce786461ab331eea9cc0757ffe0858e92ef3c9bae843934f9a55098ec1a28d6e03852aed3ce3bc244a56de362b584de5bd

data/README.md

@@ -4,11 +4,27 @@
 
 ## Description
 
-icalPal is a command-line tool to query a macOS Calendar and Reminders
+icalPal is a command-line tool to query macOS Calendar and Reminders
 databases for accounts, calendars, events, and tasks.  It can be run
 on any system with [Ruby](https://www.ruby-lang.org/) and access to a
 Calendar or Reminders database.
 
+<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
+
+**Table of Contents**
+
+- [Installation](#installation)
+- [Features](#features)
+  - [Compatability with icalBuddy](#compatability-with-icalbuddy)
+  - [Additional commands](#additional-commands)
+  - [Additional options](#additional-options)
+- [Usage](#usage)
+- [Output formats](#output-formats)
+- [History](#history)
+
+<!-- markdown-toc end -->
+
+
 ## Installation
 
 As a system-wide Ruby gem:
@@ -23,18 +39,11 @@ or in your home diretory:
 gem install --user-install icalPal
 ```
 
-As a Homebrew formula:
-
-```
-brew tap ajrosen/icalPal
-brew install icalPal
-```
-
 ## Features
 
-### Compatability with [icalBuddy](https://github.com/ali-rantakari/icalBuddy)
+### Compatability with icalBuddy
 
-icalPal tries to be compatible with icalBuddy for command-line options
+icalPal tries to be compatible with [icalBuddy](https://github.com/ali-rantakari/icalBuddy) for command-line options
 and for output.  There are a some important differences to be aware
 of.
 
@@ -62,7 +71,7 @@ Shows only reminders that have a due date.
 * The ```-c``` part is optional, but you cannot abbreviate the command if you leave it off.
 * Use ```-o``` to print the output in different formats.  CSV or JSON are intertesting choices.
 * Copy your Calendar database file and use ```--db``` on it.
-* ```--it``` and ```--et``` will filter by Calendar *type*.  Types are **Local**, **Exchange**, **CalDAV**, **MobileMe**, **Subscribed**, and **Birthdays**
+* ```--it``` and ```--et``` will filter by Calendar *type*.  Types are **Local**, **Exchange**, **CalDAV**, **MobileMe**, **Subscribed**, **Birthdays**, and **Reminders**
 * ```--il``` and ```-el``` will filter by Reminder list
 * ```--ia``` includes *only* all-day events (opposite of ```--ea```)
 * ```--aep``` is like ```--iep```, but *adds* to the default property list instead of replacing it.
@@ -201,6 +210,8 @@ Environment variables:
     ICALPAL                 Additional arguments
     ICALPAL_CONFIG          Additional arguments from a file
                             (default: /Users/ajr/.icalpal)
+
+    Do not quote or escape values.  Options set in ICALPAL override ICALPAL_CONFIG.  Options on the command line override ICALPAL.
 ```
 
 ## Output formats
@@ -212,7 +223,7 @@ CSV, Hash, JSON, XML, and YAML print all fields for all items in their
 respective formats.  From that you can analyze the results any way you
 like.
 
-[Remind](https://dianne.skoll.ca/projects/remind/) format uses a minimal implementation built in icalPal.
+[Remind](https://dianne.skoll.ca/projects/remind/) format uses a minimal implementation built into icalPal.
 
 Other formats such as ANSI, HTML, Markdown, RDoc, and TOC, use Ruby's
 [RDoc::Markup](https://ruby-doc.org/stdlib-2.6.10/libdoc/rdoc/rdoc/RDoc/Markup.html)

data/bin/icalPal

@@ -11,6 +11,7 @@ begin
 
   require_relative '../lib/icalpal'
   require_relative '../lib/options'
+  require_relative '../lib/utils'
 rescue LoadError => e
   dep = e.message[/-- (.*)/, 1]
 
@@ -28,14 +29,14 @@ end
 # All kids love log!
 $log = Logger.new(STDERR, { level: $defaults[:common][:debug] })
 $log.formatter = proc do |s, t, _p, m| # Severity, time, progname, msg
-  ($log.level.positive?)? "#{s}: #{m}\n" :
-    format("[%-5<sev>s] %<time>s [%<caller>s] - %<message>s\n",
-           {
-             sev: s,
-             time: t.strftime('%H:%M:%S.%L'),
-             caller: caller(4, 1)[0].split('/')[-1],
-             message: m
-           })
+  format("[%-5<sev>s] %<time>s [%<file>s:%<line>5s] - %<message>s\n",
+         {
+           sev: s,
+           time: t.strftime('%H:%M:%S.%L'),
+           file: caller(4, 1)[0].split('/')[-1].split(':')[0],
+           line: caller(4, 1)[0].split('/')[-1].split(':')[1],
+           message: m
+         })
 end
 
 $opts = ICalPal::Options.new.parse_options
@@ -56,9 +57,8 @@ $log.info("Options: #{$opts}")
 # @param item[Object]
 
 def add(item)
-  $log.info("Adding #{item.inspect} #{item['UUID']} (#{item['title']})") if item['UUID']
+  $log.debug("Adding #{item.dump} #{item['UUID']} (#{item['title']})") if item['UUID']
 
-  item['sday'] = ICalPal::RDT.new(*item['sdate'].to_a[0..2]) if ICalPal::Event === item && item['sdate']
   $items.push(item)
 end
 
@@ -101,114 +101,84 @@ end
 # Make sure we opened at least one database
 unless success
   $log.fatal('Could not open database')
-  $opts[:db].each { |db| $log.fatal("Tried #{db}") }
+
+  # SQLite3 does not return useful error messages.  If any databases
+  # failed because of EPERM (operation not permitted), our parent
+  # process might need Full Disk Access, and we should suggest that.
+  eperm = 0
+
+  $opts[:db].each do |db|
+    # Use a real open to get a useful error
+    File.open(db).close
+  rescue Exception => e
+    $log.fatal("#{e.class}: #{db}")
+
+    eperm = 1 if e.instance_of?(Errno::EPERM)
+  end
+
+  if eperm.positive?
+    $stderr.puts
+    $stderr.puts "Does #{ancestor} have Full Disk Access in System Settings?"
+    $stderr.puts
+    $stderr.puts "Try running: open 'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles'"
+  end
 
   abort
 end
 
 $log.info("Loaded #{$rows.count} #{klass} rows")
+$log.info("Window is #{$opts[:from]} to #{$opts[:to]}")
 
 
 ##################################################
 # Process the data
 
 # Add rows
-$rows.each_with_index do |row, i|
-  $log.debug("Row #{i}: #{row['ROWID']}:#{row['UUID']} - #{row['account']}/#{row['calendar']}/#{row['title']}")
-
+$rows.each do |row|
   # --es/--is
-  if $opts[:es].any? row['account']
-    $log.debug(':es')
-    next
-  end
-
-  unless $opts[:is].empty? || ($opts[:is].any? row['account'])
-    $log.debug(':is')
-    next
-  end
+  next if $opts[:es].any? row['account']
+  next unless $opts[:is].empty? || ($opts[:is].any? row['account'])
 
   # --ec/--ic
   unless klass == ICalPal::Store || !row['calendar']
-    if $opts[:ec].any? row['calendar']
-      $log.debug(':ec')
-      next
-    end
-
-    unless $opts[:ic].empty? || ($opts[:ic].any? row['calendar'])
-      $log.debug(':ic')
-      next
-    end
+    next if $opts[:ec].any? row['calendar']
+    next unless $opts[:ic].empty? || ($opts[:ic].any? row['calendar'])
   end
 
   # Instantiate an item
   item = klass.new(row)
 
   # --et/--it
-  if $opts[:et].any? item['type']
-    $log.debug(':et')
-    next
-  end
-
-  unless $opts[:it].empty? || ($opts[:it].any? item['type'])
-    $log.debug(':it')
-    next
-  end
+  next if $opts[:et].any? item['type']
+  next unless $opts[:it].empty? || ($opts[:it].any? item['type'])
 
   # --el/--il
-  if $opts[:el].any? item['list_name']
-    $log.debug(':el')
-    next
-  end
-
-  unless $opts[:il].empty? || ($opts[:il].any? item['list_name'])
-    $log.debug(':il')
-    next
-  end
+  next if $opts[:el].any? item['list_name']
+  next unless $opts[:il].empty? || ($opts[:il].any? item['list_name'])
 
   # --match
   if $opts[:match]
     r = $opts[:match].split('=')
 
     if item[r[0]].to_s.respond_to?(:match)
-      unless item[r[0]].to_s.match(Regexp.new(r[1].to_s, Regexp::IGNORECASE))
-        $log.debug(':match')
-        next
-      end
+      next unless item[r[0]].to_s =~ Regexp.new(r[1], Regexp::IGNORECASE)
     end
   end
 
   if ICalPal::Event === item
     # Check for all-day and cancelled events
-    if $opts[:ea] && item['all_day'].positive?
-      $log.debug(':ea')
-      next
-    end
-
-    if $opts[:ia] && !item['all_day'].positive?
-      $log.debug(':ia')
-      next
-    end
-
-    if item['status'] == :canceled
-      $log.debug(':canceled')
-      next
-    end
+    next if $opts[:ea] && item['all_day'].positive?
+    next if $opts[:ia] && !item['all_day'].positive?
+    next if item['status'] == :canceled
 
     (item['has_recurrences'].positive?)?
-      item.recurring.each { |i| add(i) } :
-      item.non_recurring.each { |i| add(i) }
+      item.recurring.each { |j| add(j) } :
+      item.non_recurring.each { |j| add(j) }
   else
     # Check for dated reminders
     if ICalPal::Reminder === item
-      if $opts[:dated] == 1 && item['due_date'].positive?
-        $log.debug(':undated')
-        next
-      end
-
-      if $opts[:dated] == 2 && item['due_date'].zero?
-        $log.debug(':dated')
-        next
-      end
+      next if $opts[:dated] == 1 && item['due_date'].positive?
+      next if $opts[:dated] == 2 && item['due_date'].zero?
     end
 
     add(item)
@@ -227,11 +197,10 @@ end
 
 # Sort the rows
 begin
-  $log.info("Sorting/uniqing #{$items.count} items by #{[ $opts[:sep], $opts[:sort], 'sdate' ]}, reverse #{$opts[:reverse].inspect}")
+  $log.info("Sorting #{$items.count} items by #{[ $opts[:sep], $opts[:sort], 'sdate' ]}, reverse #{$opts[:reverse].inspect}")
 
   $items.sort_by! { |i| [ i[$opts[:sep]], i[$opts[:sort]], i['sdate'] ] }
   $items.reverse! if $opts[:reverse]
-  $items.uniq!
 rescue Exception => e
   $log.info("Sorting failed: #{e}\n")
 end
@@ -277,7 +246,7 @@ unless mu
        when 'json' then items.map { |i| i.self }.to_json
        when 'xml'
          xml = items.map { |i| "<#{$opts[:cmd].chomp('s')}>#{i.to_xml}</#{$opts[:cmd].chomp('s')}>" }
-         "<#{$opts[:cmd]}>\n#{xml.join('')}</#{$opts[:cmd]}>"
+         "<#{$opts[:cmd]}>\n#{xml.join}</#{$opts[:cmd]}>"
        when 'yaml' then items.map { |i| i.self }.to_yaml
        when 'remind' then items.map { |i|
            "REM #{i['sdate'].strftime('%F AT %R')} " +
@@ -342,14 +311,6 @@ items.each_with_index do |i, j|
       # First property, value only
       props << RDoc::Markup::Heading.new(2, value.to_s)
     end
-
-    # unless k.positive?
-    #   # First property, value only
-    #   props << RDoc::Markup::Heading.new(2, value.to_s)
-    # else
-    #   props << RDoc::Markup::BlankLine.new unless (i['placeholder'] || $opts[:ps])
-    #   props << RDoc::Markup::ListItem.new(prop, RDoc::Markup::Paragraph.new(value)) unless (i['placeholder'])
-    # end
   end
 
   # Print it

data/bin/icalpal

@@ -0,0 +1,322 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'logger'
+
+  require 'csv'
+  require 'json'
+  require 'rdoc'
+  require 'sqlite3'
+  require 'yaml'
+
+  require_relative '../lib/icalpal'
+  require_relative '../lib/options'
+  require_relative '../lib/utils'
+rescue LoadError => e
+  dep = e.message[/-- (.*)/, 1]
+
+  $stderr.puts "FATAL: icalpal is missing a dependency: #{dep}"
+  $stderr.puts
+  $stderr.puts "Install with 'gem install --user-install #{dep}'"
+
+  exit
+end
+
+
+##################################################
+# Load options
+
+# All kids love log!
+$log = Logger.new(STDERR, { level: $defaults[:common][:debug] })
+$log.formatter = proc do |s, t, _p, m| # Severity, time, progname, msg
+  format("[%-5<sev>s] %<time>s [%<file>s:%<line>5s] - %<message>s\n",
+         {
+           sev: s,
+           time: t.strftime('%H:%M:%S.%L'),
+           file: caller(4, 1)[0].split('/')[-1].split(':')[0],
+           line: caller(4, 1)[0].split('/')[-1].split(':')[1],
+           message: m
+         })
+end
+
+$opts = ICalPal::Options.new.parse_options
+
+$rows = []                      # Rows from the database
+$items = []                     # Items to be printed
+
+
+##################################################
+# All kids love log!
+
+$log.info("Options: #{$opts}")
+
+
+##################################################
+# Add an item to the list
+#
+# @param item[Object]
+
+def add(item)
+  $log.debug("Adding #{item.dump} #{item['UUID']} (#{item['title']})") if item['UUID']
+
+  $items.push(item)
+end
+
+
+##################################################
+# Load the data
+
+# What are we getting?
+klass = ICalPal.call($opts[:cmd])
+success = false
+
+# Get it
+$opts[:db].each do |db|
+  $log.debug("Trying #{db}")
+
+  if klass == ICalPal::Reminder
+    begin
+      # Load all .sqlite files
+      $log.debug("Loading *.sqlite in #{db}")
+      Dir.glob("#{db}/*.sqlite").each do |d|
+        $rows += ICalPal.load_data(d, klass::QUERY)
+        success = true
+
+      rescue SQLite3::CantOpenException
+        # Non-fatal exception, try the next one
+      end
+    end
+  else
+    # Load database
+    begin
+      $rows += ICalPal.load_data(db, klass::QUERY)
+      success = true
+
+    rescue SQLite3::CantOpenException
+      # Non-fatal exception, try the next one
+    end
+  end
+end
+
+# Make sure we opened at least one database
+unless success
+  $log.fatal('Could not open database')
+
+  # SQLite3 does not return useful error messages.  If any databases
+  # failed because of EPERM (operation not permitted), our parent
+  # process might need Full Disk Access, and we should suggest that.
+  eperm = 0
+
+  $opts[:db].each do |db|
+    # Use a real open to get a useful error
+    File.open(db).close
+  rescue Exception => e
+    $log.fatal("#{e.class}: #{db}")
+
+    eperm = 1 if e.instance_of?(Errno::EPERM)
+  end
+
+  if eperm.positive?
+    $stderr.puts
+    $stderr.puts "Does #{ancestor} have Full Disk Access in System Settings?"
+    $stderr.puts
+    $stderr.puts "Try running: open 'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles'"
+  end
+
+  abort
+end
+
+$log.info("Loaded #{$rows.count} #{klass} rows")
+$log.info("Window is #{$opts[:from]} to #{$opts[:to]}")
+
+
+##################################################
+# Process the data
+
+# Add rows
+$rows.each do |row|
+  # --es/--is
+  next if $opts[:es].any? row['account']
+  next unless $opts[:is].empty? || ($opts[:is].any? row['account'])
+
+  # --ec/--ic
+  unless klass == ICalPal::Store || !row['calendar']
+    next if $opts[:ec].any? row['calendar']
+    next unless $opts[:ic].empty? || ($opts[:ic].any? row['calendar'])
+  end
+
+  # Instantiate an item
+  item = klass.new(row)
+
+  # --et/--it
+  next if $opts[:et].any? item['type']
+  next unless $opts[:it].empty? || ($opts[:it].any? item['type'])
+
+  # --el/--il
+  next if $opts[:el].any? item['list_name']
+  next unless $opts[:il].empty? || ($opts[:il].any? item['list_name'])
+
+  # --match
+  if $opts[:match]
+    r = $opts[:match].split('=')
+
+    if item[r[0]].to_s.respond_to?(:match)
+      next unless item[r[0]].to_s =~ Regexp.new(r[1], Regexp::IGNORECASE)
+    end
+  end
+
+  if ICalPal::Event === item
+    # Check for all-day and cancelled events
+    next if $opts[:ea] && item['all_day'].positive?
+    next if $opts[:ia] && !item['all_day'].positive?
+    next if item['status'] == :canceled
+
+    (item['has_recurrences'].positive?)?
+      item.recurring.each { |j| add(j) } :
+      item.non_recurring.each { |j| add(j) }
+  else
+    # Check for dated reminders
+    if ICalPal::Reminder === item
+      next if $opts[:dated] == 1 && item['due_date'].positive?
+      next if $opts[:dated] == 2 && item['due_date'].zero?
+    end
+
+    add(item)
+  end
+end
+
+# Add placeholders for empty days
+if $opts[:sed] && $opts[:sd] && klass == ICalPal::Event
+  days = $items.collect { |i| i['sday'] }.uniq.sort
+
+  $opts[:days].times do |n|
+    day = $opts[:from] + n
+    $items.push(klass.new(day)) unless days.any? { |i| i.to_s == day.to_s }
+  end
+end
+
+# Sort the rows
+begin
+  $log.info("Sorting #{$items.count} items by #{[ $opts[:sep], $opts[:sort], 'sdate' ]}, reverse #{$opts[:reverse].inspect}")
+
+  $items.sort_by! { |i| [ i[$opts[:sep]], i[$opts[:sort]], i['sdate'] ] }
+  $items.reverse! if $opts[:reverse]
+rescue Exception => e
+  $log.info("Sorting failed: #{e}\n")
+end
+
+$log.debug("#{$items.count} items remain")
+
+# Configure formatting
+mu = case $opts[:output]
+     when 'ansi' then RDoc::Markup::ToAnsi.new
+     when 'default' then RDoc::Markup::ToICalPal.new($opts)
+     when 'html'
+       rdoc = RDoc::Options.new
+       rdoc.pipe = true
+       rdoc.output_decoration = false
+       RDoc::Markup::ToHtml.new(rdoc)
+     when 'md' then RDoc::Markup::ToMarkdown.new
+     when 'rdoc' then RDoc::Markup::ToRdoc.new
+     when 'toc' then RDoc::Markup::ToTableOfContents.new
+     end
+
+
+##################################################
+# Print the data
+
+items = $items[0..$opts[:li] - 1]
+
+unless mu
+  $log.debug("Output in #{$opts[:output]} format")
+
+  puts case $opts[:output]
+       when 'csv'
+         # Get all headers
+         headers = []
+         items.each { |i| headers += i.keys }
+         headers.uniq!
+
+         # Populate a CSV::Table
+         table = CSV::Table.new([], headers: headers)
+         items.each { |i| table << i.to_csv(headers) }
+
+         table
+       when 'hash' then items.map { |i| i.self }
+       when 'json' then items.map { |i| i.self }.to_json
+       when 'xml'
+         xml = items.map { |i| "<#{$opts[:cmd].chomp('s')}>#{i.to_xml}</#{$opts[:cmd].chomp('s')}>" }
+         "<#{$opts[:cmd]}>\n#{xml.join}</#{$opts[:cmd]}>"
+       when 'yaml' then items.map { |i| i.self }.to_yaml
+       when 'remind' then items.map { |i|
+           "REM #{i['sdate'].strftime('%F AT %R')} " +
+             "DURATION #{((i['edate'] - i['sdate']).to_f * 1440).to_i} " +
+             "MSG #{i['title']}"
+         }.join("\n")
+       else abort "No formatter for #{$opts[:output]}"
+       end
+
+  exit
+end
+
+$log.debug("Formatting with #{mu.inspect}")
+
+doc = RDoc::Markup::Document.new
+section = nil
+
+items.each_with_index do |i, j|
+  $log.debug("Print #{j}: #{i.inspect}")
+
+  # --li
+  break if $opts[:li].positive? && j >= $opts[:li]
+
+  # Use RDoc::Markup::Verbatim to save the item
+  v = RDoc::Markup::Verbatim.new
+  v.format = i
+  doc << v
+
+  # Sections
+  if $opts[:sep] && section != i[$opts[:sep]]
+    $log.debug("New section '#{$opts[:sep]}': #{i[$opts[:sep]]}")
+
+    doc << RDoc::Markup::Raw.new($opts[:sep])
+
+    doc << RDoc::Markup::BlankLine.new if j.positive?
+    doc << RDoc::Markup::Heading.new(1, i[$opts[:sep]].to_s)
+    doc << RDoc::Markup::Rule.new(0)
+
+    section = i[$opts[:sep]]
+  end
+
+  # Item
+  props = RDoc::Markup::List.new(:BULLET)
+
+  # Properties
+  $opts[:props].each_with_index do |prop, k|
+    value = i[prop]
+
+    next unless value
+    next if Array === value && !value[0]
+    next if String === value && value.empty?
+
+    $log.debug("#{prop}: #{value}")
+
+    # Use Raw to save the property
+    props << RDoc::Markup::Raw.new(prop)
+
+    if k.positive?
+      props << RDoc::Markup::BlankLine.new unless (i['placeholder'] || $opts[:ps])
+      props << RDoc::Markup::ListItem.new(prop, RDoc::Markup::Paragraph.new(value)) unless (i['placeholder'])
+    else
+      # First property, value only
+      props << RDoc::Markup::Heading.new(2, value.to_s)
+    end
+  end
+
+  # Print it
+  props << RDoc::Markup::BlankLine.new unless props.empty?
+
+  doc << props
+end
+
+print doc.accept(mu)

data/icalPal.gemspec

@@ -15,13 +15,43 @@ EOF
   s.homepage	= "https://github.com/ajrosen/#{s.name}"
   s.licenses	= [ 'GPL-3.0-or-later' ]
 
+  s.metadata = {
+    'bug_tracker_uri' => "https://github.com/ajrosen/#{s.name}/issues",
+    'rubygems_mfa_required' => 'true'
+  }
+
   s.files	= Dir["#{s.name}.gemspec", 'bin/*', 'lib/*.rb']
   s.executables	= [ "#{s.name}" ]
   s.extra_rdoc_files = [ 'README.md' ]
 
-  s.add_runtime_dependency 'nokogiri-plist', '~> 0.5.0'
-  s.add_runtime_dependency 'sqlite3', '~> 2'
+  # The macOS and Homebrew versions of rubygems have incompatible
+  # requirements for sqlite3.
+  #
+  # macOS comes with version 1.3.13, so it does not need to be added
+  # as a dependency, but it cannot install anything newer:
+  #
+  # requires Ruby version >= 3.0, < 3.4.dev. The current ruby version is 2.6.10.
+  #
+  # Homebrew's Ruby formula does not come with sqlite3, so it does
+  # need to be added as a dependency, but it cannot install version
+  # 1.3.13:
+  #
+  # error: call to undeclared function
+  #
+  # So we must call add_dependency, but iff we are not building with
+  # macOS' Ruby installation.
+
+  s.add_dependency 'nokogiri-plist', '~> 0.5.0'
+  s.add_dependency 'sqlite3', '~> 2.6.0' unless s.rubygems_version == `/usr/bin/gem --version`.strip
+  s.add_dependency 'timezone', '>= 0.99', '~> 1.3.0'
 
   s.bindir = 'bin'
   s.required_ruby_version = '>= 2.6.0'
+
+  s.post_install_message = <<-EOF
+
+Note: #{ICalPal::NAME} requires "Full Disk Access" in System Settings to access your calendar.
+Make sure the program that runs #{ICalPal::NAME}, not #{ICalPal::NAME} itself, has these permissions.
+
+EOF
 end