From 4d63cd09c1d97480c14be80a74e49f5f4134b340 Mon Sep 17 00:00:00 2001 From: Cyborus Date: Fri, 9 Feb 2024 17:02:42 -0500 Subject: better document structs --- generator/src/structs.rs | 16 + src/generated.rs | 986 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 1002 insertions(+) diff --git a/generator/src/structs.rs b/generator/src/structs.rs index 1d07ab4..45e2f71 100644 --- a/generator/src/structs.rs +++ b/generator/src/structs.rs @@ -65,6 +65,15 @@ pub fn create_struct_for_definition( if field_ty == "Option" { fields.push_str("#[serde(with = \"time::serde::rfc3339::option\")]\n"); } + if let MaybeRef::Value { value } = &prop_schema { + if let Some(desc) = &value.description { + for line in desc.lines() { + fields.push_str("/// "); + fields.push_str(line); + fields.push_str("\n/// \n"); + } + } + } if &field_name != prop_name { fields.push_str("#[serde(rename = \""); fields.push_str(prop_name); @@ -159,6 +168,13 @@ fn create_query_struct(op: &Operation) -> eyre::Result { if let ParameterIn::Query { param: query_param } = ¶m._in { let ty = crate::methods::param_type(query_param, true)?; let field_name = crate::sanitize_ident(¶m.name); + if let Some(desc) = ¶m.description { + for line in desc.lines() { + fields.push_str("/// "); + fields.push_str(line); + fields.push_str("\n/// \n"); + } + } fields.push_str("pub "); fields.push_str(&field_name); fields.push_str(": "); diff --git a/src/generated.rs b/src/generated.rs index 231f93d..a0fb4b5 100644 --- a/src/generated.rs +++ b/src/generated.rs @@ -7281,7 +7281,11 @@ pub mod structs { pub struct AddTimeOption { #[serde(with = "time::serde::rfc3339::option")] pub created: Option, + /// time in seconds + /// pub time: u64, + /// User who spent the time (optional) + /// pub user_name: Option, } @@ -7356,6 +7360,8 @@ pub mod structs { pub block_on_official_review_requests: Option, pub block_on_outdated_branch: Option, pub block_on_rejected_reviews: Option, + /// Deprecated: true + /// pub branch_name: Option, #[serde(with = "time::serde::rfc3339::option")] pub created_at: Option, @@ -7384,10 +7390,20 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct ChangeFileOperation { + /// new or updated file content, must be base64 encoded + /// pub content: Option, + /// old path of the file to move + /// pub from_path: Option, + /// indicates what to do with the file + /// pub operation: String, + /// path to the existing or new file + /// pub path: String, + /// sha is the SHA for the file that already exists, required for update or delete + /// pub sha: Option, } @@ -7398,12 +7414,22 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct ChangeFilesOptions { pub author: Option, + /// branch (optional) to base this file from. if not given, the default branch is used + /// pub branch: Option, pub committer: Option, pub dates: Option, + /// list of file operations + /// pub files: Vec, + /// message (optional) for the commit of this file. if not supplied, a default message will be used + /// pub message: Option, + /// new_branch (optional) will make a new branch from `branch` before creating the file + /// pub new_branch: Option, + /// Add a Signed-off-by trailer by the committer at the end of the commit log message. + /// pub signoff: Option, } @@ -7554,9 +7580,13 @@ pub mod structs { pub struct ContentsResponse { #[serde(rename = "_links")] pub links: Option, + /// `content` is populated when `type` is `file`, otherwise null + /// pub content: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] pub download_url: Option, + /// `encoding` is populated when `type` is `file`, otherwise null + /// pub encoding: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] pub git_url: Option, @@ -7568,8 +7598,14 @@ pub mod structs { pub sha: Option, pub size: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] + /// `submodule_git_url` is populated when `type` is `submodule`, otherwise null + /// pub submodule_git_url: Option, + /// `target` is populated when `type` is `symlink`, otherwise null + /// pub target: Option, + /// `type` will be `file`, `dir`, `symlink`, or `submodule` + /// #[serde(rename = "type")] pub r#type: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] @@ -7593,6 +7629,8 @@ pub mod structs { pub block_on_official_review_requests: Option, pub block_on_outdated_branch: Option, pub block_on_rejected_reviews: Option, + /// Deprecated: true + /// pub branch_name: Option, pub dismiss_stale_approvals: Option, pub enable_approvals_whitelist: Option, @@ -7617,8 +7655,16 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateBranchRepoOption { + /// Name of the branch to create + /// pub new_branch_name: String, + /// Deprecated: true + /// + /// Name of the old branch to create from + /// pub old_branch_name: Option, + /// Name of the old branch/tag/commit to create from + /// pub old_ref_name: Option, } @@ -7626,6 +7672,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateEmailOption { + /// email addresses to add + /// pub emails: Option>, } @@ -7636,12 +7684,22 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateFileOptions { pub author: Option, + /// branch (optional) to base this file from. if not given, the default branch is used + /// pub branch: Option, pub committer: Option, + /// content must be base64 encoded + /// pub content: String, pub dates: Option, + /// message (optional) for the commit of this file. if not supplied, a default message will be used + /// pub message: Option, + /// new_branch (optional) will make a new branch from `branch` before creating the file + /// pub new_branch: Option, + /// Add a Signed-off-by trailer by the committer at the end of the commit log message. + /// pub signoff: Option, } @@ -7649,7 +7707,11 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateForkOption { + /// name of the forked repository + /// pub name: Option, + /// organization name, if forking into an organization + /// pub organization: Option, } @@ -7657,6 +7719,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateGPGKeyOption { + /// An armored GPG key to add + /// pub armored_public_key: String, pub armored_signature: Option, } @@ -7697,13 +7761,19 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateIssueOption { + /// deprecated + /// pub assignee: Option, pub assignees: Option>, pub body: Option, pub closed: Option, #[serde(with = "time::serde::rfc3339::option")] pub due_date: Option, + /// list of label ids + /// pub labels: Option>, + /// milestone id + /// pub milestone: Option, #[serde(rename = "ref")] pub r#ref: Option, @@ -7714,8 +7784,14 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateKeyOption { + /// An armored SSH key to add + /// pub key: String, + /// Describe if the key has only read access or read/write + /// pub read_only: Option, + /// Title of the key to add + /// pub title: String, } @@ -7754,6 +7830,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateOrUpdateSecretOption { + /// Data of the secret to update + /// pub data: String, } @@ -7767,6 +7845,8 @@ pub mod structs { pub location: Option, pub repo_admin_change_team_access: Option, pub username: String, + /// possible values are `public` (default), `limited` or `private` + /// pub visibility: Option, pub website: Option, } @@ -7792,8 +7872,14 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreatePullReviewComment { pub body: Option, + /// if comment to new file line or 0 + /// pub new_position: Option, + /// if comment to old file line or 0 + /// pub old_position: Option, + /// the tree path + /// pub path: Option, } @@ -7832,16 +7918,38 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateRepoOption { + /// Whether the repository should be auto-initialized? + /// pub auto_init: Option, + /// DefaultBranch of the repository (used when initializes and in template) + /// pub default_branch: Option, + /// Description of the repository to create + /// pub description: Option, + /// Gitignores to use + /// pub gitignores: Option, + /// Label-Set to use + /// pub issue_labels: Option, + /// License to use + /// pub license: Option, + /// Name of the repository to create + /// pub name: String, + /// Whether the repository is private + /// pub private: Option, + /// Readme of the repository to create + /// pub readme: Option, + /// Whether the repository is template + /// pub template: Option, + /// TrustModel of the repository + /// pub trust_model: Option, } @@ -7883,6 +7991,12 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateUserOption { #[serde(with = "time::serde::rfc3339::option")] + /// For explicitly setting the user creation timestamp. Useful when users are + /// + /// migrated from other systems. When omitted, the user's creation timestamp + /// + /// will be set to "now". + /// pub created_at: Option, pub email: String, pub full_name: Option, @@ -7900,8 +8014,14 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct CreateWikiPageOptions { + /// content must be base64 encoded + /// pub content_base64: Option, + /// optional commit message summarizing the change + /// pub message: Option, + /// page title. leave empty to keep unchanged + /// pub title: Option, } @@ -7922,6 +8042,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct DeleteEmailOption { + /// email addresses to delete + /// pub emails: Option>, } @@ -7932,12 +8054,22 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct DeleteFileOptions { pub author: Option, + /// branch (optional) to base this file from. if not given, the default branch is used + /// pub branch: Option, pub committer: Option, pub dates: Option, + /// message (optional) for the commit of this file. if not supplied, a default message will be used + /// pub message: Option, + /// new_branch (optional) will make a new branch from `branch` before creating the file + /// pub new_branch: Option, + /// sha is the SHA for the file that already exists + /// pub sha: String, + /// Add a Signed-off-by trailer by the committer at the end of the commit log message. + /// pub signoff: Option, } @@ -8047,6 +8179,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct EditIssueOption { + /// deprecated + /// pub assignee: Option, pub assignees: Option>, pub body: Option, @@ -8093,6 +8227,8 @@ pub mod structs { pub full_name: Option, pub location: Option, pub repo_admin_change_team_access: Option, + /// possible values are `public`, `limited` or `private` + /// pub visibility: Option, pub website: Option, } @@ -8138,35 +8274,93 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct EditRepoOption { + /// either `true` to allow mark pr as merged manually, or `false` to prevent it. + /// pub allow_manual_merge: Option, + /// either `true` to allow merging pull requests with a merge commit, or `false` to prevent merging pull requests with merge commits. + /// pub allow_merge_commits: Option, + /// either `true` to allow rebase-merging pull requests, or `false` to prevent rebase-merging. + /// pub allow_rebase: Option, + /// either `true` to allow rebase with explicit merge commits (--no-ff), or `false` to prevent rebase with explicit merge commits. + /// pub allow_rebase_explicit: Option, + /// either `true` to allow updating pull request branch by rebase, or `false` to prevent it. + /// pub allow_rebase_update: Option, + /// either `true` to allow squash-merging pull requests, or `false` to prevent squash-merging. + /// pub allow_squash_merge: Option, + /// set to `true` to archive this repository. + /// pub archived: Option, + /// either `true` to enable AutodetectManualMerge, or `false` to prevent it. Note: In some special cases, misjudgments can occur. + /// pub autodetect_manual_merge: Option, + /// set to `true` to allow edits from maintainers by default + /// pub default_allow_maintainer_edit: Option, + /// sets the default branch for this repository. + /// pub default_branch: Option, + /// set to `true` to delete pr branch after merge by default + /// pub default_delete_branch_after_merge: Option, + /// set to a merge style to be used by this repository: "merge", "rebase", "rebase-merge", or "squash". + /// pub default_merge_style: Option, + /// a short description of the repository. + /// pub description: Option, + /// enable prune - remove obsolete remote-tracking references + /// pub enable_prune: Option, pub external_tracker: Option, pub external_wiki: Option, + /// either `true` to enable actions unit, or `false` to disable them. + /// pub has_actions: Option, + /// either `true` to enable issues for this repository or `false` to disable them. + /// pub has_issues: Option, + /// either `true` to enable packages unit, or `false` to disable them. + /// pub has_packages: Option, + /// either `true` to enable project unit, or `false` to disable them. + /// pub has_projects: Option, + /// either `true` to allow pull requests, or `false` to prevent pull request. + /// pub has_pull_requests: Option, + /// either `true` to enable releases unit, or `false` to disable them. + /// pub has_releases: Option, + /// either `true` to enable the wiki for this repository or `false` to disable it. + /// pub has_wiki: Option, + /// either `true` to ignore whitespace for conflicts, or `false` to not ignore whitespace. + /// pub ignore_whitespace_conflicts: Option, pub internal_tracker: Option, + /// set to a string like `8h30m0s` to set the mirror interval time + /// pub mirror_interval: Option, + /// name of the repository + /// pub name: Option, + /// either `true` to make the repository private or `false` to make it public. + /// + /// Note: you will get a 422 error if the organization restricts changing repository visibility to organization + /// + /// owners and a non-owner tries to change the value of private. + /// pub private: Option, + /// either `true` to make this repository a template or `false` to make it a normal repository + /// pub template: Option, + /// a URL with more information about the repository. + /// pub website: Option, } @@ -8222,10 +8416,18 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct ExternalTracker { + /// External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index. + /// pub external_tracker_format: Option, + /// External Issue Tracker issue regular expression + /// pub external_tracker_regexp_pattern: Option, + /// External Issue Tracker Number Format, either `numeric`, `alphanumeric`, or `regexp` + /// pub external_tracker_style: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] + /// URL of external issue tracker. + /// pub external_tracker_url: Option, } @@ -8234,6 +8436,8 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct ExternalWiki { #[serde(deserialize_with = "crate::none_if_blank_url")] + /// URL of external wiki. + /// pub external_wiki_url: Option, } @@ -8364,17 +8568,41 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct GenerateRepoOption { + /// include avatar of the template repo + /// pub avatar: Option, + /// Default branch of the new repository + /// pub default_branch: Option, + /// Description of the repository to create + /// pub description: Option, + /// include git content of default branch in template repo + /// pub git_content: Option, + /// include git hooks in template repo + /// pub git_hooks: Option, + /// include labels in template repo + /// pub labels: Option, + /// Name of the repository to create + /// pub name: String, + /// The organization or person who will own the new repository + /// pub owner: String, + /// Whether the repository is private + /// pub private: Option, + /// include protected branches in template repo + /// pub protected_branch: Option, + /// include topics in template repo + /// pub topics: Option, + /// include webhooks in template repo + /// pub webhooks: Option, } @@ -8473,8 +8701,14 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct InternalTracker { + /// Let only contributors track time (Built-in issue tracker) + /// pub allow_only_contributors_to_track_time: Option, + /// Enable dependencies for issues and pull requests (Built-in issue tracker) + /// pub enable_issue_dependencies: Option, + /// Enable time tracking (Built-in issue tracker) + /// pub enable_time_tracker: Option, } @@ -8562,6 +8796,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct IssueLabelsOption { + /// list of label IDs + /// pub labels: Option>, #[serde(with = "time::serde::rfc3339::option")] pub updated_at: Option, @@ -8641,12 +8877,36 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct MarkdownOption { + /// Context to render + /// + /// + /// + /// in: body + /// #[serde(rename = "Context")] pub context: Option, + /// Mode to render (comment, gfm, markdown) + /// + /// + /// + /// in: body + /// #[serde(rename = "Mode")] pub mode: Option, + /// Text markdown to render + /// + /// + /// + /// in: body + /// #[serde(rename = "Text")] pub text: Option, + /// Is it a wiki page ? + /// + /// + /// + /// in: body + /// #[serde(rename = "Wiki")] pub wiki: Option, } @@ -8655,14 +8915,44 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct MarkupOption { + /// Context to render + /// + /// + /// + /// in: body + /// #[serde(rename = "Context")] pub context: Option, + /// File path for detecting extension in file mode + /// + /// + /// + /// in: body + /// #[serde(rename = "FilePath")] pub file_path: Option, + /// Mode to render (comment, gfm, markdown, file) + /// + /// + /// + /// in: body + /// #[serde(rename = "Mode")] pub mode: Option, + /// Text markup to render + /// + /// + /// + /// in: body + /// #[serde(rename = "Text")] pub text: Option, + /// Is it a wiki page ? + /// + /// + /// + /// in: body + /// #[serde(rename = "Wiki")] pub wiki: Option, } @@ -8707,8 +8997,12 @@ pub mod structs { pub pull_requests: Option, pub releases: Option, pub repo_name: String, + /// Name of User or Organisation who will own Repo after migration + /// pub repo_owner: Option, pub service: Option, + /// deprecated (only for backwards compatibility) + /// pub uid: Option, pub wiki: Option, } @@ -8873,6 +9167,8 @@ pub mod structs { pub location: Option, pub name: Option, pub repo_admin_change_team_access: Option, + /// deprecated + /// pub username: Option, pub visibility: Option, pub website: Option, @@ -8940,6 +9236,8 @@ pub mod structs { pub added: Option>, pub author: Option, pub committer: Option, + /// sha1 hash of the commit + /// pub id: Option, pub message: Option, pub modified: Option>, @@ -8967,6 +9265,8 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct PayloadUser { pub email: Option, + /// Full name of the commit author + /// pub name: Option, pub username: Option, } @@ -9175,6 +9475,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct RenameUserOption { + /// New username for this user. This name cannot be in use yet by any other user. + /// pub new_username: String, } @@ -9202,6 +9504,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct RepoTopicOptions { + /// list of topic names + /// pub topics: Option>, } @@ -9316,6 +9620,8 @@ pub mod structs { pub struct Secret { #[serde(with = "time::serde::rfc3339::option")] pub created_at: Option, + /// the secret's name + /// pub name: Option, } @@ -9415,8 +9721,12 @@ pub mod structs { pub pull_request_url: Option, pub ref_action: Option, pub ref_comment: Option, + /// commit SHA where issue/PR was referenced + /// pub ref_commit_sha: Option, pub ref_issue: Option, + /// whether the assignees were removed or added + /// pub removed_assignee: Option, pub resolve_doer: Option, pub review_id: Option, @@ -9456,8 +9766,14 @@ pub mod structs { pub created: Option, pub id: Option, pub issue: Option, + /// deprecated (only for backwards compatibility) + /// pub issue_id: Option, + /// Time in seconds + /// pub time: Option, + /// deprecated (only for backwards compatibility) + /// pub user_id: Option, pub user_name: Option, } @@ -9467,6 +9783,8 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct TransferRepoOption { pub new_owner: String, + /// ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories. + /// pub team_ids: Option>, } @@ -9477,14 +9795,28 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct UpdateFileOptions { pub author: Option, + /// branch (optional) to base this file from. if not given, the default branch is used + /// pub branch: Option, pub committer: Option, + /// content must be base64 encoded + /// pub content: String, pub dates: Option, + /// from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL + /// pub from_path: Option, + /// message (optional) for the commit of this file. if not supplied, a default message will be used + /// pub message: Option, + /// new_branch (optional) will make a new branch from `branch` before creating the file + /// pub new_branch: Option, + /// sha is the SHA for the file that already exists + /// pub sha: String, + /// Add a Signed-off-by trailer by the committer at the end of the commit log message. + /// pub signoff: Option, } @@ -9492,6 +9824,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct UpdateRepoAvatarOption { + /// image must be base64 encoded + /// pub image: Option, } @@ -9499,6 +9833,8 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct UpdateUserAvatarOption { + /// image must be base64 encoded + /// pub image: Option, } @@ -9506,28 +9842,58 @@ pub mod structs { /// #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct User { + /// Is user active + /// pub active: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] + /// URL to the user's avatar + /// pub avatar_url: Option, #[serde(with = "time::serde::rfc3339::option")] pub created: Option, + /// the user's description + /// pub description: Option, pub email: Option, + /// user counts + /// pub followers_count: Option, pub following_count: Option, + /// the user's full name + /// pub full_name: Option, + /// the user's id + /// pub id: Option, + /// Is the user an administrator + /// pub is_admin: Option, + /// User locale + /// pub language: Option, #[serde(with = "time::serde::rfc3339::option")] pub last_login: Option, + /// the user's location + /// pub location: Option, + /// the user's username + /// pub login: Option, + /// the user's authentication sign-in name. + /// pub login_name: Option, + /// Is user login prohibited + /// pub prohibit_login: Option, + /// Is user restricted + /// pub restricted: Option, pub starred_repos_count: Option, + /// User visibility level option: public, limited, private + /// pub visibility: Option, + /// the user's website + /// pub website: Option, } @@ -9547,6 +9913,8 @@ pub mod structs { pub diff_view_style: Option, pub full_name: Option, pub hide_activity: Option, + /// Privacy + /// pub hide_email: Option, pub language: Option, pub location: Option, @@ -9562,6 +9930,8 @@ pub mod structs { pub diff_view_style: Option, pub full_name: Option, pub hide_activity: Option, + /// Privacy + /// pub hide_email: Option, pub language: Option, pub location: Option, @@ -9607,6 +9977,8 @@ pub mod structs { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct WikiPage { pub commit_count: Option, + /// Page content, base64 encoded + /// pub content_base64: Option, pub footer: Option, #[serde(deserialize_with = "crate::none_if_blank_url")] @@ -9866,7 +10238,11 @@ pub mod structs { } pub struct AdminCronListQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -9884,7 +10260,11 @@ pub mod structs { } pub struct AdminGetAllEmailsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -9902,8 +10282,14 @@ pub mod structs { } pub struct AdminSearchEmailsQuery { + /// keyword + /// pub q: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -9924,7 +10310,11 @@ pub mod structs { } pub struct AdminListHooksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -9942,7 +10332,11 @@ pub mod structs { } pub struct AdminGetAllOrgsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -9960,8 +10354,14 @@ pub mod structs { } pub struct AdminUnadoptedListQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, + /// pattern of repositories to search for + /// pub pattern: Option, } @@ -9982,9 +10382,17 @@ pub mod structs { } pub struct AdminSearchUsersQuery { + /// ID of the user's login source to search for + /// pub source_id: Option, + /// user's login name to search for + /// pub login_name: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10008,6 +10416,8 @@ pub mod structs { } pub struct AdminDeleteUserQuery { + /// purge the user from the system completely + /// pub purge: Option, } @@ -10022,12 +10432,26 @@ pub mod structs { } pub struct NotifyGetListQuery { + /// If true, show notifications marked as read. Default value is false + /// pub all: Option, + /// Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned. + /// pub status_types: Option>, + /// filter notifications by subject type + /// pub subject_type: Option>, + /// Only show notifications updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show notifications updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10084,9 +10508,17 @@ pub mod structs { } pub struct NotifyReadListQuery { + /// Describes the last point that notifications were checked. Anything updated since this time will not be updated. + /// pub last_read_at: Option, + /// If true, mark all notifications on this repo. Default value is false + /// pub all: Option, + /// Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread. + /// pub status_types: Option>, + /// Status to mark notifications as, Defaults to read. + /// pub to_status: Option, } @@ -10122,6 +10554,8 @@ pub mod structs { } pub struct NotifyReadThreadQuery { + /// Status to mark notifications as + /// pub to_status: Option, } @@ -10136,7 +10570,11 @@ pub mod structs { } pub struct OrgGetAllQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10154,7 +10592,11 @@ pub mod structs { } pub struct OrgListActionsSecretsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10172,8 +10614,14 @@ pub mod structs { } pub struct OrgListActivityFeedsQuery { + /// the date of the activities to be found + /// pub date: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10200,7 +10648,11 @@ pub mod structs { } pub struct OrgListHooksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10218,7 +10670,11 @@ pub mod structs { } pub struct OrgListLabelsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10236,7 +10692,11 @@ pub mod structs { } pub struct OrgListBlockedUsersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10254,7 +10714,11 @@ pub mod structs { } pub struct OrgListMembersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10272,7 +10736,11 @@ pub mod structs { } pub struct OrgListPublicMembersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10290,7 +10758,11 @@ pub mod structs { } pub struct OrgListReposQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10308,7 +10780,11 @@ pub mod structs { } pub struct OrgListTeamsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10326,9 +10802,17 @@ pub mod structs { } pub struct TeamSearchQuery { + /// keywords to search + /// pub q: Option, + /// include search within team description (defaults to true) + /// pub include_desc: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10352,9 +10836,17 @@ pub mod structs { } pub struct ListPackagesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, + /// package type filter + /// pub r#type: Option, + /// name filter + /// pub q: Option, } @@ -10378,22 +10870,56 @@ pub mod structs { } pub struct IssueSearchIssuesQuery { + /// whether issue is open or closed + /// pub state: Option, + /// comma separated list of labels. Fetch only issues that have any of this labels. Non existent labels are discarded + /// pub labels: Option, + /// comma separated list of milestone names. Fetch only issues that have any of this milestones. Non existent are discarded + /// pub milestones: Option, + /// search string + /// pub q: Option, + /// repository to prioritize in the results + /// pub priority_repo_id: Option, + /// filter by type (issues / pulls) if set + /// pub r#type: Option, + /// Only show notifications updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show notifications updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// filter (issues / pulls) assigned to you, default is false + /// pub assigned: Option, + /// filter (issues / pulls) created by you, default is false + /// pub created: Option, + /// filter (issues / pulls) mentioning you, default is false + /// pub mentioned: Option, + /// filter pulls requesting your review, default is false + /// pub review_requested: Option, + /// filter pulls reviewed by you, default is false + /// pub reviewed: Option, + /// filter by owner + /// pub owner: Option, + /// filter by team (requires organization owner parameter to be provided) + /// pub team: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10468,22 +10994,56 @@ pub mod structs { } pub struct RepoSearchQuery { + /// keyword + /// pub q: Option, + /// Limit search to repositories with keyword as topic + /// pub topic: Option, + /// include search of keyword within repository description + /// pub include_desc: Option, + /// search only for repos that the user with the given id owns or contributes to + /// pub uid: Option, + /// repo owner to prioritize in the results + /// pub priority_owner_id: Option, + /// search only for repos that belong to the given team id + /// pub team_id: Option, + /// search only for repos that the user with the given id has starred + /// pub starred_by: Option, + /// include private repositories this user has access to (defaults to true) + /// pub private: Option, + /// show only pubic, private or all repositories (defaults to all) + /// pub is_private: Option, + /// include template repositories this user has access to (defaults to true) + /// pub template: Option, + /// show only archived, non-archived or all repositories (defaults to all) + /// pub archived: Option, + /// type of repository to search for. Supported values are "fork", "source", "mirror" and "collaborative" + /// pub mode: Option, + /// if `uid` is given, search only for repos that the user owns + /// pub exclusive: Option, + /// sort repos by attribute. Supported values are "alpha", "created", "updated", "size", and "id". Default is "alpha" + /// pub sort: Option, + /// sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not specified. + /// pub order: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10546,8 +11106,14 @@ pub mod structs { } pub struct RepoListActivityFeedsQuery { + /// the date of the activities to be found + /// pub date: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10574,7 +11140,11 @@ pub mod structs { } pub struct RepoListBranchesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10592,7 +11162,11 @@ pub mod structs { } pub struct RepoListCollaboratorsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10610,13 +11184,29 @@ pub mod structs { } pub struct RepoGetAllCommitsQuery { + /// SHA or branch to start listing commits from (usually 'master') + /// pub sha: Option, + /// filepath of a file/dir + /// pub path: Option, + /// include diff stats for every commit (disable for speedup, default 'true') + /// pub stat: Option, + /// include verification for every commit (disable for speedup, default 'true') + /// pub verification: Option, + /// include a list of affected files for every commit (disable for speedup, default 'true') + /// pub files: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results (ignored if used with 'path') + /// pub limit: Option, + /// commits that match the given specifier will not be listed. + /// pub not: Option, } @@ -10652,7 +11242,11 @@ pub mod structs { } pub struct RepoGetCombinedStatusByRefQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10670,9 +11264,17 @@ pub mod structs { } pub struct RepoListStatusesByRefQuery { + /// type of sort + /// pub sort: Option, + /// type of state + /// pub state: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10696,6 +11298,8 @@ pub mod structs { } pub struct RepoGetContentsListQuery { + /// The name of the commit/branch/tag. Default the repository’s default branch (usually master) + /// pub r#ref: Option, } @@ -10710,6 +11314,8 @@ pub mod structs { } pub struct RepoGetContentsQuery { + /// The name of the commit/branch/tag. Default the repository’s default branch (usually master) + /// pub r#ref: Option, } @@ -10724,6 +11330,8 @@ pub mod structs { } pub struct RepoGetEditorConfigQuery { + /// The name of the commit/branch/tag. Default the repository’s default branch (usually master) + /// pub r#ref: Option, } @@ -10738,7 +11346,11 @@ pub mod structs { } pub struct ListForksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10756,8 +11368,14 @@ pub mod structs { } pub struct RepoGetSingleCommitQuery { + /// include diff stats for every commit (disable for speedup, default 'true') + /// pub stat: Option, + /// include verification for every commit (disable for speedup, default 'true') + /// pub verification: Option, + /// include a list of affected files for every commit (disable for speedup, default 'true') + /// pub files: Option, } @@ -10778,7 +11396,11 @@ pub mod structs { } pub struct RepoGetNoteQuery { + /// include verification for every commit (disable for speedup, default 'true') + /// pub verification: Option, + /// include a list of affected files for every commit (disable for speedup, default 'true') + /// pub files: Option, } @@ -10796,8 +11418,14 @@ pub mod structs { } pub struct GetTreeQuery { + /// show all directories and files + /// pub recursive: Option, + /// page number; the 'truncated' field in the response will be true if there are still more items after this page, false if the last page + /// pub page: Option, + /// number of items per page + /// pub per_page: Option, } @@ -10818,7 +11446,11 @@ pub mod structs { } pub struct RepoListHooksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10836,6 +11468,8 @@ pub mod structs { } pub struct RepoTestHookQuery { + /// The name of the commit/branch/tag, indicates which commit will be loaded to the webhook payload. + /// pub r#ref: Option, } @@ -10850,17 +11484,41 @@ pub mod structs { } pub struct IssueListIssuesQuery { + /// whether issue is open or closed + /// pub state: Option, + /// comma separated list of labels. Fetch only issues that have any of this labels. Non existent labels are discarded + /// pub labels: Option, + /// search string + /// pub q: Option, + /// filter by type (issues / pulls) if set + /// pub r#type: Option, + /// comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded + /// pub milestones: Option, + /// Only show items updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show items updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// Only show items which were created by the the given user + /// pub created_by: Option, + /// Only show items for which the given user is assigned + /// pub assigned_by: Option, + /// Only show items in which the given user was mentioned + /// pub mentioned_by: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10920,9 +11578,17 @@ pub mod structs { } pub struct IssueGetRepoCommentsQuery { + /// if provided, only comments updated since the provided time are returned. + /// pub since: Option, + /// if provided, only comments updated before the provided time are returned. + /// pub before: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -10958,7 +11624,11 @@ pub mod structs { } pub struct IssueCreateIssueCommentAttachmentQuery { + /// name of the attachment + /// pub name: Option, + /// time of the attachment's creation. This is a timestamp in RFC 3339 format + /// pub updated_at: Option, } @@ -10982,7 +11652,11 @@ pub mod structs { } pub struct IssueCreateIssueAttachmentQuery { + /// name of the attachment + /// pub name: Option, + /// time of the attachment's creation. This is a timestamp in RFC 3339 format + /// pub updated_at: Option, } @@ -11006,7 +11680,11 @@ pub mod structs { } pub struct IssueListBlocksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11024,7 +11702,11 @@ pub mod structs { } pub struct IssueGetCommentsQuery { + /// if provided, only comments updated since the specified time are returned. + /// pub since: Option, + /// if provided, only comments updated before the provided time are returned. + /// pub before: Option, } @@ -11054,7 +11736,11 @@ pub mod structs { } pub struct IssueListIssueDependenciesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11072,7 +11758,11 @@ pub mod structs { } pub struct IssueGetIssueReactionsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11090,7 +11780,11 @@ pub mod structs { } pub struct IssueSubscriptionsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11108,9 +11802,17 @@ pub mod structs { } pub struct IssueGetCommentsAndTimelineQuery { + /// if provided, only comments updated since the specified time are returned. + /// pub since: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, + /// if provided, only comments updated before the provided time are returned. + /// pub before: Option, } @@ -11146,10 +11848,20 @@ pub mod structs { } pub struct IssueTrackedTimesQuery { + /// optional filter by user (available for issue managers) + /// pub user: Option, + /// Only show times updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show times updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11188,9 +11900,17 @@ pub mod structs { } pub struct RepoListKeysQuery { + /// the key_id to search for + /// pub key_id: Option, + /// fingerprint of the key + /// pub fingerprint: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11214,7 +11934,11 @@ pub mod structs { } pub struct IssueListLabelsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11232,6 +11956,8 @@ pub mod structs { } pub struct RepoGetRawFileOrLfsQuery { + /// The name of the commit/branch/tag. Default the repository’s default branch (usually master) + /// pub r#ref: Option, } @@ -11246,9 +11972,17 @@ pub mod structs { } pub struct IssueGetMilestonesListQuery { + /// Milestone state, Recognized values are open, closed and all. Defaults to "open" + /// pub state: Option, + /// filter by milestone name + /// pub name: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11272,12 +12006,26 @@ pub mod structs { } pub struct NotifyGetRepoListQuery { + /// If true, show notifications marked as read. Default value is false + /// pub all: Option, + /// Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned + /// pub status_types: Option>, + /// filter notifications by subject type + /// pub subject_type: Option>, + /// Only show notifications updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show notifications updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11334,9 +12082,17 @@ pub mod structs { } pub struct NotifyReadRepoListQuery { + /// If true, mark all notifications on this repo. Default value is false + /// pub all: Option, + /// Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread. + /// pub status_types: Option>, + /// Status to mark notifications as. Defaults to read. + /// pub to_status: Option, + /// Describes the last point that notifications were checked. Anything updated since this time will not be updated. + /// pub last_read_at: Option, } @@ -11372,11 +12128,23 @@ pub mod structs { } pub struct RepoListPullRequestsQuery { + /// State of pull request: open or closed (optional) + /// pub state: Option, + /// Type of sort + /// pub sort: Option, + /// ID of the milestone + /// pub milestone: Option, + /// Label IDs + /// pub labels: Option>, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11412,6 +12180,8 @@ pub mod structs { } pub struct RepoDownloadPullDiffOrPatchQuery { + /// whether to include binary file changes. if true, the diff is applicable with `git apply` + /// pub binary: Option, } @@ -11426,9 +12196,17 @@ pub mod structs { } pub struct RepoGetPullRequestCommitsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, + /// include verification for every commit (disable for speedup, default 'true') + /// pub verification: Option, + /// include a list of affected files for every commit (disable for speedup, default 'true') + /// pub files: Option, } @@ -11452,9 +12230,17 @@ pub mod structs { } pub struct RepoGetPullRequestFilesQuery { + /// skip to given file + /// pub skip_to: Option, + /// whitespace behavior + /// pub whitespace: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11478,7 +12264,11 @@ pub mod structs { } pub struct RepoListPullReviewsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11496,6 +12286,8 @@ pub mod structs { } pub struct RepoUpdatePullRequestQuery { + /// how to update pull request + /// pub style: Option, } @@ -11510,7 +12302,11 @@ pub mod structs { } pub struct RepoListPushMirrorsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11528,6 +12324,8 @@ pub mod structs { } pub struct RepoGetRawFileQuery { + /// The name of the commit/branch/tag. Default the repository’s default branch (usually master) + /// pub r#ref: Option, } @@ -11542,10 +12340,20 @@ pub mod structs { } pub struct RepoListReleasesQuery { + /// filter (exclude / include) drafts, if you dont have repo write access none will show + /// pub draft: Option, + /// filter (exclude / include) pre-releases + /// pub pre_release: Option, + /// page size of results, deprecated - use limit + /// pub per_page: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11572,6 +12380,8 @@ pub mod structs { } pub struct RepoCreateReleaseAttachmentQuery { + /// name of the attachment + /// pub name: Option, } @@ -11586,7 +12396,11 @@ pub mod structs { } pub struct RepoListStargazersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11604,9 +12418,17 @@ pub mod structs { } pub struct RepoListStatusesQuery { + /// type of sort + /// pub sort: Option, + /// type of state + /// pub state: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11630,7 +12452,11 @@ pub mod structs { } pub struct RepoListSubscribersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11648,7 +12474,11 @@ pub mod structs { } pub struct RepoListTagsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results, default maximum page size is 50 + /// pub limit: Option, } @@ -11666,10 +12496,20 @@ pub mod structs { } pub struct RepoTrackedTimesQuery { + /// optional filter by user (available for issue managers) + /// pub user: Option, + /// Only show times updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show times updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11708,7 +12548,11 @@ pub mod structs { } pub struct RepoListTopicsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11726,7 +12570,11 @@ pub mod structs { } pub struct RepoGetWikiPagesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11744,6 +12592,8 @@ pub mod structs { } pub struct RepoGetWikiPageRevisionsQuery { + /// page number of results to return (1-based) + /// pub page: Option, } @@ -11758,8 +12608,14 @@ pub mod structs { } pub struct OrgListTeamActivityFeedsQuery { + /// the date of the activities to be found + /// pub date: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11786,7 +12642,11 @@ pub mod structs { } pub struct OrgListTeamMembersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11804,7 +12664,11 @@ pub mod structs { } pub struct OrgListTeamReposQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11822,8 +12686,14 @@ pub mod structs { } pub struct TopicSearchQuery { + /// keywords to search + /// pub q: String, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11843,7 +12713,11 @@ pub mod structs { } pub struct UserGetOAuth2ApplicationsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11861,7 +12735,11 @@ pub mod structs { } pub struct UserCurrentListFollowersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11879,7 +12757,11 @@ pub mod structs { } pub struct UserCurrentListFollowingQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11897,7 +12779,11 @@ pub mod structs { } pub struct UserCurrentListGpgKeysQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11915,7 +12801,11 @@ pub mod structs { } pub struct UserListHooksQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11933,8 +12823,14 @@ pub mod structs { } pub struct UserCurrentListKeysQuery { + /// fingerprint of the key + /// pub fingerprint: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11955,7 +12851,11 @@ pub mod structs { } pub struct UserListBlockedUsersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11973,7 +12873,11 @@ pub mod structs { } pub struct OrgListCurrentUserOrgsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -11991,7 +12895,11 @@ pub mod structs { } pub struct UserCurrentListReposQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12009,7 +12917,11 @@ pub mod structs { } pub struct UserCurrentListStarredQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12027,7 +12939,11 @@ pub mod structs { } pub struct UserGetStopWatchesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12045,7 +12961,11 @@ pub mod structs { } pub struct UserCurrentListSubscriptionsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12063,7 +12983,11 @@ pub mod structs { } pub struct UserListTeamsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12081,9 +13005,17 @@ pub mod structs { } pub struct UserCurrentTrackedTimesQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, + /// Only show times updated after the given time. This is a timestamp in RFC 3339 format + /// pub since: Option, + /// Only show times updated before the given time. This is a timestamp in RFC 3339 format + /// pub before: Option, } @@ -12119,9 +13051,17 @@ pub mod structs { } pub struct UserSearchQuery { + /// keyword + /// pub q: Option, + /// ID of the user to search for + /// pub uid: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12145,9 +13085,17 @@ pub mod structs { } pub struct UserListActivityFeedsQuery { + /// if true, only show actions performed by the requested user + /// pub only_performed_by: Option, + /// the date of the activities to be found + /// pub date: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12177,7 +13125,11 @@ pub mod structs { } pub struct UserListFollowersQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12195,7 +13147,11 @@ pub mod structs { } pub struct UserListFollowingQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12213,7 +13169,11 @@ pub mod structs { } pub struct UserListGpgKeysQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12231,8 +13191,14 @@ pub mod structs { } pub struct UserListKeysQuery { + /// fingerprint of the key + /// pub fingerprint: Option, + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12253,7 +13219,11 @@ pub mod structs { } pub struct OrgListUserOrgsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12271,7 +13241,11 @@ pub mod structs { } pub struct UserListReposQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12289,7 +13263,11 @@ pub mod structs { } pub struct UserListStarredQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12307,7 +13285,11 @@ pub mod structs { } pub struct UserListSubscriptionsQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } @@ -12325,7 +13307,11 @@ pub mod structs { } pub struct UserGetTokensQuery { + /// page number of results to return (1-based) + /// pub page: Option, + /// page size of results + /// pub limit: Option, } -- cgit v1.2.3