Skip to main content

Capabilities

Struct Capabilities 

Source
#[non_exhaustive]
pub struct Capabilities { pub automation: bool, pub bot_can_create_repos: bool, pub role_levels: Vec<ForgeRole>, pub required_checks: RequiredCheckKind, pub webhooks: bool, pub account_link: LinkMethod, pub per_repo_tokens: bool, pub required_workflow: bool, pub single_owner_repos_unreviewed: bool, pub bridge_posted_check: bool, }
Expand description

What a forge — and one namespace on it — can do (§5.8).

The core and the UX branch on this, never on ForgeKind. A personal GitHub account is not a special case: it is the GitHub adapter returning a smaller set here.

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§automation: bool

The adapter holds a credential for this namespace and can act on it at all. false is manual mode: every forge-side step is a human’s.

§bot_can_create_repos: bool

The bridge can create repositories here. Without it, repo/create reserves the name and returns manual steps.

§role_levels: Vec<ForgeRole>

The forge roles available on repositories here, lowest first. crate::collapse_to_ladder fits a requested role onto it.

§required_checks: RequiredCheckKind

How the verify-trust check is made required.

§webhooks: bool

Whether the forge pushes change events. Without them, drift is found by a scheduled inspect sweep.

§account_link: LinkMethod

How members link their forge accounts.

§per_repo_tokens: bool

Whether the credential can be narrowed to one repository per job.

§required_workflow: bool

The check runs from a namespace-level workflow pinned to a revision (a GitHub org ruleset’s required workflow), so a pull request cannot change what checks it. Without it the repository’s own workflow is guarded by owner review instead (§9).

§single_owner_repos_unreviewed: bool

Without a namespace workflow, a repository with a single owner gets no review requirement on its workflow (there is nobody else to review), so its owner could weaken their own check. The UI shows “solo: workflow edits not review-protected” for such repositories; ProtectionState::check_source_guard says which applies to each.

§bridge_posted_check: bool

The bridge itself runs verify-trust against each pull request and posts the check under its own forge identity, and the protection requires the check from that identity (§9, “forged check runs”). Nothing in the repository decides what runs, and no CI workflow can post a check that counts. The bridge becomes a merge dependency, as the registry already is.

Trait Implementations§

Source§

impl Clone for Capabilities

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Capabilities

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for Capabilities

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for Capabilities

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for Capabilities

Source§

impl PartialEq for Capabilities

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for Capabilities

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for Capabilities

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.