gloo 5.3.8 → 5.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09b142bdfb67e58657f3b57bd8cafcc2854818a7e31d6baf1c57b873a4b9299d'
-  data.tar.gz: 54bcb342bf1917c63bb856dd6bf0b8b49c06e77710817adff73cdc4a29bae986
+  metadata.gz: c5353f95b95c44382afa5fbd36d3f14681314dcee7a284bb60c51806f6b9be5a
+  data.tar.gz: cabbfad7080488c79b911a12d9c070885505b0926f414f821d4d3cc2222c01bd
 SHA512:
-  metadata.gz: f1b1c09eb8b9c686b6dfe8e4b55d0cee1f0ccf41d8f1eb7681b18c9954b0f030348735451a638ae0fd2ab4d3c8624aaf224a5e2697fcd3b850616b2cf7cab32a
-  data.tar.gz: 20788c488d3b105b79d2c1f999422c59b812ef3487cb0d214f8491ab90b20e4b1cd58eedfed744f51e3bbcf11c2c34715e07b314e2c2875ea35c778920afa4e2
+  metadata.gz: d86a2a5c5476dab64505e1180fb43b6c24d9cb4bec414a9dc9703afb8748a85070eb33ba5db10ed2146ac1244380f8cf3fb7bc81773e892474d441615711c955
+  data.tar.gz: 8d41fd6c9ee3f5839e423721f8d23c2024f777caaddf60785209f2ad2d867360974c75697cb46fe62a45c81994fe41ff337794fe24118fe2bb5ca93cf2f22d6e

data/CLAUDE.md

@@ -0,0 +1,83 @@
+@/Users/ecrane/dev/gloo_meta/CLAUDE.md
+
+# Gloo — Core Interpreter
+
+This is the main gloo language implementation, packaged as a Ruby gem.
+
+## Project Structure
+
+```
+gloo/
+├── lib/gloo/
+│   ├── core/        Parser, Obj base class, Dictionary, path names (PN)
+│   ├── exec/        Execution engine, dispatcher, runner
+│   ├── expr/        Expression evaluator and operators
+│   ├── objs/        Object type implementations
+│   │   ├── basic/   string, int, bool, container, text, decimal, untyped, alias
+│   │   ├── ctrl/    script, function (ƒ), each, repeat
+│   │   ├── dt/      date, time, datetime
+│   │   ├── str_utils/
+│   │   ├── system/  ruby, file_handle, system
+│   │   └── web/     http_get, http_post, json, uri, erb
+│   ├── verbs/       One file per verb (28 total)
+│   ├── persist/     File loading/saving
+│   ├── convert/     Type conversion
+│   └── plugin/      Plugin system
+├── test/            Ruby unit tests (minitest)
+└── test.gloo/       Gloo-language integration tests
+```
+
+## Test Suites
+
+### Ruby unit tests — `test/`
+Run with: `rake test`
+
+File naming: `test/<area>/<name>_test.rb`
+Structure mirrors `lib/gloo/` — a test file per class/verb.
+
+```
+test/
+├── verbs/           One *_test.rb per verb
+├── objs/basic/      One *_test.rb per object type
+├── objs/ctrl/
+├── objs/dt/
+├── core/
+├── exec/
+├── expr/
+└── ...
+```
+
+Base classes: inherit from `GlooTest` (defined in `test/base_test.rb`).
+
+### Gloo integration tests — `test.gloo/`
+Written in gloo itself. Each file contains `[test]` objects with `on_test` scripts using `assert` and `refute`.
+
+```
+test.gloo/
+├── basic.test.gloo
+├── dt/
+├── lang/
+├── math/
+├── objs/
+├── string/
+└── verbs/
+```
+
+Test object pattern:
+```gloo
+tests [can] :
+  group [can] :
+    my_test [test] :
+      description [string] : What this verifies
+      on_test [script] :
+        # ... setup ...
+        eval some.value = expected
+        assert "description of passing condition"
+```
+
+## Adding a Missing Unit Test
+
+1. Find the relevant `test/<area>/*_test.rb` file (or create one mirroring the `lib/` path)
+2. Inherit from `GlooTest`
+3. Run the full suite with `rake test` to verify nothing is broken
+4. Check `test.gloo/` to see if a corresponding gloo-level integration test is also needed

data/lib/VERSION

@@ -1 +1 @@
-5.3.8
+5.3.9

data/lib/VERSION_NOTES

@@ -1,3 +1,7 @@
+5.3.9 - 2026.06.11
+ - Adds append message to file object
+
+
 5.3.8 - 2026.05.24
  - Update to URI to enable opening on Windows and WSL.
 

data/lib/gloo/objs/system/file_handle.rb

@@ -37,7 +37,7 @@ module Gloo
       # Get a list of message names that this object receives.
       #
       def self.messages
-        basic = %w[read write delete get_name get_ext get_parent get_sha256]
+        basic = %w[read write append delete get_name get_ext get_parent get_sha256]
         checks = %w[exists? is_file? is_dir? mkdir]
         search = %w[find_match]
         show = %w[show page open]
@@ -89,6 +89,23 @@ module Gloo
         end
       end
 
+      #
+      # Append the given data to the file as a new line.
+      # Adds a leading newline if the file does not already end with one.
+      #
+      def msg_append
+        data = ''
+        return unless value
+
+        if @params&.token_count&.positive?
+          expr = Gloo::Expr::Expression.new( @engine, @params.tokens )
+          data = expr.evaluate
+        end
+        existing = File.exist?( value ) ? File.read( value ) : ''
+        prefix = existing.empty? || existing.end_with?( "\n" ) ? '' : "\n"
+        File.open( value, 'a' ) { |f| f.puts "#{prefix}#{data}" }
+      end
+
       #
       # Write the given data out to the file.
       #

data/test.gloo/lang/gloo_sys.test.gloo

@@ -89,3 +89,18 @@ tests [can] :
           put $.screen_cols into ^.i
           eval ^.i > 0
           assert "expected screen_cols to be greater than 0"
+
+      get_platform_os [test] :
+        description [string] : Get the platform OS.
+        on_test [script] :
+          eval $.platform_mac? = true
+          assert "expected platform_mac to be true"
+
+          eval $.platform_windows? = false
+          assert "expected platform_windows to be false"
+
+          eval $.platform_linux? = false
+          assert "expected platform_linux to be false"
+
+          eval $.platform_wsl? = false
+          assert "expected platform_wsl to be false"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo
 version: !ruby/object:Gem::Version
-  version: 5.3.8
+  version: 5.3.9
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-24 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -263,6 +263,7 @@ files:
 - ".ruby-gemset"
 - ".ruby-version"
 - ".travis.yml"
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt