Skip to content

Bump Submodule/github/rest-api-description from 4162f99 to a0508ce #87

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions Sources/apps/Client.swift
Original file line number Diff line number Diff line change
Expand Up @@ -1080,8 +1080,6 @@ public struct Client: APIProtocol {
///
/// Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.
///
/// When using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported.
///
/// You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.
///
/// - Remark: HTTP `POST /app/installations/{installation_id}/access_tokens`.
Expand Down
6 changes: 0 additions & 6 deletions Sources/apps/Types.swift
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,6 @@ public protocol APIProtocol: Sendable {
///
/// Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.
///
/// When using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported.
///
/// You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.
///
/// - Remark: HTTP `POST /app/installations/{installation_id}/access_tokens`.
Expand Down Expand Up @@ -521,8 +519,6 @@ extension APIProtocol {
///
/// Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.
///
/// When using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported.
///
/// You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.
///
/// - Remark: HTTP `POST /app/installations/{installation_id}/access_tokens`.
Expand Down Expand Up @@ -6901,8 +6897,6 @@ public enum Operations {
///
/// Optionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.
///
/// When using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported.
///
/// You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.
///
/// - Remark: HTTP `POST /app/installations/{installation_id}/access_tokens`.
Expand Down
89 changes: 89 additions & 0 deletions Sources/orgs/Types.swift
Original file line number Diff line number Diff line change
Expand Up @@ -6448,6 +6448,32 @@ public enum Components {
///
/// - Remark: Generated from `#/components/schemas/organization-role/description`.
public var description: Swift.String?
/// The system role from which this role inherits permissions.
///
/// - Remark: Generated from `#/components/schemas/organization-role/base_role`.
@frozen public enum base_rolePayload: String, Codable, Hashable, Sendable {
case read = "read"
case triage = "triage"
case write = "write"
case maintain = "maintain"
case admin = "admin"
}
/// The system role from which this role inherits permissions.
///
/// - Remark: Generated from `#/components/schemas/organization-role/base_role`.
public var base_role: Components.Schemas.organization_hyphen_role.base_rolePayload?
/// Source answers the question, "where did this role come from?"
///
/// - Remark: Generated from `#/components/schemas/organization-role/source`.
@frozen public enum sourcePayload: String, Codable, Hashable, Sendable {
case Organization = "Organization"
case Enterprise = "Enterprise"
case Predefined = "Predefined"
}
/// Source answers the question, "where did this role come from?"
///
/// - Remark: Generated from `#/components/schemas/organization-role/source`.
public var source: Components.Schemas.organization_hyphen_role.sourcePayload?
/// A list of permissions included in this role.
///
/// - Remark: Generated from `#/components/schemas/organization-role/permissions`.
Expand All @@ -6468,6 +6494,8 @@ public enum Components {
/// - id: The unique identifier of the role.
/// - name: The name of the role.
/// - description: A short description about who this role is for or what permissions it grants.
/// - base_role: The system role from which this role inherits permissions.
/// - source: Source answers the question, "where did this role come from?"
/// - permissions: A list of permissions included in this role.
/// - organization:
/// - created_at: The date and time the role was created.
Expand All @@ -6476,6 +6504,8 @@ public enum Components {
id: Swift.Int64,
name: Swift.String,
description: Swift.String? = nil,
base_role: Components.Schemas.organization_hyphen_role.base_rolePayload? = nil,
source: Components.Schemas.organization_hyphen_role.sourcePayload? = nil,
permissions: [Swift.String],
organization: Components.Schemas.nullable_hyphen_simple_hyphen_user? = nil,
created_at: Foundation.Date,
Expand All @@ -6484,6 +6514,8 @@ public enum Components {
self.id = id
self.name = name
self.description = description
self.base_role = base_role
self.source = source
self.permissions = permissions
self.organization = organization
self.created_at = created_at
Expand All @@ -6493,6 +6525,8 @@ public enum Components {
case id
case name
case description
case base_role
case source
case permissions
case organization
case created_at
Expand All @@ -6503,6 +6537,18 @@ public enum Components {
///
/// - Remark: Generated from `#/components/schemas/team-role-assignment`.
public struct team_hyphen_role_hyphen_assignment: Codable, Hashable, Sendable {
/// Determines if the team has a direct, indirect, or mixed relationship to a role
///
/// - Remark: Generated from `#/components/schemas/team-role-assignment/assignment`.
@frozen public enum assignmentPayload: String, Codable, Hashable, Sendable {
case direct = "direct"
case indirect = "indirect"
case mixed = "mixed"
}
/// Determines if the team has a direct, indirect, or mixed relationship to a role
///
/// - Remark: Generated from `#/components/schemas/team-role-assignment/assignment`.
public var assignment: Components.Schemas.team_hyphen_role_hyphen_assignment.assignmentPayload?
/// - Remark: Generated from `#/components/schemas/team-role-assignment/id`.
public var id: Swift.Int
/// - Remark: Generated from `#/components/schemas/team-role-assignment/node_id`.
Expand Down Expand Up @@ -6575,6 +6621,7 @@ public enum Components {
/// Creates a new `team_hyphen_role_hyphen_assignment`.
///
/// - Parameters:
/// - assignment: Determines if the team has a direct, indirect, or mixed relationship to a role
/// - id:
/// - node_id:
/// - name:
Expand All @@ -6590,6 +6637,7 @@ public enum Components {
/// - repositories_url:
/// - parent:
public init(
assignment: Components.Schemas.team_hyphen_role_hyphen_assignment.assignmentPayload? = nil,
id: Swift.Int,
node_id: Swift.String,
name: Swift.String,
Expand All @@ -6605,6 +6653,7 @@ public enum Components {
repositories_url: Swift.String,
parent: Components.Schemas.nullable_hyphen_team_hyphen_simple? = nil
) {
self.assignment = assignment
self.id = id
self.node_id = node_id
self.name = name
Expand All @@ -6621,6 +6670,7 @@ public enum Components {
self.parent = parent
}
public enum CodingKeys: String, CodingKey {
case assignment
case id
case node_id
case name
Expand Down Expand Up @@ -6748,6 +6798,22 @@ public enum Components {
///
/// - Remark: Generated from `#/components/schemas/user-role-assignment`.
public struct user_hyphen_role_hyphen_assignment: Codable, Hashable, Sendable {
/// Determines if the user has a direct, indirect, or mixed relationship to a role
///
/// - Remark: Generated from `#/components/schemas/user-role-assignment/assignment`.
@frozen public enum assignmentPayload: String, Codable, Hashable, Sendable {
case direct = "direct"
case indirect = "indirect"
case mixed = "mixed"
}
/// Determines if the user has a direct, indirect, or mixed relationship to a role
///
/// - Remark: Generated from `#/components/schemas/user-role-assignment/assignment`.
public var assignment: Components.Schemas.user_hyphen_role_hyphen_assignment.assignmentPayload?
/// Team the user has gotten the role through
///
/// - Remark: Generated from `#/components/schemas/user-role-assignment/inherited_from`.
public var inherited_from: [Components.Schemas.team_hyphen_simple]?
/// - Remark: Generated from `#/components/schemas/user-role-assignment/name`.
public var name: Swift.String?
/// - Remark: Generated from `#/components/schemas/user-role-assignment/email`.
Expand Down Expand Up @@ -6795,6 +6861,8 @@ public enum Components {
/// Creates a new `user_hyphen_role_hyphen_assignment`.
///
/// - Parameters:
/// - assignment: Determines if the user has a direct, indirect, or mixed relationship to a role
/// - inherited_from: Team the user has gotten the role through
/// - name:
/// - email:
/// - login:
Expand All @@ -6818,6 +6886,8 @@ public enum Components {
/// - starred_at:
/// - user_view_type:
public init(
assignment: Components.Schemas.user_hyphen_role_hyphen_assignment.assignmentPayload? = nil,
inherited_from: [Components.Schemas.team_hyphen_simple]? = nil,
name: Swift.String? = nil,
email: Swift.String? = nil,
login: Swift.String,
Expand All @@ -6841,6 +6911,8 @@ public enum Components {
starred_at: Swift.String? = nil,
user_view_type: Swift.String? = nil
) {
self.assignment = assignment
self.inherited_from = inherited_from
self.name = name
self.email = email
self.login = login
Expand All @@ -6865,6 +6937,8 @@ public enum Components {
self.user_view_type = user_view_type
}
public enum CodingKeys: String, CodingKey {
case assignment
case inherited_from
case name
case email
case login
Expand Down Expand Up @@ -7293,6 +7367,17 @@ public enum Components {
///
/// - Remark: Generated from `#/components/schemas/custom-property/url`.
public var url: Swift.String?
/// The source type of the property
///
/// - Remark: Generated from `#/components/schemas/custom-property/source_type`.
@frozen public enum source_typePayload: String, Codable, Hashable, Sendable {
case organization = "organization"
case enterprise = "enterprise"
}
/// The source type of the property
///
/// - Remark: Generated from `#/components/schemas/custom-property/source_type`.
public var source_type: Components.Schemas.custom_hyphen_property.source_typePayload?
/// The type of the value for the property
///
/// - Remark: Generated from `#/components/schemas/custom-property/value_type`.
Expand Down Expand Up @@ -7376,6 +7461,7 @@ public enum Components {
/// - Parameters:
/// - property_name: The name of the property
/// - url: The URL that can be used to fetch, update, or delete info about this property via the API.
/// - source_type: The source type of the property
/// - value_type: The type of the value for the property
/// - required: Whether the property is required.
/// - default_value: Default value of the property
Expand All @@ -7385,6 +7471,7 @@ public enum Components {
public init(
property_name: Swift.String,
url: Swift.String? = nil,
source_type: Components.Schemas.custom_hyphen_property.source_typePayload? = nil,
value_type: Components.Schemas.custom_hyphen_property.value_typePayload,
required: Swift.Bool? = nil,
default_value: Components.Schemas.custom_hyphen_property.default_valuePayload? = nil,
Expand All @@ -7394,6 +7481,7 @@ public enum Components {
) {
self.property_name = property_name
self.url = url
self.source_type = source_type
self.value_type = value_type
self.required = required
self.default_value = default_value
Expand All @@ -7404,6 +7492,7 @@ public enum Components {
public enum CodingKeys: String, CodingKey {
case property_name
case url
case source_type
case value_type
case required
case default_value
Expand Down
8 changes: 7 additions & 1 deletion Sources/repos/Client.swift
Original file line number Diff line number Diff line change
Expand Up @@ -15145,7 +15145,13 @@ public struct Client: APIProtocol {
}
/// Get a release asset
///
/// To download the asset's binary content, set the `Accept` header of the request to [`application/octet-stream`](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types). The API will either redirect the client to the location, or stream it directly if possible. API clients should handle both a `200` or `302` response.
/// To download the asset's binary content:
///
/// - If within a browser, fetch the location specified in the `browser_download_url` key provided in the response.
/// - Alternatively, set the `Accept` header of the request to
/// [`application/octet-stream`](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types).
/// The API will either redirect the client to the location, or stream it directly if possible.
/// API clients should handle both a `200` or `302` response.
///
/// - Remark: HTTP `GET /repos/{owner}/{repo}/releases/assets/{asset_id}`.
/// - Remark: Generated from `#/paths//repos/{owner}/{repo}/releases/assets/{asset_id}/get(repos/get-release-asset)`.
Expand Down
Loading