stellar 0.1.1 → 0.2.0

data/Gemfile

@@ -4,6 +4,7 @@ source :rubygems
 gem 'mechanize', '>= 2.0.2'
 gem 'nokogiri', '>= 1.5.0'
 
+
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development do
@@ -18,4 +19,7 @@ group :development do
   gem 'ruby-debug19', :platform => :mri_19
 
   gem 'highline', '>= 1.6.2'
+  
+  # MRI 1.9 has JSON in the standard library.
+  gem 'json', :platform => :mri_18
 end

data/Gemfile.lock

@@ -23,19 +23,19 @@ GEM
     net-http-digest_auth (1.1.1)
     net-http-persistent (1.9)
     nokogiri (1.5.0)
-    rake (0.9.2)
+    rake (0.9.2.2)
     rbx-require-relative (0.0.5)
     rcov (0.9.11)
-    rdoc (3.10)
+    rdoc (3.11)
       json (~> 1.4)
-    rspec (2.6.0)
-      rspec-core (~> 2.6.0)
-      rspec-expectations (~> 2.6.0)
-      rspec-mocks (~> 2.6.0)
-    rspec-core (2.6.4)
-    rspec-expectations (2.6.0)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
       diff-lcs (~> 1.1.2)
-    rspec-mocks (2.6.0)
+    rspec-mocks (2.7.0)
     ruby-debug (0.10.4)
       columnize (>= 0.1)
       ruby-debug-base (~> 0.10.4.0)
@@ -53,7 +53,7 @@ GEM
       archive-tar-minitar (>= 0.5.2)
     webrobots (0.0.12)
       nokogiri (>= 1.4.4)
-    yard (0.7.2)
+    yard (0.7.3)
     yard-rspec (0.1)
       yard
 
@@ -64,6 +64,7 @@ DEPENDENCIES
   bundler (>= 1.0.21)
   highline (>= 1.6.2)
   jeweler (>= 1.6.4)
+  json
   mechanize (>= 2.0.2)
   nokogiri (>= 1.5.0)
   rcov

data/Rakefile

@@ -51,6 +51,9 @@ task :spec => :fixtures
 
 krb_file = 'spec/fixtures/kerberos.b64'
 file krb_file do
+  $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+  require 'stellar'
+
   kerberos = {}
   kerberos[:user] = ask('MIT Kerberos Username: ') { |q| q.echo = true }
   kerberos[:pass] = ask('MIT Kerberos Password: ') { |q| q.echo = '*' }

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.2.0

data/lib/stellar.rb

@@ -1,4 +1,5 @@
 # Standard library.
+require 'json'
 require 'openssl'
 require 'uri'
 
@@ -20,4 +21,5 @@ end  # namespace Stellar
 require 'stellar/auth.rb'
 require 'stellar/client.rb'
 require 'stellar/courses.rb'
+require 'stellar/gradebook.rb'
 require 'stellar/homework.rb'

data/lib/stellar/auth.rb

@@ -18,33 +18,24 @@ module Auth
   #     with :user and :pass keys
   # @return [Stellar::Client] self, for convenient method chaining
   def auth(options = {})
-    # Reset any prior credentials.
-    @mech = mech
+    # Create new Mechanize instance to drop any old credentials.
+    
     if options[:cert]
-      log = Logger.new(STDERR)
-      log.level = Logger::INFO
-      @mech.log = log
-      
       key = options[:cert][:key]
-      if key.respond_to?(:to_str)
-        if File.exist?(key)
-          @mech.key = key
-        else
-          @mech.key = OpenSSL::PKey::RSA.new key
-        end
-      else
-        @mech.key = key
+      if key.respond_to?(:to_str) && !File.exist?(key)
+        key = OpenSSL::PKey::RSA.new key
       end
       cert = options[:cert][:cert]
-      if cert.respond_to?(:to_str)
-        if File.exist?(cert)
-          @mech.cert = cert
-        else
-          @mech.cert = OpenSSL::X509::Certificate.new cert
-        end
-      else
-        @mech.cert = cert
+      if cert.respond_to?(:to_str) && !File.exist?(cert)
+        cert = OpenSSL::X509::Certificate.new cert
+      end
+      
+      @mech = mech do |m|
+        m.key = key
+        m.cert = cert
       end
+    else
+      @mech = mech
     end
     
     # Go to a page that is guaranteed to redirect to shitoleth.
@@ -52,28 +43,25 @@ module Auth
     # Fill in the form.
     step1_form = step1_page.form_with :action => /WAYF/
     step1_form.checkbox_with(:name => /perm/).checked = :checked
-    step2_page = step1_form.submit
+    step2_page = step1_form.submit step1_form.buttons.first
     # Click through the stupid confirmation form.
     step2_form = step2_page.form_with :action => /WAYF/
-    cred_page = step2_form.submit
+    cred_page = step2_form.submit step2_form.button_with(:name => /select/i)
     
     # Fill in the credentials form.
     if options[:cert]
       cred_form = cred_page.form_with :action => /certificate/i
       cred_form.checkbox_with(:name => /pref/).checked = :checked
-      puts cred_form
-      puts cred_form.submit(cred_form.buttons.first).body
-      return
     elsif options[:kerberos]
       cred_form = cred_page.form_with :action => /username/i
       cred_form.field_with(:name => /user/).value = options[:kerberos][:user]
       cred_form.field_with(:name => /pass/).value = options[:kerberos][:pass]
     else
-      raise 'Unsupported credentials'
+      raise ArgumentError, 'Unsupported credentials'
     end
     
     # Click through the SAML response form.
-    saml_page = cred_form.submit
+    saml_page = cred_form.submit cred_form.buttons.first
     unless saml_form = saml_page.form_with(:action => /SAML/)
       raise ArgumentError, 'Authentication failed due to invalid credentials'
     end
@@ -101,9 +89,10 @@ module Auth
     # @return [Hash] a Hash with a :cert key (the OpenSSL::X509::Certificate)
     #     and a :key key (the matching OpenSSL::PKey::PKey private key)
     def get_certificate(kerberos)
-      mech = Mechanize.new
-      mech.ca_file = mitca_path
-      mech.user_agent_alias = 'Linux Firefox'
+      mech = Mechanize.new do |m|
+        m.user_agent_alias = 'Linux Firefox'
+        # NOTE: ca.mit.edu uses a Geotrust certificate, not the self-signed one
+      end
       login_page = mech.get 'https://ca.mit.edu/ca/'
       login_form = login_page.form_with :action => /login/
       login_form.field_with(:name => /login/).value = kerberos[:user]

data/lib/stellar/client.rb

@@ -15,10 +15,13 @@ class Client
   end
   
   # New Mechanize instance.
-  def mech
-    m = Mechanize.new
-    m.ca_file = mitca_path
-    m.user_agent_alias = 'Linux Firefox'
+  def mech(&block)
+    m = Mechanize.new do |m|
+      # m.ca_file = mitca_path
+      m.user_agent_alias = 'Linux Firefox'
+      yield m if block
+      m
+    end
     m
   end
 

data/lib/stellar/courses.rb

@@ -107,6 +107,11 @@ class Course
   def homework
     @homework ||= Stellar::HomeworkList.new self
   end
+  
+  # Client scoped to the course's Gradebook module.
+  def gradebook
+    @gradebook ||= Stellar::Gradebook.new self
+  end
 end  # class Stellar::Course
 
 end  # namespace Stellar

data/lib/stellar/gradebook.rb

@@ -0,0 +1,354 @@
+# :nodoc: namespace
+module Stellar
+
+# Stellar client scoped to a course's Gradebook module.
+class Gradebook
+  # Maps the text in navigation links to URI objects.
+  #
+  # Example: navigation['Homework'] => <# URI: .../ >
+  attr_reader :navigation
+  
+  # The course whose Gradebook is exposed by this client.
+  attr_reader :course
+  
+  # Generic Stellar client used to make requests.
+  attr_reader :client
+  
+  # Creates a Stellar client scoped to a course's Gradebook module.
+  #
+  # @param [Stellar::Course] the course whose gradebook is desired
+  def initialize(course)
+    @course = course
+    @client = course.client
+    @url = course.navigation['Gradebook']
+    
+    page = @client.get_nokogiri @url
+    @navigation = Hash[page.css('#toolBox.dashboard dd a').map { |link|
+      [link.inner_text, URI.join(page.url, link['href'])]
+    }]
+  end
+
+  # All assignments in this course's Gradebook module.
+  # @return [Stellar::Gradebook::AssignmentList] list of assignments in this
+  #     gradebook
+  def assignments
+    @assignments ||= Stellar::Gradebook::AssignmentList.new self
+  end  
+
+  # All students in this course's Gradebook module.
+  # @return [Stellar::Gradebook::StudentList] list of students in this gradebook
+  def students
+    @students ||= Stellar::Gradebook::StudentList.new self
+  end  
+
+# Collection of assignments in a course's Gradebook module.
+class AssignmentList
+  # The course's 
+  attr_reader :gradebook
+  
+  # Generic Stellar client used to make requests.
+  attr_reader :client
+  
+  # Creates a list of Gradebook assignments for a class.
+  #
+  # @param [Stellar::Gradebook] gradebook client scoped to a course's Gradebook
+  def initialize(gradebook)
+    @gradebook = gradebook
+    @client = gradebook.client
+    
+    @url = gradebook.navigation['Assignments']
+    reload!
+  end
+  
+  # All assignments in this course's Gradebook module.
+  # @return [Array<Stellar::Gradebook::Assignment>] list of assignments posted
+  #     by this course 
+  def all
+    @assignments
+  end
+  
+  # An assignment in the course's homework module.
+  # @param [String] name the name of the desired assignment
+  # @return [Stellar::Homework] an assignment with the given name, or nil if no
+  #     such assignment exists 
+  def named(name)
+    @assignments.find { |a| a.name == name }
+  end
+  
+  # Reloads the contents of this assignment list.
+  #
+  # @return [Stellar::Gradebook::AssignmentList] self, for easy call chaining
+  def reload!
+    assignment_page = @client.get_nokogiri @url
+    
+    @assignments = assignment_page.css('.gradeTable tbody tr').map { |tr|
+      begin
+        Stellar::Gradebook::Assignment.new tr, self
+      rescue ArgumentError
+        nil
+      end
+    }.reject(&:nil?)
+    
+    self
+  end
+  
+  # Creates a new assignment in the Gradebook.
+  #
+  # @param [String] long_name the assignment's full name
+  # @param [String] short_name a shorter name?
+  # @param [Numeric] max_score maximum score that a student can receive
+  # @param [Time] due_on date when the pset is due
+  # @param [Numeric] weight score weight in total score for the course
+  # @return [Stellar::Gradebook::AssignmentList] self, for easy call chaining
+  def add(long_name, short_name, max_points, due_on = Time.now, weight = nil)
+    add_page = @client.get @gradebook.navigation['Add Assignment']
+    add_form = add_page.form_with :action => /new/i
+    add_form.field_with(:name => /title/i).value = long_name
+    add_form.field_with(:name => /short/i).value = short_name
+    add_form.field_with(:name => /points/i).value = max_points.to_s
+    add_form.field_with(:name => /short/i).value = due_on.strftime('%m.%d.%Y')
+    if weight
+      add_form.field_with(:name => /weight/i).value = weight.to_s
+    end
+    add_form.submit add_form.button_with(:class => /active/)
+    
+    reload!
+  end
+end  # class Stellar::Gradebook::AssignmentList
+
+# One assignment in the Gradebook tab.
+class Assignment
+  # Assignment name.
+  attr_reader :name
+  
+  # URL of the assignment's main page.
+  attr_reader :url
+  
+  # True if the homework was deleted.
+  attr_reader :deleted
+  # True if the homework was deleted.
+  alias_method :deleted?, :deleted
+  
+  # The gradebook that this assignment is in.
+  attr_reader :gradebook
+  
+  # Generic Stellar client used to make requests.
+  attr_reader :client
+  
+  # Creates a submission from a <tr> element in the Gradebook assignments page.
+  #
+  # @param [Nokogiri::XML::Element] tr a <tr> element in the Gradebook
+  #     assignments page describing this assignment
+  # @param [Stellar::Gradebook] gradebook Stellar client scoped to the
+  #     course gradebook containing this assignment
+  def initialize(tr, gradebook)
+    @gradebook = gradebook
+    @client = gradebook.client
+    
+    link = tr.css('a[href*=".html"]').find { |link| link.css('img').empty? }
+    raise ArgumentError, 'Invalid assignment-listing <tr>' unless link
+    @name = link.inner_text
+    @url = URI.join tr.document.url, link['href']
+    
+    page = client.get_nokogiri @url
+    summary_table = page.css('.gradeTable').find do |table|
+      /summary/i =~ table.css('caption').inner_text
+    end
+    raise ArgumentError, 'Invalid assignment-listing <tr>' unless summary_table
+    
+    edit_link = summary_table.css('tbody tr a[href*="edit"]').first
+    raise ArgumentError, 'Invalid assignment-listing <tr>' unless edit_link
+    @edit_url = URI.join @url.to_s, edit_link['href']
+    
+    @deleted = false
+  end
+  
+  # Deletes this assignment from the Gradebook.
+  def delete!
+    return if @deleted
+    
+    edit_page = @client.get @edit_url
+    edit_form = edit_page.form_with :action => /edit/i
+    confirm_page = edit_form.submit edit_form.button_with(:name => /del/i)
+    
+    @deleted = true
+    self
+  end
+end  # class Stellar::Gradebook::Assignment
+
+# Collection of students in a course's Gradebook module.
+class StudentList
+  # The course's 
+  attr_reader :gradebook
+  
+  # Generic Stellar client used to make requests.
+  attr_reader :client
+  
+  # Creates a list of students in a class' Gradebook.
+  #
+  # @param [Stellar::Gradebook] gradebook client scoped to a course's Gradebook
+  def initialize(gradebook)
+    @gradebook = gradebook
+    @client = gradebook.client
+    
+    @url = gradebook.navigation['Students']
+    reload!
+  end
+  
+  # All students listed in this course's Gradebook module.
+  # @return [Array<Stellar::Gradebook::Student>] list of students in this course
+  def all
+    @students
+  end
+  
+  # A student in the course's Gradebook module.
+  # @param [String] name the name of the desired student
+  # @return [Stellar::Gradebook::Student] a student with the given name, or nil
+  #     if no such student exists
+  def named(name)
+    @students.find { |a| a.name == name }
+  end
+
+  # A student in the course's Gradebook module.
+  # @param [String] email the e-mail of the desired student
+  # @return [Stellar::Gradebook::Student] a student with the given e-mail
+  #     address, or nil if no such student exists
+  def with_email(email)
+    @students.find { |a| a.email == email }
+  end
+  
+  # Reloads the contents of this student list.
+  #
+  # @return [Stellar::Gradebook::StudentList] self, for easy call chaining
+  def reload!
+    student_page = @client.get_nokogiri @url
+    
+    data_script = student_page.css('script').find do |script|
+      /var rows\s*\=.*\;/m =~ script.inner_text
+    end
+    data = JSON.parse((/var rows\s*\=([^;]*)\;/m).
+        match(data_script.inner_text)[1].gsub("'", '"'))
+    
+    @students = data.map { |student_line|
+      email = student_line[0]
+      url = URI.join @url.to_s, student_line[1]
+      name = student_line[2].split(',', 2).map(&:strip).reverse.join(' ')
+      
+      begin
+        Stellar::Gradebook::Student.new url, email, name, gradebook
+      rescue ArgumentError
+        nil
+      end
+    }.reject(&:nil?)
+    
+    self
+  end
+end  # class Stellar::Gradebook::StudentsList
+
+# Stellar client scoped to a student's Gradebook page.
+class Student
+  # The student's full name.
+  attr_reader :name
+  
+  # The student's e-mail.
+  attr_reader :email
+
+  # URL of the student's page of grades in the Gradebook.
+  attr_reader :url
+  
+  # The course Gradebook that this student entry belongs to.
+  attr_reader :gradebook
+  
+  # Generic Stellar client used to make requests.
+  attr_reader :client
+  
+  # Creates a Stellar client scoped to a student's Gradebook page.
+  #
+  # @param [URI] url URL to the student's grade page
+  # @param [Stellar::Gradebook] gradebook Stellar client scoped to the
+  #     course gradebook containing this assignment
+  def initialize(url, email, name, gradebook)
+    @url = url
+    @email = email
+    @name = name
+    @gradebook = gradebook
+    @client = gradebook.client
+    
+    @grades = nil
+    @input_names = nil
+    @comment = nil
+  end
+  
+  # The student's grades for all assignments.
+  #
+  # @return [Hash] map between assignment names and the student's scores
+  def grades
+    reload! unless @grades
+    @grades
+  end
+  
+  # The instructor's comment for the student.
+  #
+  # @return [String] the content of the comment
+  def comment
+    reload! unless @comment
+    @comment
+  end
+  
+  # Reloads the information in the student's grades page.
+  #
+  # @return [Stellar::Gradebook::Student] self, for easy call chaining
+  def reload!
+    page = @client.get_nokogiri @url
+
+    @grades = {}
+    @input_names = {} 
+    page.css('.gradeTable tbody tr').each do |tr|
+      name = tr.css('a[href*="assignment"]').inner_text
+      input_field = tr.css('input[type="text"][name*="oints"]').first
+      @input_names[name] = input_field['name']
+      @grades[name] = input_field['value'].empty? ? nil :
+          input_field['value'].to_f
+    end
+    @comment = page.css('textarea[name*="comment"]').inner_text
+    
+    self
+  end
+  
+  # Changes some of the student's grades.
+  #
+  # @param [Hash] new_grades maps assignment names to the desired scores 
+  # @return [Stellar::Gradebook::Student] self, for easy call chaining
+  def update_grades(new_grades)
+    reload! unless @input_names
+    
+    page = @client.get @url
+    grade_form = page.form_with :action => /detail/i
+    new_grades.each do |assignment_name, new_grade|
+      unless input_name = @input_names[assignment_name]
+        raise ArgumentError, "Invalid assignment #{assignment_name}"
+      end
+      grade_form.field_with(:name => input_name).value = new_grade.to_s
+    end
+    grade_form.submit grade_form.button_with(:class => /save/)
+    
+    reload!
+  end
+  
+  # Changes the comment on the student's grades page.
+  #
+  # @param [String] text the new comment text
+  # @return [Stellar::Gradebook::Student] self, for easy call chaining
+  def update_comment(text)
+    page = @client.get @url
+    grade_form = page.form_with :action => /detail/i
+    grade_form.field_with(:name => /comment/i).value = text
+    grade_form.submit grade_form.button_with(:class => /save/)
+    
+    reload!
+  end
+end  # class Stellar::Gradebook::Assignment::Student
+
+end  # class Stellar::Gradebook
+
+end  # namespace Stellar

data/lib/stellar/homework.rb

@@ -29,8 +29,10 @@ class HomeworkList
     @assignments
   end
   
-  # All assignments in this course's homework module.
-  # @return [Array<Stellar::Homework>] list of assignments posted by this course 
+  # An assignment in the course's homework module.
+  # @param [String] name the name of the desired assignment
+  # @return [Stellar::Homework] an assignment with the given name, or nil if no
+  #     such assignment exists 
   def named(name)
     @assignments.find { |a| a.name == name }
   end
@@ -98,9 +100,14 @@ class Submission
   
   # Creates a submission from a <tr> element in the Stellar homework page.
   #
-  # @param [Nokogiri::XML::Element]
+  # @param [Nokogiri::XML::Element] tr a <tr> element in the Stellar homework
+  #     page describing this submission
+  # @param [Stellar::Homework] homework Stellar client scoped to the assignment
+  #     that this submission is for  
   def initialize(tr, homework)
-    link = tr.css('a').find { |link| /submission\s+details/ =~ link.inner_text }
+    link = tr.css('a').find do |link|
+      (/^\s*\d+\s*$/ =~ link.inner_text) && !(/grade/ =~ link['href'])
+    end
     raise ArgumentError, 'Invalid submission-listing <tr>' unless link
 
     @url = URI.join tr.document.url, link['href']
@@ -185,6 +192,12 @@ class Comment
   # Generic Stellar client used to make requests.
   attr_reader :client
   
+  # Creates a comment from a <table> in a Stellar submission details page.
+  #
+  # @param [Nokogiri::XML::Element] table a <table> element in a Stellar
+  #     submission details showing this comment
+  # @param [Stellar::Homework::Submission] submission Stellar client scoped to
+  #     the submission that was commented on
   def initialize(table, submission)
     @submission = submission
     @client = @submission.client

data/spec/stellar/client_spec.rb

@@ -36,7 +36,9 @@ describe Stellar::Client do
 
     describe 'with bad Kerberos credentials' do
       it 'should raise ArgumentError' do
-        client.auth :kerberos => test_mit_kerberos.merge(:pass => 'fail')
+        lambda {
+          client.auth :kerberos => test_mit_kerberos.merge(:pass => 'fail')
+        }.should raise_error(ArgumentError)
       end
     end
   end

data/spec/stellar/gradebook_spec.rb

@@ -0,0 +1,100 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Stellar::Gradebook do
+  before :all do
+    @gradebook = test_client.course("6.006", 2011, :fall).gradebook
+  end
+  
+  describe '#navigation' do
+    it 'should have an Assignments section' do
+      @gradebook.navigation['Assignments'].should be_kind_of(URI)
+    end
+    
+    it 'should have an Add Assignment section' do
+      @gradebook.navigation['Add Assignment'].should be_kind_of(URI)
+    end
+
+    it 'should have a Students section' do
+      @gradebook.navigation['Students'].should be_kind_of(URI)
+    end
+  end
+  
+  let(:assignments) { @gradebook.assignments }
+
+  describe '#assignments' do    
+    describe '#all' do
+      it 'should have at least one assignment' do
+        assignments.all.should have_at_least(1).assignment
+      end
+      
+      it 'should have an assignment named Quiz 1' do
+        assignments.named('Quiz 1').
+                    should be_kind_of(Stellar::Gradebook::Assignment)
+      end
+    end
+  end
+  
+  describe '#add_assignment' do
+    before do
+      @old_length = assignments.all.length
+      assignments.add 'RSpec Test PS', 'rspec-test', 42,
+          Time.now + 5, 1.01
+    end
+    
+    after do
+      assignment = assignments.named('RSpec Test PS')
+      assignment.delete!
+    end
+    
+    it 'should create a new assignment' do
+      assignments.all.length.should == 1 + @old_length
+    end
+
+    it 'should create an assignment with the right name' do
+      assignments.named('RSpec Test PS').
+                  should be_kind_of(Stellar::Gradebook::Assignment)
+    end
+  end
+  
+  describe Stellar::Gradebook::Assignment do
+    before do
+      assignments.add 'RSpec Test PS', 'rspec-test',
+          42, Time.now + 5, 1.01
+      @assignment = assignments.named 'RSpec Test PS'
+    end
+    
+    after { @assignment.delete! }
+    
+    it 'should have a name' do
+      @assignment.name.should == 'RSpec Test PS'
+    end
+    
+    it 'should have an URL' do
+      @assignment.url.should be_kind_of(URI)
+    end
+    
+    it 'should not be deleted' do
+      @assignment.should_not be_deleted
+    end
+    
+    describe '#delete!' do
+      before do
+        @old_length = assignments.all.length
+        @assignment.delete!
+        assignments.reload!
+      end
+      
+      it 'should remove an assignment' do
+        assignments.all.length.should == @old_length - 1
+      end
+      
+      it 'should remove the correct assignment' do
+        assignments.named('RSpec Test PS').should be_nil
+      end
+      
+      it 'should mark the assignment deleted' do
+        @assignment.should be_deleted
+      end
+    end
+  end
+end

data/spec/stellar/gradebook_student_spec.rb

@@ -0,0 +1,105 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Stellar::Gradebook do
+  before :all do
+    @gradebook = test_client.course("6.006", 2011, :fall).gradebook
+    @gradebook.assignments.add 'RSpec Test PS', 'rspec-test', 42
+    @assignment = @gradebook.assignments.named('RSpec Test PS')
+  end
+  
+  after :all do
+    @assignment.delete!
+  end
+  
+  let(:test_name) { 'Christianne Swartz' }
+  let(:test_email) { 'ude.tim@ytsirhc'.reverse }
+  
+  describe '#students' do
+    describe '#all' do
+      let(:all) { @gradebook.students.all }
+      
+      it 'should have at least 1 student' do
+        all.should have_at_least(1).student
+      end
+      
+      it 'should only contain Student instances' do
+        all.each do |student|
+          student.should be_kind_of(Stellar::Gradebook::Student)
+        end
+      end
+    end
+    
+    shared_examples_for 'a student query' do
+      it 'should return a student' do
+        student.should be_kind_of(Stellar::Gradebook::Student)
+      end
+      
+      it 'should return a student with the correct name' do
+        student.name.should == test_name
+      end
+      
+      it 'should return a student with the correct email' do
+        student.email.should == test_email
+      end
+    end
+    
+    describe '#named' do
+      let(:student) { @gradebook.students.named test_name }
+      
+      it_should_behave_like 'a student query'
+    end
+    
+    describe '#with_email' do
+      let(:student) { @gradebook.students.with_email test_email }
+
+      it_should_behave_like 'a student query'
+    end
+  end
+  
+  describe Stellar::Gradebook::Student do
+    let(:student) { @gradebook.students.named test_name }
+
+    describe '#grades' do
+      let(:grades) { student.grades }
+      
+      it 'should have a score for the test assignment' do
+        grades.should have_key('RSpec Test PS')
+      end
+
+      it 'should have an empty score for the test assignment' do
+        grades['RSpec Test PS'].should be_nil
+      end
+    end
+    
+    describe '#comment' do
+      it 'should be some string' do
+        student.comment.should be_kind_of(String)
+      end
+    end
+    
+    describe '#update_grades' do
+      before do
+        student.update_grades 'RSpec Test PS' => 41.59
+      end
+      
+      it 'should store the right grade' do
+        student.grades['RSpec Test PS'].should == 41.59
+      end
+    end  
+
+    describe '#update_comment' do
+      before do
+        @old_comment = student.comment
+        student.update_comment 'RSpec Test Comment'
+      end
+      
+      after do
+        student.update_comment @old_comment
+      end
+      
+      it 'should store the right comment' do
+        student.comment.should == 'RSpec Test Comment'
+      end
+    end  
+  end
+end

data/stellar.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "stellar"
-  s.version = "0.1.1"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Victor Costan"]
-  s.date = "2011-10-16"
+  s.date = "2011-10-28"
   s.description = "So we don't have to put up with Stellar's craptastic ui"
   s.email = "victor@costan.us"
   s.extra_rdoc_files = [
@@ -30,6 +30,7 @@ Gem::Specification.new do |s|
     "lib/stellar/auth.rb",
     "lib/stellar/client.rb",
     "lib/stellar/courses.rb",
+    "lib/stellar/gradebook.rb",
     "lib/stellar/homework.rb",
     "lib/stellar/mitca.crt",
     "spec/fixtures/.gitkeep",
@@ -37,6 +38,8 @@ Gem::Specification.new do |s|
     "spec/stellar/auth_spec.rb",
     "spec/stellar/client_spec.rb",
     "spec/stellar/courses_spec.rb",
+    "spec/stellar/gradebook_spec.rb",
+    "spec/stellar/gradebook_student_spec.rb",
     "spec/stellar/homework_spec.rb",
     "spec/stellar/homework_submissions_spec.rb",
     "spec/stellar_spec.rb",
@@ -65,6 +68,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<ruby-debug>, [">= 0"])
       s.add_development_dependency(%q<ruby-debug19>, [">= 0"])
       s.add_development_dependency(%q<highline>, [">= 1.6.2"])
+      s.add_development_dependency(%q<json>, [">= 0"])
     else
       s.add_dependency(%q<mechanize>, [">= 2.0.2"])
       s.add_dependency(%q<nokogiri>, [">= 1.5.0"])
@@ -78,6 +82,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<ruby-debug>, [">= 0"])
       s.add_dependency(%q<ruby-debug19>, [">= 0"])
       s.add_dependency(%q<highline>, [">= 1.6.2"])
+      s.add_dependency(%q<json>, [">= 0"])
     end
   else
     s.add_dependency(%q<mechanize>, [">= 2.0.2"])
@@ -92,6 +97,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<ruby-debug>, [">= 0"])
     s.add_dependency(%q<ruby-debug19>, [">= 0"])
     s.add_dependency(%q<highline>, [">= 1.6.2"])
+    s.add_dependency(%q<json>, [">= 0"])
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stellar
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-16 00:00:00.000000000Z
+date: 2011-10-28 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
-  requirement: &15419440 !ruby/object:Gem::Requirement
+  requirement: &19824800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 2.0.2
   type: :runtime
   prerelease: false
-  version_requirements: *15419440
+  version_requirements: *19824800
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &15418740 !ruby/object:Gem::Requirement
+  requirement: &19823840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 1.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *15418740
+  version_requirements: *19823840
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &15418020 !ruby/object:Gem::Requirement
+  requirement: &19812300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 3.9.4
   type: :development
   prerelease: false
-  version_requirements: *15418020
+  version_requirements: *19812300
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &15413920 !ruby/object:Gem::Requirement
+  requirement: &19811720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 2.6.0
   type: :development
   prerelease: false
-  version_requirements: *15413920
+  version_requirements: *19811720
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &15413080 !ruby/object:Gem::Requirement
+  requirement: &19811080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: 0.7.2
   type: :development
   prerelease: false
-  version_requirements: *15413080
+  version_requirements: *19811080
 - !ruby/object:Gem::Dependency
   name: yard-rspec
-  requirement: &15412400 !ruby/object:Gem::Requirement
+  requirement: &19810280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0.1'
   type: :development
   prerelease: false
-  version_requirements: *15412400
+  version_requirements: *19810280
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &15411660 !ruby/object:Gem::Requirement
+  requirement: &19809620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: 1.0.21
   type: :development
   prerelease: false
-  version_requirements: *15411660
+  version_requirements: *19809620
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &15410740 !ruby/object:Gem::Requirement
+  requirement: &19809040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +98,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *15410740
+  version_requirements: *19809040
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &15409860 !ruby/object:Gem::Requirement
+  requirement: &19808300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -109,10 +109,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15409860
+  version_requirements: *19808300
 - !ruby/object:Gem::Dependency
   name: ruby-debug
-  requirement: &15409140 !ruby/object:Gem::Requirement
+  requirement: &19806780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -120,10 +120,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15409140
+  version_requirements: *19806780
 - !ruby/object:Gem::Dependency
   name: ruby-debug19
-  requirement: &15408460 !ruby/object:Gem::Requirement
+  requirement: &19805900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -131,10 +131,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *15408460
+  version_requirements: *19805900
 - !ruby/object:Gem::Dependency
   name: highline
-  requirement: &15406380 !ruby/object:Gem::Requirement
+  requirement: &19804800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -142,7 +142,18 @@ dependencies:
         version: 1.6.2
   type: :development
   prerelease: false
-  version_requirements: *15406380
+  version_requirements: *19804800
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &19793180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *19793180
 description: So we don't have to put up with Stellar's craptastic ui
 email: victor@costan.us
 executables: []
@@ -164,6 +175,7 @@ files:
 - lib/stellar/auth.rb
 - lib/stellar/client.rb
 - lib/stellar/courses.rb
+- lib/stellar/gradebook.rb
 - lib/stellar/homework.rb
 - lib/stellar/mitca.crt
 - spec/fixtures/.gitkeep
@@ -171,6 +183,8 @@ files:
 - spec/stellar/auth_spec.rb
 - spec/stellar/client_spec.rb
 - spec/stellar/courses_spec.rb
+- spec/stellar/gradebook_spec.rb
+- spec/stellar/gradebook_student_spec.rb
 - spec/stellar/homework_spec.rb
 - spec/stellar/homework_submissions_spec.rb
 - spec/stellar_spec.rb
@@ -191,7 +205,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -746749934758506157
+      hash: -1478260872774288007
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: