sharepoint-cli 0.0.2

Agent-friendly SharePoint Online CLI with JSON output, structured exit codes, and schema introspection
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

//! `sharepoint drives list <site-ref>`

use crate::auth::AuthContext;
use crate::cli::{DrivesCmd, Runtime};
use crate::error::{CliError, Result};
use crate::graph::{GraphClient, drives, sites};
use crate::reference::SiteRef;

pub async fn run(rt: &Runtime, cmd: DrivesCmd) -> Result<()> {
    match cmd {
        DrivesCmd::List { site, limit, all } => list(rt, &site, limit, all).await,
    }
}

async fn list(rt: &Runtime, site_input: &str, limit: usize, all: bool) -> Result<()> {
    let auth = AuthContext::new(rt.cfg.clone(), rt.cache_path.clone());
    let graph = GraphClient::new(auth);

    // The site argument can be a URL, an alias name, "default", or spo://Site.
    let site_ref = if site_input == "default" {
        SiteRef::Default
    } else if site_input.starts_with("http://") || site_input.starts_with("https://") {
        SiteRef::Url(site_input.to_string())
    } else if let Some(rest) = site_input.strip_prefix("spo://") {
        // Accept bare spo://SiteName (and spo://SiteName/... with trailing segments ignored).
        let name = rest
            .split('/')
            .next()
            .filter(|s| !s.is_empty())
            .ok_or_else(|| {
                CliError::Input(
                    "spo:// URI is missing a site name (expected spo://SiteName)".into(),
                )
            })?;
        SiteRef::Name(name.to_string())
    } else {
        SiteRef::Name(site_input.to_string())
    };

    let site = sites::resolve(
        &graph,
        &site_ref,
        &rt.cfg.site_aliases,
        rt.cfg.default_site.as_deref(),
    )
    .await?;
    let mut all_drives = drives::list_drives(&graph, &site.id).await?;
    let total = all_drives.len();
    if !all && all_drives.len() > limit {
        all_drives.truncate(limit);
    }

    if rt.out.json {
        let items: Vec<_> = all_drives
            .iter()
            .map(|d| {
                serde_json::json!({
                    "id": d.id,
                    "name": d.name,
                    "drive_type": d.drive_type,
                    "site": {"id": site.id, "name": site.display_name, "url": site.web_url},
                })
            })
            .collect();
        rt.out.print_json(&serde_json::json!({
            "total": total,
            "next": null,
            "items": items,
        }));
    } else {
        for d in &all_drives {
            rt.out
                .print_data(&format!("{:30}  {:18}  {}", d.name, d.drive_type, d.id));
        }
        rt.out
            .print_message(&format!("({total} drive(s) on {})", site.display_name));
    }
    Ok(())
}