cocos 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbe9c2c739403b5996adda6684d175a3853afbd76bffe81adf44c8a31cbe0c8d
-  data.tar.gz: 4ba46909cd0722c656aaa1be7145dc5430e681bf5f4722e2b03b3af6928d9de8
+  metadata.gz: f34f86372be24c8d19abde781cc66b5d9c6b323e09c7620221f30b9e115b786d
+  data.tar.gz: d025bedc0c96372e74339bd4a0ae7fcd56857d23a1678b35c1b2a8aef2b1be12
 SHA512:
-  metadata.gz: 5416f8ad167ba3f614cb85483b372bd1b9a8ccf7c60a69fcdbcfac954c1ae3c586f582e1fa3d7abf6dc6cf4c3f95c1da0f8e2bbfaae12b716d77290f90450715
-  data.tar.gz: e7aa4a8514cf702b9b35b526e60011743de51ebdf1cbb2e8e0861e722225b5e3e76b113304dbcb8c58c377be17e340fd0e961a64a8a3a568768d01fe17a6de3e
+  metadata.gz: 50b9cc405bb2d5e16900958a55c11fcf02b5854a4410c072cbab51d585c3a656f9a9a8bb4246b51fc7b46d0200d7fefa98ea3bd4d0e95bb455c8e60dc92c6e10
+  data.tar.gz: fc797f93f3f73644b5b6ee6695564ffd4f4f7308aa8412d5d62785baa9301e5cd740ceb017215d7a3417884edcc057044e15c938bea1310c4c217cbb310d188b

data/CHANGELOG.md

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

data/README.md

@@ -87,8 +87,7 @@ And so on.
 
 _Read / parse convenience short-cut helpers_
 
-`read_blob( path )` <br>
-also known as `read_binary` or `read_bin`
+`read_blob( path )`
 
 
 `read_text( path )` <br>
@@ -98,14 +97,14 @@ also known as `read_txt`
 `read_lines( path )`
 
 
-
 `read_json( path )` / `parse_json( str )`
 
 
-`read_yaml( path )` / `parse_yaml( str )`
+`read_yaml( path )` / `parse_yaml( str )` <br>
+also known as `read_yml` / `parse_yml`
 
 
-`read_csv( path, headers: true )` / `parse_csv( str, headers: true )`
+`read_csv( path )` / `parse_csv( str )`
 
 note: comma-separated values (.csv) reading & parsing service
 brought to you by the [**csvreader library / gem »**](https://github.com/rubycocos/csvreader/tree/master/csvreader)
@@ -113,8 +112,7 @@ brought to you by the [**csvreader library / gem »**](https://github.com/rubyco
 
 `read_data( path )` / `parse_data( str )`
 
-note:  alternate shortcut / alias for `read_csv( path, headers: false )` / `parse_csv( str, headers: false )`
-
+note:  alternate csv reader / parser; reads data WITHOUT headers, that is, named columns - returns data array not named hash (table)
 
 
 
@@ -125,7 +123,6 @@ brought to you by the [**tabreader library / gem »**](https://github.com/rubyco
 
 
 
-
 `read_ini( path )` / `parse_ini( str )` <br>
 also known as `read_conf / parse_conf`
 

data/Rakefile

@@ -12,7 +12,7 @@ Hoe.spec 'cocos' do
   self.urls = { home: 'https://github.com/rubycocos/cocos' }
 
   self.author = 'Gerald Bauer'
-  self.email = 'opensport@googlegroups.com'
+  self.email = 'gerald.bauer@gmail.com'
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'

data/lib/cocos/version.rb

@@ -1,8 +1,8 @@
 
 module Cocos
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 3
-  PATCH = 1
+  MINOR = 4
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version
@@ -14,8 +14,6 @@ module Cocos
   end
 
   def self.root
-    File.expand_path( File.dirname(File.dirname(__FILE__) ))
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__) )))
   end
-
 end # module Cocos
-

data/lib/cocos.rb

@@ -29,8 +29,9 @@ require 'webclient'
 
 #####################
 # our own code
-require 'cocos/version'   # note: let version always go first
-require 'cocos/env'       ## e.g. EnvParser
+require_relative 'cocos/version'   # note: let version always go first
+require_relative 'cocos/env'       ## e.g. EnvParser
+
 
 ###
 ##  read/parse convenience/helper shortcuts
@@ -43,138 +44,153 @@ module Kernel
 ################
 #  private helpers - keep along here - why? why not?
 
-##### check if path starts with http:// or https://
-##       if yes, assume it's a download
-DOWNLOAD_RX = %r{^https?://}i
 
-## note: hack - use !! to force nil (no match) to false
-##                         and matchdata to true
-def _download?( path )
-   !! DOWNLOAD_RX.match( path )
-end
+## todo:  add symbolize options a la read_json? - why? why not?
+##         add sep options
 
+def read_csv( path, sep: nil )
+  opts = {}
+  opts[:sep] = sep  if sep
 
+  CsvHash.read( path, **opts )
+end
 
-## todo:  add symbolize options a la read_json
-##         add sep options
-def read_csv( path, headers: true )
-
-   if _download?( path )
-     parse_csv( _wget!( path ).text,
-                headers: headers )
-   else
-     if headers
-        CsvHash.read( path )
-     else
-        Csv.read( path )
-     end
-    end
+def parse_csv( str, sep: nil )
+  opts = {}
+  opts[:sep] = sep  if sep
+
+  CsvHash.parse( str, **opts )
 end
 
-def parse_csv( str, headers: true )
-  if headers
-    CsvHash.parse( str )
-  else
-    Csv.parse( str )
-  end
+
+##  note - use explicit download for now
+##
+def download_csv( url, sep: nil )
+  opts = {}
+  opts[:sep] = sep  if sep
+
+  parse_csv( download_text( url ),
+              **opts )
 end
 
 
+
 ### note: use read_data / parse_data
 ##  for alternate shortcut for read_csv / parse_csv w/ headers: false
 ##       returning arrays of strings
 def read_data( path )
-  if _download?( path )
-    read_data( _wget!( path ).text )
-  else
-    Csv.read( path )
-  end
+  Csv.read( path )
 end
 
 def parse_data( str )
   Csv.parse( str )
 end
 
+def download_data( url )
+  parse_data( download_text( url ))
+end
+
 
 
 def read_tab( path )
-  if _download?( path )
-    parse_tab( _wget!( path ).text )
-  else
-    Tab.read( path )
-  end
+  Tab.read( path )
 end
 
 def parse_tab( str )
   Tab.parse( str )
 end
 
+def download_tab( url )
+  parse_tab( download_text( url ))
+end
+
+
 
 ## todo:  add symbolize options ???
 def read_json( path )
-  JSON.parse( read_text( path ))
+  parse_json( read_text( path ))
 end
 
 def parse_json( str )
   JSON.parse( str )
 end
 
+def download_json( url )
+  parse_json( download_text( url ))
+end
+
 
 ### todo/check:  use parse_safeyaml or such? (is default anyway?) - why? why not?
 def read_yaml( path )
-   YAML.load( read_text( path ))
+   parse_yaml( read_text( path ))
 end
 
 def parse_yaml( str )
   YAML.load( str )
 end
 
+def download_yaml( url )
+   parse_yaml( download_text( url ))
+end
+
+## keep yml alias - why? why not?
+alias_method :read_yml,     :read_yaml
+alias_method :parse_yml,    :parse_yaml
+alias_method :download_yml, :download_yaml
+
 
 def read_ini( path )
-   INI.load( read_text( path ))
+   parse_ini( read_text( path ))
 end
 
 def parse_ini( str )
   INI.load( str )
 end
 
+def download_ini( url )
+   parse_ini( download_text( url ))
+end
+
 alias_method :read_conf, :read_ini
 alias_method :parse_conf, :parse_ini
+alias_method :download_conf, :download_ini
 
 
 
 
 def read_text( path )
-  if _download?( path )
-    _wget!( path ).text
-  else
    ## 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
-    txt
-  end
+    File.open( path, 'r:utf-8' ) do |f|
+        f.read
+    end
+end
+
+def download_text( url )
+  wget!( url ).text
 end
-alias_method :read_txt, :read_text
+
+alias_method :read_txt,     :read_text
+alias_method :download_txt, :download_text
+
 
 
 def read_blob( path )
-  if _download?( path )
-    _wget!( path ).blob
-  else
-    blob =  File.open( path, 'rb' ) do |f|
-                   f.read
-            end
-    blob
-  end
+    File.open( path, 'rb' ) do |f|
+        f.read
+    end
 end
-alias_method :read_binary, :read_blob
-alias_method :read_bin,    :read_blob
+## alias_method :read_binary, :read_blob
+## alias_method :read_bin,    :read_blob
 
+def download_blob( url )
+   wget!( url ).blob
+end
+## alias_method :download_binary, :download_blob
+## alias_method :download_bin,    :download_blob
 
 
 
@@ -191,10 +207,14 @@ def parse_lines( str )
   str.lines
 end
 
+def download_lines( url )
+  parse_lines( download_text( url ))
+end
+
 
 
 def read_env( path )
-   EnvParser.load( read_text( path ))
+   parse_env( read_text( path ))
 end
 
 def parse_env( str )
@@ -251,8 +271,8 @@ def write_blob( path, blob )
     f.write( blob )
   end
 end
-alias_method :write_binary, :write_blob
-alias_method :write_bin,    :write_blob
+# alias_method :write_binary, :write_blob
+# alias_method :write_bin,    :write_blob
 
 
 def write_text( path, text )
@@ -274,20 +294,20 @@ alias_method :write_txt,  :write_text
 #
 # note:
 #  for now write_csv expects array of string arrays
-#     does NOT support array of hashes for now 
+#     does NOT support array of hashes for now
 
 def write_csv( path, recs, headers: nil )
   dirname = File.dirname( path )
   FileUtils.mkdir_p( dirname )  unless Dir.exist?( dirname )
 
   File.open( path, 'w:utf-8' ) do |f|
-    if headers 
+    if headers
       f.write( headers.join(','))   ## e.g. Date,Team 1,FT,HT,Team 2
       f.write( "\n" )
-    end  
+    end
 
     recs.each do |values|
-      ## quote values that incl. a comma 
+      ## quote values that incl. a comma
       ##  todo/fix - add more escape/quote checks - why? why not?
       ##   check how other csv libs handle value generation
       buf =  values.map do |value|
@@ -297,10 +317,10 @@ def write_csv( path, recs, headers: nil )
                   value
                end
              end.join( ',' )
-  
+
       f.write( buf )
       f.write( "\n" )
-    end 
+    end
   end
 end
 
@@ -309,16 +329,13 @@ end
 ######
 #   world wide web (www) support
 
-def wget( url, **kwargs )
-  Webclient.get( url, **kwargs )
+def wget( url, **opts )
+  Webclient.get( url, **opts )
 end
 ##  add alias www_get or web_get - why? why not?
 
-
-
-## private helper - make public -why? why not?
-def _wget!( url, **kwargs )
-  res = Webclient.get( url, **kwargs )
+def wget!( url, **opts )
+  res = Webclient.get( url, **opts )
 
   ##  check/todo - use a different exception/error - keep RuntimeError - why? why not?
   raise RuntimeError, "HTTP #{res.status.code} - #{res.status.message}"   if res.status.nok?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocos
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-29 00:00:00.000000000 Z
+date: 2024-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csvreader
@@ -101,7 +101,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.1'
 description: cocos (code commons) - auto-include quick-starter prelude & prolog
-email: opensport@googlegroups.com
+email: gerald.bauer@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: