OMGeeky/google-apis-rs
1
0
Fork 0
mirror of https://github.com/OMGeeky/google-apis-rs.git synced 2026-02-23 15:49:49 +01:00
Code Issues Packages Projects Releases Wiki Activity

regen all APIs

Browse Source
This commit is contained in:
Sebastian Thiel
2021-08-31 08:03:52 +08:00
parent 21914b2c4d
commit d032b0c961
2479 changed files with 14830 additions and 13186 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
gen/groupsmigration1/Cargo.toml
View File

@@ -4,12 +4,12 @@
[package]
name = "google-groupsmigration1"
version = "2.0.5+20210318"
version = "2.0.8+20210318"
authors = ["Sebastian Thiel <byronimo@gmail.com>"]
description = "A complete library to interact with Groups Migration (protocol v1)"
repository = "https://github.com/Byron/google-apis-rs/tree/main/gen/groupsmigration1"
homepage = "https://developers.google.com/google-apps/groups-migration/"
documentation = "https://docs.rs/google-groupsmigration1/2.0.5+20210318"
documentation = "https://docs.rs/google-groupsmigration1/2.0.8+20210318"
license = "MIT"
keywords = ["groupsmigration", "google", "protocol", "web", "api"]
autobins = false

44
gen/groupsmigration1/README.md
View File

@@ -5,21 +5,21 @@ DO NOT EDIT !
-->
The `google-groupsmigration1` library allows access to all features of the *Google Groups Migration* service.
This documentation was generated from *Groups Migration* crate version *2.0.5+20210318*, where *20210318* is the exact revision of the *groupsmigration:v1* schema built by the [mako](http://www.makotemplates.org/) code generator *v2.0.5*.
This documentation was generated from *Groups Migration* crate version *2.0.8+20210318*, where *20210318* is the exact revision of the *groupsmigration:v1* schema built by the [mako](http://www.makotemplates.org/) code generator *v2.0.8*.
Everything else about the *Groups Migration* *v1* API can be found at the
[official documentation site](https://developers.google.com/google-apps/groups-migration/).
# Features
Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/GroupsMigration) ...
Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/GroupsMigration) ...
* archive
* [*insert*](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/api::ArchiveInsertCall)
* [*insert*](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/api::ArchiveInsertCall)
Upload supported by ...
* [*insert archive*](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/api::ArchiveInsertCall)
* [*insert archive*](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/api::ArchiveInsertCall)
@@ -27,17 +27,17 @@ Upload supported by ...
The API is structured into the following primary items:
* **[Hub](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/GroupsMigration)**
* **[Hub](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/GroupsMigration)**
* a central object to maintain state and allow accessing all *Activities*
* creates [*Method Builders*](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::MethodsBuilder) which in turn
allow access to individual [*Call Builders*](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::CallBuilder)
* **[Resources](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Resource)**
* creates [*Method Builders*](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::MethodsBuilder) which in turn
allow access to individual [*Call Builders*](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::CallBuilder)
* **[Resources](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Resource)**
* primary types that you can apply *Activities* to
* a collection of properties and *Parts*
* **[Parts](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Part)**
* **[Parts](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Part)**
* a collection of properties
* never directly used in *Activities*
* **[Activities](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::CallBuilder)**
* **[Activities](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::CallBuilder)**
* operations to apply to *Resources*
All *structures* are marked with applicable traits to further categorize them and ease browsing.
@@ -128,17 +128,17 @@ match result {
```
## Handling Errors
All errors produced by the system are provided either as [Result](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Result) enumeration as return value of
All errors produced by the system are provided either as [Result](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Result) enumeration as return value of
the doit() methods, or handed as possibly intermediate results to either the
[Hub Delegate](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html).
[Hub Delegate](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html).
When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This
makes the system potentially resilient to all kinds of errors.
## Uploads and Downloads
If a method supports downloads, the response body, which is part of the [Result](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Result), should be
If a method supports downloads, the response body, which is part of the [Result](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Result), should be
read by you to obtain the media.
If such a method also supports a [Response Result](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::ResponseResult), it will return that by default.
If such a method also supports a [Response Result](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::ResponseResult), it will return that by default.
You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making
this call: `.param("alt", "media")`.
@@ -148,29 +148,29 @@ Methods supporting uploads can do so using up to 2 different protocols:
## Customization and Callbacks
You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Delegate) to the
[Method Builder](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::CallBuilder) before making the final `doit()` call.
You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Delegate) to the
[Method Builder](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::CallBuilder) before making the final `doit()` call.
Respective methods will be called to provide progress information, as well as determine whether the system should
retry on failure.
The [delegate trait](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort.
The [delegate trait](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort.
## Optional Parts in Server-Requests
All structures provided by this library are made to be [encodable](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::RequestValue) and
[decodable](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses
All structures provided by this library are made to be [encodable](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::RequestValue) and
[decodable](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses
are valid.
Most optionals are are considered [Parts](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::Part) which are identifiable by name, which will be sent to
Most optionals are are considered [Parts](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::Part) which are identifiable by name, which will be sent to
the server to indicate either the set parts of the request or the desired parts in the response.
## Builder Arguments
Using [method builders](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::CallBuilder), you are able to prepare an action call by repeatedly calling it's methods.
Using [method builders](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::CallBuilder), you are able to prepare an action call by repeatedly calling it's methods.
These will always take a single argument, for which the following statements are true.
* [PODs][wiki-pod] are handed by copy
* strings are passed as `&str`
* [request values](https://docs.rs/google-groupsmigration1/2.0.5+20210318/google_groupsmigration1/client::RequestValue) are moved
* [request values](https://docs.rs/google-groupsmigration1/2.0.8+20210318/google_groupsmigration1/client::RequestValue) are moved
Arguments will always be copied or cloned into the builder, to make them independent of their original life times.

5
gen/groupsmigration1/src/api.rs
View File

@@ -99,6 +99,7 @@ impl Default for Scope {
/// }
/// # }
/// ```
#[derive(Clone)]
pub struct GroupsMigration<> {
client: hyper::Client<hyper_rustls::HttpsConnector<hyper::client::connect::HttpConnector>, hyper::body::Body>,
auth: oauth2::authenticator::Authenticator<hyper_rustls::HttpsConnector<hyper::client::connect::HttpConnector>>,
@@ -115,7 +116,7 @@ impl<'a, > GroupsMigration<> {
GroupsMigration {
client,
auth: authenticator,
_user_agent: "google-api-rust-client/2.0.5".to_string(),
_user_agent: "google-api-rust-client/2.0.8".to_string(),
_base_url: "https://groupsmigration.googleapis.com/".to_string(),
_root_url: "https://groupsmigration.googleapis.com/".to_string(),
}
@@ -126,7 +127,7 @@ impl<'a, > GroupsMigration<> {
}
/// Set the user-agent header field to use in all requests to the server.
/// It defaults to `google-api-rust-client/2.0.5`.
/// It defaults to `google-api-rust-client/2.0.8`.
///
/// Returns the previously set user-agent.
pub fn user_agent(&mut self, agent_name: String) -> String {

27
gen/groupsmigration1/src/client.rs
View File

@@ -61,8 +61,8 @@ pub trait Part {}
pub trait NestedType {}
/// A utility to specify reader types which provide seeking capabilities too
pub trait ReadSeek: Seek + Read {}
impl<T: Seek + Read> ReadSeek for T {}
pub trait ReadSeek: Seek + Read + Send {}
impl<T: Seek + Read + Send> ReadSeek for T {}
/// A trait for all types that can convert themselves into a *parts* string
pub trait ToParts {
@@ -362,8 +362,8 @@ const BOUNDARY: &str = "MDuXWGyeE33QFXGchb2VFWc4Z7945d";
/// to google APIs, and might not be a fully-featured implementation.
#[derive(Default)]
pub struct MultiPartReader<'a> {
raw_parts: Vec<(HeaderMap, &'a mut dyn Read)>,
current_part: Option<(Cursor<Vec<u8>>, &'a mut dyn Read)>,
raw_parts: Vec<(HeaderMap, &'a mut (dyn Read + Send))>,
current_part: Option<(Cursor<Vec<u8>>, &'a mut (dyn Read + Send))>,
last_part_boundary: Option<Cursor<Vec<u8>>>,
}
@@ -386,7 +386,7 @@ impl<'a> MultiPartReader<'a> {
/// `mime` - It will be put onto the content type
pub fn add_part(
&mut self,
reader: &'a mut dyn Read,
reader: &'a mut (dyn Read + Send),
size: u64,
mime_type: Mime,
) -> &mut MultiPartReader<'a> {
@@ -405,7 +405,7 @@ impl<'a> MultiPartReader<'a> {
pub fn mime_type(&self) -> Mime {
Mime(
TopLevel::Multipart,
SubLevel::Ext("Related".to_string()),
SubLevel::Ext("related".to_string()),
vec![(
Attr::Ext("boundary".to_string()),
Value::Ext(BOUNDARY.to_string()),
@@ -449,9 +449,11 @@ impl<'a> Read for MultiPartReader<'a> {
(n, true, _) if n > 0 => {
let (headers, reader) = self.raw_parts.remove(0);
let mut c = Cursor::new(Vec::<u8>::new());
// TODO: The first line ending should be omitted for the first part,
// fortunately Google's API serves don't seem to mind.
(write!(
&mut c,
"{}--{}{}{}{}",
"{}--{}{}{}{}{}",
LINE_ENDING,
BOUNDARY,
LINE_ENDING,
@@ -459,7 +461,8 @@ impl<'a> Read for MultiPartReader<'a> {
.iter()
.map(|(k, v)| format!("{}: {}", k, v.to_str().unwrap()))
.join(LINE_ENDING),
LINE_ENDING
LINE_ENDING,
LINE_ENDING,
))
.unwrap();
c.seek(SeekFrom::Start(0)).unwrap();
@@ -482,7 +485,7 @@ impl<'a> Read for MultiPartReader<'a> {
// before clearing the last part, we will add the boundary that
// will be written last
self.last_part_boundary = Some(Cursor::new(
format!("{}--{}--", LINE_ENDING, BOUNDARY).into_bytes(),
format!("{}--{}--{}", LINE_ENDING, BOUNDARY, LINE_ENDING).into_bytes(),
))
}
// We are depleted - this can trigger the next part to come in
@@ -696,8 +699,9 @@ impl<'a, A> ResumableUploadHelper<'a, A> {
_ => MIN_CHUNK_SIZE,
};
self.reader.seek(SeekFrom::Start(start)).unwrap();
loop {
self.reader.seek(SeekFrom::Start(start)).unwrap();
let request_size = match self.content_length - start {
rs if rs > chunk_size => chunk_size,
rs => rs,
@@ -713,7 +717,6 @@ impl<'a, A> ResumableUploadHelper<'a, A> {
}),
total_length: self.content_length,
};
start += request_size;
if self.delegate.cancel_chunk_upload(&range_header) {
return None;
}
@@ -732,6 +735,8 @@ impl<'a, A> ResumableUploadHelper<'a, A> {
.await;
match res {
Ok(res) => {
start += request_size;
if res.status() == StatusCode::PERMANENT_REDIRECT {
continue;
}

2
gen/groupsmigration1/src/lib.rs
View File

@@ -2,7 +2,7 @@
// This file was generated automatically from 'src/mako/api/lib.rs.mako'
// DO NOT EDIT !
//! This documentation was generated from *Groups Migration* crate version *2.0.5+20210318*, where *20210318* is the exact revision of the *groupsmigration:v1* schema built by the [mako](http://www.makotemplates.org/) code generator *v2.0.5*.
//! This documentation was generated from *Groups Migration* crate version *2.0.8+20210318*, where *20210318* is the exact revision of the *groupsmigration:v1* schema built by the [mako](http://www.makotemplates.org/) code generator *v2.0.8*.
//!
//! Everything else about the *Groups Migration* *v1* API can be found at the
//! [official documentation site](https://developers.google.com/google-apps/groups-migration/).