Struct screeps_api::sync::SyncApi

pub struct SyncApi<C: Connect = HttpsConnector<HttpConnector>, T: TokenStorage = RcTokenStorage> { /* fields omitted */ }

API structure mirroring Api, but providing utilities for synchronous connection.

This structure owns both the hyper client and the tokio core. If this is not wanted, please use Api instead.

Methods

impl SyncApi<HttpsConnector<HttpConnector>, RcTokenStorage>

fn new() -> Result<Self, SyncError>

Opinionated method to construct a SyncApi with non-Send token storage, with HTTPS support and connecting to the default server.

Since this connects to the official server, it won't be useful without HTTPS support.

Use Config for more configuration, including choosing an HTTP only backend, or setting the url to something other than https://screep.com/api/.

impl<C: Connect, T: TokenStorage> SyncApi<C, T>

fn login<'b, U, V>(&mut self, username: U, password: V) -> Result<(), Error> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Logs in with the given username and password and gets an authentication token as the result.

The authentication token will then be stored in this client.

fn register(
    &mut self,
    details: RegistrationDetails
) -> Result<RegistrationSuccess, Error>

Registers a new account with the given username, password and optional email and returns a result. Successful results contain no information other than that of success.

This is primarily for private servers with screepsmod-auth installed. Unknown if this works on the official server.

fn my_info(&mut self) -> Result<MyInfo, Error>

Gets user information on the user currently logged in, including username and user id.

See Api::my_info for more information.

fn world_start_room(&mut self) -> Result<WorldStartRoom, Error>

Gets the world shard and room name the server thinks the client should start with viewing.

See Api::world_start_room for more information.

fn shard_start_room<'b, U>(&mut self, shard: U) -> Result<WorldStartRoom, Error> where
    U: Into<Cow<'b, str>>, 

Gets the room name the server thinks the client should start with viewing for a particular shard.

See Api::world_start_room for more information.

fn map_stats<'a, U, V>(
    &mut self,
    shard: &'a str,
    rooms: &'a V
) -> Result<MapStats, Error> where
    U: AsRef<str>,
    &'a V: IntoIterator<Item = U>, 

Get information on a number of rooms.

See Api::map_stats for more information.

fn room_overview<'b, U, V>(
    &mut self,
    shard: U,
    room_name: V,
    request_interval: u32
) -> Result<RoomOverview, Error> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Gets the overview of a room, returning totals for usually 3 intervals, 8, 180 and 1440, representing data for the past hour, data for the past 24 hours, and data for the past week respectively.

See Api::room_overview for more information.

fn room_terrain<'b, U, V>(
    &mut self,
    shard: Option<U>,
    room_name: V
) -> Result<RoomTerrain, Error> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Gets the terrain of a room, returning a 2d array of 50x50 points.

See Api::room_terrain for more information.

fn shard_list(&mut self) -> Result<Vec<ShardInfo>, Error>

Gets a list of shards available on this server. Errors with a 404 error when connected to a non-sharded server.

See Api::shard_list for more information.

fn room_status<'b, U>(&mut self, room_name: U) -> Result<RoomStatus, Error> where
    U: Into<Cow<'b, str>>, 

Gets the "status" of a room: if it is open, if it is in a novice area, if it exists.

See Api::room_status for more information.

fn recent_pvp(&mut self, details: RecentPvpDetails) -> Result<RecentPvp, Error>

Experimental endpoint to get all rooms in which PvP has recently occurred.

See Api::recent_pvp for more information.

fn leaderboard_season_list(&mut self) -> Result<Vec<LeaderboardSeason>, Error>

Gets a list of all past leaderboard seasons, with end dates, display names, and season ids for each season.

See Api::leaderboard_season_list for more information.

fn find_season_leaderboard_rank<'b, U, V>(
    &mut self,
    leaderboard_type: LeaderboardType,
    username: U,
    season: V
) -> Result<FoundUserRank, Error> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Finds the rank of a user in a specific season for a specific leaderboard type.

See Api::find_season_leaderboard_rank for more information.

fn find_leaderboard_ranks<'b, U>(
    &mut self,
    leaderboard_type: LeaderboardType,
    username: U
) -> Result<Vec<FoundUserRank>, Error> where
    U: Into<Cow<'b, str>>, 

Finds the rank of a user for all seasons for a specific leaderboard type.

See Api::leaderboard_page for more information.

fn leaderboard_page<'b, U>(
    &mut self,
    leaderboard_type: LeaderboardType,
    season: U,
    limit: u32,
    offset: u32
) -> Result<LeaderboardPage, Error> where
    U: Into<Cow<'b, str>>, 

Gets a page of the leaderboard for a given season.

See Api::leaderboard_page for more information.

Methods from Deref<Target = Api<C, Client<C>, T>>

fn login<'b, U, V>(&self, username: U, password: V) -> FutureResponse<LoggedIn> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Logs in with the given username and password and returns a result containing the token.

Use logged_in.return_to(client.tokens) to let the client use the token from logging in.

fn register(
    &self,
    details: RegistrationDetails
) -> FutureResponse<RegistrationSuccess>

Registers a new account with the given username, password and optional email and returns a result. Successful results contain no information other than that of success.

This is primarily for private servers with screepsmod-auth installed. Unknown if this works on the official server.

fn my_info(&self) -> Result<FutureResponse<MyInfo>, NoToken>

Gets user information on the user currently logged in, including username and user id.

fn world_start_room(&self) -> Result<FutureResponse<WorldStartRoom>, NoToken>

Gets the world shard and room name the server thinks the client should start with viewing.

fn shard_start_room<'b, U>(
    &self,
    shard: U
) -> Result<FutureResponse<WorldStartRoom>, NoToken> where
    U: Into<Cow<'b, str>>, 

Gets the room name the server thinks the client should start with viewing for a particular shard.

fn map_stats<'a, U, V>(
    &self,
    shard: &'a str,
    rooms: &'a V
) -> Result<FutureResponse<MapStats>, NoToken> where
    U: AsRef<str>,
    &'a V: IntoIterator<Item = U>, 

Get information on a number of rooms.

fn room_overview<'b, U, V>(
    &self,
    shard: U,
    room_name: V,
    request_interval: u32
) -> Result<FutureResponse<RoomOverview>, NoToken> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Gets the overview of a room, returning totals for usually 3 intervals, 8, 180 and 1440, representing data for the past hour, data for the past 24 hours, and data for the past week respectively.

All Allowed request_intervals are not known, but at least 8, 180 and 1440 are allowed. The returned data, at the time of writing, includes 8 data points of each type, representing equal portions of the time period requested (hour for 8, day for 180, week for 1440).

fn room_terrain<'b, U, V>(
    &self,
    shard: Option<U>,
    room_name: V
) -> FutureResponse<RoomTerrain> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Gets the terrain of a room, returning a 2d array of 50x50 points.

Does not require authentication.

fn shard_list(&self) -> FutureResponse<Vec<ShardInfo>>

Gets a list of shards available on this server. Errors with a 404 error when connected to a non-sharded server.

Does not require authentication.

fn room_status<'b, U>(
    &self,
    room_name: U
) -> Result<FutureResponse<RoomStatus>, NoToken> where
    U: Into<Cow<'b, str>>, 

Gets the "status" of a room: if it is open, if it is in a novice area, if it exists.

fn recent_pvp(&self, details: RecentPvpDetails) -> FutureResponse<RecentPvp>

Experimental endpoint to get all rooms in which PvP has recently occurred, or where PvP has occurred since a certain game tick.

fn leaderboard_season_list(
    &self
) -> Result<FutureResponse<Vec<LeaderboardSeason>>, NoToken>

Gets a list of all past leaderboard seasons, with end dates, display names, and season ids for each season.

Seasons are a way of having limited time periods (usually one month) in which all rankings are reset at the beginning of, and points earned during the time period contribute to a player's rank in that season.

This method does not return any actual data, but rather just a list of valid past season, any of the ids of which can then be used to retrieve more information.

fn find_season_leaderboard_rank<'b, U, V>(
    &self,
    leaderboard_type: LeaderboardType,
    username: U,
    season: V
) -> Result<FutureResponse<FoundUserRank>, NoToken> where
    U: Into<Cow<'b, str>>,
    V: Into<Cow<'b, str>>, 

Finds the rank of a user in a specific season for a specific leaderboard type.

Will return ApiError::UserNotFound when the username does not exist, and ApiError::ResultNotFound when the user exists but does not have a rank for the given season. The user will not have a rank when either the account did not exist when the season ended, or the user either processed no power or upgraded no controllers, during the specific leaderboard season.

This is technically the same API endpoint as find_leaderboard_rank, but the result format differs when requesting a specific season from when requesting all season ranks.

fn find_leaderboard_ranks<'b, U>(
    &self,
    leaderboard_type: LeaderboardType,
    username: U
) -> Result<FutureResponse<Vec<FoundUserRank>>, NoToken> where
    U: Into<Cow<'b, str>>, 

Finds the rank of a user for all seasons for a specific leaderboard type.

This will return ApiError::UserNotFound if a username does not exist, and may also return an empty Vec as the result if the user does not have any ranks in the given leaderboard type (they have never contributed any global control points, or processed power, depending on the type).

fn leaderboard_page<'b, U>(
    &self,
    leaderboard_type: LeaderboardType,
    season: U,
    limit: u32,
    offset: u32
) -> Result<FutureResponse<LeaderboardPage>, NoToken> where
    U: Into<Cow<'b, str>>, 

Gets a page of the leaderboard for a given season.

Limit dictates how many users will be returned, maximum is 20. Higher than that will cause an InvalidParameters error message.

Offset doesn't have to be a multiple of limit, but it's most likely most useful that it is. Offset 0 will get you the start/top of the ranked list.

Trait Implementations

impl<C: Debug + Connect, T: Debug + TokenStorage> Debug for SyncApi<C, T>

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<C: Connect, T: TokenStorage> Deref for SyncApi<C, T>

type Target = Api<C, Client<C>, T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.