salesforce_core 0.13.5

Unofficial Rust SDK for Salesforce Core APIs (Sales, Service, Platform)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Shared test utilities for integration tests.
//!
//! Provides authentication helpers and a skip macro for tests that require
//! Salesforce credentials via a JSON file path in `SFDC_CREDENTIALS`.

use salesforce_core::client;
use std::env;

/// Environment variable pointing to the credentials JSON file.
const CREDENTIALS_ENV: &str = "SFDC_CREDENTIALS";

/// Returns true if the credentials environment variable is set.
pub fn credentials_available() -> bool {
    env::var(CREDENTIALS_ENV).is_ok()
}

/// Skips the current test if Salesforce credentials are not configured.
///
/// Must be called at the start of every integration test. The test function
/// must return `Result<(), Box<dyn std::error::Error>>`.
#[macro_export]
macro_rules! skip_if_no_credentials {
    () => {
        if !common::credentials_available() {
            eprintln!(
                "Skipping integration test: set SFDC_CREDENTIALS to a JSON file path to run."
            );
            return Ok(());
        }
    };
}

/// Creates an authenticated Salesforce client by loading credentials from the
/// JSON file specified in the `SFDC_CREDENTIALS` environment variable.
///
/// The JSON file should contain:
/// ```json
/// {
///   "client_id": "...",
///   "client_secret": "...",
///   "instance_url": "https://your-instance.my.salesforce.com",
///   "tenant_id": "..."
/// }
/// ```
pub async fn auth_client() -> Result<client::Client, Box<dyn std::error::Error>> {
    let path = env::var(CREDENTIALS_ENV)?;
    let client = client::Builder::new()
        .credentials_path(path.into())
        .build()?
        .connect()
        .await?;
    Ok(client)
}