vrcli 0.1.1

A command-line interface for the VRChat API that lets you manage friends, users, worlds, and authentication directly from your terminal
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

use anyhow::Result;
use vrchatapi::apis::worlds_api;

/// Search worlds by query
pub async fn search_worlds(
    api_config: &vrchatapi::apis::configuration::Configuration,
    query: &str,
    limit: i32,
    offset: i32,
) -> Result<Vec<vrchatapi::models::LimitedWorld>> {
    let worlds = worlds_api::search_worlds(
        api_config,
        None, // featured
        None, // sort
        None, // user
        None, // user_id
        Some(limit),
        None, // order
        Some(offset),
        Some(query),
        None, // tag
        None, // notag
        None, // release_status
        None, // max_unity_version
        None, // min_unity_version
        None, // platform
        None, // fuzzy
    )
    .await?;

    Ok(worlds)
}

/// Fetch world data by ID
pub async fn fetch_world_by_id(
    api_config: &vrchatapi::apis::configuration::Configuration,
    world_id: &str,
) -> Result<vrchatapi::models::World> {
    let world = worlds_api::get_world(api_config, world_id)
        .await
        .map_err(|e| {
            // Convert API errors to more user-friendly messages
            match e {
                vrchatapi::apis::Error::ResponseError(ref response_content) => {
                    if response_content.status == 404 {
                        return anyhow::anyhow!("No world found with ID '{}'", world_id);
                    }
                    anyhow::anyhow!(
                        "Failed to fetch world '{}' - HTTP {}",
                        world_id,
                        response_content.status
                    )
                }
                _ => {
                    // For other errors, provide a more general but clear message
                    anyhow::anyhow!("Failed to fetch world '{}' - {}", world_id, e)
                }
            }
        })?;
    Ok(world)
}