clever 1.2.5 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2aa09c7aac824c85190007ac587d840a2a1a6405
-  data.tar.gz: 5215165a0770691ab4cdd48e48c5d24cd8f94728
+  metadata.gz: eadea65a93fb58c3c03e4669c9eee742a4d0ca3b
+  data.tar.gz: 5cf08d8b4e9c9aa374b522e448ef867fc95db0f6
 SHA512:
-  metadata.gz: 2eb28ef44305ad1b53cf35a9e182c5f8673b24aa14363a6c84ff8a70399ff4a3cdd0b918ee144399b00222ffdd41ed464a19304f4a591b2aa644b8e79c9cf0f2
-  data.tar.gz: 9c518d83cda43403f90d35eef8c853b845584234dab8c6d8c7d846b02656b2238cbc3d311442115dc1cf41a9448827dee0cac2578b46a556742fcf98fb54c9c3
+  metadata.gz: 8d8ba0401e1c2076e71b8e633a53d2e388a72b1e4c1bd49ac01d1792e0801002c12d743578be42ba75deacd96355f80c5a4584a49aa6e40ca50e19352de6fed5
+  data.tar.gz: 55e3247234f4b6612f6ee9dd90c16773608b5c042042e323f562446341e5f8226cdd582a98c198814a3ad36b94d3c49eb60e1fc661cb55c47ec9e324af258dad

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    clever (1.2.5)
+    clever (2.3.0)
       faraday
       faraday_middleware
 

data/lib/clever.rb

@@ -17,6 +17,7 @@ require 'clever/types/event'
 require 'clever/types/student'
 require 'clever/types/section'
 require 'clever/types/teacher'
+require 'clever/types/term'
 require 'clever/types/token'
 
 module Clever
@@ -27,6 +28,7 @@ module Clever
   SECTIONS_ENDPOINT = '/v2.0/sections'
   TEACHERS_ENDPOINT = '/v2.0/teachers'
   EVENTS_ENDPOINT   = '/v1.2/events'
+  TERMS_ENDPOINT    = '/v2.0/terms'
   GRADES_ENDPOINT   = 'https://grades-api.beta.clever.com/v1/grade'
 
   class DistrictNotFound < StandardError; end

data/lib/clever/client.rb

@@ -54,7 +54,7 @@ module Clever
       Paginator.fetch(connection, endpoint, :get, Types::Event, client: self).force
     end
 
-    %i(students courses teachers sections).each do |record_type|
+    %i(students courses teachers sections terms).each do |record_type|
       define_method(record_type) do |record_uids = []|
         authenticate
 
@@ -75,14 +75,21 @@ module Clever
 
       fetched_courses = courses
 
+      terms_hash = terms.each_with_object({}) { |term, terms| terms[term.uid] = term  }
+
       sections.map do |section|
         course = fetched_courses.find { |clever_course| clever_course.uid == section.course }
+        term = terms_hash[section.term_id]
         Types::Classroom.new(
           'id' => section.uid,
           'name' => section.name,
           'period' => section.period,
           'course_number' => course&.number,
-          'grades' => section.grades
+          'grades' => section.grades,
+          'subjects' => section.subjects,
+          'term_name' => term&.name,
+          'term_start_date' => term&.start_date,
+          'term_end_date' => term&.end_date
         )
       end
     end
@@ -129,7 +136,8 @@ module Clever
       section.teachers.each do |teacher_uid|
         enrollments[:teacher] << Types::Enrollment.new(
           'classroom_uid' => section.uid,
-          'user_uid' => teacher_uid
+          'user_uid' => teacher_uid,
+          'primary' => section.primary_teacher_uid == teacher_uid
         )
       end
     end

data/lib/clever/types/base.rb

@@ -10,6 +10,14 @@ module Clever
           variables[key] = value
         end
       end
+
+      def presence(field)
+        field unless blank?(field)
+      end
+
+      def blank?(field)
+        field.nil? || field == ''
+      end
     end
   end
 end

data/lib/clever/types/classroom.rb

@@ -8,15 +8,23 @@ module Clever
                   :period,
                   :course_number,
                   :grades,
-                  :provider
+                  :subjects,
+                  :provider,
+                  :term_name,
+                  :term_start_date,
+                  :term_end_date
 
       def initialize(attributes = {}, *)
-        @uid           = attributes['id']
-        @name          = attributes['name']
-        @period        = attributes['period']
-        @course_number = attributes['course_number']
-        @grades        = attributes['grades']
-        @provider      = 'clever'
+        @uid             = attributes['id']
+        @name            = attributes['name']
+        @period          = attributes['period']
+        @course_number   = attributes['course_number']
+        @grades          = attributes['grades']
+        @subjects        = attributes['subjects']
+        @term_name       = attributes['term_name']
+        @term_start_date = attributes['term_start_date']
+        @term_end_date   = attributes['term_end_date']
+        @provider        = 'clever'
       end
     end
   end

data/lib/clever/types/enrollment.rb

@@ -5,12 +5,14 @@ module Clever
     class Enrollment < Base
       attr_reader :classroom_uid,
                   :user_uid,
-                  :provider
+                  :provider,
+                  :primary
 
       def initialize(attributes = {})
-        @classroom_uid = attributes['classroom_uid']
-        @user_uid      = attributes['user_uid']
-        @provider      = 'clever'
+        @classroom_uid   = attributes['classroom_uid']
+        @user_uid        = attributes['user_uid']
+        @provider        = 'clever'
+        @primary         = attributes.dig('primary') || false
       end
     end
   end

data/lib/clever/types/section.rb

@@ -8,19 +8,25 @@ module Clever
                   :period,
                   :course,
                   :grades,
+                  :subjects,
                   :students,
                   :teachers,
-                  :provider
+                  :term_id,
+                  :provider,
+                  :primary_teacher_uid
 
       def initialize(attributes = {}, *)
-        @uid      = attributes['id']
-        @name     = attributes['name']
-        @period   = attributes['period']
-        @course   = attributes['course']
-        @grades   = attributes['grade']
-        @students = attributes['students']
-        @teachers = attributes['teachers']
-        @provider = 'clever'
+        @uid                 = attributes['id']
+        @name                = attributes['name']
+        @period              = attributes['period']
+        @course              = attributes['course']
+        @grades              = [presence(attributes['grade'])].compact
+        @subjects            = [presence(attributes['subject'])].compact
+        @students            = attributes['students']
+        @teachers            = attributes['teachers']
+        @term_id             =  attributes['term_id']
+        @provider            = 'clever'
+        @primary_teacher_uid = attributes['teacher']
       end
     end
   end

data/lib/clever/types/student.rb

@@ -37,14 +37,6 @@ module Clever
 
       private
 
-      def presence(field)
-        field unless blank?(field)
-      end
-
-      def blank?(field)
-        field.nil? || field == ''
-      end
-
       def username_from(username_source)
         return if blank?(username_source)
 

data/lib/clever/types/term.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Clever
+  module Types
+    class Term < Base
+      attr_reader :uid,
+                  :name,
+                  :start_date,
+                  :end_date
+
+      def initialize(attributes = {}, *)
+        @uid        = attributes['id']
+        @name       = attributes['name']
+        @start_date = attributes['start_date']
+        @end_date   = attributes['end_date']
+      end
+    end
+  end
+end

data/lib/clever/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Clever
-  VERSION = '1.2.5'
+  VERSION = '2.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clever
 version: !ruby/object:Gem::Version
-  version: 1.2.5
+  version: 2.3.0
 platform: ruby
 authors:
 - Robert Julius
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-05-15 00:00:00.000000000 Z
+date: 2020-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -200,6 +200,7 @@ files:
 - lib/clever/types/section.rb
 - lib/clever/types/student.rb
 - lib/clever/types/teacher.rb
+- lib/clever/types/term.rb
 - lib/clever/types/token.rb
 - lib/clever/version.rb
 homepage: https://github.com/tci/clever
@@ -223,7 +224,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.6.13
 signing_key: 
 specification_version: 4
 summary: Wrapper for the Clever API.