cocos 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e276117f95b89fcfc61f23559b725c3905aa8668eb6b0b7e7175c4fe57eb1a86
-  data.tar.gz: 1b3043bd0de213189a8e531d4fea92ccf7b1262636067a05c914261a66d4338c
+  metadata.gz: 8bef9f661e35af9a5b936f7e37a27e73d0554e361e4d5f3a722305db037b6dc9
+  data.tar.gz: c347765ba3ce339a52541c801bb10fb6ce39800facd619773a6072bddffd16c2
 SHA512:
-  metadata.gz: ff35b353cde05f6f76e6b6069442abda8769488768edaba6dfd2b411b06ec24aac97d0a10c25bcac08ba5617451e2a9c800861a5bd535e4d347b8e68b17eb747
-  data.tar.gz: '08c86a7e5950818e53c38668b68259e4248be7e0ef5201a52a570349e7dfe803dd6a534af73ca45ca7745fadc9a19022c15d08a38a121c5153fbc7705035e153'
+  metadata.gz: 8f6d70adfcfd0eb010daf8b7a23e8ae402a6186f7242d097e8a1fb99ad6187105567727077c033760b724c9863b6da64efe4a960ac8dd6c9ff961a6b485a9b89
+  data.tar.gz: d0b49d70ac8a369ed7d1f1d51b793edcffd468575592a1cb229c09494d16f7ff63b5479e385858d621190981c92e14c307cb7ebab66c62669fc12e94b69ce09b

data/CHANGELOG.md

@@ -1,4 +1,4 @@
-### 0.4.2
+### 0.4.3
 ### 0.0.1 / 2022-08-01
 
 * Everything is new. First release.

data/Manifest.txt

@@ -7,3 +7,4 @@ lib/cocos.rb
 lib/cocos/env.rb
 lib/cocos/find_file.rb
 lib/cocos/version.rb
+lib/cocos/words.rb

data/lib/cocos/find_file.rb

@@ -1,3 +1,5 @@
+module Cocos
+  module  Find
 
 
 ##
@@ -13,8 +15,6 @@
 ##     always return absolute (expanded) path - why? why not?
 
 
-module Kernel
-
 def find_file!( name, path: )
     filepath = find_file( name, path: path )
     raise Errno::ENOENT, "file #{name.inspect} not found; looking in path #{path.inspect}"   if filepath.nil?
@@ -79,5 +79,5 @@ def find_dir( name, path: [] )
 end
 
 
-
-end  # module Kernel
+end  ## module  Find
+end  ## module Cocos

data/lib/cocos/version.rb

@@ -2,7 +2,7 @@
 module Cocos
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
   MINOR = 4
-  PATCH = 2
+  PATCH = 3
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/lib/cocos/words.rb

@@ -0,0 +1,86 @@
+
+###
+##
+##   try  new style with Cocos::FileUtils or Cocos::IO module
+##           and include module into Kernel (instead of directly)
+
+
+module Cocos
+module  FileUtils
+
+
+
+## "words" or "word array.
+##
+##  follows  %w[] rules
+##    splits on whitespace (space or newline)
+##    BUT include support for inline comments!!!!
+##
+##    %w[apple banana cherry]
+##        => ["apple", "banana", "cherry"]
+##      note - allows more than one word on a line!!!!
+##
+##    %w[
+##        ruby
+##        python
+##        javascript
+##        go
+##     ]
+##      => ["ruby", "python", "javascript", "go"]
+##
+##  %w[] is a shorthand syntax (known as a percent literal)
+##    used to create an array of strings.
+##   It allows you to write an array of words without typing
+##    repetitive quotation marks and commas.
+##   Instead, you separate each item using whitespace (spaces or newlines).
+##   note - You CANNOT use standard # comments inside %w[].
+##    Ruby treats the # character as part of a literal string, which will ruin your array.
+##
+##
+##  todo/check:
+##   Option 1: The "Strict Space" Rule (Simplest & Safest)
+##   In most text/config files, a comment is separated by a space
+##    (e.g., key = value # comment).
+##   If a # is glued to a word without a space, it is usually part of the data
+##    (like a hex color #ffffff or a tag #important).
+##     You can modify your code to only remove # if it is preceded by whitespace
+##         color#ff0000     # red
+##         color = #ff0000  # red
+##   check - if this is how # is handled in yaml?
+##      - Inline Comments: A # can be placed at the end of a line of data,
+##                          but it must be preceded by a space.
+##     e.g.  port: 8080# This will break or fail to parse correctly
+##
+##  e.g. use
+##        line.sub( ??, '' ).strip
+
+def parse_words( txt )
+   words = []     ## array of strings
+   txt.each_line( chomp: true ) do |line|
+
+      line = line.strip
+
+      next  if line.empty? || line.start_with?('#')
+
+      ##  strip (inline) end-of-line comments (from line) too - keep why? why not?
+      ##    ## (eat-up) REQUIRED leading (preceding) space(s) too - why? why not?
+      line = line.sub( /[ \t]+#.*/, '' )
+
+      ##  support __END__ marker for inline comments
+      break  if line == '__END__'
+
+      words += line.split( /[ \t]+/ )
+   end
+
+   words
+end
+
+alias_method :parse_wordarray, :parse_words
+
+
+## todo - add (missing) read_words/wordarray too - why? why not?
+
+
+
+end  # module FileUtils
+end  # module Cocos

data/lib/cocos.rb

@@ -435,6 +435,19 @@ end # module Kernel
 
 
 
+require_relative 'cocos/words'    ## pulls in parse_words/wordarray
+
+###
+##   try add kernel global methods via module
+module Kernel
+  include Cocos::FileUtils
+  include Cocos::Find        # e.g. find_file, find_dir, etc.
+end  ## module Kernel
+
+
+
+
+
 
 ####
 #  convenience alias  (use plural or singual)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocos
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-19 00:00:00.000000000 Z
+date: 2026-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csvreader
@@ -119,6 +119,7 @@ files:
 - lib/cocos/env.rb
 - lib/cocos/find_file.rb
 - lib/cocos/version.rb
+- lib/cocos/words.rb
 homepage: https://github.com/rubycocos/cocos
 licenses:
 - Public Domain