Struct spacetraders::client::Client

pub struct Client {
    pub username: String,
    pub token: String,
    // some fields omitted
}

A SpaceTraders client that is associated to a specific username

Fields

username: String

The users username

token: String

The uses access token

Implementations

impl Client

pub fn new(http_client: HttpClient, username: String, token: String) -> Client

Create a new game with a reqwest client that has the Authorization header set

Arguments

• username - A string containing the username of the current player
• token - A string containing the access token for the username provided

pub async fn get_my_info(&self) -> Result<UserInfo, SpaceTradersClientError>

Get all information about the current user

pub async fn get_flight_plan(
    &self,
    flight_plan_id: String
) -> Result<FlightPlan, SpaceTradersClientError>

Get the current details of a flight plan

Arguments

• flight_plan_id - A string containing the flight plan id

pub async fn create_flight_plan(
    &self,
    ship_id: String,
    destination: String
) -> Result<FlightPlan, SpaceTradersClientError>

Create a flight plan.

Arguments

• ship_id - A string containing the ship_id to create the flight plan for
• destination - A string containing the location to send the ship to

pub async fn get_my_loans(&self) -> Result<LoanInfo, SpaceTradersClientError>

Get any loans taken out by the current user

pub async fn pay_off_loan(
    &self,
    loan_id: &str
) -> Result<PayLoanResponse, SpaceTradersClientError>

Pay off a loan completely

Arguments

• loan_id - A string containing the loan_id of the loan to pay off

pub async fn request_new_loan(
    &self,
    loan_type: LoanType
) -> Result<RequestLoan, SpaceTradersClientError>

Request a new loan

Arguments

• loan_type - A LoanType with the type of loan being requested for the current user

pub async fn get_location_info(
    &self,
    location_symbol: String
) -> Result<LocationInfo, SpaceTradersClientError>

Get location info about a specific location

Arguments

• location_symbol - A string containing the location name to get info about

pub async fn get_location_marketplace(
    &self,
    location_symbol: &str
) -> Result<LocationMarketplace, SpaceTradersClientError>

Get the marketplace data about a location.

Note

You must have a ship docked at the location in order to get it’s marketplace data

Arguments

• location_symbol - A string containing the name of the location to get marketplace data for

pub async fn create_purchase_order(
    &self,
    ship_id: String,
    good: Good,
    quantity: i32
) -> Result<PurchaseOrder, SpaceTradersClientError>

Create a purchase order to transfer goods from a location to your ship

Arguments

• ship - A Ship struct that you’d like to transfer the goods into
• good - A Good enum containing the type of good you’d like to transfer
• quantity - An i32 containing the quantity of good you’d like transferred

pub async fn create_sell_order(
    &self,
    ship_id: String,
    good: Good,
    quantity: i32
) -> Result<PurchaseOrder, SpaceTradersClientError>

Create a sell order to transfer good from your ship to a location. Your ship will automatically sell the good to whatever location it is docked at

Arguments

• ship - A Ship struct that you’d like to transfer the goods from
• good - A Good enum containing the type of good you’d like to transfer
• quantity - An i32 containing the quantity of good you’d like transferred

pub async fn purchase_ship(
    &self,
    location_symbol: String,
    ship_type: String
) -> Result<PurchaseShip, SpaceTradersClientError>

Add a ship to the users inventory by purchasing it

Arguments

• location_symbol - A string containing the location you’d like to purchase the ship from
• ship_type - A string containing the type of ship you’d like to purchase

pub async fn get_my_ship(
    &self,
    ship_id: &str
) -> Result<MyShip, SpaceTradersClientError>

Get info about a specific ship for the current user

Arguments

• ship_id - A string id of the ship you’d like info about

pub async fn get_my_ships(&self) -> Result<MyShips, SpaceTradersClientError>

Get all your ships

pub async fn jettison_cargo(
    &self,
    ship_id: &str,
    good: Good,
    quantity: i32
) -> Result<JettisonCargo, SpaceTradersClientError>

Jettison cargo from a ship

pub async fn get_ships_for_sale(
    &self
) -> Result<ShipsForSale, SpaceTradersClientError>

Get all ships that are available for sale

pub async fn get_systems_info(
    &self
) -> Result<SystemsInfo, SpaceTradersClientError>

Get information about all systems

pub async fn get_available_loans(
    &self
) -> Result<AvailableLoans, SpaceTradersClientError>

Get all available loans

pub async fn attempt_warp_jump(
    &self,
    ship_id: String
) -> Result<FlightPlan, SpaceTradersClientError>

Attempt a warp jump

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.