Crate minesweeper_client 

Minesweeper Client Library

This library provides a Rust client for the minesweeper multiplayer server, supporting both HTTP API calls and WebSocket connections for real-time gameplay.

Usage

High-Level Interface (Recommended)

The MinesweeperGame struct provides a high-level interface that manages game state locally and provides convenient methods for game actions:

use minesweeper_client::{MinesweeperGame, GameParams, Pos};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let game = MinesweeperGame::new("http://localhost:8000")?;

    // Start a new game
    let params = GameParams { width: 8, height: 8, bombs: 10 };
    game.start_game(params).await?;

    // Make moves
    game.reveal(Pos { x: 0, y: 0 }).await?;
    game.flag(Pos { x: 1, y: 1 }).await?;
     
    // Check game state
    if let Some(state) = game.get_state().await {
        println!("Game over: {}, Won: {}", state.is_game_over(), state.is_won());
    }
     
    game.disconnect().await?;
    Ok(())
}

Low-Level Interface

For more control, you can use the low-level MinesweeperClient and MinesweeperWebSocket directly:

use minesweeper_client::{MinesweeperClient, MinesweeperWebSocket, GameParams, ClientMessage, Pos};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let client = MinesweeperClient::new("http://localhost:8000")?;
    let game_id = client.create_game(GameParams { width: 8, height: 8, bombs: 10 }).await?;
     
    let ws_url = client.websocket_url(&game_id)?;
    let mut ws = MinesweeperWebSocket::connect(&ws_url).await?;
     
    // Receive initial state
    if let Some(message) = ws.receive_message().await? {
        println!("Received: {:?}", message);
    }
     
    // Send actions manually
    ws.send_message(ClientMessage::Reveal { pos: Pos { x: 0, y: 0 } }).await?;
     
    ws.close().await?;
    Ok(())
}

Structs

CellUpdate

CreateResponse

GameParams

GameState

Represents the current state of a minesweeper game

MinesweeperClient

HTTP client for minesweeper server API

MinesweeperGame

High-level minesweeper game client that manages game state locally

MinesweeperWebSocket

WebSocket client for real-time minesweeper gameplay

Pos

Enums

Cell

ClientMessage

GameEvent

Events emitted by the minesweeper game

ServerMessage

Type Aliases

Result