inform-runtime 1.0.4 → 1.2.0

data/lib/{runtime → story_teller}/grammar_parser.rb

@@ -1,24 +1,22 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'set'
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # In-file Grammar support implementation follows.
 #
@@ -102,7 +100,7 @@ module Inform
           ''
         end +
         map { |verb| "'#{verb}'" }.join(SpaceString) + Newline +
-        grammars.map(&:to_s).join(Newline)
+        grammars.join(Newline)
     end
     alias to_str to_s
 
@@ -122,7 +120,7 @@ module Inform
         concat(symbolize_grammar(grammar)) unless grammar.empty?
         push(:end)
         @action = action
-        @expected_tokens = grammar.map { |a| a =~ CustomScopePattern ? a.to_s.split('=').first.to_sym : a }
+        @expected_tokens = grammar.map { |a| CustomScopePattern.match?(a) ? a.to_s.split('=').first.to_sym : a }
         @reverse = reverse.nil? ? false : reverse
         @source = source
       end
@@ -251,26 +249,10 @@ module Inform
       "(#{@file}):#{@line}: token error, unexpected '#{@found}', expecting '#{@expected}'"
     end
   end
+end
 
-  def self.load_grammar(module_name)
-    Inform::Grammar.load_by_name(module_name)
-  end
-
-  def self.load_grammar_by_path(module_path)
-    Inform::Grammar.load_by_path(module_path)
-  end
-
-  def self.unload_grammars!
-    log.debug "Unloading all grammars"
-    Inform::Grammar::Verbs.clear
-  end
-
-  def self.prime_dictionary
-    Inform::Object.select_map(:name).compact.each do |n|
-      Inform::Dictionary.merge(n.split(/[,\s]+/).grep_v(/[^a-z]/i).map(&:downcase).map(&:to_sym))
-    end
-  end
-
+# The Inform module
+module Inform
   ### Grammar
   module Grammar
     # The Inform::Grammar::Index class
@@ -368,8 +350,8 @@ module Inform
         grammar_guess = str + ext
         guess = File.expand_path(
           File.join(
-            Inform::Library.inform_gem_lib_path,
-            Inform::Runtime.inform_dir_path,
+            StoryTeller::Library.inform_gem_lib_path,
+            StoryTeller::Engine.inform_code_prefix,
             grammar_guess))
         return guess if File.exist?(guess)
       end
@@ -403,6 +385,7 @@ module Inform
         @block_comment = false
       end
 
+      # rubocop: disable Metrics/AbcSize
       # rubocop: disable Metrics/MethodLength
       def parse_grammar(grammar_module, lines, origin_path: nil, origin_line: 0)
         line_index = Integer(origin_line || 0)
@@ -411,18 +394,19 @@ module Inform
           next unless /^\s*[^\#\n]/.match?(line)
           begin
             parse(grammar_module, line)
-          rescue DuplicateVerb => e
-            e.file = File.basename(origin_path)
+          rescue Inform::DuplicateVerb => e
+            e.file = File.basename(origin_path) unless origin_path.nil?
             e.line = line_index
             log.warn e
-          rescue UnexpectedToken => e
-            e.file = File.basename(origin_path)
+          rescue Inform::UnexpectedToken => e
+            e.file = File.basename(origin_path) unless origin_path.nil?
             e.line = line_index
             raise e
           end
         end
         true
       end
+      # rubocop: enable Metrics/AbcSize
       # rubocop: enable Metrics/MethodLength
 
       # rubocop: disable Metrics/AbcSize
@@ -454,13 +438,13 @@ module Inform
           # tokens.delete_if { |a| !TokenPattern.match?(a) }
           keys = tokens.map { |a| a[1..-2] }
           key = synonym ? keys.last : keys.first
-          log.debug "Loading verb: #{key}"
+          log.trace "Loading verb: #{key}"
           @verb = Inform::Grammar::Verbs.lookup(key)
           if @verb
             raise DuplicateVerb.new(key) unless synonym
             @verb.merge keys
           else
-            @verb = Verb.new(keys, source, meta, emote)
+            @verb = Inform::Verb.new(keys, source, meta, emote)
           end
           keys.each do |k|
             Inform::Grammar::Verbs[k] = @verb
@@ -480,7 +464,7 @@ module Inform
           key = keys.first
           existing_verb = Inform::Grammar::Verbs.lookup(key)
           if existing_verb.nil?
-            @verb = Verb.new(keys, source, meta, emote)
+            @verb = Inform::Verb.new(keys, source, meta, emote)
           elsif only.nil?
             existing_verb.merge(keys)
             @verb = existing_verb
@@ -493,7 +477,7 @@ module Inform
               Inform::Grammar::Verbs.delete(existing_key)
               existing_verb.delete(existing_key)
             end
-            @verb = Verb.new(keys, source, meta, emote)
+            @verb = Inform::Verb.new(keys, source, meta, emote)
             @verb.grammars = existing_verb.grammars if replace.nil?
             keys.each do |new_key|
               Inform::Grammar::Verbs[new_key] = @verb
@@ -506,7 +490,7 @@ module Inform
           tokens.shift
           reverse = false; reverse = true if /reverse/.match?(action)
           action = action.gsub(/;/, '').split.first.to_sym
-          grammar = Verb::Grammar.new(tokens, source, action, reverse)
+          grammar = Inform::Verb::Grammar.new(tokens, source, action, reverse)
           @grammars.push(grammar)
         else
           unless @verb.nil?
@@ -550,4 +534,4 @@ module Inform
   end
   # module Grammar
 end
-# module Inform
+# module StoryTeller

data/lib/{runtime → story_teller}/helpers.rb

@@ -1,22 +1,22 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # Additional mixin methods
 
@@ -139,15 +139,29 @@ module Inform
   # The ObjectHelpers module functionality
   module ObjectHelpers
     def object?(obj = self)
-      obj.is_a?(Inform::Object) || obj.is_a?(Inform::System::Object)
+      obj.is_a?(Inform::Object)
     end
 
     def sysobj?(obj = self)
-      obj.is_a?(Inform::System::Object)
+      defined?(Inform::Ephemeral::Object) && obj.is_a?(Inform::Ephemeral::Object)
     end
   end
 end
 
+# # The Inform module
+# module Inform
+#   # The ObjectHelpers module functionality
+#   module ObjectHelpers
+#     def object?(obj = self)
+#       obj.is_a?(Inform::Object) || obj.is_a?(Inform::Ephemeral::Object)
+#     end
+
+#     def sysobj?(obj = self)
+#       obj.is_a?(Inform::Ephemeral::Object)
+#     end
+#   end
+# end
+
 # The Inform module
 module Inform
   # The NilClassObjectHelpers module functionality

data/lib/{runtime → story_teller}/history.rb

@@ -1,22 +1,22 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # The Inform module
 module Inform

data/lib/{runtime → story_teller}/inflector.rb

@@ -28,12 +28,10 @@
 
 # * http://www.opensource.org/licenses/MIT
 
-# The Inform module
-module Inform
+# The StoryTeller module
+module StoryTeller
   # The Inflector module
   module Inflector
-    extend self # rubocop: disable Style/ModuleFunction
-
     # The Inflections class
     class Inflections
       @instance = nil
@@ -124,6 +122,7 @@ module Inform
       return yield Inflections.instance if block_given?
       Inflections.instance
     end
+    module_function :inflections
   end
   # module Inflector
 
@@ -192,4 +191,4 @@ module Inform
   # rubocop: enable Metrics/BlockLength
   # Inflector.inflections do |inflect|
 end
-# module Inform
+# module StoryTeller

data/lib/story_teller/inform/base.rb

@@ -0,0 +1,160 @@
+# lib/story_teller/inform/base.rb
+# encoding: utf-8
+# frozen_string_literal: false
+
+# Copyright Nels Nelson 2008-2026 but freely usable (see license)
+#
+# This file is part of StoryTeller.
+#
+# The StoryTeller is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The StoryTeller is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
+
+# module Inform
+module Inform
+  # module AdapterClassDelegation
+  module AdapterClassDelegation
+    def delegated_adapter_class
+      klass = adapter_class
+      klass.equal?(self) ? nil : klass
+    rescue NotImplementedError
+      nil
+    end
+
+    def ===(other)
+      klass = delegated_adapter_class
+      super || (!klass.nil? && other.is_a?(klass))
+    end
+
+    def method_missing(method_name, *args, **kwargs, &block)
+      klass = delegated_adapter_class
+      return klass.public_send(method_name, *args, **kwargs, &block) if !klass.nil? && klass.respond_to?(method_name)
+
+      super
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      klass = delegated_adapter_class
+      (!klass.nil? && klass.respond_to?(method_name, include_private)) || super
+    end
+  end
+
+  # class Object
+  class Object
+    class << self
+      include AdapterClassDelegation
+
+      def adapter_class
+        StoryTeller::ModelAdapter.object_class
+      end
+
+      def new(*args, **kwargs, &block)
+        return super unless equal?(Inform::Object)
+
+        StoryTeller::ModelAdapter.object_class!.new(*args, **kwargs, &block)
+      end
+
+      def build(*args, **kwargs, &block)
+        if equal?(Inform::Object)
+          StoryTeller::ModelAdapter.object_class!.new(*args, **kwargs, &block)
+        else
+          super
+        end
+      end
+
+      def create(*args, **kwargs, &block)
+        if equal?(Inform::Object)
+          StoryTeller::ModelAdapter.object_class!.create(*args, **kwargs, &block)
+        else
+          new(*args, **kwargs, &block)
+        end
+      end
+
+      def fetch_or_create_by_name(*args, **kwargs, &block)
+        if equal?(Inform::Object)
+          StoryTeller::ModelAdapter.object_class!.fetch_or_create_by_name(*args, **kwargs, &block)
+        else
+          super
+        end
+      end
+
+      def all(*args, **kwargs, &block)
+        if equal?(Inform::Object)
+          StoryTeller::ModelAdapter.object_class!.all(*args, **kwargs, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+  # class Object
+
+  # class Tag
+  class Tag
+    class << self
+      include AdapterClassDelegation
+
+      def adapter_class
+        StoryTeller::ModelAdapter.tag_class
+      end
+
+      def new(*args, &block)
+        return super unless equal?(Inform::Tag)
+
+        StoryTeller::ModelAdapter.tag_class!.new(*args, &block)
+      end
+    end
+  end
+
+  # class Link
+  class Link
+    class << self
+      include AdapterClassDelegation
+
+      def adapter_class
+        StoryTeller::ModelAdapter.link_class
+      end
+
+      def new(*args, &block)
+        return super unless equal?(Inform::Link)
+
+        StoryTeller::ModelAdapter.link_class!.new(*args, &block)
+      end
+    end
+  end
+
+  # class Module
+  class Module
+    class << self
+      include AdapterClassDelegation
+
+      def adapter_class
+        StoryTeller::ModelAdapter.module_class
+      end
+
+      def new(*args, &block)
+        return super unless equal?(Inform::Module)
+
+        StoryTeller::ModelAdapter.module_class!.new(*args, &block)
+      end
+    end
+  end
+
+  # class Tagged
+  class Tagged
+  end
+
+  # class Modularized
+  class Modularized
+  end
+end
+# module Inform

data/lib/{runtime → story_teller/inform/ephemeral}/link.rb

@@ -1,67 +1,41 @@
+# lib/story_teller/link.rb
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of the StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# The StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# The StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with the StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # Link
 
-if defined?(Sequel::Migration)
-# The LinkSetup class
-class LinkSetup < Sequel::Migration
-  # rubocop: disable Metrics/MethodLength
-  def up
-    # return if table_exists? :link
-    log.debug "#up"
-    create_table? :link do
-      primary_key :id
-      foreign_key :from_id, :object, on_delete: :cascade
-      foreign_key :to_id, :object, on_delete: :cascade
-      index :name
-      index :created_at
-
-      String :name
-      DateTime :created_at
-      DateTime :modified_at
-    end
-  end
-  # rubocop: enable Metrics/MethodLength
-
-  def down
-    drop_table :link if table_exists? :link
-  end
-end
-# class LinkSetup
-end
-# defined?(Sequel::Migration)
-
 # The Inform module
 module Inform
-  # The Inform::Link class
-  class Link < Sequel::Model
-    set_primary_key :id
-    def_column_accessor :created_at, :modified_at
-    def_column_accessor :name
-    many_to_one :from, class: Inform::Object, key: :from_id
-    many_to_one :to,   class: Inform::Object, key: :to_id
-
+# module Ephemeral
+module Ephemeral
+  # The Inform::Ephemeral::Link class
+  class Link < Inform::Link
     LinkTemplate = '%<link_name>s -> %<to_name>s [%<to_identity>s]'.freeze
-    LinkMethods = %w[from_id to_id].freeze
-    MethodWriterTemplate = '%<method_name>s='.freeze
+    attr_reader :name, :to, :from
+
+    def initialize(properties)
+      super()
+      @name = properties[:name]
+      @to = properties[:to]
+      @from = properties[:from]
+    end
 
     def before_create
       self.created_at ||= Time.now
@@ -89,7 +63,11 @@ module Inform
       self
     end
   end
+  # class Link
+end
+# module Ephemeral
 end
+# module Inform
 
 # The Inform module
 module Inform
@@ -123,7 +101,11 @@ module Inform
     # rubocop: enable Metrics/MethodLength
 
     def linked?(link_name)
-      Inform::Link.filter(name: link_name.to_s, from_id: self.id).count > 0
+      if Inform::Link.respond_to?(:filter)
+        Inform::Link.filter(name: link_name.to_s, from_id: self.id).count > 0
+      else
+        !self.links.find(&:link_name).nil?
+      end
     end
 
     def unlink(link_name)

data/lib/{runtime → story_teller/inform/ephemeral}/module.rb

@@ -1,57 +1,31 @@
 # encoding: utf-8
 # frozen_string_literal: false
 
-# Copyright Nels Nelson 2008-2023 but freely usable (see license)
+# Copyright Nels Nelson 2008-2025 but freely usable (see license)
 #
-# This file is part of the Inform Runtime.
+# This file is part of StoryTeller.
 #
-# The Inform Runtime is free software: you can redistribute it and/or
+# StoryTeller is free software: you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# The Inform Runtime is distributed in the hope that it will be useful,
+# StoryTeller is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
-# along with the Inform Runtime.  If not, see <http://www.gnu.org/licenses/>.
+# along with StoryTeller.  If not, see <http://www.gnu.org/licenses/>.
 
 # Module
 
-if defined?(Sequel::Migration)
-# The ModuleSetup class
-class ModuleSetup < Sequel::Migration
-  def up
-    log.debug "#up"
-    create_table? :module do
-      primary_key :id
-      index :name
-      index :created_at
-
-      String :name, unique: true, null: false
-      DateTime :created_at
-      DateTime :modified_at
-    end
-  end
-
-  def down
-    drop_table(:module, cascade: true) if table_exists? :module
-  end
-end
-# class ModuleSetup
-end
-# defined?(Sequel::Migration)
-
 # The Inform module
 module Inform
-  # Deine the Inform::Module class
-  class Module < Sequel::Model
-    set_primary_key :id
-    def_column_accessor :created_at, :modified_at
-    def_column_accessor :name
-
+# module Ephemeral
+module Ephemeral
+  # The Inform::Module class
+  class Module < Inform::Module
     def to_s
       name
     end
@@ -94,36 +68,21 @@ from module a, modularized b where b.module_id = a.id group by a.id, a.name}
     # rubocop: enable Style/FormatString
     # rubocop: enable Style/FormatStringToken
   end
+  # class Module
+end
+# module Ephemeral
 end
 # module Inform
 
 # Modularized
 
-if defined?(Sequel::Migration)
-# The ModularizedSetup class
-class ModularizedSetup < Sequel::Migration
-  def up
-    create_table? :modularized do
-      primary_key :id
-      foreign_key :object_id, :object, on_delete: :cascade
-      foreign_key :module_id, :module, on_delete: :cascade
-    end
-  end
-
-  def down
-    drop_table(:modularized, cascade: true) if table_exists? :modularized
-  end
-end
-# class ModularizedSetup
-end
-# defined?(Sequel::Migration)
-
 # The Inform module
 module Inform
-  # The Inform::Modularized class
-  class Modularized < Sequel::Model
-    set_primary_key :id
-  end
+# module Ephemeral
+module Ephemeral
+  # The Inform::Ephemeral::Modularized class
+  class Modularized < Inform::Modularized; end
+end
 end
 # module Inform