toilet_tracker 0.1.0

data/lib/toilet_tracker/services/timezone_service.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require 'active_support/time'
+
+module ToiletTracker
+  module Services
+    class TimezoneService
+      attr_reader :config
+
+      def initialize(config = ToiletTracker.configuration)
+        @config = config
+      end
+
+      def calculate_shift(from_timezone, to_timezone, at_time = Time.current)
+        from_zone = resolve_timezone(from_timezone)
+        to_zone = resolve_timezone(to_timezone)
+
+        # Calculate offset difference in hours
+        from_offset = from_zone.at(at_time).utc_offset
+        to_offset = to_zone.at(at_time).utc_offset
+
+        (to_offset - from_offset) / 3600
+      end
+
+      def apply_shift(time, shift_hours)
+        return time if shift_hours.zero?
+
+        time + shift_hours.hours
+      end
+
+      def resolve_timezone(timezone_spec)
+        case timezone_spec
+        when String
+          resolve_timezone_string(timezone_spec)
+        when ActiveSupport::TimeZone
+          timezone_spec
+        else
+          raise Core::InvalidTimezone, timezone_spec
+        end
+      end
+
+      def timezone_abbreviations
+        @timezone_abbreviations ||= build_abbreviation_map
+      end
+
+      private
+
+      def resolve_timezone_string(timezone_str)
+        # First try as a named timezone (e.g., "Europe/Rome", "UTC")
+        zone = ActiveSupport::TimeZone[timezone_str]
+        return zone if zone
+
+        # Try as an abbreviation (e.g., "PST", "EST")
+        abbreviation_zones = timezone_abbreviations[timezone_str.upcase]
+        if abbreviation_zones&.any?
+          # If multiple zones have the same abbreviation, use the first one
+          # In a real application, you might want to be more sophisticated here
+          return abbreviation_zones.first
+        end
+
+        # Try to parse as offset (e.g., "UTC+5", "GMT-3")
+        return ActiveSupport::TimeZone[timezone_str] if timezone_str.match?(/^(UTC|GMT)([+-]\d{1,2})$/)
+
+        raise Core::InvalidTimezone, timezone_str
+      end
+
+      def build_abbreviation_map
+        map = Hash.new { |h, k| h[k] = [] }
+
+        ActiveSupport::TimeZone.all.each do |zone|
+          collect_zone_abbreviations(zone, map)
+        end
+
+        map
+      end
+
+      def collect_zone_abbreviations(zone, map)
+        sample_times.each do |time|
+          abbr = zone.tzinfo.abbreviation(time).to_s.upcase
+          add_zone_to_map(map, abbr, zone)
+        end
+      end
+
+      def sample_times
+        [Time.current, Time.current + 6.months]
+      end
+
+      def add_zone_to_map(map, abbr, zone)
+        map[abbr] << zone unless map[abbr].include?(zone)
+      end
+    end
+  end
+end

data/lib/toilet_tracker/utils/zip_handler.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'zip'
+require 'tempfile'
+
+module ToiletTracker
+  module Utils
+    class ZipHandler
+      class ZipError < StandardError; end
+
+      class ChatFileNotFoundError < ZipError; end
+
+      def self.extract_chat_file(zip_path)
+        new(zip_path).extract_chat_file
+      end
+
+      def self.zip_file?(file_path)
+        File.extname(file_path).downcase == '.zip'
+      end
+
+      def initialize(zip_path)
+        @zip_path = zip_path
+        validate_zip_file!
+      end
+
+      def extract_chat_file
+        chat_entries = find_chat_entries
+
+        raise ChatFileNotFoundError, 'No _chat.txt file found in zip archive' if chat_entries.empty?
+
+        chat_entry = if chat_entries.size > 1
+                       # If multiple _chat.txt files, prefer the one in root or with shortest path
+                       chat_entries.min_by { |entry| entry.name.count('/') }
+                     else
+                       chat_entries.first
+                     end
+
+        extract_to_tempfile(chat_entry)
+      end
+
+      private
+
+      def validate_zip_file!
+        raise ZipError, "Zip file not found: #{@zip_path}" unless File.exist?(@zip_path)
+
+        return if File.readable?(@zip_path)
+
+        raise ZipError, "Zip file not readable: #{@zip_path}"
+      end
+
+      def find_chat_entries
+        chat_entries = []
+
+        Zip::File.open(@zip_path) do |zip|
+          zip.each do |entry|
+            # Look for files named exactly _chat.txt (case insensitive)
+            chat_entries << entry if File.basename(entry.name).match?(/^_chat\.txt$/i) && !entry.directory?
+          end
+        end
+
+        chat_entries
+      rescue Zip::Error => e
+        raise ZipError, "Invalid zip file: #{e.message}"
+      end
+
+      def extract_to_tempfile(entry)
+        temp_file = Tempfile.new(['chat_export', '.txt'])
+
+        begin
+          Zip::File.open(@zip_path) do |_zip|
+            content = entry.get_input_stream.read
+            temp_file.write(content)
+          end
+
+          temp_file.close
+          temp_file.path
+        rescue Zip::Error => e
+          temp_file&.close
+          temp_file&.unlink
+          raise ZipError, "Failed to extract chat file: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/toilet_tracker/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ToiletTracker
+  VERSION = '0.1.0'
+end

data/lib/toilet_tracker.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'active_support/time'
+
+require_relative 'toilet_tracker/version'
+require_relative 'toilet_tracker/configuration'
+require_relative 'toilet_tracker/core/errors'
+require_relative 'toilet_tracker/core/message'
+require_relative 'toilet_tracker/core/result'
+require_relative 'toilet_tracker/core/parse_result'
+require_relative 'toilet_tracker/parsers/base_parser'
+require_relative 'toilet_tracker/parsers/whatsapp_parser'
+require_relative 'toilet_tracker/parsers/message_parser'
+require_relative 'toilet_tracker/services/timezone_service'
+require_relative 'toilet_tracker/services/shift_service'
+require_relative 'toilet_tracker/services/analysis_service'
+require_relative 'toilet_tracker/utils/zip_handler'
+
+module ToiletTracker
+  class Error < StandardError; end
+
+  def self.parse_line(line)
+    analysis_service = Services::AnalysisService.new
+    analysis_service.analyze_line(line)
+  end
+
+  def self.parse_lines(lines)
+    analysis_service = Services::AnalysisService.new
+    analysis_service.analyze_lines(lines)
+  end
+
+  def self.reset!
+    # Reset configuration to defaults
+    reset_configuration!
+  end
+end

data/sig/toilet_tracker.rbs

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

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: toilet_tracker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- NetherSoul
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.2.1
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.5
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+description: "A Ruby gem that parses WhatsApp messages containing toilet tracking
+  data using emoji commands (\U0001F6BD for settings, \U0001F4A9 for events) with
+  timezone support\n"
+email:
+- nethersoul.dev@gmail.com
+executables:
+- toilet_tracker
+extensions: []
+extra_rdoc_files: []
+files:
+- ".overcommit.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".standard.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- PARSING_SPEC.md
+- README.md
+- Rakefile
+- STYLE_GUIDE.md
+- exe/toilet_tracker
+- lib/toilet_tracker.rb
+- lib/toilet_tracker/configuration.rb
+- lib/toilet_tracker/core/errors.rb
+- lib/toilet_tracker/core/message.rb
+- lib/toilet_tracker/core/parse_result.rb
+- lib/toilet_tracker/core/result.rb
+- lib/toilet_tracker/parsers/base_parser.rb
+- lib/toilet_tracker/parsers/message_parser.rb
+- lib/toilet_tracker/parsers/whatsapp_parser.rb
+- lib/toilet_tracker/services/analysis_service.rb
+- lib/toilet_tracker/services/shift_service.rb
+- lib/toilet_tracker/services/timezone_service.rb
+- lib/toilet_tracker/utils/zip_handler.rb
+- lib/toilet_tracker/version.rb
+- sig/toilet_tracker.rbs
+homepage: https://github.com/brownops/toilet_tracker
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/brownops/toilet_tracker
+  source_code_uri: https://github.com/brownops/toilet_tracker
+  changelog_uri: https://github.com/brownops/toilet_tracker/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Parse WhatsApp messages for toilet tracking with emoji-based commands
+test_files: []