Make Client::send a public method, add a short doccomment

master
Emi Simpson 2020-05-20 14:24:35 -04:00
parent 1d9fccdc9f
commit 53876ea6e8
No known key found for this signature in database
GPG Key ID: 68FAB2E2E6DFC98B
1 changed files with 11 additions and 1 deletions

View File

@ -916,7 +916,17 @@ impl Client {
} }
} }
async fn send<Request: Endpoint<ResponseError = crate::api::Error> + std::fmt::Debug>( /// Send an arbitrary request to the server, without updating client state
///
/// **Warning:** Because this method *does not* update the client state, it is
/// important to make sure than you account for this yourself, and use wrapper methods
/// where available. This method should *only* be used if a wrapper method for the
/// endpoint you'd like to use is not available.
///
/// # Arguments
///
/// * `request` - A filled out and valid request for the endpoint to be hit
pub async fn send<Request: Endpoint<ResponseError = crate::api::Error> + std::fmt::Debug>(
&self, &self,
request: Request, request: Request,
) -> Result<Request::Response> { ) -> Result<Request::Response> {