Struct Client 

pub struct Client { /* private fields */ }

Implementations

impl Client

pub fn new( http: Client, instance: InstanceUrl, auth: Arc<dyn TokenSource>, retries: u32, ) -> Self

pub fn has_written(&self) -> bool

Whether this client sent a change the server may have applied (a non-GET request it answered, or one that timed out).

pub fn instance(&self) -> &InstanceUrl

pub async fn get<T: Projection>( &self, path: &str, query: &[(&str, &str)], ) -> Result<T>

GETs path (relative to /api/) with query, adding T::FIELDS.

pub async fn post<T: Projection>(&self, path: &str, body: &Value) -> Result<T>

POSTs body to path (relative to /api/) and decodes the answer, asking for T::FIELDS. A write: never retried.

pub async fn post_query<T: Projection>( &self, path: &str, body: &Value, ) -> Result<T>

A POST that only reads (commands/assist): retried like a GET and not counted as a write.

pub async fn post_unit(&self, path: &str, body: &Value) -> Result<()>

POSTs body to path and ignores the answer.

pub async fn delete(&self, path: &str) -> Result<()>

pub async fn upload<T: Projection>( &self, path: &str, files: &[(String, Vec<u8>)], ) -> Result<T>

Uploads files in one multipart POST to path and decodes the answer. A write: never retried.

pub async fn download(&self, url: &str) -> Result<Response>

GETs a file URL YouTrack handed out (relative to the instance) and returns the response for streaming.

pub async fn raw( &self, method: Method, path_and_query: &str, body: Option<&Value>, ) -> Result<Option<String>>

Sends a request as given and returns YouTrack’s JSON text, None for an empty body. Only GET is retried.

pub async fn get_all<T>(&self, path: &str) -> Result<Vec<T>>

where T: Projection + Send + 'static,

Every item of a collection, read in pages of LIST_PAGE.

pub fn paginate<T>( &self, path: String, query: Vec<(String, String)>, page_size: usize, ) -> impl Stream<Item = Result<T>> + Send + '_

where T: Projection + Send + 'static,

Pages through a collection with $skip/$top, shrinking the page if the instance caps its size.