gloo 6.5.1 → 6.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19bd707a24eb9bbd3e2759cdb2ae244d2dafc28f40c0f4046c856152e343261c
-  data.tar.gz: fd3fd34b664abb32a464d3745de0ede24e136f2b2a7f375809170312bbec51a1
+  metadata.gz: 24b089e57c145daea09ee59a1967bc38ec4482d0a9a137f9e3a32e8b71fb4ece
+  data.tar.gz: 625b347a0ff732f2fe81008c9e7e6d56de92f84ef846ccd37ebeda10948117ab
 SHA512:
-  metadata.gz: f21efa7866b7eeb455fb4e7a8c64465bcd41a498d6129f04220c69eb814178f92775aeb96ef0e2a972f6df481d4603acf6e3de7c728e6508262347012cfb20cc
-  data.tar.gz: 956306465a135039e185104bb81cf504af379265814b5a02ba4637c3a6412463ce655aa48bae66e1f3315fd8c90925899c2ca0afda9fbf6a795c66b35e339967
+  metadata.gz: 3080060d8fea38b00cc1870d9ae07d8149db13395834d72a20c9f18f7b9c43d97b6af97177d653b7eaeeffa49b04f9005a8318f7aaaa56edf65619645dde8016
+  data.tar.gz: f137b40bf30a08e7af993fdd67041084a7f6aefbaf461934f1b4b8bd370e399cf3044537388d1a09be6dd954d73c3487ceddf6c977493287e3aa5ec6894f2b13

data/docs/application.md

@@ -88,6 +88,8 @@ gloo:
   #
   # Run this script when starting up gloo.
   # (Only if a script file is not specified.)
+  # A bare filename (no path) is looked up in the config directory
+  # above. Either way, the .gloo extension is assumed if left off.
   #
   start_with:
 

data/lib/VERSION

@@ -1 +1 @@
-6.5.1
+6.6.0

data/lib/VERSION_NOTES

@@ -1,3 +1,9 @@
+6.6.0 - 2026.09.12
+ - Allow shortcut reference for start file in configuration directory.
+ - Adds word wrap message for strings and text.
+ - Adds line wrapping for object comments and help documentation.
+
+
 6.5.1 - 2026.09.11
  - Adds doc to the load verb for recent changes.
 

data/lib/gloo/app/engine.rb

@@ -207,7 +207,9 @@ module Gloo
         end
 
         name = @settings.start_with
-        @persist_man.load( name ) if name
+        return if name.blank?
+
+        @persist_man.load( resolve_start_with( name ) )
       end
 
       #
@@ -382,6 +384,20 @@ module Gloo
 
       private
 
+      #
+      # Resolve the start_with setting to a loadable name/path.
+      # A bare filename (no directory separator) is resolved against
+      # the config directory rather than the project path, and the
+      # .gloo extension is assumed when not given.
+      #
+      def resolve_start_with( name )
+        ext = @persist_man.file_ext
+        name = "#{name}#{ext}" unless name.end_with?( ext )
+        return name if name.include?( File::SEPARATOR )
+
+        return File.join( @settings.config_path, name )
+      end
+
       #
       # Get the stack trace as a string, truncating the middle if it's long.
       #

data/lib/gloo/app/settings.rb

@@ -189,13 +189,53 @@ module Gloo
       def get_default_settings
         projects = File.join( @user_root, 'projects' )
         str = <<~TEXT
+          #
+          # Gloo configuration
+          #
           gloo:
+
+            #
+            # Root directory for projects.
+            # Update this with the directory with your gloo projects.
+            #
             project_path: #{projects}
+
+            #
+            # Run this script when starting up gloo.
+            # (Only if a script file is not specified.)
+            # A bare filename (no path) is looked up in the config directory
+            # above. Either way, the .gloo extension is assumed if left off.
+            #
             start_with:
+
+            #
+            # Indentation (spaces) when showing an object outline.
+            #
             list_indent: 2
+
+            #
+            # Show listing the object tree,
+            # how many levels of children will be shown?
+            # Children at deeper levels will be hidden.
+            #
             list_levels: 3
+
+            #
+            # When listing the object tree, also show each object's doc (the
+            # comment declared immediately above it in its source file), if it
+            # has one.
+            #
             list_docs: false
+
+            #
+            # Show debug statements in the log?
+            #
             debug: false
+
+            #
+            # Color theme for console output: dark or light.
+            # Match this to your terminal's background.
+            #
             theme: #{DEFAULT_THEME}
         TEXT
         return str

data/lib/gloo/docs/help_shell.rb

@@ -24,6 +24,10 @@ module Gloo
       README_GLOB = 'README*'.freeze
       NO_README_YET = 'No README found for library'.freeze
 
+      # Matches a (possibly indented) markdown bullet line, capturing
+      # its leading whitespace and the text after '- '.
+      BULLET_RE = /\A(\s*)-\s+(.*)\z/.freeze
+
       #
       # Initialize the help shell for the given engine.
       #
@@ -249,10 +253,51 @@ module Gloo
       #
       def page_markdown( md )
         rule = '-' * @engine.platform.cols
-        bracketed = "#{rule}\n#{md.strip}\n#{rule}\n"
+        wrapped = wrap_markdown_for_terminal( md.strip )
+        bracketed = "#{rule}\n#{wrapped}\n#{rule}\n"
         @engine.platform.page( Gloo::Docs::MarkdownRenderer.colorize( bracketed, @engine.theme ) )
       end
 
+      #
+      # Word-wrap plain (pre-color) markdown to the terminal width.
+      # Headings and fenced code blocks are left untouched (code is
+      # never rewrapped); a bullet line's continuation lines are
+      # indented to line up under its text, not under the '-' itself
+      # -- same convention as List#show_doc's doc-line wrapping.
+      #
+      def wrap_markdown_for_terminal( md )
+        width = Gloo::App::Settings.cols( @engine )
+        in_code_fence = false
+        lines = md.split( "\n", -1 ).flat_map do |line|
+          if line.strip.start_with?( '```' )
+            in_code_fence = !in_code_fence
+            next [ line ]
+          end
+          next [ line ] if in_code_fence || line.start_with?( '#' ) || line.strip.empty?
+
+          wrap_markdown_line( line, width )
+        end
+        return lines.join( "\n" )
+      end
+
+      #
+      # Wrap one prose or bullet markdown line to width. A bullet's
+      # continuation lines get a blank-space prefix the same length as
+      # its '{indent}- ', so wrapped text lines up under the bullet's
+      # own text.
+      #
+      def wrap_markdown_line( line, width )
+        match = BULLET_RE.match( line )
+        prefix = match ? "#{match[1]}- " : ''
+        text = match ? match[2] : line
+        cont_indent = ' ' * prefix.length
+
+        wrapped = Gloo::Objs::WordWrap.wrap( text, width - prefix.length )
+        # "".split( "\n", -1 ) is [], not [ '' ] -- keep a blank line as one piece.
+        pieces = wrapped.empty? ? [ '' ] : wrapped.split( "\n", -1 )
+        return pieces.each_with_index.map { |piece, i| "#{i.zero? ? prefix : cont_indent}#{piece}" }
+      end
+
       #
       # Snapshot the verb, object type, doc page, and loaded library
       # names for tab-completion.

data/lib/gloo/objs/basic/string_msgs.rb

@@ -55,6 +55,7 @@ module Gloo
           'splitl ({index}) — Get the substring to the left of index {index} (same as split (0, {index})). A parameter is required. Does not change the value of the string. It will have the substring.',
           'splitr ({index}) — Get the substring from index {index} to the end of the string (same as split ({index}, size)). A parameter is required. Does not change the value of the string. It will have the substring.',
           'split_list ({delim} {dst.path}) — Split the string by {delim} and put the parts into children of the container at {dst.path} (or an alias that points to one), one part per child, in order. Existing children are matched by position and have their values set; extra parts get new (untyped) children, numbered from 1; extra existing children are left alone. Both parameters are required. Does not change the value of the string. It will have the number of parts.',
+          'word_wrap ({width}) — Word-wrap the string to {width} columns, breaking on whitespace (never mid-word; an overlong word is left on its own line rather than broken). The {width} parameter is optional; it defaults to the terminal\'s current width. This message changes the value of the string. It will have the wrapped string.',
           'page — Show the value in a pager (less), for viewing long content a screen at a time.'
         ]
       end
@@ -481,6 +482,25 @@ module Gloo
         return s
       end
 
+      #
+      # Word-wrap the string to the given column width, breaking on
+      # whitespace. Defaults to the terminal's current width when no
+      # width parameter is given.
+      #
+      def msg_word_wrap
+        width = Gloo::App::Settings.cols( @engine )
+        if @params&.token_count&.positive?
+          expr = Gloo::Expr::Expression.new( @engine, @params.tokens )
+          data = expr.evaluate
+          width = data.to_i
+        end
+
+        s = Gloo::Objs::WordWrap.wrap( value, width )
+        set_value s
+        @engine.heap.it.set_to s
+        return s
+      end
+
       #
       # Show the value in a pager, for long content.
       #

data/lib/gloo/objs/basic/word_wrap.rb

@@ -0,0 +1,58 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2026 Eric Crane.  All rights reserved.
+#
+# Word-wrapping utility.
+# This is a static class.
+#
+
+module Gloo
+  module Objs
+    class WordWrap
+
+      # ---------------------------------------------------------------------
+      #    Wrapping
+      # ---------------------------------------------------------------------
+
+      #
+      # Wrap the given text to the given column width.
+      # Greedy word-wrap: breaks on whitespace, never mid-word. A single
+      # word longer than the width is left on its own line rather than
+      # being hard-broken (e.g. a URL stays intact, just overflows).
+      # Existing line breaks in the text are preserved -- each line is
+      # wrapped independently, so blank lines and paragraph breaks survive.
+      #
+      def self.wrap( text, width )
+        return text.to_s if width.to_i <= 0
+
+        text.to_s.split( "\n", -1 ).map { |line| wrap_line( line, width ) }.join( "\n" )
+      end
+
+      # ---------------------------------------------------------------------
+      #    Private
+      # ---------------------------------------------------------------------
+
+      #
+      # Wrap a single line (no embedded newlines) to the given width.
+      #
+      def self.wrap_line( line, width )
+        words = line.split( ' ' )
+        return line if words.empty?
+
+        lines = []
+        current = words.shift
+        words.each do |word|
+          if "#{current} #{word}".length > width
+            lines << current
+            current = word
+          else
+            current = "#{current} #{word}"
+          end
+        end
+        lines << current
+        return lines.join( "\n" )
+      end
+      private_class_method :wrap_line
+
+    end
+  end
+end

data/lib/gloo/verbs/list.rb

@@ -92,21 +92,53 @@ module Gloo
 
       #
       # Show the object's doc (its leading comment, cleaned up) above
-      # its listing line, one '#'-prefixed line per line of doc.
-      # Silent when the object has none.
+      # its listing line, one '#'-prefixed line per line of doc, word-
+      # wrapped to fit the terminal. Silent when the object has none.
       #
       def show_doc( obj, indent )
         return if obj.doc.to_s.strip.empty?
 
-        theme = @engine.theme
+        prefix = "#{indent}# "
+        cont_indent = "#{indent}  " # lines up under the text after '# '
+        width = doc_wrap_width( prefix.length )
+
         # split( -1 ), not each_line -- a doc ending in a blank '#' line
         # ends with "\n", and each_line silently drops that trailing
         # empty line rather than yielding it.
         obj.doc.split( "\n", -1 ).each do |line|
-          @engine.log.show theme.muted( "#{indent}# #{line}".rstrip )
+          show_doc_line( line, prefix, cont_indent, width )
         end
       end
 
+      #
+      # Word-wrap a single doc line to width, then show each wrapped
+      # piece: the '#' prefix on the first, the aligned continuation
+      # indent on the rest.
+      #
+      def show_doc_line( line, prefix, cont_indent, width )
+        theme = @engine.theme
+        wrapped = Gloo::Objs::WordWrap.wrap( line, width )
+        # "".split( "\n", -1 ) is [], not [ '' ] -- a blank line still
+        # needs one piece so it renders as a bare '#', not nothing.
+        pieces = wrapped.empty? ? [ '' ] : wrapped.split( "\n", -1 )
+        pieces.each_with_index do |piece, i|
+          p = i.zero? ? prefix : cont_indent
+          @engine.log.show theme.muted( "#{p}#{piece}".rstrip )
+        end
+      end
+
+      #
+      # How many columns of text fit after the doc-line prefix. Falls
+      # back to a small minimum rather than a zero/negative width when
+      # the terminal is very narrow or the indent is very deep.
+      #
+      def doc_wrap_width( prefix_length )
+        width = Gloo::App::Settings.cols( @engine ) - prefix_length
+        return width if width.positive?
+
+        return 20
+      end
+
       #
       # Determine how many levels to show.
       #

data/test.gloo/objs/string.test.gloo

@@ -79,6 +79,23 @@ tests.objs.string [can] :
       eval it = 'three'
       assert "expected split (8 100) to clamp to 'three'"
 
+  word_wrap [test] :
+    description [string] : Word-wrap a string to an explicit width
+    on_test [script] :
+      put 'one two three four five' into ^^.s
+      tell ^^.s to word_wrap (10)
+      tell ^^.s to count_lines
+      eval it = 3
+      assert "expected word_wrap (10) to produce 3 lines"
+
+  word_wrap_keeps_long_word_intact [test] :
+    description [string] : word_wrap never breaks a word, even one wider than the width
+    on_test [script] :
+      put 'http://example.com/a-really-long-url short' into ^^.s
+      tell ^^.s to word_wrap (10)
+      check ^^.s for substring? ('http://example.com/a-really-long-url')
+      assert "expected the long word to remain intact on its own line"
+
   split_list [test] :
     description [string] : Split a string into children of a target container
     on_test [script] :

data/test.gloo/objs/text.test.gloo

@@ -101,3 +101,12 @@ tests.objs.text [can] :
       put 'hello world' into ^^.b
       tell ^^.b to substring? ('lo w')
       assert "expected it to be true that it contains 'lo w'"
+
+  word_wrap [test] :
+    description [string] : Word-wrap text to an explicit width
+    on_test [script] :
+      put 'one two three four five' into ^^.b
+      tell ^^.b to word_wrap (10)
+      tell ^^.b to count_lines
+      eval it = 3
+      assert "expected word_wrap (10) to produce 3 lines"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo
 version: !ruby/object:Gem::Version
-  version: 6.5.1
+  version: 6.6.0
 platform: ruby
 authors:
 - Eric Crane
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -361,6 +362,7 @@ files:
 - lib/gloo/objs/basic/string_msgs.rb
 - lib/gloo/objs/basic/text.rb
 - lib/gloo/objs/basic/untyped.rb
+- lib/gloo/objs/basic/word_wrap.rb
 - lib/gloo/objs/ctrl/each.rb
 - lib/gloo/objs/ctrl/each_child.rb
 - lib/gloo/objs/ctrl/each_dir.rb
@@ -505,6 +507,7 @@ licenses:
 - MIT
 metadata:
   documentation_uri: https://github.com/ecrane/gloo
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -519,7 +522,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.17
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: Gloo scripting language.  A scripting language built on ruby.
 test_files: []