forthic 0.2.0 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3faede941e29c0090a90077103892015502bb1bef7897726821932197a72be1
-  data.tar.gz: 4393b304179b84c9b1cca818ae04af1cf6800dcd07c86ff92ec5e1b1f4fc4bbf
+  metadata.gz: 4ebffd3b7bf74a96a5bdbb6d178996eeea1c2d35edc22743e4dba9154e1e40f9
+  data.tar.gz: a34907460efd7db068214dff1410b512a9a9ad10e3eee149e120eb5b414ebc2f
 SHA512:
-  metadata.gz: b8dea528434b695a7c272c1cd3d9b6d3885c2eb0d4acd43b876663f764abaca97b9896df81e8618dfe98612c4e4a2b18ba883ccbde93873d232cc933eb7ca28e
-  data.tar.gz: baefe4a1a1157b5c190c7e62c703fcf7e0568aefb7103e2a463d514c798ba739a2f5eacdf35af70dd47d51e705ad546738bdac3f7b9de1c25d99d30b5e1153d5
+  metadata.gz: 7013c8908441bc6aaee014af8e6ac124bf0e60245474adacdcf4a8633c686ef781dc022e0f163a93222dfd3435e5e21c875ac273f13ae029909f51d354fbfdeb
+  data.tar.gz: 759a725d11e735ab283d99e076cf314f72ff98c086cf2dcd0ff93077f2031fa0bb27d814008f63ced3c179b6803f566a10d6b79a5e0082d9c91c30f9159b3d03

data/README.md

@@ -1,3 +1,13 @@
+> **⚠️ DEPRECATED PACKAGE**
+>
+> This package is from an archived repository and will not receive updates.
+>
+> **New repository:** https://github.com/forthix/forthic-rb
+>
+> Watch the new repository for announcements about updated packages.
+
+---
+
 # Forthic
 
 A Forthic interpreter that runs within Ruby.

data/lib/forthic/code_location.rb

@@ -16,5 +16,20 @@ module Forthic
       @start_pos = start_pos
       @end_pos = end_pos
     end
+
+    # @return [String]
+    def to_s
+      "#{@screen_name}:#{@line}:#{@column}"
+    end
+
+    # @return [Integer]
+    def line_number
+      @line
+    end
+
+    # @return [Integer]
+    def column_number
+      @column
+    end
   end
 end

data/lib/forthic/errors/unknown_word_error.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "../forthic_error"
+
+module Forthic
+  module Errors
+    class UnknownWordError < ForthicError
+      attr_reader :word_name
+
+      # @param [String] word_name The name of the unknown word
+      # @param [CodeLocation, nil] location Where the error occurred
+      # @param [Array<String>] suggested_words Optional list of similar words for suggestions
+      def initialize(word_name, location = nil, suggested_words = [])
+        @word_name = word_name
+        @suggested_words = suggested_words
+
+        description = build_description(suggested_words)
+        super(ErrorCodes::WORD_NOT_FOUND, "Word '#{word_name}' not found", description, location)
+      end
+
+      # @return [Array<String>] List of suggested similar words
+      def suggested_words
+        @suggested_words.dup
+      end
+
+      private
+
+      # @param [Array<String>] suggested_words
+      # @return [String]
+      def build_description(suggested_words)
+        base_description = "Check for typos in the word name or ensure the word has been defined."
+        return base_description if suggested_words.empty?
+
+        suggestions = suggested_words.take(3).join(", ")
+        "#{base_description} Did you mean: #{suggestions}?"
+      end
+    end
+  end
+end

data/lib/forthic/forthic_error.rb

@@ -46,5 +46,20 @@ module Forthic
 
       result.reverse
     end
+
+    # @return [String]
+    def message
+      to_s
+    end
+
+    # @return [String]
+    def to_s
+      parts = [@title]
+      parts << "at #{@location}" if @location
+      if @description && !@description.empty?
+        parts[-1] = "#{parts[-1]}: #{@description}"
+      end
+      parts.join(" ")
+    end
   end
 end

data/lib/forthic/interpreter.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "forthic_error"
+require_relative "errors/unknown_word_error"
 require_relative "tokenizer"
 require_relative "token"
 require_relative "code_location"
@@ -220,7 +221,11 @@ module Forthic
         next if [TokenType::START_DEF, TokenType::END_DEF, TokenType::COMMENT].include?(token.type) || @execution_state.is_compiling
       end
       true
+    rescue ForthicError => e
+      # Re-raise ForthicError and its subclasses without wrapping
+      raise e
     rescue => e
+      # Wrap non-ForthicError exceptions
       error = ForthicError.new(ErrorCodes::EXECUTION_ERROR, "Error executing token '#{token&.string}'", "An unexpected error occurred during execution. Check the token syntax and try again.", token&.location)
       error.set_caught_error(e)
       raise error
@@ -409,7 +414,11 @@ module Forthic
     # @param [Token] token
     def handle_word_token(token)
       word = find_word(token.string)
-      raise ForthicError.new(ErrorCodes::WORD_NOT_FOUND, "Word '#{token.string}' not found", "Check for typos in the word name or ensure the word has been defined.", token.location) unless word
+      unless word
+        # Generate suggested words for better error messages
+        suggested_words = find_similar_words(token.string)
+        raise Errors::UnknownWordError.new(token.string, token.location, suggested_words)
+      end
       handle_word(word, token.location)
     end
 
@@ -424,5 +433,86 @@ module Forthic
         word.execute(self)
       end
     end
+
+    private
+
+    # Find words similar to the given word name for error suggestions
+    # @param [String] word_name The unknown word to find suggestions for
+    # @return [Array<String>] Array of similar word names
+    def find_similar_words(word_name)
+      return [] if word_name.nil? || word_name.empty?
+
+      all_words = collect_available_words
+
+      # Find words with similar names using simple string distance
+      suggestions = all_words.select do |available_word|
+        levenshtein_distance(word_name.downcase, available_word.downcase) <= 2
+      end
+
+      # If no close matches, try prefix matching
+      if suggestions.empty?
+        suggestions = all_words.select do |available_word|
+          available_word.downcase.start_with?(word_name[0, 2].downcase) ||
+            word_name.downcase.start_with?(available_word[0, 2].downcase)
+        end
+      end
+
+      suggestions.take(3)
+    end
+
+    # Collect all available word names from all modules in scope
+    # @return [Array<String>] Array of all available word names
+    def collect_available_words
+      words = []
+
+      # Collect from global module (hardcoded common words since GlobalModule uses methods)
+      global_words = %w[
+        POP DUP SWAP >STR CONCAT SPLIT JOIN /N /R /T LOWERCASE UPPERCASE
+        APPEND REVERSE UNIQUE MAP FOREACH KEYS VALUES LENGTH RANGE SLICE
+        SELECT TAKE DROP NTH LAST FLATTEN REDUCE + - * / MOD
+        == != > >= < <= OR AND NOT IN BOOL INT FLOAT
+        VARIABLES ! @ !@ INTERPRET EXPORT USE-MODULES REC
+      ]
+      words.concat(global_words)
+
+      # Collect from module stack
+      @execution_state.module_stack.each do |mod|
+        if mod.respond_to?(:words) && mod.words
+          words.concat(mod.words.map(&:name))
+        end
+      end
+
+      words.uniq.compact
+    end
+
+    # Calculate Levenshtein distance between two strings
+    # @param [String] str1
+    # @param [String] str2
+    # @return [Integer] The edit distance between the strings
+    def levenshtein_distance(str1, str2)
+      return str2.length if str1.empty?
+      return str1.length if str2.empty?
+
+      # Create matrix
+      matrix = Array.new(str1.length + 1) { Array.new(str2.length + 1, 0) }
+
+      # Initialize first row and column
+      (0..str1.length).each { |i| matrix[i][0] = i }
+      (0..str2.length).each { |j| matrix[0][j] = j }
+
+      # Fill matrix
+      (1..str1.length).each do |i|
+        (1..str2.length).each do |j|
+          cost = (str1[i - 1] == str2[j - 1]) ? 0 : 1
+          matrix[i][j] = [
+            matrix[i - 1][j] + 1,      # deletion
+            matrix[i][j - 1] + 1,      # insertion
+            matrix[i - 1][j - 1] + cost # substitution
+          ].min
+        end
+      end
+
+      matrix[str1.length][str2.length]
+    end
   end
 end

data/lib/forthic/version.rb

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

data/lib/forthic.rb

@@ -8,6 +8,10 @@ module Forthic
   autoload :Token, "forthic/token"
   autoload :PositionedString, "forthic/positioned_string"
   autoload :ForthicError, "forthic/forthic_error"
+
+  module Errors
+    autoload :UnknownWordError, "forthic/errors/unknown_word_error"
+  end
   autoload :Word, "forthic/words/word"
   autoload :PushValueWord, "forthic/words/push_value_word"
   autoload :DefinitionWord, "forthic/words/definition_word"

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: forthic
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.4
 platform: ruby
 authors:
 - Rino Jose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-13 00:00:00.000000000 Z
+date: 2026-01-01 00:00:00.000000000 Z
 dependencies: []
-description: This package provides a Forthic interpreter that allows you to execute
-  Forthic code within your Ruby projects. Forthic is a stack-based programming language
-  inspired by Forth.
+description: "[ARCHIVED] This package provides a Forthic interpreter that allows you
+  to execute Forthic code within your Ruby projects. Forthic is a stack-based programming
+  language inspired by Forth. This gem is from an archived repository. Please see
+  https://github.com/forthix/forthic-rb for the new official repository."
 email:
 - rjose@forthix.com
 executables: []
@@ -27,6 +28,7 @@ files:
 - Rakefile
 - lib/forthic.rb
 - lib/forthic/code_location.rb
+- lib/forthic/errors/unknown_word_error.rb
 - lib/forthic/forthic_error.rb
 - lib/forthic/forthic_module.rb
 - lib/forthic/global_module.rb
@@ -49,12 +51,16 @@ files:
 - lib/forthic/words/start_module_word.rb
 - lib/forthic/words/word.rb
 - sig/forthic.rbs
-homepage: https://github.com/linkedin/forthic
+homepage: https://github.com/forthix/forthic-rb
 licenses: []
 metadata:
-  homepage_uri: https://github.com/linkedin/forthic
-  source_code_uri: https://github.com/linkedin/forthic
-post_install_message:
+  homepage_uri: https://github.com/forthix/forthic-rb
+  source_code_uri: https://github.com/forthix/forthic-rb
+post_install_message: |
+  ⚠️  NOTICE: This gem is from an archived repository.
+
+  The Forthic project has moved to: https://github.com/forthix/forthic-rb
+  Please visit the new repository for updates and support.
 rdoc_options: []
 require_paths:
 - lib
@@ -72,5 +78,5 @@ requirements: []
 rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
-summary: A Forthic interpreter that runs within Ruby.
+summary: "[ARCHIVED] A Forthic interpreter that runs within Ruby - See https://github.com/forthix/forthic-rb"
 test_files: []