quickbooks 0.0.7 → 0.4.0

data/README

@@ -2,7 +2,7 @@
 
 The purpose of this gem is to perform connectivity and communication with Quickbooks, providing the user with access to quickbooks data as everyday ruby objects. This could be understood to be somewhat like an ORM, but it is different in that its models are predefined by the Quickbooks API.
 
-In releases prior to 1.0, some knowledge of the Quickbooks API may be required. In releases beyond 1.0, the Quickbooks API should be fully hidden from your view.
+In releases prior to 0.1.0, some knowledge of the Quickbooks API may be required. In releases beyond 0.1.0, the Quickbooks API should be fully hidden from your view.
 
 Enjoy and PLEASE contribute either by suggestion or by submitting patches, etc. Or if development seems slow, please feel free to join! My work on this project has been solely for my own use of the gem, while opening up its achievements for others to use as well. Development may slow down considerably when I find it is at a stable and usable point for my needs. You've been warned! ;)
 
@@ -13,8 +13,9 @@ Enjoy and PLEASE contribute either by suggestion or by submitting patches, etc.
 
 == Status
 
-This library is a work in progress and has limited capabilities right now. As of version 0.0.5, the Customer model is the only model fleshed out and in working condition, and that even with some bugs. It is stable in the capabilities that are defined, but there are
-some points where the usability needs improvement. I have attempted to make the Quickbooks family of models to work much like DataMapper models, with their finder methods and such.
+This library is a work in progress. This package is separated into two distinct components: Qbxml and Quickbooks (models). The Qbxml represents most of the work of complying to the Quickbooks SDK, and is useful separate from the Quickbooks portion, for use with the QB Web Connector or QB Online Edition (as this gem does not support these connection types yet). For now, The Web Connector is NOT in plans to be supported as it requires additional logic of a different kind in asynchronous network communication.
+
+Furthermore, as of version 0.1.0, the Customer model is the only model fleshed out and in working condition. It is rather stable, but please report any bugs you find. I have attempted to make the Quickbooks family of models to work much like DataMapper models, with their finder methods and such. It may be possible to make this gem into a DataMapper adapter.
 
 == Usage
 
@@ -29,7 +30,9 @@ Without any configuration, you should be able to talk to Quickbooks immediately
   c.last_name = 'Smith'
   c.save
 
-Again, until a later version, you will need to be running Quickbooks on the same computer _and have quickbooks open_ to the company file you need.
+Read further in Qbxml::Request and Qbxml::Response in order to get a better understanding of the kinds of options you can use. The Quickbooks::Base - inherited models also hold a lot of logic that is specific to each data type.
+
+Again, until a later version, you will need to be running Quickbooks on the same computer _and have quickbooks open_ to the company file you need. The first time you run your script, you will need to authorize access to your script when Quickbooks asks you to.
 
 == Authors
   
@@ -41,4 +44,6 @@ This library is released under the terms of the MIT License.
 == Changes
 
 * Initial import of a new rewrite at version 0.0.3
-* 0.0.5 includes support for ordered qbxml attributes, as well as better error-handling and smarter saving.
+* 0.0.5 includes support for ordered qbxml attributes, as well as better error-handling and smarter saving.
+* 0.0.7 includes support for nested finder options, with aliases for easy access. Outdated by bugfixes in the next version.
+* 0.1.0 Bugfixes, a little more docs, and connection is a little more robust.

data/Rakefile

@@ -6,7 +6,7 @@ require 'rake/gempackagetask'
 require 'rake/contrib/rubyforgepublisher'
 
 PKG_NAME = 'quickbooks'
-PKG_VERSION = "0.0.7"
+PKG_VERSION = "0.4.0"
 
 PKG_FILES = FileList[
     "lib/**/*", "rspec/**/*", "[A-Z]*", "Rakefile", "doc/**/*"
@@ -43,7 +43,8 @@ spec = Gem::Specification.new do |s|
   s.description = s.summary = "A module to connect to QuickBooks through the QuickBooks SDK using WIN32OLE (other connection types to come)."
 
   #### Dependencies.
-  s.add_dependency('formattedstring', '>= 0.0.1')
+  s.add_dependency('formattedstring', '>= 0.1.0')
+  s.add_dependency('hash_magic', '>= 0.1.0')
   
   #### Which files are to be included in this gem?  Everything!  (Except CVS directories.)
   s.files = PKG_FILES
@@ -56,7 +57,7 @@ spec = Gem::Specification.new do |s|
   s.extra_rdoc_files = ["README", "LICENSE"]
 
   #### Author and project details.
-  s.author = "Chris Bruce & Daniel Parker"
+  s.author = "Daniel Parker"
   s.email = "gems@behindlogic.com"
   s.homepage = "http://quickbooks.rubyforge.org"
   s.rubyforge_project = 'quickbooks'

data/doc/classes/Array.html

@@ -62,10 +62,6 @@
                 <a href="../files/lib/quickbooks/ruby_magic_rb.html">
                 lib/quickbooks/ruby_magic.rb
                 </a>
-        <br />
-                <a href="../files/lib/quickbooks/structure_rb.html">
-                lib/quickbooks/structure.rb
-                </a>
         <br />
             </td>
         </tr>
@@ -96,33 +92,22 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000037">camelize_values</a>&nbsp;&nbsp;
-      <a href="#M000049">camelize_values</a>&nbsp;&nbsp;
-      <a href="#M000038">camelize_values!</a>&nbsp;&nbsp;
-      <a href="#M000050">camelize_values!</a>&nbsp;&nbsp;
-      <a href="#M000058">expand_slashes</a>&nbsp;&nbsp;
-      <a href="#M000057">expand_slashes!</a>&nbsp;&nbsp;
-      <a href="#M000056">flatten_slashes</a>&nbsp;&nbsp;
-      <a href="#M000055">flatten_slashes!</a>&nbsp;&nbsp;
-      <a href="#M000060">keep_unique!</a>&nbsp;&nbsp;
-      <a href="#M000047">only</a>&nbsp;&nbsp;
-      <a href="#M000041">only</a>&nbsp;&nbsp;
-      <a href="#M000048">only!</a>&nbsp;&nbsp;
-      <a href="#M000042">only!</a>&nbsp;&nbsp;
-      <a href="#M000043">order</a>&nbsp;&nbsp;
-      <a href="#M000051">order</a>&nbsp;&nbsp;
-      <a href="#M000044">order!</a>&nbsp;&nbsp;
-      <a href="#M000052">order!</a>&nbsp;&nbsp;
-      <a href="#M000061">ordered!</a>&nbsp;&nbsp;
-      <a href="#M000062">ordered?</a>&nbsp;&nbsp;
-      <a href="#M000063">ordered_propogated!</a>&nbsp;&nbsp;
-      <a href="#M000054">slashed!</a>&nbsp;&nbsp;
-      <a href="#M000053">slashed?</a>&nbsp;&nbsp;
-      <a href="#M000059">step_into_slash</a>&nbsp;&nbsp;
-      <a href="#M000045">stringify_values</a>&nbsp;&nbsp;
-      <a href="#M000039">stringify_values</a>&nbsp;&nbsp;
-      <a href="#M000040">stringify_values!</a>&nbsp;&nbsp;
-      <a href="#M000046">stringify_values!</a>&nbsp;&nbsp;
+      <a href="#M000026">camelize_values</a>&nbsp;&nbsp;
+      <a href="#M000038">camelize_values</a>&nbsp;&nbsp;
+      <a href="#M000027">camelize_values!</a>&nbsp;&nbsp;
+      <a href="#M000039">camelize_values!</a>&nbsp;&nbsp;
+      <a href="#M000030">only</a>&nbsp;&nbsp;
+      <a href="#M000036">only</a>&nbsp;&nbsp;
+      <a href="#M000031">only!</a>&nbsp;&nbsp;
+      <a href="#M000037">only!</a>&nbsp;&nbsp;
+      <a href="#M000032">order</a>&nbsp;&nbsp;
+      <a href="#M000040">order</a>&nbsp;&nbsp;
+      <a href="#M000033">order!</a>&nbsp;&nbsp;
+      <a href="#M000041">order!</a>&nbsp;&nbsp;
+      <a href="#M000034">stringify_values</a>&nbsp;&nbsp;
+      <a href="#M000028">stringify_values</a>&nbsp;&nbsp;
+      <a href="#M000029">stringify_values!</a>&nbsp;&nbsp;
+      <a href="#M000035">stringify_values!</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -144,26 +129,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000037" class="method-detail">
-        <a name="M000037"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000037.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000037.html');return false;">
-          <span class="method-name">camelize_values</span><span class="method-args">(specials={})</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000049.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000049.html');return false;">
+          <a href="Array.src/M000026.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000026.html');return false;">
           <span class="method-name">camelize_values</span><span class="method-args">(specials={})</span>
           </a>
         </div>
@@ -178,7 +149,7 @@
         <div class="method-heading">
           <a href="Array.src/M000038.html" target="Code" class="method-signature"
             onclick="popupCode('Array.src/M000038.html');return false;">
-          <span class="method-name">camelize_values!</span><span class="method-args">(specials={})</span>
+          <span class="method-name">camelize_values</span><span class="method-args">(specials={})</span>
           </a>
         </div>
       
@@ -186,12 +157,12 @@
         </div>
       </div>
 
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000050.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000050.html');return false;">
+          <a href="Array.src/M000027.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000027.html');return false;">
           <span class="method-name">camelize_values!</span><span class="method-args">(specials={})</span>
           </a>
         </div>
@@ -200,69 +171,13 @@
         </div>
       </div>
 
-      <div id="method-M000058" class="method-detail">
-        <a name="M000058"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000058.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000058.html');return false;">
-          <span class="method-name">expand_slashes</span><span class="method-args">(seed=nil)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000057.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000057.html');return false;">
-          <span class="method-name">expand_slashes!</span><span class="method-args">(seed=nil)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000056.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000056.html');return false;">
-          <span class="method-name">flatten_slashes</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000055.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000055.html');return false;">
-          <span class="method-name">flatten_slashes!</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
+      <div id="method-M000039" class="method-detail">
+        <a name="M000039"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000060.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000060.html');return false;">
-          <span class="method-name">keep_unique!</span><span class="method-args">()</span>
+          <a href="Array.src/M000039.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000039.html');return false;">
+          <span class="method-name">camelize_values!</span><span class="method-args">(specials={})</span>
           </a>
         </div>
       
@@ -270,12 +185,12 @@
         </div>
       </div>
 
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000030" class="method-detail">
+        <a name="M000030"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000047.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000047.html');return false;">
+          <a href="Array.src/M000030.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000030.html');return false;">
           <span class="method-name">only</span><span class="method-args">(*values)</span>
           </a>
         </div>
@@ -284,12 +199,12 @@
         </div>
       </div>
 
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
+      <div id="method-M000036" class="method-detail">
+        <a name="M000036"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000041.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000041.html');return false;">
+          <a href="Array.src/M000036.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000036.html');return false;">
           <span class="method-name">only</span><span class="method-args">(*values)</span>
           </a>
         </div>
@@ -298,12 +213,12 @@
         </div>
       </div>
 
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000031" class="method-detail">
+        <a name="M000031"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000048.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000048.html');return false;">
+          <a href="Array.src/M000031.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000031.html');return false;">
           <span class="method-name">only!</span><span class="method-args">(*values)</span>
           </a>
         </div>
@@ -312,12 +227,12 @@
         </div>
       </div>
 
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
+      <div id="method-M000037" class="method-detail">
+        <a name="M000037"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000042.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000042.html');return false;">
+          <a href="Array.src/M000037.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000037.html');return false;">
           <span class="method-name">only!</span><span class="method-args">(*values)</span>
           </a>
         </div>
@@ -326,12 +241,12 @@
         </div>
       </div>
 
-      <div id="method-M000043" class="method-detail">
-        <a name="M000043"></a>
+      <div id="method-M000032" class="method-detail">
+        <a name="M000032"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000043.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000043.html');return false;">
+          <a href="Array.src/M000032.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000032.html');return false;">
           <span class="method-name">order</span><span class="method-args">(*ordered)</span>
           </a>
         </div>
@@ -340,12 +255,12 @@
         </div>
       </div>
 
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000040" class="method-detail">
+        <a name="M000040"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000051.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000051.html');return false;">
+          <a href="Array.src/M000040.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000040.html');return false;">
           <span class="method-name">order</span><span class="method-args">(*ordered)</span>
           </a>
         </div>
@@ -354,12 +269,12 @@
         </div>
       </div>
 
-      <div id="method-M000044" class="method-detail">
-        <a name="M000044"></a>
+      <div id="method-M000033" class="method-detail">
+        <a name="M000033"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000044.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000044.html');return false;">
+          <a href="Array.src/M000033.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000033.html');return false;">
           <span class="method-name">order!</span><span class="method-args">(*ordered)</span>
           </a>
         </div>
@@ -368,12 +283,12 @@
         </div>
       </div>
 
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000041" class="method-detail">
+        <a name="M000041"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000052.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000052.html');return false;">
+          <a href="Array.src/M000041.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000041.html');return false;">
           <span class="method-name">order!</span><span class="method-args">(*ordered)</span>
           </a>
         </div>
@@ -382,96 +297,12 @@
         </div>
       </div>
 
-      <div id="method-M000061" class="method-detail">
-        <a name="M000061"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000061.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000061.html');return false;">
-          <span class="method-name">ordered!</span><span class="method-args">(*keys_in_order)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000062" class="method-detail">
-        <a name="M000062"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000062.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000062.html');return false;">
-          <span class="method-name">ordered?</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000063.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000063.html');return false;">
-          <span class="method-name">ordered_propogated!</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000054.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000054.html');return false;">
-          <span class="method-name">slashed!</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000053.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000053.html');return false;">
-          <span class="method-name">slashed?</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000059" class="method-detail">
-        <a name="M000059"></a>
+      <div id="method-M000034" class="method-detail">
+        <a name="M000034"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000059.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000059.html');return false;">
-          <span class="method-name">step_into_slash</span><span class="method-args">(key)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
-
-        <div class="method-heading">
-          <a href="Array.src/M000045.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000045.html');return false;">
+          <a href="Array.src/M000034.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000034.html');return false;">
           <span class="method-name">stringify_values</span><span class="method-args">()</span>
           </a>
         </div>
@@ -480,12 +311,12 @@
         </div>
       </div>
 
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000039.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000039.html');return false;">
+          <a href="Array.src/M000028.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000028.html');return false;">
           <span class="method-name">stringify_values</span><span class="method-args">()</span>
           </a>
         </div>
@@ -494,12 +325,12 @@
         </div>
       </div>
 
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
+      <div id="method-M000029" class="method-detail">
+        <a name="M000029"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000040.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000040.html');return false;">
+          <a href="Array.src/M000029.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000029.html');return false;">
           <span class="method-name">stringify_values!</span><span class="method-args">()</span>
           </a>
         </div>
@@ -508,12 +339,12 @@
         </div>
       </div>
 
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
+      <div id="method-M000035" class="method-detail">
+        <a name="M000035"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000046.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000046.html');return false;">
+          <a href="Array.src/M000035.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000035.html');return false;">
           <span class="method-name">stringify_values!</span><span class="method-args">()</span>
           </a>
         </div>