dweb 0.13.3

Decentralised web and storage library for Autonomi
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

/*
 Copyright (c) 2025 Mark Hughes

 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU Affero General Public License for more details.

 You should have received a copy of the GNU Affero General Public License
 along with this program. If not, see <https://www.gnu.org/licenses/>.
*/

use color_eyre::eyre::Result;

/// Submit a request to the main with ports server and return a JSON result on success
///
/// url_path should begin with '/' and contains the API path and any parameters for the
/// request.
///
/// You don't need to provide host or port unless you wish to override the defaults.
///
/// This function assumes some defaults to save having to build the request from scratch
/// but it is fine to do that and not use this function. If doing that yourself, it is
/// recommended that you use the helper function make_main_server_url() to construct
/// the host/port part of the URL.
///
pub async fn main_server_request(
    host: Option<&String>,
    port: Option<u16>,
    url_path: &str,
) -> Result<String> {
    let url_string = make_main_server_url(host, port, url_path);
    println!("DEBUG main_server_request() request: {url_string}");

    let response: reqwest::Response = match reqwest::Client::builder()
        .build()?
        .get(&url_string)
        .header("Accept", "application/json")
        .send()
        .await
    {
        Ok(response) => response,
        Err(e) => {
            println!("Unable to access dweb server - is it running?");
            println!("\nIf not, you can start it in another terminal using 'dweb serve' or by starting the dweb app if you have that installed.");
            return Err(e.into());
        }
    };

    match response.text().await {
        Ok(body) => Ok(body),
        Err(e) => {
            println!("Failed to get text from server response: {e}");
            Err(e.into())
        }
    }
}

// Default to 'with ports' server
pub fn make_main_server_url(host: Option<&String>, port: Option<u16>, url_path: &str) -> String {
    let default_host = crate::web::LOCALHOST_STR.to_string();
    let host = host.unwrap_or(&default_host);
    let port = port.unwrap_or(crate::web::SERVER_PORTS_MAIN_PORT);
    format!("http://{host}:{port}{url_path}")
}