jini 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0898b2d8bd7381604c3770d49d61e0f26e0b94297fefb6461853d9f7750917c
-  data.tar.gz: 95a3af28dadfaa4a221180ad178c66a907d233180bb8d7b88d03e2312540368b
+  metadata.gz: 43186103106cc20b20cb012d5c4a086247e7cfee767ef9c38859fba6167cb6c3
+  data.tar.gz: '02442138ba02d71b2b972cba52a0e465d7681ad8454235d7e03571352db5a0e2'
 SHA512:
-  metadata.gz: d7cf187ac21491e8b8635bf11a6cbda968ca60ad869cabc80cfcf5817449b9b85c14de95036f00ba6c8bccc14801ae2e4ce0ccaed33ecf4af46cb7cd2235ba88
-  data.tar.gz: fe7a1c88a7140391ec61b364508efb0fb3e01f5a66e90abd1ec4e66e51f581b2945e64a16a1fd32056cfad88b31189dfd93d17db4959cf9a11ae590b865db567
+  metadata.gz: ba43e479c4127528d445ee02e0331f24efefe519321b542962f07782e009c08dda7fd19246c953d5f1c7879dc82f36781562fe5973520ed001440b3eb23dd3de
+  data.tar.gz: 8ee8c81f0eb1a44123fd9c23cb941808c3e63e19161a31050556123626f9246b38a87fc150bd3a5f5557978b6d7484da68adf1bde1bec2ed73ed5721aa858b6f

data/.yardoc/checksums

@@ -1 +1 @@
-lib/jini.rb 8f60725dde02593fd368b256d6c67e25a7b821bf
+lib/jini.rb bfb9c0382f347ed973480d26501de3fcbb3d6742

data/README.md

@@ -3,7 +3,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/jini.svg)](https://badge.fury.io/rb/jini)
 
-The class [`Jini`](https://www.rubydoc.info/gems/jini/0.1.3/Jini) helps you build a XPATH.
+The class [`Jini`](https://www.rubydoc.info/gems/jini/0.1.4/Jini) helps you build a XPATH.
 
 ```ruby
 require 'jini'
@@ -17,7 +17,7 @@ xpath = Jini
 puts(xpath) # -> xpath: /parent[@key="value"]
 ```
 
-The full list of methods is [here](https://www.rubydoc.info/gems/jini/0.1.3).
+The full list of methods is [here](https://www.rubydoc.info/gems/jini/0.1.4).
 
 Install it:
 
@@ -33,3 +33,7 @@ gem 'jini'
 
 Pay attention, it is not a parser. The only functionality this gem provides
 is _building_ XPATHs.
+
+## New features requests
+If you find an error, or you want to add new functionality, simply create a new `Issue`
+and describe what happened, also try to add/fix something and send pull request.

data/doc/Jini/InvalidPath.html

@@ -125,7 +125,7 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/doc/Jini.html

@@ -114,7 +114,9 @@
 <p>MIT</p>
 </dd></dl>
 
-<p>It’s a simple XPATH builder. &lt;p&gt;&lt;/p&gt; require ‘jini’ xpath = Jini.new(‘parent’)</p>
+<p>It’s a simple XPATH builder. Class is thread safe.</p>
+
+<p>require ‘jini’ xpath = Jini.new(‘parent’)</p>
 
 <pre class="code ruby"><code class="ruby">.add_node(&#39;child&#39;)
 .add_attr(&#39;toy&#39;, &#39;plane&#39;)
@@ -397,7 +399,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#new_attr_value-instance_method" title="#new_attr_value (instance method)">#<strong>new_attr_value</strong>(name, value)  &#x21d2; Jini </a>
+      <a href="#nodes-instance_method" title="#nodes (instance method)">#<strong>nodes</strong>  &#x21d2; Object </a>
     
 
     
@@ -412,7 +414,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Replaces <strong>all</strong> attr <strong>values</strong> by name.</p>
+<p>All nodes in xpath as array.</p>
 </div></span>
   
 </li>
@@ -511,6 +513,30 @@
 <p>Removes property.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#replace_attr_value-instance_method" title="#replace_attr_value (instance method)">#<strong>replace_attr_value</strong>(name, value)  &#x21d2; Jini </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Replaces <strong>all</strong> attr <strong>values</strong> by name.</p>
+</div></span>
+  
 </li>
 
       
@@ -651,12 +677,12 @@
       <pre class="lines">
 
 
-46
 47
-48</pre>
+48
+49</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 46</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 47</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_head'>head</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
   <span class='ivar'>@head</span> <span class='op'>=</span> <span class='id identifier rubyid_head'>head</span>
@@ -753,12 +779,12 @@
       <pre class="lines">
 
 
-111
-112
-113</pre>
+121
+122
+123</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 111</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 121</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_attr'>add_attr</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@head</span><span class='embexpr_end'>}</span><span class='tstring_content'>[@</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_content'>=\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_value'>value</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;]</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -832,12 +858,12 @@
       <pre class="lines">
 
 
-118
-119
-120</pre>
+128
+129
+130</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 118</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 128</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_attrs'>add_attrs</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@head</span><span class='embexpr_end'>}</span><span class='tstring_content'>@</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -927,12 +953,12 @@
       <pre class="lines">
 
 
-64
 65
-66</pre>
+66
+67</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 64</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 65</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_node'>add_node</span><span class='lparen'>(</span><span class='id identifier rubyid_node'>node</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@head</span><span class='embexpr_end'>}</span><span class='tstring_content'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_node'>node</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1006,12 +1032,12 @@
       <pre class="lines">
 
 
-163
-164
-165</pre>
+173
+174
+175</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 163</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 173</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_nodes'>add_nodes</span><span class='lparen'>(</span><span class='id identifier rubyid_node'>node</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@head</span><span class='embexpr_end'>}</span><span class='tstring_content'>//</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_node'>node</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1113,12 +1139,12 @@
       <pre class="lines">
 
 
-94
-95
-96</pre>
+104
+105
+106</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 94</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 104</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_property'>add_property</span><span class='lparen'>(</span><span class='id identifier rubyid_property'>property</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_add_node'>add_node</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_property'>property</span><span class='embexpr_end'>}</span><span class='tstring_content'>()</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rparen'>)</span>
@@ -1190,13 +1216,13 @@
       <pre class="lines">
 
 
-154
-155
-156
-157</pre>
+164
+165
+166
+167</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 154</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 164</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_all'>all</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Jini/InvalidPath.html" title="Jini::InvalidPath (class)">InvalidPath</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>You cannot add all tag after attr!</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>if</span> <span class='ivar'>@head</span><span class='lbracket'>[</span><span class='op'>-</span><span class='int'>1</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_eql?'>eql?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>]</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
@@ -1289,13 +1315,13 @@
       <pre class="lines">
 
 
-172
-173
-174
-175</pre>
+182
+183
+184
+185</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 172</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 182</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_at'>at</span><span class='lparen'>(</span><span class='id identifier rubyid_position'>position</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Jini/InvalidPath.html" title="Jini::InvalidPath (class)">InvalidPath</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Cant use at after selection</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>if</span> <span class='ivar'>@head</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>::</span><span class='tstring_end'>&#39;</span></span>
@@ -1386,12 +1412,12 @@
       <pre class="lines">
 
 
-209
-210
-211</pre>
+219
+220
+221</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 209</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 219</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_gt'>gt</span><span class='lparen'>(</span><span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_action_between'>action_between</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>&gt;</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
@@ -1481,12 +1507,12 @@
       <pre class="lines">
 
 
-200
-201
-202</pre>
+210
+211
+212</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 200</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 210</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_lt'>lt</span><span class='lparen'>(</span><span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_action_between'>action_between</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>&lt;</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
@@ -1497,9 +1523,9 @@
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="new_attr_value-instance_method">
+  <h3 class="signature " id="nodes-instance_method">
   
-    #<strong>new_attr_value</strong>(name, value)  &#x21d2; <tt><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></tt> 
+    #<strong>nodes</strong>  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -1508,62 +1534,26 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Replaces <strong>all</strong> attr <strong>values</strong> by name. Before: ‘[@id=“some value”]’ After: ‘[@id=“new value”]’</p>
+<p>All nodes in xpath as array.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
   
-    <li>
-      
-        <span class='name'>name</span>
-      
-      
-        <span class='type'>(<tt>String</tt>)</span>
-      
-      
-      
-        &mdash;
-        <div class='inline'>
-<p>of attr</p>
-</div>
-      
-    </li>
-  
-    <li>
-      
-        <span class='name'>value</span>
-      
-      
-        <span class='type'>(<tt>String</tt>)</span>
-      
-      
-      
-        &mdash;
-        <div class='inline'>
-<p>upd value</p>
-</div>
-      
-    </li>
-  
-</ul>
-
 <p class="tag_title">Returns:</p>
 <ul class="return">
   
     <li>
       
       
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></tt>)</span>
+        <span class='type'></span>
       
       
       
-        &mdash;
+        
         <div class='inline'>
-<p>with replaced attr value</p>
+<p>nodes as [Array]</p>
 </div>
       
     </li>
@@ -1576,21 +1566,21 @@
       <pre class="lines">
 
 
-143
-144
-145
-146
-147
-148</pre>
+92
+93
+94
+95
+96
+97</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 143</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 92</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_new_attr_value'>new_attr_value</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_n_rxp'>n_rxp</span> <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(\[@?</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>=&quot;[^&quot;]+&quot;(\[\]+|\]))</span><span class='regexp_end'>/</span></span>
-  <span class='id identifier rubyid_attr'>attr</span> <span class='op'>=</span> <span class='ivar'>@head</span><span class='lbracket'>[</span><span class='id identifier rubyid_n_rxp'>n_rxp</span><span class='rbracket'>]</span>
-  <span class='id identifier rubyid_attr'>attr</span><span class='lbracket'>[</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>&quot;(.*?)&quot;</span><span class='regexp_end'>/</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_value'>value</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;</span><span class='tstring_end'>&quot;</span></span>
-  <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='ivar'>@head</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='id identifier rubyid_n_rxp'>n_rxp</span><span class='comma'>,</span> <span class='id identifier rubyid_attr'>attr</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_attr'>attr</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_nodes'>nodes</span>
+  <span class='id identifier rubyid_checked'>checked</span> <span class='op'>=</span> <span class='ivar'>@head</span>
+    <span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>%r{</span><span class='tstring_content'>(//|/)</span><span class='regexp_end'>}</span></span><span class='rparen'>)</span>
+    <span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_method'>method</span><span class='lparen'>(</span><span class='symbol'>:empty_check</span><span class='rparen'>)</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_checked'>checked</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_node'>node</span><span class='op'>|</span> <span class='id identifier rubyid_checked'>checked</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span> <span class='id identifier rubyid_node'>node</span> <span class='kw'>if</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_eql?'>eql?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>//</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='op'>||</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_eql?'>eql?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>/</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_to_a'>to_a</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1677,12 +1667,12 @@
       <pre class="lines">
 
 
-191
-192
-193</pre>
+201
+202
+203</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 191</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 201</span>
 
 <span class='kw'>def</span> <span class='kw'>or</span><span class='lparen'>(</span><span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_action_between'>action_between</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>|</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_alpha'>alpha</span><span class='comma'>,</span> <span class='id identifier rubyid_beta'>beta</span><span class='rparen'>)</span>
@@ -1756,14 +1746,14 @@
       <pre class="lines">
 
 
-129
-130
-131
-132
-133</pre>
+139
+140
+141
+142
+143</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 129</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 139</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_remove_attr'>remove_attr</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span>
@@ -1787,7 +1777,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Removes node by name</p>
+<p>Removes node by name.</p>
 
 
   </div>
@@ -1855,12 +1845,12 @@
       <pre class="lines">
 
 
-72
 73
-74</pre>
+74
+75</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 72</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 73</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_remove_node'>remove_node</span><span class='lparen'>(</span><span class='id identifier rubyid_node'>node</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_purge_head'>purge_head</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_node'>node</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -1950,12 +1940,12 @@
       <pre class="lines">
 
 
-102
-103
-104</pre>
+112
+113
+114</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 102</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 112</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_remove_property'>remove_property</span><span class='lparen'>(</span><span class='id identifier rubyid_property'>property</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='ivar'>@head</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_property'>property</span><span class='embexpr_end'>}</span><span class='tstring_content'>()</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -1963,6 +1953,107 @@
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="replace_attr_value-instance_method">
+  
+    #<strong>replace_attr_value</strong>(name, value)  &#x21d2; <tt><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Replaces <strong>all</strong> attr <strong>values</strong> by name. Before: ‘[@id=“some value”]’ After: ‘[@id=“new value”]’</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>name</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>of attr</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>value</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>upd value</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>with replaced attr value</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+153
+154
+155
+156
+157
+158</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 153</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_replace_attr_value'>replace_attr_value</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_n_rxp'>n_rxp</span> <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(\[@?</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>=&quot;[^&quot;]+&quot;(\[\]+|\]))</span><span class='regexp_end'>/</span></span>
+  <span class='id identifier rubyid_attr'>attr</span> <span class='op'>=</span> <span class='ivar'>@head</span><span class='lbracket'>[</span><span class='id identifier rubyid_n_rxp'>n_rxp</span><span class='rbracket'>]</span>
+  <span class='id identifier rubyid_attr'>attr</span><span class='lbracket'>[</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>&quot;(.*?)&quot;</span><span class='regexp_end'>/</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_value'>value</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;</span><span class='tstring_end'>&quot;</span></span>
+  <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='ivar'>@head</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='id identifier rubyid_n_rxp'>n_rxp</span><span class='comma'>,</span> <span class='id identifier rubyid_attr'>attr</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_attr'>attr</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1977,7 +2068,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>This method replaces <strong>all</strong> origins to new</p>
+<p>This method replaces <strong>all</strong> origins to new.</p>
 
 
   </div>
@@ -2043,17 +2134,17 @@
       <pre class="lines">
 
 
-80
 81
 82
 83
 84
 85
 86
-87</pre>
+87
+88</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 80</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 81</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_replace_node'>replace_node</span><span class='lparen'>(</span><span class='id identifier rubyid_origin'>origin</span><span class='comma'>,</span> <span class='id identifier rubyid_new'>new</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="" title="Jini (class)">Jini</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="#initialize-instance_method" title="Jini#initialize (method)">new</a></span></span><span class='lparen'>(</span>
@@ -2132,13 +2223,13 @@
       <pre class="lines">
 
 
-182
-183
-184
-185</pre>
+192
+193
+194
+195</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 182</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 192</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_selection'>selection</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Jini/InvalidPath.html" title="Jini::InvalidPath (class)">InvalidPath</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Cannot select, path contains bad symbols</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_bad_symbols?'>bad_symbols?</span> <span class='ivar'>@head</span>
@@ -2227,14 +2318,14 @@
       <pre class="lines">
 
 
-54
 55
 56
 57
-58</pre>
+58
+59</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 54</span>
+      <pre class="code"><span class="info file"># File 'lib/jini.rb', line 55</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span>
   <span class='id identifier rubyid_copy'>copy</span> <span class='op'>=</span> <span class='ivar'>@head</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>%r{</span><span class='tstring_content'>//|/</span><span class='regexp_end'>}</span></span><span class='rparen'>)</span>
@@ -2251,7 +2342,7 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/doc/_index.html

@@ -112,7 +112,7 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/doc/file.README.html

@@ -62,7 +62,7 @@
 
 <p><a href="https://badge.fury.io/rb/jini"><img src="https://badge.fury.io/rb/jini.svg" alt="Gem Version" /></a></p>
 
-<p>The class <a href="https://www.rubydoc.info/gems/jini/0.1.3/Jini"><code>Jini</code></a> helps you build a XPATH.</p>
+<p>The class <a href="https://www.rubydoc.info/gems/jini/0.1.4/Jini"><code>Jini</code></a> helps you build a XPATH.</p>
 
 <p><code>ruby
 require 'jini'
@@ -76,7 +76,7 @@ xpath = Jini
 puts(xpath) # -&gt; xpath: /parent[@key="value"]
 </code></p>
 
-<p>The full list of methods is <a href="https://www.rubydoc.info/gems/jini/0.1.3">here</a>.</p>
+<p>The full list of methods is <a href="https://www.rubydoc.info/gems/jini/0.1.4">here</a>.</p>
 
 <p>Install it:</p>
 
@@ -92,10 +92,14 @@ gem 'jini'
 
 <p>Pay attention, it is not a parser. The only functionality this gem provides
 is <em>building</em> XPATHs.</p>
+
+<h2 id="new-features-requests">New features requests</h2>
+<p>If you find an error, or you want to add new functionality, simply create a new <code>Issue</code>
+and describe what happened, also try to add/fix something and send pull request.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/doc/index.html

@@ -62,7 +62,7 @@
 
 <p><a href="https://badge.fury.io/rb/jini"><img src="https://badge.fury.io/rb/jini.svg" alt="Gem Version" /></a></p>
 
-<p>The class <a href="https://www.rubydoc.info/gems/jini/0.1.3/Jini"><code>Jini</code></a> helps you build a XPATH.</p>
+<p>The class <a href="https://www.rubydoc.info/gems/jini/0.1.4/Jini"><code>Jini</code></a> helps you build a XPATH.</p>
 
 <p><code>ruby
 require 'jini'
@@ -76,7 +76,7 @@ xpath = Jini
 puts(xpath) # -&gt; xpath: /parent[@key="value"]
 </code></p>
 
-<p>The full list of methods is <a href="https://www.rubydoc.info/gems/jini/0.1.3">here</a>.</p>
+<p>The full list of methods is <a href="https://www.rubydoc.info/gems/jini/0.1.4">here</a>.</p>
 
 <p>Install it:</p>
 
@@ -92,10 +92,14 @@ gem 'jini'
 
 <p>Pay attention, it is not a parser. The only functionality this gem provides
 is <em>building</em> XPATHs.</p>
+
+<h2 id="new-features-requests">New features requests</h2>
+<p>If you find an error, or you want to add new functionality, simply create a new <code>Issue</code>
+and describe what happened, also try to add/fix something and send pull request.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/doc/method_list.html

@@ -126,7 +126,7 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="Jini.html#new_attr_value-instance_method" title="Jini#new_attr_value (method)">#new_attr_value</a></span>
+      <span class='object_link'><a href="Jini.html#nodes-instance_method" title="Jini#nodes (method)">#nodes</a></span>
       <small>Jini</small>
     </div>
   </li>
@@ -166,7 +166,7 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="Jini.html#replace_node-instance_method" title="Jini#replace_node (method)">#replace_node</a></span>
+      <span class='object_link'><a href="Jini.html#replace_attr_value-instance_method" title="Jini#replace_attr_value (method)">#replace_attr_value</a></span>
       <small>Jini</small>
     </div>
   </li>
@@ -174,13 +174,21 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="Jini.html#selection-instance_method" title="Jini#selection (method)">#selection</a></span>
+      <span class='object_link'><a href="Jini.html#replace_node-instance_method" title="Jini#replace_node (method)">#replace_node</a></span>
       <small>Jini</small>
     </div>
   </li>
   
 
   <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Jini.html#selection-instance_method" title="Jini#selection (method)">#selection</a></span>
+      <small>Jini</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Jini.html#to_s-instance_method" title="Jini#to_s (method)">#to_s</a></span>
       <small>Jini</small>

data/doc/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Sep 21 12:26:11 2022 by
+  Generated on Wed Oct 19 16:07:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-3.0.0).
 </div>

data/jini.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=2.6.8'
   s.name = 'jini'
-  s.version = '0.1.4'
+  s.version = '0.1.5'
   s.license = 'MIT'
   s.summary = 'Simple Immutable Ruby XPATH Builder'
   s.description = 'Class Jini helps you build a XPATH and then modify its parts via a simple fluent interface.'

data/lib/jini.rb

@@ -28,7 +28,8 @@
 # License:: MIT
 #
 # It's a simple XPATH builder.
-# <p></p>
+# Class is thread safe.
+#
 # require 'jini'
 # xpath = Jini.new('parent')
 #   .add_node('child')
@@ -65,7 +66,7 @@ class Jini
     Jini.new("#{@head}/#{node}")
   end
 
-  # Removes node by name
+  # Removes node by name.
   # @param node [String] the node for removal
   # @return [Jini] without a node
   # @since 0.0.7
@@ -73,7 +74,7 @@ class Jini
     Jini.new(purge_head("/#{node}"))
   end
 
-  # This method replaces *all* origins to new
+  # This method replaces *all* origins to new.
   # @param origin [String] origin node
   # @param new [String] new one
   # @since 0.1.0
@@ -86,6 +87,15 @@ class Jini
     )
   end
 
+  # All nodes in xpath as array.
+  # @return nodes as [Array]
+  def nodes
+    checked = @head
+      .split(%r{(//|/)})
+      .each(&method(:empty_check))
+    checked.each { |node| checked.delete node if node.eql?('//') || node.eql?('/') }.to_a
+  end
+
   # Addition property in tail.
   # @example before: '../child', after: '../child/property()'
   # @param property [String] to add
@@ -140,7 +150,7 @@ class Jini
   # @param name [String] of attr
   # @param value [String] upd value
   # @return [Jini] with replaced attr value
-  def new_attr_value(name, value)
+  def replace_attr_value(name, value)
     n_rxp = /(\[@?#{name}="[^"]+"(\[\]+|\]))/
     attr = @head[n_rxp]
     attr[/"(.*?)"/] = "\"#{value}\""
@@ -212,19 +222,24 @@ class Jini
 
   private
 
+  # @param node [String] node for check
+  def empty_check(node)
+    raise InvalidPath, 'Invalid path, empty node' if node.length.eql? 0
+  end
+
   # @param node [String] node for check
   def space_check(node)
     raise InvalidPath, "Nodes can't contain spaces: #{node} – contain space." if valid? node
   end
 
-  # regex: '[' or ']' or '@' or '//'
+  # Regex: '[' or ']' or '@' or '//'.
   # @param node [String]
   # @return [Boolean] matching regex
   def bad_symbols?(node)
     !!node.match(%r{[|]|@|//}) unless node.nil?
   end
 
-  # regex: '[' or ']' or '@' or '=' or '<' or '>'
+  # Regex: '[' or ']' or '@' or '=' or '<' or '>'.
   # @param node [String] node for check
   # @return [Boolean] matching regex
   def valid?(node)

data/test/jini_test.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2022-2022 Ivanchuk Ivan
+# Copyright (c) 2022 Ivanchuk Ivan
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -262,13 +262,13 @@ class JiniTest < Minitest::Test
     )
   end
 
-  def test_replace_attr
+  def test_replace_attr_value
     assert_equal(
       'parent/child[@toy="car"]',
       Jini.new(PARENT)
           .add_node(CHILD)
           .add_attr('toy', 'plane')
-          .new_attr_value('toy', 'car')
+          .replace_attr_value('toy', 'car')
           .to_s
     )
   end
@@ -283,4 +283,42 @@ class JiniTest < Minitest::Test
           .to_s
     )
   end
+
+  def test_nodes
+    assert_equal(
+      [].append(
+        'parent',
+        'child[@key="value"]',
+        'under_attr',
+        'many[3]'
+      ),
+      Jini.new(PARENT)
+          .add_node(CHILD)
+          .add_attr('key', 'value')
+          .add_node('under_attr')
+          .add_nodes('many')
+          .at(3)
+          .nodes
+    )
+  end
+
+  def test_nodes_ctor
+    assert_equal(
+      [].append(
+        'parent',
+        'child[@key="value"]',
+        'under_attr',
+        'many[3]'
+      ),
+      Jini.new('parent/child[@key="value"]/under_attr//many[3]').nodes
+    )
+  end
+
+  def test_nodes_raises_invalid_path
+    assert_raises(Jini::InvalidPath) do
+      Jini.new("#{PARENT}//")
+          .add_nodes(CHILD)
+          .nodes
+    end
+  end
 end

data/test/test_helper.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2022-2022 Ivan Ivanchuk
+# Copyright (c) 2022 Ivan Ivanchuk
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jini
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Ivan Ivanchuck
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-21 00:00:00.000000000 Z
+date: 2022-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest