timex_datalink_caldav 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6c7e200c3fbb1011bd0b0b67b98db758f8802b72d8686ceb991b4766cb285860
+  data.tar.gz: e5b0052df0811f4af6f52c34727bd26bd93254903fdc218e9be00d51ae5ac169
+SHA512:
+  metadata.gz: b07bd1855b0b9ffe5a36301c239df18f588bacfd7c1ba6f3e20988057cab7491343dc86072ad43bd5194e0c67e5d25ccb9d4f252214953dd8ed2a793819d9a72
+  data.tar.gz: 529e2275b9207f501414c41131df0e505ae85e46ae8319a4ab0c04a35275b85be393c84b022e0e10890e3072ff4969a351aa55da453a3183b240bc9db19df94f

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2023-05-11
+
+- Initial release

data/Gemfile

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in timex_datalink_caldav.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "rspec", "~> 3.12"
+
+gem "timex_datalink_client", "~> 0.11.0"
+
+gem "calendav", "~> 0.4.0"
+
+gem "icalendar", "~> 2.8"
+
+gem "icalendar-recurrence", "~> 1.1"
+
+gem "activesupport", "~> 7.0"

data/Gemfile.lock

@@ -0,0 +1,97 @@
+PATH
+  remote: .
+  specs:
+    timex_datalink_caldav (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (7.0.4.3)
+      activesupport (= 7.0.4.3)
+    activesupport (7.0.4.3)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    addressable (2.8.4)
+      public_suffix (>= 2.0.2, < 6.0)
+    calendav (0.4.0)
+      http
+      icalendar
+      nokogiri
+    concurrent-ruby (1.2.2)
+    crc (0.4.2)
+    diff-lcs (1.5.0)
+    domain_name (0.5.20190701)
+      unf (>= 0.0.5, < 1.0.0)
+    ffi (1.15.5)
+    ffi-compiler (1.0.1)
+      ffi (>= 1.0.0)
+      rake
+    http (5.1.1)
+      addressable (~> 2.8)
+      http-cookie (~> 1.0)
+      http-form_data (~> 2.2)
+      llhttp-ffi (~> 0.4.0)
+    http-cookie (1.0.5)
+      domain_name (~> 0.5)
+    http-form_data (2.3.0)
+    i18n (1.13.0)
+      concurrent-ruby (~> 1.0)
+    icalendar (2.8.0)
+      ice_cube (~> 0.16)
+    icalendar-recurrence (1.1.3)
+      icalendar (~> 2.0)
+      ice_cube (~> 0.16)
+    ice_cube (0.16.4)
+    llhttp-ffi (0.4.0)
+      ffi-compiler (~> 1.0)
+      rake (~> 13.0)
+    mdb (0.5.0)
+    minitest (5.18.0)
+    nokogiri (1.14.4-arm64-darwin)
+      racc (~> 1.4)
+    public_suffix (5.0.1)
+    racc (1.6.2)
+    rake (13.0.6)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubyserial (0.6.0)
+      ffi (~> 1.9, >= 1.9.3)
+    timex_datalink_client (0.11.0)
+      activemodel (~> 7.0.4)
+      crc (~> 0.4.2)
+      mdb (~> 0.5.0)
+      rubyserial (~> 0.6.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.8.2)
+
+PLATFORMS
+  arm64-darwin-22
+
+DEPENDENCIES
+  activesupport (~> 7.0)
+  calendav (~> 0.4.0)
+  icalendar (~> 2.8)
+  icalendar-recurrence (~> 1.1)
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  timex_datalink_caldav!
+  timex_datalink_client (~> 0.11.0)
+
+BUNDLED WITH
+   2.4.10

data/README.md

@@ -0,0 +1,58 @@
+# TimexDatalinkCaldav
+
+TimexDatalinkCaldav is a simple Ruby gem designed to sync events from a CalDAV server to a Timex Datalink watch. It can also be used as a standalone command-line interface (CLI) tool.
+
+## Installation
+
+To install the TimexDatalinkCaldav gem, simply run:
+
+```sh
+gem install timex_datalink_caldav
+```
+
+Or add this line to your application's Gemfile:
+
+```ruby
+source "https://rubygems.pkg.github.com/wjhrdy" do
+  gem "timex_datalink_caldav"
+end
+```
+
+And then execute:
+
+```sh
+bundle install
+```
+
+## Usage
+
+### As a Gem
+
+Here's an example of how to use the tool in your Ruby code:
+
+```ruby
+require 'timex_datalink_caldav'
+
+client = TimexDatalinkCaldav::Client.new(your_username, your_password, your_server_uri, your_device)
+client.sync_to_watch
+```
+
+### As a CLI Tool
+
+After installing the gem, you can use it as a CLI tool:
+
+```sh
+timex_datalink_caldav -u https://caldavendpoint.com -n your_username -p your_password -d your_device
+```
+
+Please replace `your_username`, `your_password`, and `your_device` with your actual CalDAV server username, password, and device respectively. In this example, we're using Apple's iCloud CalDAV server. You'll need to replace this with the URI of your own CalDAV server if you're not using iCloud.
+
+## Note
+
+Ensure you have the necessary dependencies installed on your system and you have the correct permissions to access the specified device. 
+
+The tool currently works with events that have attendees and converts event times to Eastern Standard Time (EST). Events are sorted by time before syncing to the watch.
+
+## Resources
+
+If you want to use this I highly recommend pairing it with the Raspberry Pi Pico and [this project](https://github.com/famiclone6502/DIY_Datalink_Adapter).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/bin/timex_datalink_caldav

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require_relative '../lib/timex_datalink_caldav'
+
+TimexDatalinkCaldav::CLI.new(ARGV).execute

data/lib/timex_datalink_caldav/client.rb

@@ -0,0 +1,97 @@
+require 'calendav'
+require 'icalendar/recurrence'
+require 'timex_datalink_client'
+require 'active_support/time'
+
+module TimexDatalinkCaldav
+  class Client
+    def initialize(user, password, server_url, serial_device)
+      @user = user
+      @password = password
+      @server_url = server_url
+      @serial_device = serial_device
+    end
+
+    def get_events
+      credentials = Calendav::Credentials::Standard.new(
+        host: @server_url,
+        username: @user,
+        password: @password,
+        authentication: :basic_auth
+      )
+
+      # Create a new client with the credentials
+      client = Calendav.client(credentials)
+
+      # Get events from the calendar for the next day
+      client.events.list(@server_url, from: Time.now, to: Time.now + 24*60*60)
+    end
+
+    def sync_to_watch
+      events = get_events
+
+      appointments = []
+      appointment_map = {} # Used to avoid duplicate appointments
+
+      events.each do |event|
+        ical_events = Icalendar::Event.parse(event.calendar_data)
+        if ical_events.any?
+          ical_event = ical_events.first
+          if ical_event.attendee&.any? # Exclude events without attendees
+            next_occurrence = ical_event.occurrences_between(Time.now, Time.now + 24*60*60).first
+            if next_occurrence
+              est_time = next_occurrence.start_time.in_time_zone('Eastern Time (US & Canada)')
+              key = "#{est_time}_#{ical_event.summary.to_s}"
+              unless appointment_map[key] # Check if the event is already in the map
+                puts "Adding appointment: #{ical_event.summary.to_s} at time #{est_time}"
+                appointment = TimexDatalinkClient::Protocol1::Eeprom::Appointment.new(
+                  time: est_time,
+                  message: ical_event.summary.to_s
+                )
+                appointments << appointment
+                appointment_map[key] = true
+              end
+            end
+          end
+        end
+      end
+      
+      # Sort the appointments by time
+      appointments.sort_by! { |appointment| appointment.time }
+      write_to_watch(appointments)
+    end
+
+    def write_to_watch(appointments)
+      time1 = Time.now
+
+      models = [
+        TimexDatalinkClient::Protocol1::Sync.new,
+        TimexDatalinkClient::Protocol1::Start.new,
+        TimexDatalinkClient::Protocol1::Time.new(
+          zone: 1,
+          time: time1,
+          is_24h: false
+        ),
+        TimexDatalinkClient::Protocol1::TimeName.new(
+          zone: 1,
+          name: time1.zone
+        ),
+        TimexDatalinkClient::Protocol1::Eeprom.new(
+          appointments: appointments,
+          appointment_notification_minutes: 5
+        ),
+        TimexDatalinkClient::Protocol1::End.new
+      ]
+
+      timex_datalink_client = TimexDatalinkClient.new(
+        serial_device: @serial_device,
+        models: models,
+        byte_sleep: 0.008,
+        packet_sleep: 0.06,
+        verbose: true
+      )
+
+      timex_datalink_client.write
+    end
+  end
+end

data/lib/timex_datalink_caldav/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TimexDatalinkCaldav
+  VERSION = "0.2.0"
+end

data/lib/timex_datalink_caldav.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+require 'optparse'
+
+require_relative "timex_datalink_caldav/client"
+
+module TimexDatalinkCaldav
+  class CLI
+    def initialize(arguments)
+      @options = parse_options(arguments)
+    end
+
+    def execute
+      client = TimexDatalinkCaldav::Client.new(@options.fetch(:user), @options.fetch(:password), @options.fetch(:uri), @options.fetch(:device))
+      client.sync_to_watch
+    end
+
+    private
+
+    def parse_options(arguments)
+      options = {}
+      OptionParser.new do |opts|
+        opts.banner = "Usage: timex_datalink_caldav [options]"
+
+        opts.on("-u", "--uri URI", "CalDAV server URI") do |v|
+          options[:uri] = v
+        end
+
+        opts.on("-n", "--user USERNAME", "Username for CalDAV server") do |v|
+          options[:user] = v
+        end
+
+        opts.on("-p", "--password PASSWORD", "Password for CalDAV server") do |v|
+          options[:password] = v
+        end
+
+        opts.on("-d", "--device DEVICE", "Serial device for Timex Datalink watch") do |v|
+          options[:device] = v
+        end
+      end.parse!(arguments)
+      options
+    end
+  end
+end

data/sig/timex_datalink_caldav.rbs

@@ -0,0 +1,4 @@
+module TimexDatalinkCaldav
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/timex_datalink_caldav.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "lib/timex_datalink_caldav/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "timex_datalink_caldav"
+  spec.version = TimexDatalinkCaldav::VERSION
+  spec.authors = ["Willy Hardy"]
+  spec.email = ["zpga8gbp@mailer.me"]
+
+  spec.summary = "Allows the Timex Datalink watch to sync with a CalDAV server."
+  spec.description = "Adds a CLI and a feature to pull your next day of calendar events into the Timex Datalink watch. Note: Hardcoded protocol1 and EST timezone. At the moment."
+  spec.homepage = "https://github.com/wjhrdy/timex-datalink-caldav"
+  spec.required_ruby_version = ">= 2.6.0"
+  
+  spec.license = "MIT"
+  spec.metadata["github_repo"] = "ssh://github.com/wjhrdy/timex-datalink-caldav"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/wjhrdy/timex-datalink-caldav"
+  spec.metadata["changelog_uri"] = "https://github.com/wjhrdy/timex-datalink-caldav/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
+    end
+  end
+  spec.require_paths = ["lib"]
+  spec.executables << 'timex_datalink_caldav'
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: timex_datalink_caldav
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Willy Hardy
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-05-15 00:00:00.000000000 Z
+dependencies: []
+description: 'Adds a CLI and a feature to pull your next day of calendar events into
+  the Timex Datalink watch. Note: Hardcoded protocol1 and EST timezone. At the moment.'
+email:
+- zpga8gbp@mailer.me
+executables:
+- timex_datalink_caldav
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/timex_datalink_caldav
+- lib/timex_datalink_caldav.rb
+- lib/timex_datalink_caldav/client.rb
+- lib/timex_datalink_caldav/version.rb
+- sig/timex_datalink_caldav.rbs
+- timex_datalink_caldav.gemspec
+homepage: https://github.com/wjhrdy/timex-datalink-caldav
+licenses:
+- MIT
+metadata:
+  github_repo: ssh://github.com/wjhrdy/timex-datalink-caldav
+  homepage_uri: https://github.com/wjhrdy/timex-datalink-caldav
+  source_code_uri: https://github.com/wjhrdy/timex-datalink-caldav
+  changelog_uri: https://github.com/wjhrdy/timex-datalink-caldav/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Allows the Timex Datalink watch to sync with a CalDAV server.
+test_files: []