cocos 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40d870d3371a969672ba3e6b61dfb5cfbfae18809fa2edb96c8a3dbdfa44f1e8
-  data.tar.gz: f811adb7be939ff1dd90108fe16bf036f45e40540cbbff81fb7d20d6591c1426
+  metadata.gz: 38e913cc7ec8d6951edd7bb59ac80626aadf3a3fbd7b13f82ccc123dffc6a7b1
+  data.tar.gz: 8883a9656f7aa48b6c778e9786966f507a80dbd13be670ca69ff9ed5b20656a8
 SHA512:
-  metadata.gz: b504140b89069be5896ab2028263e191475d5d92423fc6df4be069523c2b037b0c28830ec0fa89426e0212007044344ed4c849345e016d12c2c0832575b85920
-  data.tar.gz: 1b5a4741a03b48740fb4868bf54c054382dbee3a3f7b7cca243d2393c88cc0c6cb5b5d75e593d5c3bdec075d3df32a714eb4f7ec861572dfd9c3e4a2278f9548
+  metadata.gz: 1b9e85de98ce029a384d0ce1fa2e09905d3d7eeee956d59ab090c0eb9300b1de121ecc1bfeaaacdebdca7dd66227f7a9fefce1ef397d1d97fa5123cac32609c8
+  data.tar.gz: ba6fc944c1dc724c131c0f32390349140c3d658a4db80d876a421704eea1d13ac78ecedc3da6141ba7116367270e836d8aafcb420b12bd664ae604ac557af8a4

data/CHANGELOG.md

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

data/Manifest.txt

@@ -4,4 +4,5 @@ Manifest.txt
 README.md
 Rakefile
 lib/cocos.rb
+lib/cocos/env.rb
 lib/cocos/version.rb

data/lib/cocos/env.rb

@@ -0,0 +1,91 @@
+###
+# simple read_env, load_env machinery
+##   inspired by
+##      dotenv gem -> https://github.com/bkeepers/dotenv
+##      figaro     -> https://github.com/laserlemon/figaro  
+##      and others
+
+
+##  todo/check:
+##    move to its own (standandaloen) envparser gem - why? why not?
+
+module EnvParser
+    # returns a hash
+    #  (compatible structure - works like YAML.load_file)
+    #
+    #   change to .read(path) and parse( text) - why? why not?
+    def self.load_file( path )
+        text = File.open( path, 'r:utf-8' ) { |f| f.read }
+        parse( text )
+    end
+    def self.load( text )   parse( text ); end
+ 
+    
+    class Error < StandardError; end
+  
+    ## todo/check - what is JSON and YAML returning Parser/ParseError something else?
+    ##  YAML uses ParseError  and JSON uses ParserError
+    class ParseError < Error; end
+  
+
+    ## todo/check - if support for empty values e.g. abc=  is required/possible???
+    ##  todo/ addd support for quoted values - why? why not?
+    ##  add support for "inline" end of line comments - why? why not?
+    ##  add support for escapes and multi-line values - why? why not?
+LINE_RX = /\A(?<key>[A-Za-z][A-Za-z0-9_-]*)
+                 [ ]*
+                   =
+                 [ ]*
+               (?<value>.+?)    ## non-greedy
+              \z
+             /x
+
+  ## use a parser class - why? why not?
+  def self.parse( text )
+   h = {}
+
+   lineno = 0   
+  text.each_line do |line|
+    lineno += 1    ## track line numbers for (parse) error reporting
+
+    line = line.strip   ## check: use strip (or be more strict) - why? why not?
+    ## skip empty and comment lines
+    next if line.empty? || line.start_with?( '#' )
+
+    if m=LINE_RX.match(line)
+      key   = m[:key]
+      value = m[:value]
+      
+      ## todo/check - check/warn about duplicates - why? why not?
+      h[key] = value
+   else 
+      raise ParseError,  "line #{lineno} - unknown line type; cannot parse >#{line}<"
+   end
+  end
+  h
+end   # methdod self.parse
+end  # module EnvParser
+
+  
+
+__END__
+
+# parser regex from dotenv
+
+LINE = /
+(?:^|\A)              # beginning of line
+\s*                   # leading whitespace
+(?:export\s+)?        # optional export
+([\w.]+)              # key
+(?:\s*=\s*?|:\s+?)    # separator
+(                     # optional value begin
+  \s*'(?:\\'|[^'])*'  #   single quoted value
+  |                   #   or
+  \s*"(?:\\"|[^"])*"  #   double quoted value
+  |                   #   or
+  [^\#\r\n]+          #   unquoted value
+)?                    # value end
+\s*                   # trailing whitespace
+(?:\#.*)?             # optional comment
+(?:$|\z)              # end of line
+/x

data/lib/cocos/version.rb

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

data/lib/cocos.rb

@@ -30,7 +30,7 @@ require 'webclient'
 #####################
 # our own code
 require 'cocos/version'   # note: let version always go first
-
+require 'cocos/env'       ## e.g. EnvParser
 
 ###
 ##  read/parse convenience/helper shortcuts
@@ -151,6 +151,8 @@ def read_text( path )
    ## todo/check: add universal newline mode or such?
    ##  e.g. will always convert all
    ##    newline variants (\n|\r|\n\r) to "universal" \n only
+   ##
+   ##  add r:bom  - why? why not?
     txt = File.open( path, 'r:utf-8' ) do |f|
                 f.read
           end
@@ -191,6 +193,33 @@ end
 
 
 
+def read_env( path )
+   EnvParser.load( read_text( path ))
+end
+
+def parse_env( str )
+   EnvParser.load( str )
+end
+
+
+##
+##  todo/check - change path to *paths=['./.env']
+##                   and support more files - why? why not?
+def load_env( path='./.env' )
+  if File.exist?( path )
+     puts "==> loading .env settings..."
+     env = read_env( path )
+     puts "    applying .env settings... (merging into ENV)"
+     pp env
+     ## note: will only add .env setting if NOT present in ENV!!!
+     env.each do |k,v|
+         ENV[k] ||= v
+     end
+  end
+end
+
+
+
 
 ######
 #  add writers
@@ -204,7 +233,7 @@ def write_json( path, data )
   FileUtils.mkdir_p( dirname )  unless Dir.exist?( dirname )
 
   ## note: pretty print/reformat json
-  File.open( path, "w:utf-8" ) do |f|
+  File.open( path, 'w:utf-8' ) do |f|
      f.write( JSON.pretty_generate( data ))
   end
 end
@@ -218,7 +247,7 @@ def write_blob( path, blob )
   dirname = File.dirname( path )
   FileUtils.mkdir_p( dirname )  unless Dir.exist?( dirname )
 
-  File.open( path, "wb" ) do |f|
+  File.open( path, 'wb' ) do |f|
     f.write( blob )
   end
 end
@@ -234,7 +263,7 @@ def write_text( path, text )
   dirname = File.dirname( path )
   FileUtils.mkdir_p( dirname )  unless Dir.exist?( dirname )
 
-  File.open( path, "w:utf-8" ) do |f|
+  File.open( path, 'w:utf-8' ) do |f|
     f.write( text )
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocos
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-23 00:00:00.000000000 Z
+date: 2023-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csvreader
@@ -92,14 +92,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.23'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.23'
+        version: '4.0'
 description: cocos (code commons) - auto-include quick-starter prelude & prolog
 email: opensport@googlegroups.com
 executables: []
@@ -116,6 +116,7 @@ files:
 - README.md
 - Rakefile
 - lib/cocos.rb
+- lib/cocos/env.rb
 - lib/cocos/version.rb
 homepage: https://github.com/rubycocos/cocos
 licenses:
@@ -138,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: cocos (code commons) - auto-include quick-starter prelude & prolog