3 releases
0.1.2 | Jun 26, 2024 |
---|---|
0.1.1 | Jun 26, 2024 |
0.1.0 | Jun 26, 2024 |
#780 in Web programming
40 downloads per month
40KB
957 lines
BW Web API (rust edition)
A Rust library for interacting with the StarCraft Brood War API.
This is a port of the bw-web-api library, which is written in TypeScript. You can find more information there such as endpoint documentation, the expected shape of responses, etc.
Not every endpoint is working yet and this is still a work in progress. However, the most useful endpoints are implemented and working (eg. aurora_profile_by_toon
).
Installation
cargo add bw-web-api-rs
Usage
This library makes use of async/await, so you will need to use your preferred async runtime, such as tokio.
use bw_api::{AuroraProfileByToonV2FieldMask, BWClient, Region, SCApi};
#[tokio::main]
async fn main() {
let client = BWClient::new("http://localhost/:12345").unwrap();
let api = SCApi::new(client).unwrap();
let response = api
.aurora_profile_by_toon(
"By.SnOw1",
Region::Korea,
AuroraProfileByToonV2FieldMask::ScrProfile,
)
.await;
match response {
Ok(profile) => println!("{:?}", profile),
Err(e) => eprintln!("Error: {}", e),
}
}
You can find rough documentation for the endpoints here.
StarCraft Port
The port StarCraft opens for the web API will not always be the same. You can determine the port on Windows via:
(as administrator)
(Get-NetTCPConnection -OwningProcess (Get-Process -Name StarCraft | Select-Object -ExpandProperty Id) | Where-Object {$_.State -eq "Listen"} | Sort-Object -Property LocalPort | Select-Object -First 1).LocalPort
An example of running this command in Rust:
use std::process::Command;
use std::str;
fn get_starcraft_port() -> Result<String, Box<dyn std::error::Error>> {
let output = Command::new("powershell")
.arg("-Command")
.arg("(Get-NetTCPConnection -OwningProcess (Get-Process -Name StarCraft | Select-Object -ExpandProperty Id) | Where-Object { $_.State -eq 'Listen' } | Sort-Object -Property LocalPort | Select-Object -First 1).LocalPort")
.output()?;
if output.status.success() {
let port = str::from_utf8(&output.stdout)?.trim().to_string();
Ok(port)
} else {
let error_message = str::from_utf8(&output.stderr)?;
Err(Box::from(error_message))
}
}
Dependencies
~4–15MB
~205K SLoC