cocos 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 805a278e6d9393cd8d8dc34993735c77656e0dd35cbc8639f231fd2379b9633d
-  data.tar.gz: f29c8e08820c5cf7c7e852d081466bd49532a0fd7b6edd790bdbd3bb6c329ec9
+  metadata.gz: e49de20835fe070c898b36630cfb952e42003b3c280cb4d4bceee2419fd3300a
+  data.tar.gz: b1475a217a8c265c877b7c320d56388a85683aa0cd8d040761c985094fda8ace
 SHA512:
-  metadata.gz: 58806d72f9e21997a77d5b5ef7ef066367929e73bda712939c20508244be6774686a10df3de213298f1a61711607590d4cb4665946dcaebc46bc75b402767cca
-  data.tar.gz: 28e6e3f7cb54a18d179c3f5ef3cf15f4a100324f371b16ddb85a58019abb4d80be42611dad2bebd3f9e84d49c41185bc6b08b1b0074debac24e2098977913658
+  metadata.gz: c34680343ab16f40698560573e9aa110194371e4a534ba6b51f8af7d894b0dac2bead33025ce6602b10b4885b43939aec20c0c54ccba95cb11f37d03df46cfd8
+  data.tar.gz: 44c1ffd924648debe95f21b1b448709a817285a8521df50c2e2335ef761d014cbfa6aa42ed812949ecaef4bfa29850273714f6b3d94233c56bade179a3949fce

data/README.md

@@ -22,6 +22,7 @@ require 'time'
 require 'date'
 require 'json'
 require 'yaml'
+require 'base64'
 require 'fileutils'
 
 require 'uri'
@@ -86,6 +87,9 @@ And so on.
 
 _Read / parse convenience short-cut helpers_
 
+`read_blob( path )` <br>
+also known as `read_binary` or `read_bin`
+
 
 `read_text( path )` <br>
 also known as `read_txt`
@@ -94,6 +98,7 @@ also known as `read_txt`
 `read_lines( path )`
 
 
+
 `read_json( path )` / `parse_json( str )`
 
 
@@ -106,6 +111,13 @@ note: comma-separated values (.csv) reading & parsing service
 brought to you by the [**csvreader library / gem »**](https://github.com/rubycocos/csvreader/tree/master/csvreader)
 
 
+`read_data( path )` / `parse_data( str )`
+
+note:  alternate shortcut / alias for `read_csv( path, headers: false )` / `parse_csv( str, headers: false )`
+
+
+
+
 `read_tab( path )` / `parse_tab( str )`
 
 note: tabulator (`\t`)-separated values (.tab) reading & parsing service

data/lib/cocos/version.rb

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

data/lib/cocos.rb

@@ -6,6 +6,7 @@ require 'time'
 require 'date'
 require 'json'
 require 'yaml'
+require 'base64'    ## e.g. Base64.decode64,Base64.encode64,...
 require 'fileutils'
 
 require 'uri'
@@ -55,6 +56,19 @@ def parse_csv( str, headers: true )
 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 )
+  Csv.read( path )
+end
+
+def parse_data( str )
+  Csv.parse( str )
+end
+
+
+
 def read_tab( path )
    Tab.read( path )
 end
@@ -98,6 +112,9 @@ alias_method :parse_conf, :parse_ini
 
 
 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
     txt = File.open( path, 'r:utf-8' ) do |f|
                 f.read
           end
@@ -106,6 +123,21 @@ end
 alias_method :read_txt, :read_text
 
 
+def read_blob( path )
+  blob =  File.open( path, 'rb' ) do |f|
+                  f.read
+          end
+  blob
+end
+alias_method :read_binary, :read_blob
+alias_method :read_bin,    :read_blob
+
+
+
+
+## todo/check: remove \n (or\r or \r\n) from line
+##   ruby (by default) keeps the newline - follow tradition? why? why not?
+##
 def read_lines( path )
     lines = File.open( path, 'r:utf-8' ) do |f|
                f.readlines

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocos
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-01 00:00:00.000000000 Z
+date: 2022-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: csvreader