tbpgr_utils 0.0.27 → 0.0.28

data/README.md

@@ -30,6 +30,7 @@ Or install it yourself as:
 |[TbpgrUtils Array#together_delete_at](#arraytogether_delete_at)                                                    |together version of Array#delete_at. together_delete_at has alias :tdelete_at                                        |
 |[TbpgrUtils Array#together_delete_if](#arraytogether_delete_if)                                                    |together version of Array#delete_if. together_delete_if has alias :tdelete_if                                        |
 |[TbpgrUtils Array#together_empty?](#arraytogether_empty)                                                           |together version of Array#empty?. together_empty? has alias :tempty?                                                 |
+|[TbpgrUtils Array#together_fill](#arraytogether_fill)                                                              |together version of Array#fill. together_fill has alias :tfill                                                       |
 |[TbpgrUtils Array#together_map](#arraytogether_mapor-tmap-together_collect-tcollect)                               |together version of Enumerable#map. together_map has aliases [:tmap, :together_collect, :tcollect]                   |
 |[TbpgrUtils Array#together_map!](#arraytogether_map-1or-tmap-1-together_collect-1-tcollect-1)                      |together version of Enumerable#map!. together_map! has aliases [:tmap!, :together_collect!, :tcollect!]              |
 |[TbpgrUtils Array#together_reduce](#arraytogether_reduceor-treduce-together_inject-tinject)                        |together version of Enumerable#reduce. together_reduce has aliases [:treduce, :together_inject, :tinject]            |
@@ -39,6 +40,7 @@ Or install it yourself as:
 |[AttributesInitializable::ClassMethods.attr_accessor_init](#attributesinitializableclassmethodsattr_accessor_init) |generate attr_accessor + initializer                                                                                 |
 |[AttributesInitializable::ClassMethods.attr_reader_init](#attributesinitializableclassmethodsattr_reader_init)     |generate attr_reader + initializer                                                                                   |
 |[AttributesInitializable::ClassMethods.attr_writer init](#attributesinitializableclassmethodsattr_writer_init)     |generate attr_writer + initializer                                                                                   |
+|[TbpgrUtils File.insert_bom](#fileinsert_bom)                                                                     |insert BOM to UTF-8 File                                                                                             |
 |[Ghostable module](#ghostable)                                                                                     |help to create ghost method(dynamic method define by ussing method_missing + pattern-method-name)                    |
 |[TbpgrUtils Kernel#bulk_define_methods](#kernelbulk_define_methods)                                                |define methods to classes. methods have simple return value.                                                         |
 |[TestToolbox Kernel#capture_stdout](#kernelcapture_stdout)                                                         |capture STDOUT                                                                                                       |
@@ -256,6 +258,36 @@ print ret # => false
 
 [back to list](#list)
 
+### Array#together_fill
+not use block case
+~~~ruby
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*6..10]]
+ret = lists.together_fill(99)
+print ret # => [[99, 99, 99, 99, 99], [99, 99, 99, 99, 99]]
+~~~
+
+use block, no args case
+~~~ruby
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*6..10]]
+ret = lists.together_fill { |i|(i + 1) + 1 }
+print ret # => [[2, 3, 4, 5, 6], [2, 3, 4, 5, 6]]
+~~~
+
+use block, has args case
+~~~ruby
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*6..10]]
+ret = lists.together_fill(2) { |i|(i + 1) + 1 }
+print ret # => [[1, 2, 4, 5, 6], [6, 7, 4, 5, 6]]
+~~~
+
+[back to list](#list)
+
 ### Array#together_map(or tmap, together_collect, tcollect)
 ~~~ruby
 require 'tbpgr_utils'
@@ -568,6 +600,25 @@ atr_sample2.instance_variable_get "@atr2" # => atr2
 
 [back to list](#list)
 
+### File.insert_bom
+* this method's main purpose is 'UTF-8 Excel CSV File'.
+
+output bommed text from input.csv to output.csv
+~~~ruby
+require 'tbpgr_utils'
+
+File.insert_bom("input.csv", "output.csv") # => output bommed text to output.csv
+~~~
+
+output bommed text from input.csv to input.csv
+~~~ruby
+require 'tbpgr_utils'
+
+File.insert_bom("input.csv") # => output bommed text to output.csv
+~~~
+
+[back to list](#list)
+
 ### Ghostable
 * include Ghostable
 * create ghost method by using Ghostable::ghost_method
@@ -980,6 +1031,7 @@ if you are Sublime Text2 user, you can use snippet for TbpgrUtils.
 https://github.com/tbpgr/tbpgr_utils_snippets
 
 ## History
+* version 0.0.28 : add Array#together_fill(alias tfill). add File.insert_bom.
 * version 0.0.27 : add Array#together_empty?(alias tempty?)
 * version 0.0.26 : add Array#together_delete_if(alias tdelete_if)
 * version 0.0.25 : add Array#together_delete_at(alias tdelete_at)

data/lib/open_classes/array.rb

@@ -358,6 +358,38 @@ class Array
     is_empty
   end
 
+  # Arrays bulk fill.
+  #
+  # together_fill has alias :tfill
+  #
+  # not use block case
+  #   lists = [[*1..5], [*6..10]]
+  #   ret = lists.together_fill(99)
+  #   print ret # => [[99, 99, 99, 99, 99], [99, 99, 99, 99, 99]]
+  #
+  # use block, no args case
+  #   lists = [[*1..5], [*6..10]]
+  #   ret = lists.together_fill { |i|(i + 1) + 1 }
+  #   print ret # => [[2, 3, 4, 5, 6], [2, 3, 4, 5, 6]]
+  #
+  # use block, has args case
+  #   lists = [[*1..5], [*6..10]]
+  #   ret = lists.together_fill(2) { |i|(i + 1) + 1 }
+  #   print ret # => [[1, 2, 4, 5, 6], [6, 7, 4, 5, 6]]
+  def together_fill(fill_value = nil, &block)
+    if_not_contain_array_rails_type_error
+    if block
+      fill_value = 0 if fill_value.nil?
+      first.each_with_index do |i_v, i|
+        next if i < fill_value
+        each { |list|list[i] = yield(i) }
+      end
+    else
+      each { |list|list.fill fill_value }
+    end
+    self
+  end
+
   private
 
   def if_not_contain_array_rails_type_error
@@ -414,6 +446,7 @@ class Array
   alias_method :tdelete_at, :together_delete_at
   alias_method :tdelete_if, :together_delete_if
   alias_method :tempty?, :together_empty?
+  alias_method :tfill, :together_fill
   alias_methods [:together_collect, :tmap, :tcollect], :together_map
   alias_methods [:together_collect!, :tmap!, :tcollect!], :together_map!
   alias_methods [:together_find_all, :tselect, :tfindall], :together_select

data/lib/open_classes/file.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+# File
+class File
+  # insert BOM to UTF-8 File
+  #
+  # this method's main purpose is 'UTF-8 Excel CSV File'.
+  #
+  # File.insert_bom("input.csv", "output.csv") # => output bommed text to output.csv
+  # File.insert_bom("input.csv") # => output bommed text to input.csv
+  def self.insert_bom(input_filename, output_filename = nil)
+    src = File.read(input_filename)
+    output_filename ||= input_filename
+    File.open(output_filename, 'w:UTF-8') do |f|
+      src = '   ' + src
+      src.setbyte(0, 0xEF)
+      src.setbyte(1, 0xBB)
+      src.setbyte(2, 0xBF)
+      f.print src
+    end
+  end
+end

data/lib/tbpgr_utils/version.rb

@@ -2,5 +2,5 @@
 
 # Tbpgr Utilities
 module TbpgrUtils
-  VERSION = '0.0.27'
+  VERSION = '0.0.28'
 end

data/lib/tbpgr_utils.rb

@@ -4,6 +4,7 @@ require 'tbpgr_utils/version'
 # Tbpgr Utilities
 module TbpgrUtils
   require 'open_classes/array'
+  require 'open_classes/file'
   require 'open_classes/kernel'
   require 'open_classes/module'
   require 'open_classes/object'