canvas-lms-api 0.2.0

Rust client for the Instructure Canvas LMS REST API
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

// GraphQL endpoint support. Enabled with features = ["graphql"].

use crate::{error::Result, http::Requester};
use serde_json::Value;
use std::sync::Arc;

/// GraphQL client bound to a Canvas instance.
///
/// Obtain one via [`Canvas::graphql()`][crate::client::Canvas::graphql].
pub struct GraphQL {
    pub(crate) requester: Arc<Requester>,
}

impl GraphQL {
    /// Execute a raw GraphQL query against the Canvas `/api/graphql` endpoint.
    ///
    /// Returns the full JSON response (including `data` and optional `errors` fields).
    ///
    /// # Example
    /// ```no_run
    /// # #[tokio::main] async fn main() -> canvas_lms_api::Result<()> {
    /// let canvas = canvas_lms_api::Canvas::new("https://canvas.example.edu", "token")?;
    /// let gql = canvas.graphql();
    /// let result = gql.query("{ allCourses { id name } }", None).await?;
    /// println!("{result}");
    /// # Ok(()) }
    /// ```
    pub async fn query(&self, query: &str, variables: Option<Value>) -> Result<Value> {
        self.requester.graphql_query(query, variables).await
    }
}