Struct RelayClient 

pub struct RelayClient { /* private fields */ }

A thin, read-only client over the public relays.

Holds the shared reqwest::Client (never builds its own — one connection pool for the whole 512 MB box) and the normalized host list. Every request goes through crate::net::guarded_get_no_privacy; see the module doc for why.

Implementations

impl RelayClient

pub fn new(http: Client, hosts: &[String]) -> Result<Self, RelayError>

Build a client over hosts (bare hostnames or full URLs; see normalize_relay_host), deduped with configured order preserved.

An empty host list is Ok and yields is_enabled() == false — that is the operator’s second off-switch, alongside an interval of 0, and must not be an error. A malformed host, by contrast, fails loud: a typo should be visible, not silently probed forever.

pub fn with_page_limit(self, limit: u32) -> Self

Override the per-page repo limit, clamped into the relay’s usable range. The seam a future config knob would use; the clamp is what stops a 0 (which the live relay answers with one repo and a cursor) from burning the whole page budget.

pub fn hosts(&self) -> &[String]

The normalized relay base URLs this client will query, in order.

pub fn is_enabled(&self) -> bool

Whether there is anything to query at all.

pub async fn count_repos_with_collection( &self, collection: &str, ) -> AdoptionReport

Count the repos holding collection on every configured relay.

Hosts are queried sequentially, in configured order: the politeness budget is per-run, both default relays are operated by the same party, and sequential keeps peak memory at one page while making observations deterministically ordered. A 429 from any host aborts the whole run (both defaults sit behind one operator’s rate limiter, so hammering the next one after the first says “slow down” is the impolite reading).

Never returns Err: a failure is data, recorded per-host on the report.

Trait Implementations

impl Clone for RelayClient

fn clone(&self) -> RelayClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelayClient

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

Formats the value using the given formatter.