bodhi-slam 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 76c3a5ab9e27e73badc35dd7da2a78374025b7c5
-  data.tar.gz: d714537140fe349bd7d5fea95440c7642a50bb00
+  metadata.gz: 4c3c82642a103662a2881ac8e07c236853d2e812
+  data.tar.gz: ac2ebf8f9226eb5395ace0a7a8d4da99a3159b24
 SHA512:
-  metadata.gz: fa60f89fd153e8469bc28d798ed45c04a4be982f3e36d51dc59d43c8052138eae7c1b434ea472970dcbd4632aba869957eed9f2c1e39b6e169901ce8edec8b4f
-  data.tar.gz: ba8b64e7a9c6fea5ea43de3dfd5e6314f075a6f549b3785bc9ba52f0a15b22d23a4548495d282ea55272a259cafd11b4095ac9967887062b5b61ee13f0e9f70e
+  metadata.gz: fcccae214b0272c9fed879dc74e49980521db7f8bc27fb5cda37350b63c795f40c852902b59c95e64788ab8edf8d8d97c8f7c1e95eb144d88857e75c83a0c472
+  data.tar.gz: 799f5e418a7ce569b70543002dd9dcbccc897c6658f088f2fc2622e530e75b2d708b6262445747fe37c1ba0d5393f8f04ad96ff1675b4f0acd40c12f4a1fe5bd

data/lib/bodhi-slam/enumerations.rb

@@ -23,7 +23,11 @@ module Bodhi
         end
       end
     end
-    
+
+    # Gets all Bodhi::Enumerations from a given +context+
+    # and adds them to the Bodhi::Enumeration cache
+    #
+    #   Bodhi::Enumeration.find_all(context) # => [#<Bodhi::Enumeration:0x007fbff403e808>, #<Bodhi::Enumeration:0x007fbff403e808>, ...]
     def self.find_all(context)
       raise context.errors unless context.valid?
       
@@ -42,6 +46,9 @@ module Bodhi
       JSON.parse(result.body).collect{ |enum| Bodhi::Enumeration.new(enum) }
     end
 
+    # Returns a Hash of all Bodhi::Enumerations in the cache
+    # 
+    #   Bodhi::Enumerations.cache # => [#<Bodhi::Enumeration:0x007fbff403e808>, #<Bodhi::Enumeration:0x007fbff403e808>, ...]
     def self.cache
       @cache ||= Hash.new
     end

data/lib/bodhi-slam/errors/api.rb

@@ -0,0 +1,10 @@
+module Bodhi
+  class ApiErrors < StandardError
+    attr_reader :body, :status
+
+    def initialize(params={})
+      @body = params[:body]
+      @status = params[:status]
+    end
+  end
+end

data/lib/bodhi-slam/errors/context.rb

@@ -0,0 +1,4 @@
+module Bodhi
+  class ContextErrors < Bodhi::Errors
+  end
+end

data/lib/bodhi-slam/errors.rb

@@ -1,5 +1,5 @@
 module Bodhi
-  class Errors < Exception
+  class Errors < StandardError
     include Enumerable
     attr_accessor :messages
     
@@ -9,22 +9,27 @@ module Bodhi
     
     # Adds the given +message+ to the errors hash under the +name+ key
     #
-    # user.errors.add(:test, "has bad value")
-    # user.errors.any?  # => true
+    #   user.errors.add(:test, "has bad value")
+    #   user.errors.any?  # => true
     def add(name, message)
       @messages.has_key?(name) ? @messages[name].push(message) : @messages[name] = [message]
     end
     
-    # Clears all error messages
+    # Clears all current error messages
     #
-    # user.errors.add(:name, "is wrong")
-    # user.errors.clear # => nil
-    # user.errors.any?  # => false
+    #   user.errors.add(:name, "is wrong")
+    #   user.errors.any?  # => true
+    #   user.errors.clear # => nil
+    #   user.errors.any?  # => false
     def clear
       @messages.clear
     end
     
     # Returns an array of all error messages
+    # 
+    #   user.errors.add(:name, "is wrong")
+    #   user.errors.add(:address, "is not valid")
+    #   user.errors.full_messages # => ["name is wrong", "address is not valid"]
     def full_messages
       results = []
       @messages.each{ |key, values| values.each{ |value| results.push("#{key} #{value}") }}
@@ -41,16 +46,16 @@ module Bodhi
     # Yields the attribute and the error for that attribute. If the attribute
     # has more than one error message, yields once for each error message.
     # 
-    # user.errors.add(:test, "is required")
-    # user.errors.each do |attribute, error|
-    #   # yields :test and "is required"
-    # end
+    #   user.errors.add(:test, "is required")
+    #   user.errors.each do |attribute, error|
+    #     # yields :test and "is required"
+    #   end
     # 
-    # user.errors.add(:foo, "is awesome!")
-    # user.errors.each do |attribute, error|
-    #   # yields :test and "is required"
-    #   # then yields :foo and "is awesome!"
-    # end
+    #   user.errors.add(:foo, "is awesome!")
+    #   user.errors.each do |attribute, error|
+    #     # yields :test and "is required"
+    #     # then yields :foo and "is awesome!"
+    #   end
     def each
       @messages.each_key do |attribute|
         @messages[attribute].each{ |error| yield attribute, error }
@@ -82,6 +87,7 @@ module Bodhi
     #
     #   user.errors.add(:name, "is required")
     #   user.errors.size # => 1
+    #   
     #   user.errors.add(:name, "can not be blank")
     #   user.errors.size # => 2
     def size
@@ -91,11 +97,13 @@ module Bodhi
     
     # Returns +true+ if no errors are present, +false+ otherwise.
     #
-    # user.errors.add(:name, "test error")
-    # user.errors.empty?  # => false
+    #   user.errors.add(:name, "test error")
+    #   user.errors.empty?  # => false
     def empty?
       size == 0
     end
     alias :blank? :empty?
   end
-end
+end
+
+Dir[File.dirname(__FILE__) + "/errors/*.rb"].each { |file| require file }

data/lib/bodhi-slam/factory.rb

@@ -8,6 +8,11 @@ module Bodhi
       @generators = Hash.new
     end
 
+    # Returns a new randomly generated resource.
+    # Accepts an options hash to override specified values.
+    # 
+    #   Resource.factory.build # => #<Resource:0x007fbff403e808 @name="2-3lmwp^oef@245">
+    #   Resource.factory.build(name: "test") # => #<Resource:0x007fbff403e808 @name="test">
     def build(*args)
       if args.last.is_a?(Hash)
         params = args.last.reduce({}) do |memo, (k, v)| 
@@ -28,13 +33,23 @@ module Bodhi
       object
     end
 
+    # Returns an array of randomly generated resources
+    # 
+    #   Resource.factory.build_list(10) # => [#<Resource:0x007fbff403e808 @name="2-3lmwp^oef@245">, #<Resource:0x007fbff403e808 @name="p7:n#$903<u1">, ...]
+    #   Resource.factory.build_list(10, name: "test") # => [#<Resource:0x007fbff403e808 @name="test">, #<Resource:0x007fbff403e808 @name="test">, ...]
     def build_list(size, *args)
       size.times.collect{ build(*args) }
     end
 
+    # Builds and saves a new resource to the given +context+
+    # Accepts an options hash to override specified values.
+    # 
+    #   context = Bodhi::Context.new
+    #   Resource.factory.create(context) # => #<Resource:0x007fbff403e808 @name="2-3lmwp^oef@245">
+    #   Resource.factory.create(context, name: "test") # => #<Resource:0x007fbff403e808 @name="test">
     def create(context, params={})
       if context.invalid?
-        raise context.errors
+        raise context.errors, context.errors.to_a.to_s
       end
 
       object = build(params)
@@ -43,9 +58,14 @@ module Bodhi
       object
     end
 
+    # Builds and saves a list of resources to the given +context+
+    # Accepts an options hash to override specified values.
+    # 
+    #   Resource.factory.create_list(10, context) # => [#<Resource:0x007fbff403e808 @name="2-3lmwp^oef@245">, #<Resource:0x007fbff403e808 @name="p7:n#$903<u1">, ...]
+    #   Resource.factory.create_list(10, context, name: "test") # => [#<Resource:0x007fbff403e808 @name="test">, #<Resource:0x007fbff403e808 @name="test">, ...]
     def create_list(size, context, params={})
       if context.invalid?
-        raise context.errors
+        raise context.errors, context.errors.to_a.to_s
       end
 
       resources = build_list(size, params)
@@ -59,10 +79,7 @@ module Bodhi
       #puts "\033[33mResult Body\033[0m: \033[36m#{result.body}\033[0m"
 
       if result.status != 200
-        errors = JSON.parse result.body
-        errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-        errors["status"] = result.status if errors.is_a? Hash
-        raise errors.to_s
+        raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
       end
 
       #puts "\033[33mRecords\033[0m: \033[36m#{records.map(&:attributes)}\033[0m"
@@ -70,6 +87,10 @@ module Bodhi
       resources
     end
 
+    # Adds a new generator to the class with the specified +name+ and +options+
+    # 
+    #   Resource.factory.add_generator("name", type: "String")
+    #   Resource.factory.add_generator("test", type: "Integer", multi: true, required: true)
     def add_generator(name, options)
       case options[:type]
       when "String"
@@ -132,6 +153,13 @@ module Bodhi
           generator = lambda { {SecureRandom.hex => SecureRandom.hex} }
         end
 
+      when "Link"
+        if options[:multi]
+          generator = lambda { [*0..5].sample.times.collect{ Hash.new } }
+        else
+          generator = lambda { Hash.new }
+        end
+
       when "Enumerated"
         generator = lambda do
           ref = options[:ref].split('.')

data/lib/bodhi-slam/resource.rb

@@ -7,8 +7,40 @@ module Bodhi
     module ClassMethods
       def factory; @factory; end
 
+      # Saves a batch of resources to the Bodhi Cloud in the given +context+
+      # Returns an array of JSON objects describing the results for each record in the batch
+      # 
+      #   context = Bodhi::Context.new
+      #   list = Resource.factory.build_list(10)
+      #   Resource.save_batch(context, list)
+      def save_batch(context, objects)
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
+
+        result = context.connection.post do |request|
+          request.url "/#{context.namespace}/resources/#{name}"
+          request.headers['Content-Type'] = 'application/json'
+          request.headers[context.credentials_header] = context.credentials
+          request.body = objects.to_json
+        end
+
+        if result.status != 200
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
+        end
+
+        objects
+      end
+
+      # Returns a single resource from the Bodhi Cloud that matches the given +id+
+      # 
+      #   context = Bodhi::Context.new
+      #   id = Resource.factory.create(context).sys_id
+      #   obj = Resource.find(context, id)
       def find(context, id)
-        raise context.errors unless context.valid?
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
 
         unless id.is_a? String
           raise ArgumentError.new("Expected 'id' to be a String. 'id' #=> #{id.class}")
@@ -20,18 +52,22 @@ module Bodhi
         end
 
         if result.status != 200
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
 
         resource_attributes = JSON.parse(result.body)
         factory.build(context, resource_attributes)
       end
 
+      # Returns all records of the given resource from the Bodhi Cloud.
+      # 
+      #   context = Bodhi::Context.new
+      #   Resource.find_all(context) # => [#<Resource:0x007fbff403e808>, #<Resource:0x007fbff403e808>, ...]
       def find_all(context)
-        raise context.errors unless context.valid?
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
+
         page = 1
         records = []
 
@@ -42,10 +78,7 @@ module Bodhi
           end
 
           if result.status != 200
-            errors = JSON.parse result.body
-            errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-            errors["status"] = result.status if errors.is_a? Hash
-            raise errors.to_s
+            raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
           end
 
           page += 1
@@ -55,8 +88,14 @@ module Bodhi
         records.flatten.collect{ |record| factory.build(record) }
       end
 
+      # Aggregates the given resource based on the supplied +pipeline+
+      # 
+      #   context = Bodhi::Context.new
+      #   Resource.aggregate(context, "[{ $match: { property: { $gte: 20 }}}]")
       def aggregate(context, pipeline)
-        raise context.errors unless context.valid?
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
 
         unless pipeline.is_a? String
           raise ArgumentError.new("Expected 'pipeline' to be a String. 'pipeline' #=> #{pipeline.class}")
@@ -68,17 +107,20 @@ module Bodhi
         end
 
         if result.status != 200
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
 
         JSON.parse(result.body)
       end
 
+      # Returns all records for a resource which match the given +query+
+      # 
+      #   context = Bodhi::Context.new
+      #   Resource.where(context, "{property: 'value'}")
       def where(context, query)
-        raise context.errors unless context.valid?
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
 
         unless query.is_a? String
           raise ArgumentError.new("Expected 'query' to be a String. 'query' #=> #{query.class}")
@@ -90,18 +132,21 @@ module Bodhi
         end
 
         if result.status != 200
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
 
         resources = JSON.parse(result.body)
         resources.map{ |attributes| factory.build(context, attributes) }
       end
 
+      # Deletes all records from a resource in the given +context+
+      # 
+      #   context = Bodhi::Context.new
+      #   Resource.delete_all(context)
       def delete_all(context)
-        raise context.errors unless context.valid?
+        if context.invalid?
+          raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+        end
 
         result = context.connection.delete do |request|
           request.url "/#{context.namespace}/resources/#{name}"
@@ -109,10 +154,7 @@ module Bodhi
         end
 
         if result.status != 204
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
       end
     end
@@ -120,8 +162,8 @@ module Bodhi
     module InstanceMethods
       # Returns a Hash of the Objects form attributes
       # 
-      # s = SomeResource.build({foo:"test", bar:12345})
-      # s.attributes # => { foo: "test", bar: 12345 }
+      #   s = SomeResource.build({foo:"test", bar:12345})
+      #   s.attributes # => { foo: "test", bar: 12345 }
       def attributes
         attributes = Hash.new
         self.instance_variables.each do |variable|
@@ -132,15 +174,20 @@ module Bodhi
       end
   
       # Returns all the Objects attributes as JSON.
-      # Will convert any nested Objects to JSON if they respond to :to_json
+      # It converts any nested Objects to JSON if they respond to +to_json+
       # 
-      # s = SomeResource.build({foo:"test", bar:12345})
-      # s.to_json # => { "foo":"test", "bar":12345 }
+      #   s = SomeResource.build({foo:"test", bar:12345})
+      #   s.to_json # => { "foo":"test", "bar":12345 }
       def to_json(base=nil)
         super if base
         attributes.to_json
       end
 
+      # Saves the resource to the Bodhi Cloud.  Raises ArgumentError if record could not be saved.
+      # 
+      #   obj = Resouce.new
+      #   obj.save!
+      #   obj.persisted? # => true
       def save!
         result = bodhi_context.connection.post do |request|
           request.url "/#{bodhi_context.namespace}/resources/#{self.class}"
@@ -150,10 +197,7 @@ module Bodhi
         end
   
         if result.status != 201
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
 
         if result.headers['location']
@@ -168,10 +212,7 @@ module Bodhi
         end
   
         if result.status != 204
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
       end
 
@@ -184,10 +225,7 @@ module Bodhi
         end
   
         if result.status != 204
-          errors = JSON.parse result.body
-          errors.each{|error| error['status'] = result.status } if errors.is_a? Array
-          errors["status"] = result.status if errors.is_a? Hash
-          raise errors.to_s
+          raise Bodhi::ApiErrors.new(body: result.body, status: result.status), "status: #{result.status}, body: #{result.body}"
         end
       end
     end

data/lib/bodhi-slam/types.rb

@@ -52,6 +52,12 @@ module Bodhi
       end
     end
 
+    # Queries the Bodhi API for all types within the given +context+
+    # Returns an array of Bodhi::Type objects
+    # 
+    #   context = BodhiContext.new(valid_params)
+    #   types = Bodhi::Type.find_all(context)
+    #   types # => [#<Bodhi::Type:0x007fbff403e808 @name="MyType">, #<Bodhi::Type:0x007fbff403e808 @name="MyType2">, ...]
     def self.find_all(context)
       raise context.errors unless context.valid?
       page = 1
@@ -78,6 +84,16 @@ module Bodhi
       all_records.flatten.collect{ |type| Bodhi::Type.new(type) }
     end
 
+    # Dynamically defines a new Ruby class for the given +type+
+    # Class validations, factory, and helper methods will also be added
+    # 
+    #   type = Bodhi::Type.new({name: "TestType", properties: { foo:{ type:"String" }}})
+    #   klass = Bodhi::Type.create_class_with(type)
+    #   klass # => #<Class:0x007fbff403e808 @name="TestType">
+    #
+    #   # Additional class methods
+    #   klass.validations # => { foo: [#<TypeValidator:0x007fbff403e808 @type="String">] }
+    #   klass.factory # => #<Bodhi::Factory:0x007fbff403e808 @klass="TestType", @generators=[]>
     def self.create_class_with(type)
       unless type.is_a? Bodhi::Type
         raise ArgumentError.new("Expected #{type.class} to be a Bodhi::Type")

data/lib/bodhi-slam/validations.rb

@@ -12,16 +12,15 @@ module Bodhi
       #     validates :tags, requried: true, multi: true
       #     validates :name, required: true
       #
-      #   User.validations
-      #   # => {
-      #   #      tags: [
-      #   #        #<RequiredValidator:0x007fbff403e808 @options={}>,
-      #   #        #<MultiValidator:0x007fbff403e808 @options={}>
-      #   #      ],
-      #   #      name: [
-      #   #        #<RequiredValidator:0x007fbff403e808 @options={}>
-      #   #      ]
-      #   #    }
+      #   User.validations # => {
+      #     tags: [
+      #       #<RequiredValidator:0x007fbff403e808 @options={}>,
+      #       #<MultiValidator:0x007fbff403e808 @options={}>
+      #     ],
+      #     name: [
+      #       #<RequiredValidator:0x007fbff403e808 @options={}>
+      #     ]
+      #   }
       def validators; @validators; end
       
       # Creates a new validation on the given +attribute+ using the supplied +options+

data/lib/bodhi-slam/validators/type.rb

@@ -25,6 +25,8 @@ module Bodhi
         case @type
         when "GeoJSON"
           klass = Hash
+        when "Link"
+          klass = Hash
         when "DateTime"
           single_comparator = lambda do |item|
             begin

data/lib/bodhi-slam/validators.rb

@@ -7,12 +7,14 @@ module Bodhi
       raise NotImplementedError, "Subclasses must implement a validate(record, attribute, value) method."
     end
     
-    # Calls +underscore+ on the validation and returns it's class name as a symbol.
-    # Namespaces and the trailing "_validation" text will be trimmed
+    # Calls +underscore+ on the validator and returns it's class name as a symbol.
+    # Namespaces and the trailing "_validator" text will be trimmed
     # 
-    # BaseValidation.to_sym # => :base
-    # StringValidation.to_sym # => :string
-    # NotBlankValidation.to_sym # => :not_blank
+    #   type = Bodhi::TypeValidator.new("String")
+    #   is_not_blank = Bodhi::IsNotBlankValidator.new(true)
+    #
+    #   type.to_sym # => :type
+    #   is_not_blank.to_sym # => :is_not_blank
     def to_sym
       underscore.
       gsub("bodhi/", "").
@@ -22,9 +24,11 @@ module Bodhi
     
     # Returns the validation's class name in snake_case.
     #
-    # BaseValidation.underscore # => "bodhi/base_validation"
-    # StringValidation.underscore # => "bodhi/string_validation"
-    # NotBlankValidation.underscore # => "bodhi/not_blank_validation"
+    #   type = Bodhi::TypeValidator.new("String")
+    #   is_not_blank = Bodhi::IsNotBlankValidator.new(true)
+    #
+    #   type.underscore # => "bodhi/type_validator"
+    #   is_not_blank.underscore # => "bodhi/is_not_blank_validator"
     def underscore
       self.class.name.gsub(/::/, '/').
       gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
@@ -36,9 +40,11 @@ module Bodhi
     # Returns the validation as an options Hash.
     # The options hash is suitable to be used in the Bodhi::Validations.valdiates method
     #
-    # StringValidation.to_options # => { string: true }
-    # EmbeddedValidation.to_options # => { embedded: "ClassName" }
-    # EnumeratedValidation.to_options # => { enumerated: "Country.name" }
+    #   type = Bodhi::TypeValidator.new("String")
+    #   is_not_blank = Bodhi::IsNotBlankValidator.new(true)
+    #
+    #   type_validation.to_options # => { type: "String" }
+    #   is_not_blank_validation.to_options # => { is_not_blank: true }
     def to_options
       raise NotImplementedError, "Subclasses must implement a to_options method."
     end
@@ -46,12 +52,11 @@ module Bodhi
     # Returns the validator class with the given +name+
     # Raises NameError if no validator class is found
     # 
-    # Bodhi::Validator.constantize("type") # => Bodhi::TypeValidator
-    # Bodhi::Validator.constantize("multi") # => Bodhi::MutliValidator
-    # Bodhi::Validator.constantize("required") # => Bodhi::RequriedValidator
+    #   Bodhi::Validator.constantize("type") # => #<Bodhi::TypeValidator:0x007fbff403e808>
+    #   Bodhi::Validator.constantize("is_not_blank") # => #<Bodhi::IsNotBlankValidator:0x007fbff403e808>
     def self.constantize(name)
       camelized_name = name.to_s.split('_').collect(&:capitalize).join
-      full_name = "Bodhi::#{camelized_name}Validator"      
+      full_name = "Bodhi::#{camelized_name}Validator"
       Object.const_get(full_name)
     end
   end

data/lib/bodhi-slam.rb

@@ -13,17 +13,29 @@ require 'bodhi-slam/enumerations'
 require 'bodhi-slam/factory'
 
 class BodhiSlam
+  # Defines a context to interact with the Bodhi API
+  # Including a +server+, +namespace+, +username+, +password+ or +cookie+
+  #
+  #   context = Bodhi::Context.new(server: "https://test.com", namespace: "MyNamespace", username: "MyUser", password: "MyPassword")
+  #   context = Bodhi::Context.new(server: "https://test.com", namespace: "MyNamespace", username: "MyUser", cookie: "MyAuthCookie")
   def self.context(params, &block)
     bodhi_context = Bodhi::Context.new params
-    raise bodhi_context.errors unless bodhi_context.valid?
 
-    #puts "Switching context to: #{bodhi_context.attributes}"
+    if bodhi_context.invalid?
+      raise Bodhi::ContextErrors.new(bodhi_context.errors.messages), bodhi_context.errors.to_a.to_s
+    end
+
     yield bodhi_context
-    #puts "Exiting context: #{bodhi_context.attributes}"
   end
-  
+
+  # Dynamically creates Ruby Classes for each type in the given +context+
+  # 
+  #   context = Bodhi::Context.new(valid_params)
+  #   BodhiSlam.analyze(context) # => [#<Class:0x007fbff403e808 @name="TestType">, #<Class:0x007fbff403e808 @name="TestType2">, ...]
   def self.analyze(context)
-    raise context.errors unless context.valid?
+    if context.invalid?
+      raise Bodhi::ContextErrors.new(context.errors.messages), context.errors.to_a.to_s
+    end
 
     all_enums = Bodhi::Enumeration.find_all(context)
     all_types = Bodhi::Type.find_all(context)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bodhi-slam
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.5
 platform: ruby
 authors:
 - willdavis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-01 00:00:00.000000000 Z
+date: 2015-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http-persistent
@@ -104,6 +104,8 @@ files:
 - lib/bodhi-slam/context.rb
 - lib/bodhi-slam/enumerations.rb
 - lib/bodhi-slam/errors.rb
+- lib/bodhi-slam/errors/api.rb
+- lib/bodhi-slam/errors/context.rb
 - lib/bodhi-slam/factory.rb
 - lib/bodhi-slam/resource.rb
 - lib/bodhi-slam/types.rb
@@ -140,8 +142,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Ruby bindings for the Bodhi API + factories for random data generation
+summary: Ruby bindings for the Bodhi API & factories for random data generation
 test_files: []