CurrentAuthHandler

Struct CurrentAuthHandler 

Source
pub struct CurrentAuthHandler<'octo> { /* private fields */ }
Expand description

Handler for the current authenication API. Note All of the methods provided below require at least some authenication such as personal token in order to be used.

Created with Octocrab::current.

Implementations§

Source§

impl<'octo> CurrentAuthHandler<'octo>

Source

pub async fn user(&self) -> Result<Author>

Fetches information about the current user.

Source

pub async fn update_user(&self, new_data: UpdateUserProfile) -> Result<Author>

§Update the authenticated user

works with the following fine-grained token types:

The fine-grained token must have the following permission set:

  • “Profile” user permissions (write)
Source

pub async fn app(&self) -> Result<App>

Fetches information about the currently authenticated app.


let app = octocrab
    .current()
    .app()
    .await?;

println!("{}", app.name);
Source

pub fn list_repos_starred_by_authenticated_user( &self, ) -> ListStarredReposBuilder<'octo>

List repositories starred by current authenticated user.

octocrab::instance()
    .current()
    .list_repos_starred_by_authenticated_user()
    .send()
    .await?;

See the GitHub API documentation

Source

pub fn list_repos_for_authenticated_user( &self, ) -> ListReposForAuthenticatedUserBuilder<'octo>

Lists repositories that the current authenticated user.

octocrab::instance()
    .current()
    .list_repos_for_authenticated_user()
    .send()
    .await?;

See the GitHub API documentation

Source

pub fn list_gists_for_authenticated_user( &self, ) -> ListGistsForAuthenticatedUserBuilder<'octo>

List gists for the current authenticated user.

§Examples
  1. The following snippet retrieves the most recent gist:
octocrab::instance()
    .current()
    .list_gists_for_authenticated_user()
    .per_page(1)
    .page(1)
    .send()
    .await?;
  1. This retrieves the first 100 gists, which is maximum number that can be fetched in a single page:
octocrab::instance()
    .current()
    .list_gists_for_authenticated_user()
    .per_page(100)
    .page(1)
    .send()
    .await?;

See the GitHub API documentation

Source

pub fn list_gists_starred_by_authenticated_user( &self, ) -> ListStarredGistsBuilder<'octo>

List gists that were starred by the authenticated user.

Source

pub fn list_app_installations_accessible_to_user( &self, ) -> ListAppInstallationsAccessibleToUserBuilder<'octo>

Lists installations of your GitHub App that the authenticated user has explicit permission (:read, :write, or :admin) to access.

octocrab::instance()
    .current()
    .list_app_installations_accessible_to_user()
    .send()
    .await?;

See the GitHub API documentation

Source

pub fn list_org_memberships_for_authenticated_user( &self, ) -> ListOrgMembershipsForAuthenticatedUserBuilder<'octo>

Lists organizations that the current authenticated user is a member of.

octocrab::instance()
    .current()
    .list_org_memberships_for_authenticated_user()
    .send()
    .await?;

See the GitHub API documentation

Source

pub async fn get_interaction_restrictions(&self) -> Result<InteractionLimit>

§Get interaction restrictions for your public repositories

Shows which type of GitHub user can interact with your public repositories and when the restriction expires.

Fine-grained access tokens for “Get interaction restrictions for your public repositories”

This endpoint works with the following fine-grained token types:

  • GitHub App user access tokens
  • Fine-grained personal access tokens

The fine-grained token must have the following permission set:

  • “Interaction limits” user permissions (read)
Source

pub async fn set_interaction_restrictions( &self, limit_type: InteractionLimitType, expiry: InteractionLimitExpiry, ) -> Result<InteractionLimit>

§Set interaction restrictions for your public repositories

Temporarily restricts which type of GitHub user can interact with your public repositories. Setting the interaction limit at the user level will overwrite any interaction limits that are set for individual repositories owned by the user.

Fine-grained access tokens for “Set interaction restrictions for your public repositories”

This endpoint works with the following fine-grained token types:

  • GitHub App user access tokens
  • Fine-grained personal access tokens

The fine-grained token must have the following permission set:

  • “Interaction limits” user permissions (write)
Source

pub async fn remove_interaction_restrictions(&self) -> Result<()>

§Remove interaction restrictions from your public repositories

Removes any interaction restrictions from your public repositories.

Fine-grained access tokens for “Remove interaction restrictions from your public repositories”

This endpoint works with the following fine-grained token types:

  • GitHub App user access tokens
  • Fine-grained personal access tokens

The fine-grained token must have the following permission set:

  • “Interaction limits” user permissions (write)

Auto Trait Implementations§

§

impl<'octo> Freeze for CurrentAuthHandler<'octo>

§

impl<'octo> !RefUnwindSafe for CurrentAuthHandler<'octo>

§

impl<'octo> Send for CurrentAuthHandler<'octo>

§

impl<'octo> Sync for CurrentAuthHandler<'octo>

§

impl<'octo> Unpin for CurrentAuthHandler<'octo>

§

impl<'octo> !UnwindSafe for CurrentAuthHandler<'octo>

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

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

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more