gor-cli 0.2.0

A Rust CLI for GitHub — a 'gh' clone
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Implementation of the `gor classroom` subcommand.
//!
//! Provides classroom listing and assignment viewing for GitHub Classroom.

#![allow(clippy::print_stdout)]

use crate::cli::ClassroomCommand;
use crate::client::Client;
use crate::output::print_json;
use anyhow::Context;

/// Run the `gor classroom` subcommand.
///
/// # Errors
///
/// Returns an error if the command execution fails.
pub fn run(cmd: ClassroomCommand) -> anyhow::Result<()> {
    match cmd {
        ClassroomCommand::List { json, hostname } => list(json, hostname.as_deref()),
        ClassroomCommand::Assignments { id, json, hostname } => {
            assignments(id, json, hostname.as_deref())
        }
    }
}

/// List classrooms for the authenticated user.
///
/// # Errors
///
/// Returns an error if the API request fails.
fn list(json: Option<Vec<String>>, hostname: Option<&str>) -> anyhow::Result<()> {
    let host = hostname.unwrap_or("github.com");
    let client = Client::new(host).context("failed to create HTTP client")?;

    let response = client
        .get("/classrooms")
        .context("failed to fetch classrooms")?;

    let status = response.status();
    if !status.is_success() {
        anyhow::bail!("failed to list classrooms: HTTP {status}");
    }

    let classrooms: Vec<serde_json::Value> = response.json().context("failed to parse response")?;

    if let Some(fields) = json {
        let fields_ref: Option<&[String]> = if fields.is_empty() {
            None
        } else {
            Some(&fields)
        };
        print_json(&classrooms, fields_ref);
        return Ok(());
    }

    if classrooms.is_empty() {
        println!("No classrooms found.");
        return Ok(());
    }

    println!("{:<8}  {:<30}  ORGANIZATION", "ID", "NAME");
    for c in &classrooms {
        let id = c["id"].as_u64().unwrap_or(0);
        let name = c["name"].as_str().unwrap_or("—");
        let org = c["organization"]["login"].as_str().unwrap_or("—");
        let name_truncated = crate::cmd::util::truncate(name, 30);
        println!("{id:<8}  {name_truncated:<30}  {org}");
    }

    Ok(())
}

/// List assignments for a classroom.
///
/// # Errors
///
/// Returns an error if the API request fails.
fn assignments(id: u64, json: Option<Vec<String>>, hostname: Option<&str>) -> anyhow::Result<()> {
    let host = hostname.unwrap_or("github.com");
    let client = Client::new(host).context("failed to create HTTP client")?;

    let path = format!("/classrooms/{id}/assignments");
    let response = client.get(&path).context("failed to fetch assignments")?;

    let status = response.status();
    if !status.is_success() {
        anyhow::bail!("failed to list assignments: HTTP {status}");
    }

    let assignments: Vec<serde_json::Value> =
        response.json().context("failed to parse response")?;

    if let Some(fields) = json {
        let fields_ref: Option<&[String]> = if fields.is_empty() {
            None
        } else {
            Some(&fields)
        };
        print_json(&assignments, fields_ref);
        return Ok(());
    }

    if assignments.is_empty() {
        println!("No assignments found for classroom {id}.");
        return Ok(());
    }

    println!("{:<8}  {:<30}  {:<20}  INVITED", "ID", "TITLE", "DEADLINE");
    for a in &assignments {
        let aid = a["id"].as_u64().unwrap_or(0);
        let title = a["title"].as_str().unwrap_or("—");
        let deadline = a["deadline"].as_str().unwrap_or("—");
        let invited = a["invitations_count"].as_u64().unwrap_or(0);
        let title_truncated = crate::cmd::util::truncate(title, 30);
        println!("{aid:<8}  {title_truncated:<30}  {deadline:<20}  {invited}");
    }

    Ok(())
}