Skip to main content

Config

Struct Config 

Source
pub struct Config {
    pub credentials: Credentials,
    pub rest_api: RestApiConfig,
    pub websocket: WebSocketConfig,
    pub database: DatabaseConfig,
    pub rate_limiter: RateLimiterConfig,
    pub sleep_hours: u64,
    pub page_size: u32,
    pub days_to_look_back: i64,
    pub api_version: Option<u8>,
}
Expand description

Main configuration for the IG Markets API client.

Debug is derived and delegates to each field’s Debug, so the redacting Credentials and DatabaseConfig impls keep secrets out of the output; Display is manual for the same reason.

Fields§

§credentials: Credentials

Authentication credentials

§rest_api: RestApiConfig

REST API configuration

§websocket: WebSocketConfig

WebSocket API configuration

§database: DatabaseConfig

Database configuration for data persistence

§rate_limiter: RateLimiterConfig

Rate limiter configuration for API requests

§sleep_hours: u64

Number of hours between transaction fetching operations

§page_size: u32

Number of items to retrieve per page in API requests

§days_to_look_back: i64

Number of days to look back when fetching historical data

§api_version: Option<u8>

API version to use for authentication: Some(2) for CST / X-SECURITY-TOKEN, Some(3) for OAuth. Both constructors set Some(3) (crate::constants::DEFAULT_API_VERSION); an explicit None makes login fall back to v2.

Implementations§

Source§

impl Config

Source

pub fn from_credentials(credentials: Credentials) -> Self

Creates a configuration from caller-supplied credentials, reading no environment variable and loading no .env file.

This is the injection path for embedding applications that own their configuration source (their own namespaced env vars, a config file, a secrets manager). Pair it with Client::with_config. Config::new remains the .env / IG_* convenience path.

Every non-credential field takes its documented default (IG demo endpoints — see the Default impls of RestApiConfig, WebSocketConfig, RateLimiterConfig and DatabaseConfig). Override individual sections with a struct-update expression, which stays env-free because the base value is this constructor:

use ig_client::prelude::*;

let credentials = Credentials::new(
    "user".to_string(),
    "password".to_string(),
    "ABC123".to_string(),
    "api-key".to_string(),
);
let config = Config {
    rest_api: RestApiConfig {
        base_url: "https://demo-api.ig.com/gateway/deal".to_string(),
        timeout: 30,
    },
    ..Config::from_credentials(credentials)
};
assert_eq!(config.rest_api.base_url, "https://demo-api.ig.com/gateway/deal");
§Arguments
  • credentials - IG credentials supplied by the caller
§Returns

A Config built entirely from credentials plus the documented defaults

Source

pub fn new() -> Self

Creates a new configuration instance from the environment.

Loads a local .env file (via dotenv) and reads the IG_* / DATABASE_* / TX_* environment variables, falling back to the documented defaults for anything unset. Embedders that must not touch the .env file or the IG_* namespace should use Config::from_credentials instead.

§Returns

A new Config instance

Trait Implementations§

Source§

impl Clone for Config

Source§

fn clone(&self) -> Config

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Config

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Config

Source§

fn default() -> Self

Delegates to Config::new and therefore loads a .env file and reads the IG_* namespace — unlike the section-level Default impls above, which are env-free. Config { .., ..Config::default() } still touches the environment; use Config::from_credentials as the base value when that is not acceptable.

Source§

impl<'de> Deserialize<'de> for Config

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Display for Config

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Serialize for Config

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more