{"id":16913660,"url":"https://github.com/extrawurst/bevy_extern_events","last_synced_at":"2025-04-11T11:31:24.677Z","repository":{"id":209079310,"uuid":"722918408","full_name":"extrawurst/bevy_extern_events","owner":"extrawurst","description":"Bevy plugin for generic external events forwarded to Bevy EventReaders 🦀","archived":false,"fork":false,"pushed_at":"2023-11-27T13:38:44.000Z","size":71,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-01T19:46:26.585Z","etag":null,"topics":["bevy","extern-libraries"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/bevy_extern_events","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/extrawurst.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-24T09:03:24.000Z","updated_at":"2024-04-15T14:33:32.000Z","dependencies_parsed_at":"2023-11-24T23:23:19.727Z","dependency_job_id":"705f0bb2-d8be-4597-a8c0-203178f01106","html_url":"https://github.com/extrawurst/bevy_extern_events","commit_stats":null,"previous_names":["extrawurst/bevy_extern_events"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawurst%2Fbevy_extern_events","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawurst%2Fbevy_extern_events/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawurst%2Fbevy_extern_events/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawurst%2Fbevy_extern_events/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/extrawurst","download_url":"https://codeload.github.com/extrawurst/bevy_extern_events/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248383942,"owners_count":21094638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bevy","extern-libraries"],"created_at":"2024-10-13T19:14:28.913Z","updated_at":"2025-04-11T11:31:24.357Z","avatar_url":"https://github.com/extrawurst.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bevy_extern_events\n\n[![crates.io](https://img.shields.io/crates/v/bevy_extern_events.svg)](https://crates.io/crates/bevy_extern_events)\n[![docs](https://docs.rs/bevy_extern_events/badge.svg)](https://docs.rs/bevy_extern_events)\n\n## Why?\n\nBecause at some point you might want to interact with code outside of Bevy (External SDKs, Native Platform Code, non-Bevy crates). With the help of this crate you can queue events from anywhere and they will be available via the typical `EventReader` mechanism inside your Bevy Systems.\n\n**Note** that this comes at the cost of us having a global static `RwLock`-based Queue that we poll every frame (`PreUpdate`) to forward into an `EventWriter`. Events are `Box`ed because I found no other way of having a global static generic Datatype without using `Any`. \n\nTherefore I suggest using this for non-every-frame interaction and rolling a custom solution otherwise.\n\n## Example:\n\n```rust\n#[derive(Default)]\npub struct MyEvent;\n\n#[derive(Resource, Reflect, Default)]\npub struct MyEventResource(i32);\n\npub fn event_system(\n    mut res: ResMut\u003cMyEventResource\u003e,\n    mut native_events: EventReader\u003cExternEvent\u003cMyEvent\u003e\u003e,\n) {\n    for _e in native_events.read() {\n        res.0 += 1;\n    }\n}\n\nfn test() {\n    let mut app = App::new();\n    app.init_resource::\u003cMyEventResource\u003e()\n        .add_plugins(ExternEventsPlugin::\u003cMyEvent\u003e::default())\n        .add_systems(Update, event_system);\n\n    queue_event(MyEvent::default());\n\n    app.update();\n\n    assert_eq!(app.world.resource::\u003cMyEventResource\u003e().0, 1);\n}\n```\n\n## TODO\n\n- [ ] CI\n- [ ] clippy\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawurst%2Fbevy_extern_events","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fextrawurst%2Fbevy_extern_events","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawurst%2Fbevy_extern_events/lists"}