Skip to main content

Network

Struct Network 

Source
pub struct Network {
    private: PrivateAddresses,
    local: Arc<dyn LocalRepositories>,
}
Expand description

The real fetch: resolve the DID to its #atproto_pds endpoint, then com.atproto.repo.getRecord there.

Both hops go through [didbot_http::pinned_client], which resolves the host once, refuses it at a private address, pins the connection to what it resolved to and follows no redirect. Both hops read a bounded body. Every URL here is named by somebody else — the DID’s own document says which server holds the repository — which is the same posture didbot_serve::tree::oidc takes toward an issuer a token names.

Fields§

§private: PrivateAddresses§local: Arc<dyn LocalRepositories>

Implementations§

Source§

impl Network

Source

pub fn new(local: Arc<dyn LocalRepositories>, private: PrivateAddresses) -> Self

A fetcher that refuses what local already holds, and refuses a private address unless private allows one.

Source

async fn endpoint(&self, did: &str) -> Result<String, Unknown>

The #atproto_pds endpoint did’s document names.

Source

async fn get_bounded( &self, url: &str, max_bytes: usize, ) -> Result<Vec<u8>, Unknown>

A GET through a client pinned to url’s own addresses, with its body read against max_bytes.

Source

async fn send(&self, url: &str) -> Result<Response, Unknown>

A GET through a client pinned to url’s own addresses, with the status left to the caller.

Source

async fn list_records(&self, endpoint: &str, collection: &RecordRef) -> Fetched

com.atproto.repo.listRecords for every record in collection at endpoint, as an array of {"uri": …, "value": …}.

An empty collection is Fetched::Absent, the same answer a key nothing holds gets: the repository answered, and holds nothing there.

Source

async fn get_record( &self, endpoint: &str, record: &RecordRef, rkey: &str, ) -> Fetched

com.atproto.repo.getRecord for record at endpoint, as an array holding the one {"uri": …, "value": …} it found, so a caller reads one record and a whole collection the same way.

Trait Implementations§

Source§

impl Fetch for Network

Source§

fn fetch<'a>(&'a self, record: &'a RecordRef) -> FetchFuture<'a>

Read record from the repository that holds it.

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<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

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

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

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.

§

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

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: 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
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: 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, 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.
§

impl<T> WithSubscriber for T

§

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
§

fn with_current_subscriber(self) -> WithDispatch<Self>

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