rcap 1.0.1 → 1.1.0

data/lib/rcap/cap_1_2/geocode.rb

@@ -1,22 +1,8 @@
 module RCAP
   module CAP_1_2
     class Geocode < Parameter
-
       XML_ELEMENT_NAME = 'geocode' # :nodoc:
-
       XPATH = "cap:#{ XML_ELEMENT_NAME }" # :nodoc:
-
-      def to_xml_element # :nodoc:
-        xml_element = REXML::Element.new( XML_ELEMENT_NAME )
-        xml_element.add_element( NAME_ELEMENT_NAME ).add_text( @name )
-        xml_element.add_element( VALUE_ELEMENT_NAME ).add_text( @value )
-        xml_element
-      end
-
-      def self.from_xml_element( geocode_xml_element ) # :nodoc:
-        self.new( :name  => RCAP.xpath_text( geocode_xml_element, NAME_XPATH, Alert::XMLNS ),
-                 :value => RCAP.xpath_text( geocode_xml_element, VALUE_XPATH, Alert::XMLNS ))
-      end
     end
   end
 end

data/lib/rcap/cap_1_2/parameter.rb

@@ -24,7 +24,7 @@ module RCAP
       end
 
       def to_xml_element # :nodoc:
-        xml_element = REXML::Element.new( XML_ELEMENT_NAME )
+        xml_element = REXML::Element.new( self.class::XML_ELEMENT_NAME )
         xml_element.add_element( NAME_ELEMENT_NAME ).add_text( self.name )
         xml_element.add_element( VALUE_ELEMENT_NAME ).add_text( self.value )
         xml_element
@@ -55,8 +55,7 @@ module RCAP
       end
 
       def to_h # :nodoc:
-        RCAP.attribute_values_to_hash(
-          [ @name, @value ])
+        RCAP.attribute_values_to_hash( [ self.name, self.value ])
       end
 
       def self.from_h( hash ) # :nodoc:

data/lib/rcap/cap_1_2/resource.rb

@@ -136,11 +136,11 @@ module RCAP
       def self.from_h( resource_hash ) # :nodoc:
         self.new(
           :resource_desc => resource_hash[ RESOURCE_DESC_KEY ],
-          :uri => resource_hash[ URI_KEY ],
-          :mime_type => resource_hash[ MIME_TYPE_KEY ],
-          :deref_uri => resource_hash[ DEREF_URI_KEY ],
-          :size => resource_hash[ SIZE_KEY ],
-          :digest => resource_hash[ DIGEST_KEY ])
+          :uri           => resource_hash[ URI_KEY ],
+          :mime_type     => resource_hash[ MIME_TYPE_KEY ],
+          :deref_uri     => resource_hash[ DEREF_URI_KEY ],
+          :size          => resource_hash[ SIZE_KEY ],
+          :digest        => resource_hash[ DIGEST_KEY ])
       end
     end
   end

data/lib/rcap/version.rb

@@ -1,3 +1,3 @@
 module RCAP
-  VERSION = '1.0.1'
+  VERSION = '1.1.0'
 end

data/rcap.gemspec

@@ -19,7 +19,6 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ['lib']
 
-  s.has_rdoc = true
   s.extra_rdoc_files = ['README.rdoc','CHANGELOG.rdoc']
   s.add_dependency('assistance', '>= 0.1.5')
   s.add_dependency('json', '>= 1.5.1')

data/spec/alert_spec.rb

@@ -1,6 +1,70 @@
 describe( RCAP::Alert ) do
   describe( 'initialising' ) do
 
+    context( 'a CAP 1.0 alert' ) do
+      before( :each ) do
+        @original_alert = RCAP::CAP_1_0::Alert.new( :sender => 'Sender',
+                                                    :sent => DateTime.now,
+                                                    :status => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                                    :scope => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC,
+                                                    :source => 'Source',
+                                                    :restriction => 'No Restriction',
+                                                    :addresses => [ 'Address 1', 'Address 2'],
+                                                    :code => ['Code1', 'Code2'],
+                                                    :note => 'Note',
+                                                    :references => [ "1.0,1", "1.0,2" ],
+                                                    :incidents => [ 'Incident1', 'Incident2' ],
+                                                    :infos => [ RCAP::CAP_1_0::Info.new, RCAP::CAP_1_0::Info.new ])
+      end
+
+
+
+      shared_examples_for( 'it has parsed a CAP 1.0 alert correctly' ) do
+        it( 'should use the correct CAP Version' ){ @alert.class.should       == RCAP::CAP_1_0::Alert }
+        it( 'should parse identifier correctly' ) { @alert.identifier.should  == @original_alert.identifier }
+        it( 'should parse sender correctly' )     { @alert.sender.should      == @original_alert.sender }
+        it( 'should parse sent correctly' )       { @alert.sent.should( be_within( 1 ).of( @original_alert.sent ))}
+        it( 'should parse status correctly' )     { @alert.status.should      == @original_alert.status }
+        it( 'should parse msg_type correctly' )   { @alert.msg_type.should    == @original_alert.msg_type }
+        it( 'should parse source correctly' )     { @alert.source.should      == @original_alert.source }
+        it( 'should parse scope correctly' )      { @alert.scope.should       == @original_alert.scope }
+        it( 'should parse restriction correctly' ){ @alert.restriction.should == @original_alert.restriction }
+        it( 'should parse addresses correctly' )  { @alert.addresses.should   == @original_alert.addresses }
+        it( 'should parse code correctly' )       { @alert.codes.should       == @original_alert.codes }
+        it( 'should parse note correctly' )       { @alert.note.should        == @original_alert.note }
+        it( 'should parse references correctly' ) { @alert.references.should  == @original_alert.references }
+        it( 'should parse incidents correctly' )  { @alert.incidents.should   == @original_alert.incidents }
+        it( 'should parse infos correctly' ) do
+          @alert.infos.size.should == @original_alert.infos.size
+          @alert.infos.each{ |info| info.class.should == RCAP::CAP_1_0::Info }
+        end
+      end
+
+      context( 'from XML' ) do
+        before( :each ) do
+          @alert = RCAP::Alert.from_xml( @original_alert.to_xml )
+        end
+
+        it_should_behave_like( 'it has parsed a CAP 1.0 alert correctly' )
+      end
+
+      context( 'from YAML' ) do
+        before( :each ) do
+          @alert = RCAP::Alert.from_yaml( @original_alert.to_yaml )
+        end
+
+        it_should_behave_like( 'it has parsed a CAP 1.0 alert correctly' )
+      end
+
+      context( 'from JSON' ) do
+        before( :each ) do
+          @alert = RCAP::Alert.from_json( @original_alert.to_json )
+        end
+
+        it_should_behave_like( 'it has parsed a CAP 1.0 alert correctly' )
+      end
+    end
+
     context( 'a CAP 1.1 alert' ) do
       before( :each ) do
         @original_alert = RCAP::CAP_1_1::Alert.new( :sender => 'Sender',

data/spec/cap_1_0/alert_spec.rb

@@ -0,0 +1,222 @@
+require 'spec_helper'
+
+describe( RCAP::CAP_1_0::Alert ) do
+  context( 'on initialisation' ) do
+    before( :each )  do
+      @alert = RCAP::CAP_1_0::Alert.new
+    end
+
+    it( 'should not have a identifier' ){ @alert.identifier.should( be_nil )}
+    it( 'should not have a sender' ){ @alert.sender.should( be_nil )}
+    it( 'should not have a sent time' ){ @alert.sent.should( be_nil )}
+    it( 'should not have a status' ){ @alert.status.should( be_nil )}
+    it( 'should not have a scope' ){ @alert.scope.should( be_nil )}
+    it( 'should not have a source'){ @alert.source.should( be_nil )}
+    it( 'should not have a restriction'){ @alert.restriction.should( be_nil )}
+    it( 'should not have any addresses' ){ @alert.addresses.should( be_empty )}
+    it( 'should not have any codes' ){ @alert.codes.should( be_empty )}
+    it( 'should not have a note' ){ @alert.note.should( be_nil )}
+    it( 'should not have any references' ){ @alert.references.should( be_empty )}
+    it( 'should not have any incidents' ){ @alert.incidents.should( be_empty )}
+    it( 'should not have any infos' ){ @alert.infos.should( be_empty )}
+
+    shared_examples_for( "a successfully parsed CAP 1.0 alert" ) do
+      it( 'should parse identifier correctly' ) { @alert.identifier.should  == @original_alert.identifier }
+      it( 'should parse sender correctly' )     { @alert.sender.should      == @original_alert.sender }
+      it( 'should parse sent correctly' )       { @alert.sent.should( be_within( 1 ).of( @original_alert.sent ))}
+      it( 'should parse status correctly' )     { @alert.status.should      == @original_alert.status }
+      it( 'should parse msg_type correctly' )   { @alert.msg_type.should    == @original_alert.msg_type }
+      it( 'should parse source correctly' )     { @alert.source.should      == @original_alert.source }
+      it( 'should parse scope correctly' )      { @alert.scope.should       == @original_alert.scope }
+      it( 'should parse restriction correctly' ){ @alert.restriction.should == @original_alert.restriction }
+      it( 'should parse addresses correctly' )  { @alert.addresses.should   == @original_alert.addresses }
+      it( 'should parse code correctly' )       { @alert.codes.should       == @original_alert.codes }
+      it( 'should parse note correctly' )       { @alert.note.should        == @original_alert.note }
+      it( 'should parse references correctly' ) { @alert.references.should  == @original_alert.references }
+      it( 'should parse incidents correctly' )  { @alert.incidents.should   == @original_alert.incidents }
+      it( 'should parse infos correctly' ) do
+        @alert.infos.size.should == @original_alert.infos.size
+        @alert.infos.each{ |info| info.class.should == RCAP::CAP_1_0::Info }
+      end
+    end
+
+    context( 'from XML' ) do
+      before( :each ) do
+        @original_alert = RCAP::CAP_1_0::Alert.new( :sender      => 'Sender',
+                                                    :sent        => DateTime.now,
+                                                    :status      => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                                    :scope       => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC,
+                                                    :source      => 'Source',
+                                                    :restriction => 'No Restriction',
+                                                    :addresses   => [ 'Address 1', 'Address 2'],
+                                                    :codes       => [ 'Code1', 'Code2' ],
+                                                    :note        => 'Note',
+                                                    :references  => [ RCAP::CAP_1_0::Alert.new( :sender => 'Sender1' ).to_reference, RCAP::CAP_1_0::Alert.new( :sender => 'Sender2' ).to_reference ],
+                                                    :incidents   => [ 'Incident1', 'Incident2' ],
+                                                    :infos       => [ RCAP::CAP_1_0::Info.new, RCAP::CAP_1_0::Info.new ])
+        @xml_string = @original_alert.to_xml
+        @xml_document = REXML::Document.new( @xml_string )
+        @alert_element = @xml_document.root
+        @alert = RCAP::CAP_1_0::Alert.from_xml_element( @alert_element )
+      end
+
+      it_should_behave_like( "a successfully parsed CAP 1.0 alert" )
+
+    end
+
+    context( 'from YAML' ) do
+      before( :each ) do
+        @original_alert = RCAP::CAP_1_0::Alert.new( :sender      => 'Sender',
+                                                    :sent        => DateTime.now,
+                                                    :status      => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                                    :scope       => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC,
+                                                    :source      => 'Source',
+                                                    :restriction => 'No Restriction',
+                                                    :addresses   => [ 'Address 1', 'Address 2'],
+                                                    :codes       => [ 'Code1', 'Code2' ],
+                                                    :note        => 'Note',
+                                                    :references  => [ RCAP::CAP_1_0::Alert.new( :sender => 'Sender1' ).to_reference, RCAP::CAP_1_0::Alert.new( :sender => 'Sender2' ).to_reference ],
+                                                    :incidents   => [ 'Incident1', 'Incident2' ],
+                                                    :infos       => [ RCAP::CAP_1_0::Info.new, RCAP::CAP_1_0::Info.new ])
+        @yaml_string = @original_alert.to_yaml
+        @alert = RCAP::CAP_1_0::Alert.from_yaml( @yaml_string )
+      end
+
+      it_should_behave_like( "a successfully parsed CAP 1.0 alert" )
+    end
+
+    context( 'from a hash' ) do
+      before( :each ) do
+        @original_alert = RCAP::CAP_1_0::Alert.new( :sender      => 'Sender',
+                                                    :sent        => DateTime.now,
+                                                    :status      => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                                    :scope       => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC,
+                                                    :source      => 'Source',
+                                                    :restriction => 'No Restriction',
+                                                    :addresses   => [ 'Address 1', 'Address 2'],
+                                                    :codes       => [ 'Code1', 'Code2' ],
+                                                    :note        => 'Note',
+                                                    :references  => [ RCAP::CAP_1_0::Alert.new( :sender => 'Sender1' ).to_reference, RCAP::CAP_1_0::Alert.new( :sender => 'Sender2' ).to_reference ],
+                                                    :incidents   => [ 'Incident1', 'Incident2' ],
+                                                    :infos       => [ RCAP::CAP_1_0::Info.new, RCAP::CAP_1_0::Info.new ])
+        @alert = RCAP::CAP_1_0::Alert.from_h( @original_alert.to_h )
+      end
+
+      it_should_behave_like( "a successfully parsed CAP 1.0 alert" )
+    end
+
+    context( 'from JSON' ) do
+      before( :each ) do
+        @original_alert = RCAP::CAP_1_0::Alert.new( :sender      => 'Sender',
+                                                    :sent        => DateTime.now,
+                                                    :status      => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                                    :scope       => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC,
+                                                    :source      => 'Source',
+                                                    :restriction => 'No Restriction',
+                                                    :addresses   => [ 'Address 1', 'Address 2'],
+                                                    :codes       => [ 'Code1', 'Code2' ],
+                                                    :note        => 'Note',
+                                                    :references  => [ RCAP::CAP_1_0::Alert.new( :sender => 'Sender1' ).to_reference, RCAP::CAP_1_0::Alert.new( :sender => 'Sender2' ).to_reference ],
+                                                    :incidents   => [ 'Incident1', 'Incident2' ],
+                                                    :infos       => [ RCAP::CAP_1_0::Info.new, RCAP::CAP_1_0::Info.new ])
+        @alert = RCAP::CAP_1_0::Alert.from_json( @original_alert.to_json )
+      end
+
+      it_should_behave_like( "a successfully parsed CAP 1.0 alert" )
+    end
+  end
+
+  describe( 'is not valid if it' ) do
+    before( :each ) do
+      @alert = RCAP::CAP_1_0::Alert.new( :identifier => 'Identifier',
+                                         :sender     => "cap@tempuri.org",
+                                         :sent       => DateTime.now,
+                                         :status     => RCAP::CAP_1_0::Alert::STATUS_TEST,
+                                         :msg_type   => RCAP::CAP_1_0::Alert::MSG_TYPE_ALERT,
+                                         :scope      => RCAP::CAP_1_0::Alert::SCOPE_PUBLIC )
+      @alert.should( be_valid )
+    end
+
+    it( 'does not have a identifier' ) do
+      @alert.identifier = nil
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a sender' ) do
+      @alert.sender = nil
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a sent time (sent)' ) do
+      @alert.sent = nil
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a status' ) do
+      @alert.status = nil
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a message type (msg_type)' ) do
+      @alert.msg_type = nil
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a scope' ) do
+      @alert.scope = nil
+      @alert.should_not( be_valid )
+    end
+
+
+    it( 'does not have a valid status' ) do
+      @alert.status = 'incorrect value'
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a valid message type msg_type' ) do
+      @alert.msg_type = 'incorrect value'
+      @alert.should_not( be_valid )
+    end
+
+    it( 'does not have a valid scope' ) do
+      @alert.scope = 'incorrect value'
+      @alert.should_not( be_valid )
+    end
+
+
+    context( 'has an info element and it' ) do
+      it( 'is not valid' ) do
+        @info = RCAP::CAP_1_0::Info.new( :event => 'Info Event',
+                              :categories => RCAP::CAP_1_0::Info::CATEGORY_GEO,
+                              :urgency => RCAP::CAP_1_0::Info::URGENCY_IMMEDIATE,
+                              :severity => RCAP::CAP_1_0::Info::SEVERITY_EXTREME,
+                              :certainty => RCAP::CAP_1_0::Info::CERTAINTY_VERY_LIKELY )
+        @info.event = nil
+        @alert.infos << @info
+        @info.should_not( be_valid )
+        @alert.should_not( be_valid )
+      end
+    end
+  end
+
+  describe( 'instance methods' ) do
+    before( :each ) do
+      @alert = RCAP::CAP_1_0::Alert.new
+    end
+
+    describe( '#add_info' ) do
+      before( :each ) do
+        @info = @alert.add_info( :urgency => 'urgent' )
+        @info.urgency.should == 'urgent'
+      end
+
+      it( 'should return a CAP 1.0 Info object' ) do
+        @info.class.should == RCAP::CAP_1_0::Info
+      end
+
+      it( 'should add an Info object to the infos array' ) do
+        @alert.infos.size.should == 1
+      end
+    end
+  end
+end

data/spec/cap_1_0/area_spec.rb

@@ -0,0 +1,247 @@
+require 'spec_helper'
+
+describe( RCAP::CAP_1_0::Area ) do
+  context( 'on initialisation' ) do
+    before( :each ) do
+      @area = RCAP::CAP_1_0::Area.new
+    end
+
+    # Atomic
+    it( 'should not have a area_desc' ){ @area.area_desc.should( be_nil )}
+    it( 'should not have a altitude' ){ @area.altitude.should( be_nil )}
+    it( 'should not have a ceiling' ){ @area.ceiling.should( be_nil )}
+
+    # Group
+    it( 'should have an empty polygons' ){ @area.polygons.should( be_empty )}
+    it( 'should have an empty circles' ){ @area.circles.should( be_empty )}
+    it( 'should have an empty geocodes' ){ @area.geocodes.should( be_empty )}
+
+    shared_examples_for( "it can parse into a CAP 1.0 Area object" ) do
+      it( 'should parse the area_desc correctly' ) do
+        @area.area_desc.should == @original_area.area_desc
+      end
+
+      it( 'should parse the altitude correctly' ) do
+        @area.altitude.should == @original_area.altitude
+      end
+
+      it( 'should parse the ceiling correctly' ) do
+        @area.ceiling.should == @original_area.ceiling
+      end
+
+      it( 'should parse the circles correctly' ) do
+        @area.circles.should == @original_area.circles
+      end
+
+      it( 'should parse the geocodes correctly' ) do
+        @area.geocodes.should == @original_area.geocodes
+      end
+
+      it( 'should parse the polygons correctly' ) do
+        @area.polygons.should == @original_area.polygons
+      end
+    end
+
+    context( 'from XML' ) do
+      before( :each ) do
+        @original_area = RCAP::CAP_1_0::Area.new( :area_desc => 'Area Description',
+                                       :altitude => 100,
+                                       :ceiling => 200,
+                                       :circles => RCAP::CAP_1_0::Circle.new( :lattitude => 0, :longitude => 0 , :radius => 100 ),
+                                       :geocodes => RCAP::CAP_1_0::Geocode.new( :name => 'name', :value => 'value' ),
+                                       :polygons => RCAP::CAP_1_0::Polygon.new( :points => RCAP::CAP_1_0::Point.new( :lattitude =>1, :longitude => 1 )))
+
+        @alert = RCAP::CAP_1_0::Alert.new( :infos => RCAP::CAP_1_0::Info.new( :areas => @original_area ))
+        @xml_string = @alert.to_xml
+        @xml_document = REXML::Document.new( @xml_string )
+        @info_xml_element = RCAP.xpath_first( @xml_document.root, RCAP::CAP_1_0::Info::XPATH, RCAP::CAP_1_0::Alert::XMLNS )
+        @area_xml_element = RCAP.xpath_first( @info_xml_element, RCAP::CAP_1_0::Area::XPATH, RCAP::CAP_1_0::Alert::XMLNS )
+        @area = RCAP::CAP_1_0::Area.from_xml_element( @area_xml_element )
+      end
+
+      it_should_behave_like( "it can parse into a CAP 1.0 Area object" )
+    end
+
+    context( 'from YAML Data' ) do
+      before( :each ) do
+        @original_area = RCAP::CAP_1_0::Area.new( :area_desc => 'Area Description',
+                                                  :altitude => 100,
+                                                  :ceiling => 200,
+                                                  :circles => RCAP::CAP_1_0::Circle.new( :lattitude => 0, :longitude => 0 , :radius => 100 ),
+                                                  :geocodes => RCAP::CAP_1_0::Geocode.new( :name => 'name', :value => 'value' ),
+                                                  :polygons => RCAP::CAP_1_0::Polygon.new( :points => RCAP::CAP_1_0::Point.new( :lattitude =>1, :longitude => 1 )))
+
+        @area = RCAP::CAP_1_0::Area.from_yaml_data( YAML.load( @original_area.to_yaml ))
+      end
+
+      it_should_behave_like( "it can parse into a CAP 1.0 Area object" )
+    end
+
+    context( 'from a hash' ) do
+      before( :each ) do
+        @original_area = RCAP::CAP_1_0::Area.new( :area_desc => 'Area Description',
+                                       :altitude => 100,
+                                       :ceiling => 200,
+                                       :circles => RCAP::CAP_1_0::Circle.new( :lattitude => 0, :longitude => 0 , :radius => 100 ),
+                                       :geocodes => RCAP::CAP_1_0::Geocode.new( :name => 'name', :value => 'value' ),
+                                       :polygons => RCAP::CAP_1_0::Polygon.new( :points => RCAP::CAP_1_0::Point.new( :lattitude =>1, :longitude => 1 )))
+
+        @area = RCAP::CAP_1_0::Area.from_h( @original_area.to_h )
+      end
+
+      it_should_behave_like( "it can parse into a CAP 1.0 Area object" )
+    end
+  end
+
+  context( 'when exported' ) do
+    before( :each ) do
+      @area = RCAP::CAP_1_0::Area.new( :area_desc => 'Area Description',
+                             :altitude => 100,
+                             :ceiling => 200,
+                             :circles => RCAP::CAP_1_0::Circle.new(  :lattitude => 0, :longitude => 0 , :radius => 100 ),
+                             :geocodes => RCAP::CAP_1_0::Geocode.new( :name => 'name', :value => 'value' ),
+                             :polygons => RCAP::CAP_1_0::Polygon.new( :points => RCAP::CAP_1_0::Point.new( :lattitude =>1, :longitude => 1 )))
+    end
+    context( 'to a hash' ) do
+      before( :each ) do
+        @area_hash = @area.to_h
+      end
+
+      it( 'should export the area description correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::AREA_DESC_KEY ].should == @area.area_desc
+      end
+
+      it( 'should export the altitude correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::ALTITUDE_KEY ].should == @area.altitude
+      end
+
+      it( 'should set the ceiling correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::CEILING_KEY ].should == @area.ceiling
+      end
+
+      it( 'should export the circles correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::CIRCLES_KEY ].should == @area.circles.map{ |circle| circle.to_h }
+      end
+
+      it( 'should export the geocodes correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::GEOCODES_KEY ].should == @area.geocodes.map{ |geocode| geocode.to_h }
+      end
+
+      it( 'should export the polygons correctly' ) do
+        @area_hash[ RCAP::CAP_1_0::Area::POLYGONS_KEY ].should == @area.polygons.map{ |polygon| polygon.to_h }
+      end
+    end
+  end
+
+  context( 'is not valid if' ) do
+    before( :each ) do
+      @area = RCAP::CAP_1_0::Area.new( :area_desc => "Cape Town Metropole" )
+      @area.should( be_valid )
+    end
+
+    it( 'does not have an area descrtiption (area_desc)') do
+      @area.area_desc = nil
+      @area.should_not( be_valid )
+    end
+
+    it( 'has a ceiling defined but no altitude' ) do
+      @area.ceiling = 1
+      @area.altitude = nil
+      @area.should_not( be_valid )
+    end
+
+    context( 'it contains circles and it' ) do
+      before( :each ) do
+        @area.circles << RCAP::CAP_1_0::Circle.new( :lattitude => 0, :longitude => 0, :radius => 1)
+        @area.should( be_valid )
+      end
+
+      it( 'has an invalid circle' ) do
+        @area.circles.first.lattitude = nil
+        @area.should_not( be_valid )
+      end
+    end
+
+    context( 'it contains polygons and it' ) do
+      before( :each ) do
+        @polygon = RCAP::CAP_1_0::Polygon.new
+        @polygon.points.push( RCAP::CAP_1_0::Point.new( :lattitude => 0, :longitude => 0 ),
+                             RCAP::CAP_1_0::Point.new( :lattitude => 0, :longitude => 1 ),
+                             RCAP::CAP_1_0::Point.new( :lattitude => 1, :longitude => 0 ))
+        @area.polygons << @polygon
+        @area.should( be_valid )
+      end
+
+      it( 'has an invalid polygon' ) do
+        @polygon.points.first.lattitude = nil
+        @area.should_not( be_valid )
+      end
+    end
+
+    context( 'it contains geocodes and it' ) do
+      before( :each ) do
+        @geocode = RCAP::CAP_1_0::Geocode.new( :name => 'foo', :value => 'bar' )
+        @area.geocodes << @geocode
+        @area.should( be_valid )
+      end
+
+      it( 'has an invalid geocode' ) do
+        @geocode.value = nil
+        @area.should_not( be_valid )
+      end
+    end
+  end
+
+  describe( 'instance methods' ) do
+    before( :each ) do
+      @area = RCAP::CAP_1_0::Area.new
+    end
+
+    describe( '#add_polygon' ) do
+      before( :each ) do
+        @polygon = @area.add_polygon
+      end
+
+      it( 'should return a CAP 1.0 Polygon' ) do
+        @polygon.class.should == RCAP::CAP_1_0::Polygon
+      end
+
+      it( 'should add a Polygon to the polygons attribute' ) do
+        @area.polygons.size.should == 1
+      end
+    end
+
+    describe( '#add_circle' ) do
+      before( :each ) do
+        @circle = @area.add_circle( lattitude: 1, longitude: 1, radius: 1 )
+      end
+
+      it( 'should return a CAP 1.0 Circle' ) do
+        @circle.class.should == RCAP::CAP_1_0::Circle
+        @circle.lattitude.should == 1
+        @circle.longitude.should == 1
+        @circle.radius.should == 1
+      end
+
+      it( 'should add a circle to the circles attribute' ) do
+        @area.circles.size.should == 1
+      end
+    end
+
+    describe( '#add_geocode' ) do
+      before( :each ) do
+        @geocode = @area.add_geocode( name: 'Geocode', value: '123' )
+      end
+
+      it( 'should return a CAP 1.0 Geocode' ) do
+        @geocode.class.should == RCAP::CAP_1_0::Geocode
+        @geocode.name.should == 'Geocode'
+        @geocode.value.should == '123'
+      end
+
+      it( 'should add a geocode to the geocodes attribute' ) do
+        @area.geocodes.size.should == 1
+      end
+    end
+  end
+end