tftio-asana-cli 3.1.0

An interface to the Asana 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
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

//! Asana API client module providing authenticated HTTP access, pagination,
//! and rate-limit aware retry logic.

pub mod attachments;
pub mod auth;
pub mod client;
pub mod custom_fields;
pub mod error;
pub mod pagination;
pub mod projects;
pub mod sections;
pub mod stories;
pub mod tags;
pub mod tasks;
pub mod users;
pub mod workspaces;

pub use attachments::{
    delete_attachment, download_attachment, get_attachment, list_attachments, upload_attachment,
};
pub use auth::{AuthToken, StaticTokenProvider, TokenProvider};
pub use client::{ApiClient, ApiClientBuilder, ApiClientOptions};
pub use custom_fields::{get_custom_field, list_custom_fields};
pub use error::{ApiError, RateLimitInfo};
pub use pagination::{ListResponse, PaginationInfo};
pub use projects::{
    add_members, create_project, delete_project, get_project, list_members, list_projects,
    list_statuses, remove_members, update_member, update_project,
};
pub use sections::{
    add_task_to_section, create_section, delete_section, get_section, get_section_tasks,
    list_sections, update_section,
};
pub use stories::{create_story, delete_story, get_story, list_stories, update_story};
pub use tags::{create_tag, delete_tag, get_tag, list_tags, update_tag};
pub use tasks::{
    add_dependencies, add_dependents, add_followers, add_project, add_tag, create_task,
    delete_task, get_task, list_dependencies, list_dependents, list_subtasks, list_tasks,
    remove_dependencies, remove_dependents, remove_followers, remove_project, remove_tag,
    search_tasks, update_task,
};
pub use users::{get_current_user, get_user, list_users};
pub use workspaces::{get_workspace, list_workspaces};

use serde::Deserialize;

/// Generic wrapper for Asana API responses that carry a single object.
#[derive(Debug, Deserialize)]
pub(crate) struct SingleResponse<T> {
    pub data: T,
}

/// Fetch a single resource by path.
pub(crate) async fn api_get<T: serde::de::DeserializeOwned>(
    client: &ApiClient,
    path: &str,
) -> Result<T, ApiError> {
    let response: SingleResponse<T> = client.get_json_with_pairs(path, vec![]).await?;
    Ok(response.data)
}

/// Create a resource via POST.
pub(crate) async fn api_post<T: serde::Serialize + Sync, R: serde::de::DeserializeOwned>(
    client: &ApiClient,
    path: &str,
    body: &T,
) -> Result<R, ApiError> {
    let response: SingleResponse<R> = client.post_json(path, body).await?;
    Ok(response.data)
}

/// Update a resource via PUT.
pub(crate) async fn api_put<T: serde::Serialize + Sync, R: serde::de::DeserializeOwned>(
    client: &ApiClient,
    path: &str,
    body: &T,
) -> Result<R, ApiError> {
    let response: SingleResponse<R> = client.put_json(path, body).await?;
    Ok(response.data)
}

/// Delete a resource via DELETE.
pub(crate) async fn api_delete(client: &ApiClient, path: &str) -> Result<(), ApiError> {
    client.delete(path, vec![]).await
}