rubyment 0.7.25694818 → 0.7.25733511

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c51f1823c3c4dd62e754966ce5baba5868f7b3c7
-  data.tar.gz: 794b738048de52bb190202abbc345fc100776bcd
+  metadata.gz: 0b710e93d0b0389965a9b49b720148c6e365463a
+  data.tar.gz: b212104266d18535aaf66e800ea3360017876310
 SHA512:
-  metadata.gz: 6c80bd4af0c3c223842b6d4547947e0a53008168f3df7ca1b23ce1a7baeb885f0730644a141802cc68ba393c2e09231dc5046bb96e3759f76b7841c6853c3df4
-  data.tar.gz: f9617cb107118fc79358e01663e2e63db692e21920380dffa8f55c680f7dc58289884d27c2d068b8440fe92089431785ac0b6b363be7ae1fb286f557d445ae29
+  metadata.gz: 6509d00070397420335d4e9e36e99b8a90dc66d9db658e658d8ad947991a47df6843759114fe122ec17f33e7cc20639942640d76475f75a0cfba9f1705aba9a4
+  data.tar.gz: 9c7ebeeb1255a241d461c200b51227f9d158cc777a6eede7595d3f0e03b1047374381a4cda9f44f3b4591da611ad3d05e1218ec6ca97feabc69f56ebd0b3a177

data/lib/rubyment.rb

@@ -95,6 +95,70 @@ class Object
 end
 
 
+=begin
+  # begin_documentation
+
+  This module offers function to generate ruby code
+
+  # end_documentation
+=end
+module RubymentRubyCodeGenerationModule
+
+
+=begin
+if you use vim or a similar  editor, you can use such a function as:
+:read !./rubyment.rb invoke_double puts code_ruby_comment_multiline_empty
+=end
+  def code_ruby_comment_multiline_empty
+    code =<<-ENDHEREDOC
+=begin
+=end
+    ENDHEREDOC
+    [code]
+
+  end
+
+
+=begin
+if you use vim or a similar  editor, you can use such a function as:
+:read !./rubyment.rb invoke_double puts code_ruby_module_newmodule_empty
+=end
+  def code_ruby_module_newmodule_empty
+    code =<<-ENDHEREDOC
+=begin
+  # begin_documentation
+
+  # end_documentation
+=end
+module NewModule
+
+
+end # of NewModule
+
+
+    ENDHEREDOC
+    [code]
+
+  end
+
+
+end
+
+
+=begin 
+  # begin_documentation
+  This module offers function to generate computer languages code
+  # end_documentation
+=end
+module RubymentCodeGenerationModule
+
+
+  include RubymentRubyCodeGenerationModule
+
+
+end
+
+
 =begin
   # begin_documentation
 
@@ -201,12 +265,91 @@ module RubymentStringsModule
 end
 
 
+=begin 
+  # begin_documentation
+
+   This module offers functions to manipulate
+   Arrays.
+
+  # end_documentation
+=end
+module RubymentArraysModule
+
+
+=begin
+  zip will finish with the dimension of
+  the first array. It may sound like a feature,
+  I guess it is that way because it was the easiest
+  thing to implement. This one does the harder thing:
+  zip arrays: the generated array will have the
+  longest needed dimension.
+
+  The transpose method of Array suffers from the
+  same problem (indeed a bigger one, because it will
+  completely refuse to tranpose arrays with different
+  dimensions, while it could fill them with nil for us),
+  and, again, this function is the solution.
+
+  returns an #arrays__ definition, which is an array of array
+  having a transposition of arrays, which can be interpreted
+  as a zip of those arrays.
+
+  examples:
+
+  # this case is the same as [1, 2, 3].zip [4, 5]
+  arrays__zip [1, 2, 3], [4, 5]
+  # => [[1, 4], [2, 5], [3, nil]]
+
+  # this case is not the same as [1, 2].zip [3, 4, 5]
+  arrays__zip [1, 2], [3, 4, 5]
+  # => [[1, 3], [2, 4], [nil, 5]]
+
+
+=end
+  def arrays__zip *arrays
+    dimension = arrays.map(&:size).max - 1
+    (0..dimension).map { |i|
+      arrays.map { |a| a[i] }
+    }
+  end
+
+
+=begin
+
+  merge a list of arrays (like applying || on
+  each column of the matrix that arrays forms).
+
+  examples:
+  array__merge_shallow [1, false ], [false, 2, 3]
+  # => [1, 2, 3]
+
+=end
+  def array__merge_shallow *arrays
+
+    arrays__zip(*arrays).map { |a|
+      a.reduce "nne"
+    }
+
+  end
+
+
+end # of RubymentArraysModule
+
+
 =begin
   # begin_documentation
+
+  CLOSED for extensions: The module InternalRubymentModule
+  should have been called RubymentInternalModule instead,
+  to preserve the naming standards. RubymentInternalModule
+  will receive the new functions, and
+  InternalRubymentModule must be closed for extensions.
+
   This module offers function to interface with certain
   internal structures. Ie, these functions are supposed
   to be useless unless running Rubyment.
 
+
   # end_documentation
 =end
 module InternalRubymentModule
@@ -260,6 +403,9 @@ module InternalRubymentModule
 
 =end
   def autoreload wtime=1
+    (
+      sleep wtime
+    ) while rubyment_memory__get_key :file_reloading
     rubyment_memory__set_key :file_reloading, true
     load rubyment_memory__get_key :filepath
     rubyment_memory__set_key :file_reloading, false
@@ -269,8 +415,43 @@ module InternalRubymentModule
 end
 
 
+=begin 
+  # begin_documentation
+  This module offers function to interface with certain
+  internal structures. Ie, these functions are supposed
+  to be useless unless running Rubyment.
+
+  The module InternalRubymentModule
+  should have been called RubymentInternalModule instead,
+  to preserve the naming standards. RubymentInternalModule
+  will receive the new functions, and
+  InternalRubymentModule must be closed for extensions.
+
+  # end_documentation
+=end
+module RubymentInternalModule
+
+
+  include InternalRubymentModule
+
+
+end # of InternalRubymentModule
+
+
 =begin
   # begin_documentation
+
+  CLOSED for extensions:
+  The module:
+  ModifierForClassObjectModule
+  should have been called:
+  RubymentModifierForClassObjectModule
+  instead, to preserve the naming standards.
+  RubymentModifierForClassObjectModule
+  will receive the new functions, and
+  ModifierForClassObjectModule
+  must be closed for extensions.
+
   Object will be changed just by including
   this file or requiring rubyment, which is not the
   best approach, but kept to respect the open/closed
@@ -305,6 +486,41 @@ module ModifierForClassObjectModule
 end
 
 
+=begin 
+  # begin_documentation
+
+  The module:
+  ModifierForClassObjectModule
+  should have been called:
+  RubymentModifierForClassObjectModule
+  instead, to preserve the naming standards.
+  RubymentModifierForClassObjectModule
+  will receive the new functions, and
+  ModifierForClassObjectModule
+  must be closed for extensions.
+
+  Object will be changed just by including
+  this file or requiring rubyment, which is not the
+  best approach, but kept to respect the open/closed
+  principle, the Object class is kept adding some
+  methods.
+
+  However, the best approach is to add new functions
+  to this module, which will only be used to modify
+  the Object class if the RubymentModule is included.
+
+
+  # end_documentation
+=end
+module RubymentModifierForClassObjectModule
+
+
+  include ModifierForClassObjectModule
+
+
+end
+
+
 =begin
   # begin_documentation
   This module receives functions that are being worked on.
@@ -3219,6 +3435,10 @@ end
   - gem package generation and submission.
   - tree parsing.
   - graph visitor.
+  - some advanced patterns, like reloading the implementation of
+  this module from a file without stopping the process (#autoreload).
+  - some function to redesign part of Ruby API arguably misdesigned,
+  like #arrays__zip
 
 
   Rubyment functions must respect the open/closed principle
@@ -3245,12 +3465,18 @@ end
 
   # end_documentation
 =end
+
+module RubymentDevelopmentModule # must NOT be in master TODO
+end
+
 module RubymentModule
 
-  Object.class_eval { include ModifierForClassObjectModule }
+  Object.class_eval { include RubymentModifierForClassObjectModule }
+  include RubymentCodeGenerationModule
   include RubymentHTMLModule
   include RubymentStringsModule
-  include InternalRubymentModule
+  include RubymentArraysModule
+  include RubymentInternalModule
   include RubymentExperimentModule
   include RubymentMaintainedModule
   include RubymentDeprecatedModule

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubyment
 version: !ruby/object:Gem::Version
-  version: 0.7.25694818
+  version: 0.7.25733511
 platform: ruby
 authors:
 - Ribamar Santarosa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-08 00:00:00.000000000 Z
+date: 2018-12-05 00:00:00.000000000 Z
 dependencies: []
 description: a gem for keeping Rubyment, a set of ruby helpers
 email: ribamar@gmail.com