10 releases (breaking)

Uses new Rust 2024

0.8.0 Apr 25, 2025
0.7.0 Nov 30, 2024
0.6.0 Jul 5, 2024
0.5.1 Feb 28, 2024
0.2.0 Nov 6, 2023

#606 in Game dev

Download history 4/week @ 2025-01-08 8/week @ 2025-01-15 4/week @ 2025-01-29 37/week @ 2025-02-05 36/week @ 2025-02-12 28/week @ 2025-02-19 71/week @ 2025-02-26 32/week @ 2025-03-12 1/week @ 2025-03-26 10/week @ 2025-04-09 12/week @ 2025-04-16 150/week @ 2025-04-23

172 downloads per month
Used in 3 crates

MIT/Apache

45KB
390 lines

bevy_http_client

CI Crates.io Downloads Documentation MIT/Apache 2.0

A simple HTTP client Bevy Plugin for both native and WASM.

Example

use bevy::{prelude::*, time::common_conditions::on_timer};
use bevy_http_client::prelude::*;
use serde::Deserialize;

#[derive(Debug, Clone, Deserialize, Default)]
pub struct IpInfo {
    pub ip: String,
}

fn main() {
    let mut app = App::new();
    app.add_plugins((MinimalPlugins, HttpClientPlugin))
        .add_systems(Update, (handle_response, handle_error))
        .add_systems(
            Update,
            send_request.run_if(on_timer(std::time::Duration::from_secs(1))),
        );
    app.register_request_type::<IpInfo>();
    app.run();
}

fn send_request(mut ev_request: EventWriter<TypedRequest<IpInfo>>) {
    ev_request.send(
        HttpClient::new()
            .get("https://api.ipify.org?format=json")
            .with_type::<IpInfo>(),
    );
}

/// consume TypedResponse<IpInfo> events
fn handle_response(mut events: ResMut<Events<TypedResponse<IpInfo>>>) {
    for response in events.drain() {
        let response: IpInfo = response.into_inner();
        println!("ip info: {:?}", response);
    }
}

fn handle_error(mut ev_error: EventReader<TypedResponseError<IpInfo>>) {
    for error in ev_error.read() {
        println!("Error retrieving IP: {}", error.err);
    }
}

Supported Versions

bevy bevy_http_client
0.16 0.8
0.15 0.7
0.14 0.6
0.13 0.4, 0,5
0.12 0.3
0.11 0.1

License

Dual-licensed under either:

At your option. This means that when using this crate in your game, you may choose which license to use.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dually licensed as above, without any additional terms or conditions.

Dependencies

~12–20MB
~280K SLoC