rubyment 0.7.25752271 → 0.7.25752540

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6fba539ff6f78991f287f12e659693ed5a2a1bdd
-  data.tar.gz: 32dcb1fb4062d6de26fd7319bd42b480fc72888f
+  metadata.gz: d6fbbb8b232ca1a58d1440b3310dc2a87a5c6f30
+  data.tar.gz: 459ab366a552afb2fe23f31ecb2e8030842d0002
 SHA512:
-  metadata.gz: a0cbf91c10a8c2b630c457a446d307244fb55d1aeb5ac7592b1a31b26a3cb823a8522150937c465b63368df39806dfb5f86cf62f9b8dffa142eaffa5bb934b5e
-  data.tar.gz: 880fee67876c2d3cf7b982aafe0acc191ac221398a30adb24ff495014f8e2cfb2615d106f5d7a6a16cc04b8ecc77213772b3b46915418da9231f4f5fc51dcae8
+  metadata.gz: f8f6bb176e2bed86d86faa13f7c66755fef1adc4c7b64fc95a854d80b93a2697678289b9126f15b76fab6d762225cb7546b8fd3da1a55d7b57b97eba4ec7f93d
+  data.tar.gz: 8d2795d66b35b4c1f6670d1aedb69dda3ae65757c39f029f03bb7f372d0b72568a03e4040ca8ddda68eed11f55d545bd9a4edefe85383b72038c1807c8f6efda

data/lib/rubyment.rb

@@ -318,6 +318,146 @@ module RubymentStringsModule
   end
 
 
+=begin
+  Makes possible to join, similarly to Array#join, recursively.
+
+  Note of difference in behavior:
+
+  [ "", "" ].join "+"
+  # => "+"
+
+  [ nil, nil ].join "+"
+  # => "+"
+
+  In this function, empty strings are not joinned
+  (.nne and .compact are run before). It's a planned
+  change to expand the interface to be able to
+  instruct for not nne/compact strings/arrays before.
+  TODO: via inheritable joinner; possibly indenter
+
+  Examples:
+
+  string__recursive_join ["+", 1, 2, 3 ]
+  # => "1+2+3"
+
+  string__recursive_join [ "; ",  ["+", 1, 2, 3 ], ["-", 2, 1] ]
+  # => "1+2+3; 2-1"
+
+  string__recursive_join [ "; ",  ["+", 1, ["/", "a", "b"], 3 ], ["-", 2, 1] ]
+  # => "1+a/b+3; 2-1"
+
+
+
+=end
+  def string__recursive_join joinner_arrays_tuple
+    return joinner_arrays_tuple if (
+      joinner_arrays_tuple.respond_to?(:map).negate_me
+    )
+
+    joinner,
+      *operands = joinner_arrays_tuple
+    operands.map! { |operand|
+      (
+        send __method__, operand # recursive call
+      ).nne
+    }
+
+    operands.compact.join(joinner)
+  end
+
+
+=begin
+  If definition cannot map, retuns itself.
+
+  Otherwise, it will generate a string out of the values
+  given in that array, which can describe, for instance,
+  recursive expressions. Better explained by examples:
+
+  Examples:
+
+  string__from_definition [ "value", "var" ]
+  # => "var value"
+
+  string__from_definition [ "value" ]
+  # => "value"
+
+  string__from_definition [ "value", ["var"], "="   ]
+  # => "var=value"
+
+  string__from_definition [ "value", ["var"], ""  ]
+  # => "varvalue"
+
+  string__from_definition [ nil, ["var"], "="   ]
+  # => "var="
+
+  string__from_definition [ "value", ["var", "EXPORT"], "="  ]
+  # => "EXPORT var=value"
+
+  string__from_definition [ ["value"], ["var", "EXPORT"], "="  ]
+  # => "EXPORT var=value"
+
+  string__from_definition ["value", nil, nil, nil, "`", "`"]
+  # => "`value`"
+
+  string__from_definition [    ["value", nil, nil, nil, "`", "`"] , ["var", "EXPORT"], "="  ]
+  # => "EXPORT var=`value`"
+
+  # ----- test the spacer:
+
+  string__from_definition [ "value", ["var"], "=", ","  ]
+  # => "var,=,value"
+
+  string__from_definition [ "value", ["var"], nil, ","  ]
+  # => "var, ,value"
+
+  string__from_definition [ "value", ["var"], "", ","  ]
+  # => "var,value"
+
+  string__from_definition [ " ... describe here ... ", "contents:", "", "\n", "# begin section", "# end section "]
+  # => "# begin section\ncontents:\n ... describe here ... \n# end section "
+
+
+=end
+  def string__from_definition definition
+    return definition if (
+      definition.respond_to?(:map).negate_me
+    )
+
+    value,
+      variable,
+      operation,
+      spacer,
+      open,
+      close,
+      reserved = definition.map { |d|
+      send __method__, d # recursive call
+    }
+
+    # if variable is non empty, the default operation is "="
+    # of course, only applied if operation is not set
+    # A priori, nne not to be used, otherwise "" operation
+    # won't be allowed
+    operation ||= (variable && " " ||  "")
+    spacer = spacer.nne ""
+    variable  = variable.nne ""
+
+    rv = string__recursive_join [
+      spacer,  # separator
+      open,
+      [
+        spacer, # separator
+        variable,
+        operation,
+        value,
+      ],
+      close,
+    ]
+
+    rv
+
+  end
+
+
 end # of RubymentStringsModule
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubyment
 version: !ruby/object:Gem::Version
-  version: 0.7.25752271
+  version: 0.7.25752540
 platform: ruby
 authors:
 - Ribamar Santarosa