canvaslms-cli 1.3.3 → 1.4.0

package/commands/grades.js

@@ -1,205 +1,201 @@
-/**
- * Grades command
- */
-
-const { makeCanvasRequest } = require('../lib/api-client');
-const { createReadlineInterface, askQuestion } = require('../lib/interactive');
-
-async function showGrades(courseId, options) {
-  const rl = createReadlineInterface();
-  
-  try {
-    if (courseId) {
-      // Get grades for specific course with assignment details
-      await showCourseGrades(courseId, options, rl);
-    } else {
-      // Interactive course selection for grades
-      await showInteractiveGrades(options, rl);
-    }
-    
-  } catch (error) {
-    console.error('Error fetching grades:', error.message);
-    process.exit(1);
-  } finally {
-    rl.close();
-  }
-}
-
-async function showCourseGrades(courseId, options, rl) {
-  // Get course details
-  const course = await makeCanvasRequest('get', `courses/${courseId}`);
-  
-  // Get overall enrollment grades
-  const enrollments = await makeCanvasRequest('get', `courses/${courseId}/enrollments`, [
-    'user_id=self', 
-    'include[]=grades'
-  ]);
-  
-  if (!enrollments || enrollments.length === 0) {
-    console.log('No enrollment found for this course.');
-    return;
-  }
-  
-  const enrollment = enrollments[0];
-  
-  console.log(`\n📚 Grades for: ${course.name}`);
-  console.log(`📊 Course Overview:`);
-  console.log(`   Current Score: ${enrollment.grades?.current_score || 'N/A'}%`);
-  console.log(`   Final Score: ${enrollment.grades?.final_score || 'N/A'}%`);
-  console.log(`   Current Grade: ${enrollment.grades?.current_grade || 'N/A'}`);
-  console.log(`   Final Grade: ${enrollment.grades?.final_grade || 'N/A'}`);
-  
-  // Get assignment grades
-  console.log('\n📝 Loading assignment grades...');
-  const assignments = await makeCanvasRequest('get', `courses/${courseId}/assignments`, [
-    'include[]=submission',
-    'order_by=due_at',
-    'per_page=100'
-  ]);
-  
-  if (!assignments || assignments.length === 0) {
-    console.log('No assignments found for this course.');
-    return;
-  }
-  
-  // Filter assignments with grades
-  const gradedAssignments = assignments.filter(assignment => {
-    const submission = assignment.submission;
-    return submission && (
-      submission.score !== null || 
-      submission.excused || 
-      submission.missing ||
-      submission.grade
-    );
-  });
-  
-  if (gradedAssignments.length === 0) {
-    console.log('No graded assignments found.');
-    return;
-  }
-  
-  console.log(`\n📋 Assignment Grades (${gradedAssignments.length} graded):`);
-  gradedAssignments.forEach((assignment, index) => {
-    const submission = assignment.submission;
-    let gradeDisplay = '';
-    let gradeColor = '';
-    
-    if (submission.score !== null && submission.score !== undefined) {
-      const score = submission.score % 1 === 0 ? Math.round(submission.score) : submission.score;
-      const total = assignment.points_possible || 0;
-      gradeDisplay = `${score}/${total} pts`;
-      
-      // Color coding based on percentage
-      if (total > 0) {
-        const percentage = (submission.score / total) * 100;
-        if (percentage >= 90) gradeColor = '\x1b[32m'; // Green
-        else if (percentage >= 80) gradeColor = '\x1b[36m'; // Cyan
-        else if (percentage >= 70) gradeColor = '\x1b[33m'; // Yellow
-        else if (percentage >= 60) gradeColor = '\x1b[35m'; // Magenta
-        else gradeColor = '\x1b[31m'; // Red
-      }
-      
-      // Add letter grade if available
-      if (submission.grade && isNaN(submission.grade)) {
-        gradeDisplay = `${submission.grade} (${gradeDisplay})`;
-      }
-    } else if (submission.excused) {
-      gradeDisplay = 'Excused';
-      gradeColor = '\x1b[34m'; // Blue
-    } else if (submission.missing) {
-      gradeDisplay = 'Missing';
-      gradeColor = '\x1b[31m'; // Red
-    }
-    
-    console.log(`${index + 1}. ${assignment.name}`);
-    console.log(`   Grade: ${gradeColor}${gradeDisplay}\x1b[0m`);
-    
-    if (submission.submitted_at) {
-      console.log(`   Submitted: ${new Date(submission.submitted_at).toLocaleDateString()}`);
-    }
-    
-    if (assignment.due_at) {
-      console.log(`   Due: ${new Date(assignment.due_at).toLocaleDateString()}`);
-    }
-    
-    if (options.verbose && submission.grader_comments) {
-      console.log(`   Comments: ${submission.grader_comments}`);
-    }
-    
-    console.log('');
-  });
-}
-
-async function showInteractiveGrades(options, rl) {
-  // Get all courses with enrollment information
-  const courses = await makeCanvasRequest('get', 'courses', [
-    'enrollment_state=active',
-    'include[]=enrollments',
-    'include[]=favorites',
-    'include[]=total_scores'
-  ]);
-  
-  if (!courses || courses.length === 0) {
-    console.log('No courses found.');
-    return;
-  }
-  
-  // Show courses overview first
-  console.log('📊 Grades Overview:\n');
-  
-  const coursesWithGrades = courses.filter(course => 
-    course.enrollments && course.enrollments.length > 0
-  );
-  
-  console.log(`Found ${coursesWithGrades.length} enrolled course(s):\n`);
-  
-  coursesWithGrades.forEach((course, index) => {
-    const starIcon = course.is_favorite ? '⭐ ' : '';
-    console.log(`${index + 1}. ${starIcon}${course.name}`);
-    
-    if (course.enrollments && course.enrollments.length > 0) {
-      const enrollment = course.enrollments[0];
-      if (enrollment.grades) {
-        const currentScore = enrollment.grades.current_score;
-        const currentGrade = enrollment.grades.current_grade;
-        
-        // Color code the grade
-        let gradeColor = '\x1b[90m'; // Gray default
-        if (currentScore !== null && currentScore !== undefined) {
-          if (currentScore >= 90) gradeColor = '\x1b[32m'; // Green
-          else if (currentScore >= 80) gradeColor = '\x1b[36m'; // Cyan
-          else if (currentScore >= 70) gradeColor = '\x1b[33m'; // Yellow
-          else if (currentScore >= 60) gradeColor = '\x1b[35m'; // Magenta
-          else gradeColor = '\x1b[31m'; // Red
-        }
-        
-        console.log(`   Current: ${gradeColor}${currentScore || 'N/A'}% (${currentGrade || 'N/A'})\x1b[0m`);
-      } else {
-        console.log(`   Current: \x1b[90mGrades not available\x1b[0m`);
-      }
-    }
-    console.log('');
-  });
-  
-  // Ask if user wants to see detailed grades for a specific course
-  const viewDetailed = await askQuestion(rl, 'View detailed grades for a specific course? (Y/n): ');
-  
-  if (viewDetailed.toLowerCase() === 'n' || viewDetailed.toLowerCase() === 'no') {
-    return;
-  }
-  
-  const courseChoice = await askQuestion(rl, '\nEnter course number for detailed grades: ');
-  const courseIndex = parseInt(courseChoice) - 1;
-  
-  if (courseIndex >= 0 && courseIndex < coursesWithGrades.length) {
-    const selectedCourse = coursesWithGrades[courseIndex];
-    console.log(`\n✅ Selected: ${selectedCourse.name}`);
-    await showCourseGrades(selectedCourse.id, options, rl);
-  } else {
-    console.log('Invalid course selection.');
-  }
-}
-
-module.exports = {
-  showGrades
-};
+/**
+ * Grades command
+ */
+
+import { makeCanvasRequest } from '../lib/api-client.js';
+import { createReadlineInterface, askQuestion } from '../lib/interactive.js';
+import chalk from 'chalk';
+
+export async function showGrades(courseId, options) {
+  const rl = createReadlineInterface();
+  
+  try {
+    if (courseId) {
+      // Get grades for specific course with assignment details
+      await showCourseGrades(courseId, options, rl);
+    } else {
+      // Interactive course selection for grades
+      await showInteractiveGrades(options, rl);
+    }
+    
+  } catch (error) {
+    console.error(chalk.red('Error fetching grades: ') + error.message);
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+async function showCourseGrades(courseId, options, rl) {
+  // Get course details
+  const course = await makeCanvasRequest('get', `courses/${courseId}`);
+  
+  // Get overall enrollment grades
+  const enrollments = await makeCanvasRequest('get', `courses/${courseId}/enrollments`, [
+    'user_id=self', 
+    'include[]=grades'
+  ]);
+  
+  if (!enrollments || enrollments.length === 0) {
+    console.log(chalk.red('Error: No enrollment found for this course.'));
+    return;
+  }
+  
+  const enrollment = enrollments[0];
+  
+  console.log(chalk.cyan.bold('\n' + '-'.repeat(60)));
+  console.log(chalk.cyan.bold('Grades for: ') + course.name);
+  console.log(chalk.cyan('-'.repeat(60)));
+  console.log(chalk.white('Course Overview:'));
+  console.log(chalk.white('   Current Score: ') + (enrollment.grades?.current_score || 'N/A') + '%');
+  console.log(chalk.white('   Final Score: ') + (enrollment.grades?.final_score || 'N/A') + '%');
+  console.log(chalk.white('   Current Grade: ') + (enrollment.grades?.current_grade || 'N/A'));
+  console.log(chalk.white('   Final Grade: ') + (enrollment.grades?.final_grade || 'N/A'));
+  
+  // Get assignment grades
+  console.log(chalk.cyan('\nLoading assignment grades...'));
+  const assignments = await makeCanvasRequest('get', `courses/${courseId}/assignments`, [
+    'include[]=submission',
+    'order_by=due_at',
+    'per_page=100'
+  ]);
+  
+  if (!assignments || assignments.length === 0) {
+    console.log(chalk.yellow('No assignments found for this course.'));
+    return;
+  }
+  
+  // Filter assignments with grades
+  const gradedAssignments = assignments.filter(assignment => {
+    const submission = assignment.submission;
+    return submission && (
+      submission.score !== null || 
+      submission.excused || 
+      submission.missing ||
+      submission.grade
+    );
+  });
+  
+  if (gradedAssignments.length === 0) {
+    console.log(chalk.yellow('No graded assignments found.'));
+    return;
+  }
+  
+  console.log(chalk.green('Success: Grades loaded.'));
+  console.log(chalk.cyan.bold('\n' + '-'.repeat(60)));
+  console.log(chalk.cyan.bold(`Assignment Grades (${gradedAssignments.length} graded):`));
+  console.log(chalk.cyan('-'.repeat(60)));
+  gradedAssignments.forEach((assignment, index) => {
+    const submission = assignment.submission;
+    let gradeDisplay = '';
+    let gradeColor = chalk.white;
+    
+    if (submission.score !== null && submission.score !== undefined) {
+      const score = submission.score % 1 === 0 ? Math.round(submission.score) : submission.score;
+      const total = assignment.points_possible || 0;
+      gradeDisplay = `${score}/${total} pts`;
+      
+      // Color coding based on percentage
+      if (total > 0) {
+        const percentage = (submission.score / total) * 100;
+        if (percentage >= 90) gradeColor = chalk.green;
+        else if (percentage >= 80) gradeColor = chalk.cyan;
+        else if (percentage >= 70) gradeColor = chalk.yellow;
+        else if (percentage >= 60) gradeColor = chalk.magenta;
+        else gradeColor = chalk.red;
+      }
+      
+      // Add letter grade if available
+      if (submission.grade && isNaN(submission.grade)) {
+        gradeDisplay = `${submission.grade} (${gradeDisplay})`;
+      }
+    } else if (submission.excused) {
+      gradeDisplay = 'Excused';
+      gradeColor = chalk.blue;
+    } else if (submission.missing) {
+      gradeDisplay = 'Missing';
+      gradeColor = chalk.red;
+    }
+    
+    console.log(chalk.white(`${index + 1}. ${assignment.name}`));
+    console.log('   Grade: ' + gradeColor(gradeDisplay));
+    
+    if (submission.submitted_at) {
+      console.log('   Submitted: ' + new Date(submission.submitted_at).toLocaleDateString());
+    }
+    
+    if (assignment.due_at) {
+      console.log('   Due: ' + new Date(assignment.due_at).toLocaleDateString());
+    }
+    
+    if (options.verbose && submission.grader_comments) {
+      console.log('   Comments: ' + submission.grader_comments);
+    }
+    
+    console.log('');
+  });
+}
+
+async function showInteractiveGrades(options, rl) {
+  // Get all courses with enrollment information
+  const courses = await makeCanvasRequest('get', 'courses', [
+    'enrollment_state=active',
+    'include[]=enrollments',
+    'include[]=favorites',
+    'include[]=total_scores'
+  ]);
+
+  if (!courses || courses.length === 0) {
+    console.log(chalk.red('Error: No courses found.'));
+    return;
+  }
+
+  // Move declaration above first use
+  const coursesWithGrades = courses.filter(course => 
+    course.enrollments && course.enrollments.length > 0
+  );
+
+  // Show courses overview first
+  console.log(chalk.cyan.bold('\n' + '-'.repeat(60)));
+  console.log(chalk.cyan.bold('Grades Overview'));
+  console.log(chalk.cyan('-'.repeat(60)));
+  console.log(chalk.white(`Found ${coursesWithGrades.length} enrolled course(s):\n`));
+  
+  coursesWithGrades.forEach((course, index) => {
+    let gradeColor = chalk.gray;
+    const enrollment = course.enrollments[0];
+    const currentScore = enrollment.grades?.current_score;
+    if (currentScore !== null && currentScore !== undefined) {
+      if (currentScore >= 90) gradeColor = chalk.green;
+      else if (currentScore >= 80) gradeColor = chalk.cyan;
+      else if (currentScore >= 70) gradeColor = chalk.yellow;
+      else if (currentScore >= 60) gradeColor = chalk.magenta;
+      else gradeColor = chalk.red;
+    }
+    console.log(chalk.white(`${index + 1}. ${course.name}`));
+    if (enrollment.grades) {
+      console.log('   Current: ' + gradeColor(`${currentScore || 'N/A'}% (${enrollment.grades.current_grade || 'N/A'})`));
+    } else {
+      console.log('   Current: ' + chalk.gray('Grades not available'));
+    }
+    console.log('');
+  });
+  
+  // Ask if user wants to see detailed grades for a specific course
+  const viewDetailed = await askQuestion(rl, 'View detailed grades for a specific course? (Y/n): ');
+  
+  if (viewDetailed.toLowerCase() === 'n' || viewDetailed.toLowerCase() === 'no') {
+    return;
+  }
+  
+  const courseChoice = await askQuestion(rl, '\nEnter course number for detailed grades: ');
+  const courseIndex = parseInt(courseChoice) - 1;
+  
+  if (courseIndex >= 0 && courseIndex < coursesWithGrades.length) {
+    const selectedCourse = coursesWithGrades[courseIndex];
+    console.log(chalk.green(`\nSelected: ${selectedCourse.name}`));
+    await showCourseGrades(selectedCourse.id, options, rl);
+  } else {
+    console.log(chalk.red('Invalid course selection.'));
+  }
+}

package/commands/list.js

@@ -1,70 +1,68 @@
-/**
- * List courses command
- */
-
-const { makeCanvasRequest } = require('../lib/api-client');
-
-async function listCourses(options) {
-  try {
-    const queryParams = [];
-    
-    // Always show only active courses
-    queryParams.push('enrollment_state=active');
-    
-    // Include additional course information
-    queryParams.push('include[]=term');
-    queryParams.push('include[]=course_progress');
-    queryParams.push('include[]=total_students');
-    queryParams.push('include[]=favorites'); // Include favorite status
-    
-    const courses = await makeCanvasRequest('get', 'courses', queryParams);
-    
-    if (!courses || courses.length === 0) {
-      console.log('No courses found.');
-      return;
-    }
-    
-    // By default, show only starred courses unless -a flag is used
-    let filteredCourses = courses;
-    if (!options.all) {
-      filteredCourses = courses.filter(course => course.is_favorite);
-      
-      if (filteredCourses.length === 0) {
-        console.log('No starred courses found. Use -a to see all courses.');
-        return;
-      }
-    }
-    
-    const courseLabel = options.all ? 'enrolled course(s)' : 'starred course(s)';
-    console.log(`Found ${filteredCourses.length} ${courseLabel}:\n`);
-    
-    filteredCourses.forEach((course, index) => {
-      const starIcon = course.is_favorite ? '⭐ ' : '';
-      console.log(`${index + 1}. ${starIcon}${course.name}`);
-      console.log(`   ID: ${course.id}`);
-      console.log(`   Code: ${course.course_code || 'N/A'}`);
-      
-      if (options.verbose) {
-        console.log(`   Term: ${course.term?.name || 'N/A'}`);
-        console.log(`   Students: ${course.total_students || 'N/A'}`);
-        console.log(`   Start Date: ${course.start_at ? new Date(course.start_at).toLocaleDateString() : 'N/A'}`);
-        console.log(`   End Date: ${course.end_at ? new Date(course.end_at).toLocaleDateString() : 'N/A'}`);
-        console.log(`   Workflow State: ${course.workflow_state}`);
-        
-        if (course.course_progress) {
-          console.log(`   Progress: ${course.course_progress.requirement_completed_count || 0}/${course.course_progress.requirement_count || 0} requirements`);
-        }
-      }
-      
-      console.log(''); // Empty line between courses
-    });
-    
-  } catch (error) {
-    console.error('Error fetching courses:', error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  listCourses
-};
+/**
+ * List courses command
+ */
+
+import { makeCanvasRequest } from '../lib/api-client.js';
+import chalk from 'chalk';
+
+function pad(str, len) {
+  return str + ' '.repeat(Math.max(0, len - str.length));
+}
+
+export async function listCourses(options) {
+  try {
+    const queryParams = [];
+    queryParams.push('enrollment_state=active');
+    queryParams.push('include[]=term');
+    queryParams.push('include[]=course_progress');
+    queryParams.push('include[]=total_students');
+    queryParams.push('include[]=favorites');
+
+    console.log(chalk.cyan.bold('\n' + '-'.repeat(60)));
+    console.log(chalk.cyan.bold('Loading courses, please wait...'));
+    const courses = await makeCanvasRequest('get', 'courses', queryParams);
+    if (!courses || courses.length === 0) {
+      console.log(chalk.red('Error: No courses found.'));
+      return;
+    }
+    let filteredCourses = courses;
+    if (!options.all) {
+      filteredCourses = courses.filter(course => course.is_favorite);
+      if (filteredCourses.length === 0) {
+        console.log(chalk.red('Error: No starred courses found. Use -a to see all courses.'));
+        return;
+      }
+    }
+    const courseLabel = options.all ? 'enrolled course(s)' : 'starred course(s)';
+    console.log(chalk.green(`Success: Found ${filteredCourses.length} ${courseLabel}.`));
+    console.log(chalk.cyan('-'.repeat(60)));
+    // Column headers
+    console.log(
+      pad(chalk.bold('No.'), 5) +
+      pad(chalk.bold('Course Name'), 35) +
+      pad(chalk.bold('ID'), 10) +
+      pad(chalk.bold('Code'), 12) +
+      (options.verbose ? pad(chalk.bold('Term'), 15) + pad(chalk.bold('Students'), 10) + pad(chalk.bold('Start'), 12) + pad(chalk.bold('End'), 12) + pad(chalk.bold('State'), 12) + pad(chalk.bold('Progress'), 18) : '')
+    );
+    console.log(chalk.cyan('-'.repeat(60)));
+    filteredCourses.forEach((course, index) => {
+      let line = pad(chalk.white((index + 1) + '.'), 5) +
+        pad(course.name, 35) +
+        pad(String(course.id), 10) +
+        pad(course.course_code || 'N/A', 12);
+      if (options.verbose) {
+        line += pad(course.term?.name || 'N/A', 15) +
+          pad(String(course.total_students || 'N/A'), 10) +
+          pad(course.start_at ? new Date(course.start_at).toLocaleDateString() : 'N/A', 12) +
+          pad(course.end_at ? new Date(course.end_at).toLocaleDateString() : 'N/A', 12) +
+          pad(course.workflow_state, 12) +
+          pad(course.course_progress ? `${course.course_progress.requirement_completed_count || 0}/${course.course_progress.requirement_count || 0}` : 'N/A', 18);
+      }
+      console.log(line);
+    });
+    console.log(chalk.cyan('-'.repeat(60)));
+  } catch (error) {
+    console.error(chalk.red('Error fetching courses:'), error.message);
+    process.exit(1);
+  }
+}

package/commands/profile.js

@@ -1,34 +1,35 @@
-/**
- * Profile command
- */
-
-const { makeCanvasRequest } = require('../lib/api-client');
-
-async function showProfile(options) {
-  try {
-    const user = await makeCanvasRequest('get', 'users/self', ['include[]=email', 'include[]=locale']);
-    
-    console.log('User Profile:\n');
-    console.log(`Name: ${user.name}`);
-    console.log(`ID: ${user.id}`);
-    console.log(`Email: ${user.email || 'N/A'}`);
-    console.log(`Login ID: ${user.login_id || 'N/A'}`);
-    
-    if (options.verbose) {
-      console.log(`Short Name: ${user.short_name || 'N/A'}`);
-      console.log(`Sortable Name: ${user.sortable_name || 'N/A'}`);
-      console.log(`Locale: ${user.locale || 'N/A'}`);
-      console.log(`Time Zone: ${user.time_zone || 'N/A'}`);
-      console.log(`Avatar URL: ${user.avatar_url || 'N/A'}`);
-      console.log(`Created: ${user.created_at ? new Date(user.created_at).toLocaleString() : 'N/A'}`);
-    }
-    
-  } catch (error) {
-    console.error('Error fetching profile:', error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  showProfile
-};
+/**
+ * Profile command
+ */
+
+import { makeCanvasRequest } from '../lib/api-client.js';
+import chalk from 'chalk';
+
+export async function showProfile(options) {
+  try {
+    console.log(chalk.cyan.bold('Loading profile, please wait...'));
+    const user = await makeCanvasRequest('get', 'users/self', ['include[]=email', 'include[]=locale']);
+    
+    console.log(chalk.cyan.bold('\n' + '-'.repeat(60)));
+    console.log(chalk.cyan.bold('User Profile'));
+    console.log(chalk.cyan('-'.repeat(60)));
+    console.log(chalk.white('Name: ') + user.name);
+    console.log(chalk.white('ID: ') + user.id);
+    console.log(chalk.white('Email: ') + (user.email || 'N/A'));
+    console.log(chalk.white('Login ID: ') + (user.login_id || 'N/A'));
+    
+    if (options.verbose) {
+      console.log(chalk.white('Short Name: ') + (user.short_name || 'N/A'));
+      console.log(chalk.white('Sortable Name: ') + (user.sortable_name || 'N/A'));
+      console.log(chalk.white('Locale: ') + (user.locale || 'N/A'));
+      console.log(chalk.white('Time Zone: ') + (user.time_zone || 'N/A'));
+      console.log(chalk.white('Avatar URL: ') + (user.avatar_url || 'N/A'));
+      console.log(chalk.white('Created: ') + (user.created_at ? new Date(user.created_at).toLocaleString() : 'N/A'));
+    }
+    console.log(chalk.green('Success: Profile loaded.'));
+    
+  } catch (error) {
+    console.error(chalk.red('Error: Failed to fetch profile: ') + error.message);
+    process.exit(1);
+  }
+}