forthic 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edd1101930e744ff0289d9a71f7449645852a558c7f12b4f4b0fe8bb211278cd
-  data.tar.gz: ea53ba5d3f04fca67b2088debe870eba40e9c2b1bca04061095420d0b92de8cd
+  metadata.gz: ecff72dd063577e62dffecb04a0e67b8419f77eef928fce884448b067209cca9
+  data.tar.gz: 11e0fdec3cf805e4b893b27035288de08f6ff1e825e4aff08b0781ac1627d544
 SHA512:
-  metadata.gz: 8f193bcb169fe8b7a7f59c27978b3c296b61e791199b6e4c9797eb10d671ff091416ac5e7fc6ecd42f7bf70955dbbbf237fa7c97e8434ea3abd41e13a4c861e9
-  data.tar.gz: 9bea9f3a03156019a3e3e23bf634c8988bd13180ec28faa4cb91d4256851c3cefbcd9928341e494e8f281a3f331bd4262d358c7fd1bb61db99c50e0983dcc13c
+  metadata.gz: c74d61d76a7244e8cecd9de1f816320aa2d0c99e9789d03558dc098d381207b3cc7ed2147b87cf7f4aea322a4de5a959c5579a34d57292acf4fdba4f93bad31a
+  data.tar.gz: 81fb605d6781127d0e6583a6ee936445ff16a81b1cbf1336b5bf789ce902d52c7a5f76f6695ed5f9584ae270b2bce0e616528ab928441cd62502dcf93d008041

data/lib/forthic/literals.rb

@@ -133,7 +133,12 @@ module Forthic
   end
 
   # Create a zoned datetime literal handler with timezone support
-  # Parses: 2025-05-24T10:15:00Z, 2025-05-24T10:15:00-05:00, 2025-05-24T10:15:00
+  # Parses ISO 8601 datetime with IANA timezone bracket notation:
+  # - 2025-05-20T08:00:00[America/Los_Angeles]  (IANA timezone)
+  # - 2025-05-20T08:00:00-07:00[America/Los_Angeles]  (offset + IANA)
+  # - 2025-05-24T10:15:00Z  (UTC)
+  # - 2025-05-24T10:15:00-05:00  (offset only)
+  # - 2025-05-24T10:15:00  (uses default timezone)
   #
   # @param timezone [String] The default timezone to use
   # @return [Proc] A literal handler proc
@@ -142,6 +147,29 @@ module Forthic
       return nil unless str.include?("T")
 
       begin
+        # Extract IANA timezone from brackets if present
+        bracket_match = str.match(/\[([^\]]+)\]$/)
+
+        if bracket_match
+          # Extract IANA timezone name from brackets
+          tz_name = bracket_match[1]
+
+          # Extract datetime string (before bracket)
+          datetime_str = str[0...bracket_match.begin(0)]
+
+          # Parse datetime (may have offset)
+          # Handle Z suffix
+          datetime_str = datetime_str.sub(/Z$/, "+00:00")
+          time = Time.parse(datetime_str)
+
+          # Convert to specified timezone using TZInfo
+          require 'tzinfo'
+          tz = TZInfo::Timezone.get(tz_name)
+          return tz.to_local(time)
+        end
+
+        # No brackets - handle as before
+
         # Handle explicit UTC (Z suffix)
         if str.end_with?("Z")
           return Time.parse(str).utc
@@ -162,7 +190,9 @@ module Forthic
         ensure
           ENV['TZ'] = old_tz
         end
-      rescue ArgumentError
+      rescue ArgumentError, TZInfo::InvalidTimezoneIdentifier
+        # ArgumentError: invalid time format
+        # TZInfo::InvalidTimezoneIdentifier: invalid timezone name
         nil
       end
     end

data/lib/forthic/module.rb

@@ -57,6 +57,7 @@ module Forthic
       @name = name
       @string = name
       @location = nil
+      @error_handlers = []
     end
 
     def set_location(location)
@@ -67,6 +68,34 @@ module Forthic
       @location
     end
 
+    def add_error_handler(&handler)
+      @error_handlers << handler
+    end
+
+    def remove_error_handler(handler)
+      @error_handlers.delete(handler)
+    end
+
+    def clear_error_handlers
+      @error_handlers.clear
+    end
+
+    def error_handlers
+      @error_handlers.dup
+    end
+
+    def try_error_handlers(error, interp)
+      @error_handlers.each do |handler|
+        begin
+          handler.call(error, self, interp)
+          return true  # Handler succeeded
+        rescue => e
+          next  # Try next handler
+        end
+      end
+      false  # No handler succeeded
+    end
+
     def execute(_interp)
       raise NotImplementedError, "Must override Word#execute"
     end
@@ -205,6 +234,31 @@ module Forthic
     end
   end
 
+  # ModuleWord - Word that executes a handler function with error handling support
+  #
+  # Used for module words created via decorators or add_module_word().
+  # Integrates per-word error handler functionality. Ruby version is synchronous.
+  class ModuleWord < Word
+    attr_reader :handler
+
+    def initialize(name, &handler)
+      super(name)
+      @handler = handler
+    end
+
+    def execute(interp)
+      @handler.call(interp)
+    rescue IntentionalStopError => e
+      # Never handle intentional flow control errors
+      raise
+    rescue => e
+      # Try error handlers
+      handled = try_error_handlers(e, interp)
+      raise unless handled  # Re-raise if not handled
+      # If handled, execution continues (error suppressed)
+    end
+  end
+
   # -------------------------------------
   # Module
 
@@ -337,13 +391,16 @@ module Forthic
       @exportable << word.name
     end
 
-    def add_module_word(word_name, word_func)
-      word = Word.new(word_name)
-      # Define the execute method for this specific instance
-      word.define_singleton_method(:execute) do |interp|
-        word_func.call(interp)
-      end
+    def add_module_word(word_name, word_func = nil, &block)
+      # Support both calling styles:
+      # 1. add_module_word("NAME", proc) - old style
+      # 2. add_module_word("NAME") { |interp| ... } - new style (block)
+      handler = block || word_func
+      raise ArgumentError, "Must provide either a proc or block" unless handler
+
+      word = ModuleWord.new(word_name, &handler)
       add_exportable_word(word)
+      word
     end
 
     def exportable_words

data/lib/forthic/tokenizer.rb

@@ -412,7 +412,24 @@ module Forthic
         advance_position(1)
         break if whitespace?(char)
 
-        if [";", "[", "]", "{", "}", "#"].include?(char)
+        if char == "["
+          # Special case: if token contains 'T', this is likely a zoned datetime
+          # Include the bracketed timezone as part of the token
+          if @token_string.include?("T")
+            @token_string += char
+            # Continue gathering until closing bracket
+            while @input_pos < @input_string.length
+              char = @input_string[@input_pos]
+              advance_position(1)
+              @token_string += char
+              break if char == "]"
+            end
+          else
+            # Otherwise, '[' is a delimiter (for arrays)
+            advance_position(-1)
+            break
+          end
+        elsif [";", "]", "{", "}", "#"].include?(char)
           advance_position(-1)
           break
         else

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: forthic
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Rino Jose
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-09 00:00:00.000000000 Z
+date: 2025-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec