osm 0.0.1.alpha

data/spec/osm/api_strangeness_spec.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+require 'spec_helper'
+
+
+describe "Online Scout Manager API Strangeness" do
+
+  before(:each) do
+    Osm::Api.configure({:api_id=>'1234', :api_token=>'12345678', :api_name=>'API', :api_site=>:scout})
+    @api = Osm::Api.new('2345', 'abcd')
+  end
+
+  it "handles a section with no type" do
+    body = '[{"sectionConfig":"{\"subscription_level\":3,\"subscription_expires\":\"2013-01-05\",\"columnNames\":{\"phone1\":\"Home Phone\",\"phone2\":\"Parent 1 Phone\",\"address\":\"Member\'s Address\",\"phone3\":\"Parent 2 Phone\",\"address2\":\"Address 2\",\"phone4\":\"Alternate Contact Phone\",\"subs\":\"Gender\",\"email1\":\"Parent 1 Email\",\"medical\":\"Medical / Dietary\",\"email2\":\"Parent 2 Email\",\"ethnicity\":\"Gift Aid\",\"email3\":\"Member\'s Email\",\"religion\":\"Religion\",\"email4\":\"Email 4\",\"school\":\"School\"},\"numscouts\":10,\"hasUsedBadgeRecords\":true,\"hasProgramme\":true,\"extraRecords\":[{\"name\":\"Subs\",\"extraid\":\"529\"}],\"wizard\":\"false\",\"fields\":{\"email1\":true,\"email2\":true,\"email3\":true,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":true,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":true,\"saved\":true},\"intouch\":{\"address\":true,\"address2\":false,\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"medical\":false},\"mobFields\":{\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":false,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":false}}","groupname":"1st Somewhere","groupid":"1","groupNormalised":"1","sectionid":"1","sectionname":"Section 1","section":"cubs","isDefault":"1","permissions":{"badge":100,"member":100,"user":100,"register":100,"contact":100,"programme":100,"originator":1,"events":100,"finance":100,"flexi":100}}]'
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getUserRoles", :body => body)
+
+    @api.get_section(1).type.should == :unknown
+  end
+
+
+  it "handles strange extra records when getting roles" do
+    body = '[{"sectionConfig":"{\"subscription_level\":3,\"subscription_expires\":\"2013-01-05\",\"sectionType\":\"cubs\",\"columnNames\":{\"phone1\":\"Home Phone\",\"phone2\":\"Parent 1 Phone\",\"address\":\"Member\'s Address\",\"phone3\":\"Parent 2 Phone\",\"address2\":\"Address 2\",\"phone4\":\"Alternate Contact Phone\",\"subs\":\"Gender\",\"email1\":\"Parent 1 Email\",\"medical\":\"Medical / Dietary\",\"email2\":\"Parent 2 Email\",\"ethnicity\":\"Gift Aid\",\"email3\":\"Member\'s Email\",\"religion\":\"Religion\",\"email4\":\"Email 4\",\"school\":\"School\"},\"numscouts\":10,\"hasUsedBadgeRecords\":true,\"hasProgramme\":true,\"extraRecords\":[[\"1\",{\"name\":\"Subs\",\"extraid\":\"529\"}],[\"2\",{\"name\":\"Subs 2\",\"extraid\":\"530\"}]],\"wizard\":\"false\",\"fields\":{\"email1\":true,\"email2\":true,\"email3\":true,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":true,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":true,\"saved\":true},\"intouch\":{\"address\":true,\"address2\":false,\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"medical\":false},\"mobFields\":{\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":false,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":false}}","groupname":"1st Somewhere","groupid":"1","groupNormalised":"1","sectionid":"1","sectionname":"Section 1","section":"cubs","isDefault":"1","permissions":{"badge":100,"member":100,"user":100,"register":100,"contact":100,"programme":100,"originator":1,"events":100,"finance":100,"flexi":100}}]'
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getUserRoles", :body => body)
+
+    @api.get_roles()[0].should_not == nil
+  end
+
+
+  it "handles an empty array representing no due badges" do
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/challenges.php?action=outstandingBadges&section=cubs&sectionid=1&termid=1", :body => '[]')
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getUserRoles", :body => '[{"sectionConfig":"{\"subscription_level\":\"3\",\"subscription_expires\":\"2013-01-05\",\"sectionType\":\"cubs\",\"columnNames\":{\"phone1\":\"Home Phone\",\"phone2\":\"Parent 1 Phone\",\"address\":\"Member\'s Address\",\"phone3\":\"Parent 2 Phone\",\"address2\":\"Address 2\",\"phone4\":\"Alternate Contact Phone\",\"subs\":\"Gender\",\"email1\":\"Parent 1 Email\",\"medical\":\"Medical / Dietary\",\"email2\":\"Parent 2 Email\",\"ethnicity\":\"Gift Aid\",\"email3\":\"Member\'s Email\",\"religion\":\"Religion\",\"email4\":\"Email 4\",\"school\":\"School\"},\"numscouts\":10,\"hasUsedBadgeRecords\":true,\"hasProgramme\":true,\"extraRecords\":[{\"name\":\"Subs\",\"extraid\":\"529\"}],\"wizard\":\"false\",\"fields\":{\"email1\":true,\"email2\":true,\"email3\":true,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":true,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":true,\"saved\":true},\"intouch\":{\"address\":true,\"address2\":false,\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"medical\":false},\"mobFields\":{\"email1\":false,\"email2\":false,\"email3\":false,\"email4\":false,\"address\":true,\"address2\":false,\"phone1\":true,\"phone2\":true,\"phone3\":true,\"phone4\":true,\"school\":false,\"religion\":false,\"ethnicity\":true,\"medical\":true,\"patrol\":true,\"subs\":false}}","groupname":"1st Somewhere","groupid":"1","groupNormalised":"1","sectionid":"1","sectionname":"Section Name","section":"cubs","isDefault":"1","permissions":{"badge":100,"member":100,"user":100,"register":100,"contact":100,"programme":100,"originator":1,"events":100,"finance":100,"flexi":100}}]')
+    @api.get_due_badges(1, 1).should_not == nil
+  end
+
+
+  it "handles an empty array representing no notepads" do
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getNotepads", :body => '[]')
+    @api.get_notepad(1).should == nil
+  end
+
+
+  it "handles a non existant array when no events" do
+    data = '{"identifier":"eventid","label":"name"}'
+    FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/events.php?action=getEvents&sectionid=1", :body => data)
+
+    @api.get_events(1).should == []
+  end
+
+end

data/spec/osm/due_badges_spec.rb

@@ -0,0 +1,57 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe "DueBadge" do
+
+  it "Create" do
+    data = {
+      'pending' => {
+        'badge_name' => [
+          {
+            'scoutid' => '1',
+            'firstname' => 'John',
+            'lastname' => 'Doe',
+            'completed' => '',
+            'extra' => '',
+          }
+        ],
+        'cubs_core_participation' => [{
+            'sid' => '2',
+            'firstname' => 'Jane',
+            'lastname' => 'Doe',
+            'completed' => '3',
+            'extra' => 'Lvl 3'
+          }, {
+            'sid' => '1',
+            'firstname' => 'John',
+            'lastname' => 'Doe',
+            'completed' => '2',
+            'extra' => 'Lvl 2'
+          }
+        ]
+      },
+
+      'description' => {
+        'badge_name' => {
+          'name' => 'Badge Name',
+          'section' => 'cubs',
+          'type' => 'activity',
+          'badge' => 'badge_name'
+        },
+        'cubs_core_participation' => {
+          'name' => 'Participation',
+          'section' => 'cubs',
+          'type' => 'core',
+          'badge' => 'participation'
+        }
+      }
+    }
+    db = Osm::DueBadges.new(data)
+
+    db.empty?.should == false
+    db.descriptions.should == {:badge_name=>{:name=>"Badge Name", :section=>:cubs, :type=>:activity, :badge=>"badge_name"}, :cubs_core_participation=>{:name=>"Participation", :section=>:cubs, :type=>:core, :badge=>"participation"}}
+    db.by_member.should == {"John Doe"=>[{:badge=>:badge_name, :extra_information=>""}, {:badge=>:cubs_core_participation, :extra_information=>"Lvl 2"}], "Jane Doe"=>[{:badge=>:cubs_core_participation, :extra_information=>"Lvl 3"}]}
+    db.totals.should == {:badge_name=>{""=>1}, :cubs_core_participation=>{"Lvl 3"=>1, "Lvl 2"=>1}}
+  end
+
+end

data/spec/osm/event_spec.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'date'
+
+describe "Event" do
+
+  it "Create" do
+    data = {
+      'eventid' => 1,
+      'sectionid' => 2,
+      'name' => 'Event name',
+      'startdate' => '2001-01-02',
+      'starttime' => '12:00:00',
+      'enddate' => '2001-01-02',
+      'endtime' => '13:00:00',
+      'cost' => 'Free',
+      'location' => 'Somewhere',
+      'notes' => 'None'
+    }
+    event = Osm::Event.new(data)
+
+    event.id.should == 1
+    event.section_id.should == 2
+    event.name.should == 'Event name'
+    event.start.should == DateTime.new(2001, 1, 2, 12, 0, 0)
+    event.end.should == DateTime.new(2001, 1, 2, 13, 0, 0)
+    event.cost.should == 'Free'
+    event.location.should == 'Somewhere'
+    event.notes.should == 'None'
+  end
+
+end

data/spec/osm/grouping_spec.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe "Grouping" do
+
+  it "Create" do
+    data = {
+      'patrolid' => 1,
+      'name' => 'Patrol Name',
+      'active' => 1
+    }
+    patrol = Osm::Grouping.new(data)
+
+    patrol.id.should == 1
+    patrol.name.should == 'Patrol Name'
+    patrol.active.should == true
+  end
+
+end

data/spec/osm/member_spec.rb

@@ -0,0 +1,98 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe "Member" do
+
+  it "Create" do
+    data = {
+      'scoutid' => 1,
+      'sectionid' => 2,
+      'type' => '',
+      'firstname' => 'First',
+      'lastname' => 'Last',
+      'email1' => 'email1@example.com',
+      'email2' => 'email2@example.com',
+      'email3' => 'email3@example.com',
+      'email4' => 'email4@example.com',
+      'phone1' => '11111 111111',
+      'phone2' => '222222',
+      'phone3' => '+33 3333 333333',
+      'phone4' => '4444 444 444',
+      'address' => '1 Some Road',
+      'address2' => '',
+      'dob' => '2000-01-02',
+      'started' => '2006-01-02',
+      'joining_in_yrs' => '2',
+      'parents' => 'John and Jane Doe',
+      'notes' => 'None',
+      'medical' => 'Nothing',
+      'religion' => 'Unknown',
+      'school'=> 'Some School',
+      'ethnicity' => 'Yes',
+      'subs' => 'Upto end of 2007',
+      'patrolid' => '3',
+      'patrolleader' => 0,
+      'joined' => '2006-01-07',
+      'age' => '06/07',
+      'yrs' => 1,
+      'patrol' => 'Blue',
+    }
+    member = Osm::Member.new(data)
+
+    member.id.should == 1
+    member.section_id.should == 2
+    member.type.should == ''
+    member.first_name.should == 'First'
+    member.last_name.should == 'Last'
+    member.email1.should == 'email1@example.com'
+    member.email2.should == 'email2@example.com'
+    member.email3.should == 'email3@example.com'
+    member.email4.should == 'email4@example.com'
+    member.phone1.should == '11111 111111'
+    member.phone2.should == '222222'
+    member.phone3.should == '+33 3333 333333'
+    member.phone4.should == '4444 444 444'
+    member.address.should == '1 Some Road'
+    member.address2.should == ''
+    member.date_of_birth.should == Date.new(2000, 1, 2)
+    member.started.should == Date.new(2006, 1, 2)
+    member.joined_in_years.should == 2
+    member.parents.should == 'John and Jane Doe'
+    member.notes.should == 'None'
+    member.medical.should == 'Nothing'
+    member.religion.should == 'Unknown'
+    member.school.should == 'Some School'
+    member.ethnicity.should == 'Yes'
+    member.subs.should == 'Upto end of 2007'
+    member.grouping_id.should == 3
+    member.grouping_leader.should == 0
+    member.joined.should == Date.new(2006, 1, 7)
+    member.age.should == '06/07'
+    member.joined_years.should == 1
+    member.patrol.should == 'Blue'
+  end
+
+
+  it "Provides member's full name" do
+    data = {
+      'firstname' => 'First',
+      'lastname' => 'Last',
+    }
+    member = Osm::Member.new(data)
+
+    member.name.should == 'First Last'
+    member.name('_').should == 'First_Last'
+  end
+
+
+  it "Provides each part of age" do
+    data = {
+      'age' => '06/07',
+    }
+    member = Osm::Member.new(data)
+
+    member.age_years.should == 6
+    member.age_months.should == 7
+  end
+
+end

data/spec/osm/osm_spec.rb

@@ -0,0 +1,82 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'date'
+
+describe "Online Scout Manager" do
+
+  describe "Make array of symbols" do
+    it "turns array of strings to an array of symbols" do
+      start = %w{first second third}
+      Osm::make_array_of_symbols(start).should == [:first, :second, :third]
+    end
+  end
+
+
+  describe "find current term ID" do
+    it "Returns the current term for the section from all terms returned by OSM" do
+      Osm::Api.configure({:api_id=>'1234', :api_token=>'12345678', :api_name=>'API', :api_site=>:scout})
+      api = Osm::Api.new('2345', 'abcd')
+
+      body = '{"9":['
+      body += '{"termid":"1","name":"Term 1","sectionid":"9","startdate":"' + (Date.today - 90).strftime('%Y-%m-%d') + '","enddate":"' + (Date.today - 31).strftime('%Y-%m-%d') + '"},'
+      body += '{"termid":"2","name":"Term 2","sectionid":"9","startdate":"' + (Date.today - 30).strftime('%Y-%m-%d') + '","enddate":"' + (Date.today + 30).strftime('%Y-%m-%d') + '"},'
+      body += '{"termid":"3","name":"Term 3","sectionid":"9","startdate":"' + (Date.today + 31).strftime('%Y-%m-%d') + '","enddate":"' + (Date.today + 90).strftime('%Y-%m-%d') + '"}'
+      body += ']}'
+      FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getTerms", :body => body)
+
+      Osm::find_current_term_id(api, 9).should == 2
+    end
+
+    it "Raises an error if there is no current term" do
+      Osm::Api.configure({:api_id=>'1234', :api_token=>'12345678', :api_name=>'API', :api_site=>:scout})
+      api = Osm::Api.new('2345', 'abcd')
+      section_id = 9
+
+      body = '{"9":['
+      body += '{"termid":"1","name":"Term 1","sectionid":"9","startdate":"' + (Date.today + 31).strftime('%Y-%m-%d') + '","enddate":"' + (Date.today + 90).strftime('%Y-%m-%d') + '"}'
+      body += ']}'
+      FakeWeb.register_uri(:post, "https://www.onlinescoutmanager.co.uk/api.php?action=getTerms", :body => body)
+
+      expect{ Osm::find_current_term_id(api, section_id) }.to raise_error(Osm::Error)
+    end
+  end
+
+
+  describe "Make a DateTime" do
+    it "is given a date and a time" do
+      Osm::make_datetime('2001-02-03', '04:05:06').should == DateTime.new(2001, 02, 03, 04, 05, 06)
+    end
+
+    it "is given just a date" do
+      Osm::make_datetime('2001-02-03', '').should == DateTime.new(2001, 02, 03, 00, 00, 00)
+    end
+
+    it "is given neither" do
+      Osm::make_datetime('', '').should == nil
+    end
+
+    it "is given an invalid date" do
+      Osm::make_datetime('No date here1', '04:05:06').should == nil
+    end
+
+    it "is given an invalid time" do
+      Osm::make_datetime('2001-02-03', 'No time here!').should == nil
+    end
+
+    it "is given just an invalid date" do
+      Osm::make_datetime('No date here1', nil).should == nil
+    end
+  end
+
+
+  describe "Parse a date" do
+    it "is given a valid date string" do
+      Osm::parse_date('2001-02-03').should == Date.new(2001, 02, 03)
+    end
+
+    it "is given an invalid date string" do
+      Osm::parse_date('No date here!').should == nil
+    end
+  end
+
+end

data/spec/osm/programme_activity_spec.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe "Programme Activity" do
+
+  it "Create" do
+    data = {
+      'eveningid' => 1,
+      'activityid' => 2,
+      'title' => 'Activity Name',
+      'notes' => 'Notes',
+    }
+    pa = Osm::ProgrammeActivity.new(data)
+
+    pa.evening_id.should == 1
+    pa.activity_id.should == 2
+    pa.title.should == 'Activity Name'
+    pa.notes.should == 'Notes'
+  end
+
+end

data/spec/osm/programme_item_spec.rb

@@ -0,0 +1,64 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'date'
+
+describe "Programme Item" do
+
+  it "Create" do
+    data = {
+      'eveningid' => 1,
+      'sectionid' => 2,
+      'title' => 'Evening Name',
+      'notesforparents' => 'Notes for parents',
+      'games' => 'Games',
+      'prenotes' => 'Before',
+      'postnotes' => 'After',
+      'leaders' => 'Leaders',
+      'starttime' => '19:00',
+      'endtime' => '21:00',
+      'meetingdate' => '2000-01-02',
+    }
+    pi = Osm::ProgrammeItem.new(data, [])
+
+    pi.evening_id.should == 1
+    pi.section_id.should == 2
+    pi.title.should == 'Evening Name'
+    pi.notes_for_parents.should == 'Notes for parents'
+    pi.games.should == 'Games'
+    pi.pre_notes.should == 'Before'
+    pi.post_notes.should == 'After'
+    pi.leaders.should == 'Leaders'
+    pi.start_time.should == '19:00'
+    pi.end_time.should == '21:00'
+    pi.meeting_date.should == Date.new(2000, 1, 2)
+  end
+
+
+  it "Raises exceptions when trying to set invalid times" do
+    pi = Osm::ProgrammeItem.new({}, [])
+    
+    expect{ pi.start_time = 'abcde' }.to raise_error(ArgumentError)
+    expect{ pi.start_time = '24:00' }.to raise_error(ArgumentError)
+    expect{ pi.start_time = '10:61' }.to raise_error(ArgumentError)
+    pi.start_time = '12:34'
+    pi.start_time.should == '12:34'
+
+    expect{ pi.end_time = 'abcde' }.to raise_error(ArgumentError)
+    expect{ pi.end_time = '24:00' }.to raise_error(ArgumentError)
+    expect{ pi.end_time = '10:61' }.to raise_error(ArgumentError)
+    pi.end_time = '23:45'
+    pi.end_time.should == '23:45'
+  end
+
+
+  it "Makes a list of activities to save for OSM's API" do
+    pi = Osm::ProgrammeItem.new({}, [{
+      'eveningid' => 1,
+      'activityid' => 2,
+      'title' => 'Activity Name',
+      'notes' => 'Notes',
+    }])
+    pi.activities_for_saving.should == '[{"activityid":2,"notes":"Notes"}]'
+  end
+
+end

data/spec/osm/role_spec.rb

@@ -0,0 +1,111 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'date'
+
+
+describe "Role" do
+
+  it "Create" do
+    data = {
+      'sectionid' => 1,
+      'sectionname' => 'A Section',
+      'sectionConfig' => '{}',
+      'groupname' => 'A Group',
+      'groupid' => '2',
+      'groupNormalised' => '3',
+      'isDefault' => '1',
+      'permissions' => {}
+    }
+    role = Osm::Role.new(data)
+
+    role.section.id.should == 1
+    role.section.name.should == 'A Section'
+    role.group_id.should == 2
+    role.group_name.should == 'A Group'
+  end
+
+
+  it "Compares two matching roles" do
+    role1 = Osm::Role.new({'sectionConfig' => '{}'})
+    role2 = Osm::Role.new({'sectionConfig' => '{}'})
+    role1.should == role2
+  end
+
+  it "Compares two non-matching roles" do
+    role1 = Osm::Role.new({'sectionid' => 1, 'sectionConfig' => '{}'})
+    role2 = Osm::Role.new({'sectionid' => 2, 'sectionConfig' => '{}'})
+
+    role1.should_not == role2
+  end
+
+
+  it "Sorts by Group Name then section type (age order)" do
+    role1 = Osm::Role.new({'groupname' => 'Group A', 'sectionConfig' => '{}'})
+    role2 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"beavers"}'})
+    role3 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"cubs"}'})
+    role4 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"scouts"}'})
+    role5 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"explorers"}'})
+    role6 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"waiting"}'})
+    role7 = Osm::Role.new({'groupname' => 'Group B', 'sectionConfig' => '{"sectionType":"adults"}'})
+    role8 = Osm::Role.new({'groupname' => 'Group C', 'sectionConfig' => '{}'})
+
+    data = [role8, role5, role3, role7, role2, role4, role1, role6]
+    data.sort.should == [role1, role2, role3, role4, role5, role6, role7, role8]
+  end
+
+
+  it "Provides a long name for the role" do
+    role = Osm::Role.new({
+      'sectionname' => 'A Section',
+      'sectionConfig' => '{}',
+      'groupname' => 'A Group',
+    })
+    role.long_name.should == 'A Section (A Group)'
+
+    role = Osm::Role.new({
+      'sectionname' => 'A Section',
+      'sectionConfig' => '{}',
+    })
+    role.long_name.should == 'A Section'
+  end
+
+
+  it "Provides a full name for the role" do
+    role = Osm::Role.new({
+      'sectionname' => 'A Section',
+      'sectionConfig' => '{}',
+      'groupname' => 'A Group',
+    })
+    role.full_name.should == 'A Group A Section'
+
+    role = Osm::Role.new({
+      'sectionname' => 'A Section',
+      'sectionConfig' => '{}',
+    })
+    role.full_name.should == 'A Section'
+  end
+
+
+  it "Allows interegation of the permissions hash" do
+    role = Osm::Role.new({
+      'sectionConfig' => '{}',
+      'permissions' => {
+        'read_only' => 10,
+        'read_write' => 20,
+        'administer' => 100
+      }
+    })
+
+    role.can_read?(:read_only).should == true
+    role.can_read?(:read_write).should == true
+    role.can_read?(:administer).should == true
+
+    role.can_write?(:read_only).should == false
+    role.can_write?(:read_write).should == true
+    role.can_write?(:administer).should == true
+
+    role.can_read?(:non_existant).should == false
+    role.can_write?(:non_existant).should == false
+  end
+
+end