ns_connector 0.0.11 → 0.0.12

data/README.rdoc

@@ -21,7 +21,6 @@ Avaliable at {rubydoc.info}[http://rubydoc.info/gems/ns_connector/0.0.10]
 * Read write for supported types
 * Flexible searching
 * Multithreaded chunked searching for retrieving large datasets
-* ActiveRecord (vaguely) alike interface
 * Read only sublist support.
 * SubList item creation on creating new records only. (>= v0.0.7)
 * Attaching and detaching records 
@@ -114,20 +113,20 @@ Example:
 
 SubLists can be added to a record on creation. Here is how that works:
 
-	include NSConnector
-	c = Contact.new(:firstname => 'name')
-	c.sublists
-	=> {:addressbook=>
-	  [:addr1,
-	  ...
-
-	c.addressbook << c.new_addressbook_item({
-		:addr1 => 'address line 1',
-		:city => 'unicorn valley'
-	})
+  include NSConnector
+  c = Contact.new(:firstname => 'name')
+  c.sublists
+  => {:addressbook=>
+    [:addr1,
+    ...
+
+  c.addressbook << c.new_addressbook_item({
+    :addr1 => 'address line 1',
+    :city => 'unicorn valley'
+  })
 
-	c.save!
-	=> true
+  c.save!
+  => true
 
 === Reading
 You can find by any field or by internalId.
@@ -143,6 +142,10 @@ Example:
   Contact.find(12)
   => <#NSConnector::Contact:12>
 
+  # Fetch one Customer by entityid
+  Customer.find_by('entityid', 1234)
+  => <#NSConnector::Contact:12>
+
   # Fetch all Contacts, this will take a while. (Request will be broken
   # up into smaller ones and spread across multiple threads).
   Contact.all
@@ -205,6 +208,14 @@ e.g.
   "allowemptycards"=>nil,
   "applied"=>"99.99" ...
 
+== Attaching records
+You can attach/detach records with #attach! and #detach!, it's pretty simple.
+
+  # Attach customer 123 to contacts 1, 2 and 3 with the role of 1
+  Customer.find(123).attach!(Contact, [1,2,3], :role => 1)
+
+  # Or anonymously like:
+  Customer.attach!(Contact, 123, [1,2,3], :role => 1)
   
 === Troubleshooting note:
 Should you run into an error something like:

data/VERSION

@@ -1 +1 @@
-0.0.11
+0.0.12

data/lib/ns_connector/errors.rb

@@ -6,20 +6,20 @@ module NSConnector::Errors
 	# Parent class to encapsulate all successfully parsed JSON netsuite
 	# error responses. 
 	class NSError < Exception
-		def initialize netsuite_error
-			@netsuite_error = netsuite_error
+		def initialize netsuite_error=nil
+			@netsuite_error = netsuite_error if netsuite_error
 		end
 
 		# Returns the error code from the JSON returned by netsuite.
 		# Something like: "RCRD_DSNT_EXIST"
 		def code
-			@netsuite_error['code']
+			@netsuite_error['code'] rescue nil
 		end
 
 		# Takes the error message straight out of the netsuite
 		# response. Usually makes some sense.
 		def message
-			@netsuite_error['message']
+			@netsuite_error['message'] rescue nil
 		end
 	end
 

data/lib/ns_connector/resource.rb

@@ -197,6 +197,18 @@ class NSConnector::Resource
 			)
 		end
 
+		# Return a single resource, by searching for the given field.
+		# Returns:: A single record
+		# Raises:: NSConnector::Errors::NotFound when nothing found
+		def find_by(field, value)
+			results = search_by(field, value)
+			unless results.empty? then
+				return results.first
+			else
+				raise NSConnector::Errors::NotFound
+			end
+		end
+
 		# Retrieve all records, will most likely become a chunked
 		# search due to size
 		def all

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ns_connector
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-01 00:00:00.000000000 Z
+date: 2013-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -210,7 +210,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1654202155437551994
+      hash: -1969978753903346248
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: