Struct PubChemClient 

pub struct PubChemClient { /* private fields */ }

PubChem REST API client with built-in rate limiting and in-memory caching.

Cheap to clone — all internal state is reference-counted.

Implementations

impl PubChemClient

pub fn new() -> Self

Create a client with PubChem’s default rate limit (5 req/s).

Panics

Panics if the TLS backend cannot be initialised (extremely rare; indicates a broken system environment).

pub fn builder() -> PubChemClientBuilder

Start building a customised client.

pub async fn lookup(&self, id: &SubstanceIdentifier) -> Result<PubChemCompound>

Look up a compound by the best available identifier.

Priority: CAS number → InChIKey → InChI → SMILES → IUPAC name.

Results are cached by CID, so repeated calls for the same compound are free after the first network request.

Errors

• PubChemError::NotFound — no compound matched.
• PubChemError::NoUsableIdentifier — the identifier has no usable field.
• PubChemError::Http — network or server error.
• PubChemError::RateLimitExceeded — PubChem returned HTTP 429.

pub async fn enrich(&self, id: &mut SubstanceIdentifier) -> Result<()>

Enrich id in place with PubChem data, filling any missing fields.

On PubChemError::NotFound or PubChemError::NoUsableIdentifier this is a silent no-op (enrichment is best-effort). Other errors (network, parse) are propagated.

Trait Implementations

impl Clone for PubChemClient

fn clone(&self) -> PubChemClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PubChemClient

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

Formats the value using the given formatter.

impl Default for PubChemClient

fn default() -> Self

Returns the “default value” for a type.