Struct octocrab::repos::ReleasesHandler

pub struct ReleasesHandler<'octo, 'r> { /* fields omitted */ }

Handler for GitHub's releases API.

Created with RepoHandler::releases.

Implementations

impl<'octo, 'r> ReleasesHandler<'octo, 'r>

pub fn list(&self) -> ListReleasesBuilder<'_, '_, '_>

Creates a new ListReleasesBuilder that can be configured to filter listing releases.

let page = octocrab.repos("owner", "repo")
    .releases()
    .list()
    // Optional Parameters
    .per_page(100)
    .page(5u32)
    // Send the request
    .send()
    .await?;

pub fn create<'t>(
    &self,
    tag_name: &'t impl AsRef<str> + ?Sized
) -> CreateReleaseBuilder<'_, '_, '_, 't, '_, '_, '_>

Creates a new CreateReleaseBuilder with tag_name.

let page = octocrab.repos("owner", "repo")
    .releases()
    .create("v1.0.0")
    // Optional Parameters
    .target_commitish("main")
    .name("Version 1.0.0")
    .body("Announcing 1.0.0!")
    .draft(false)
    .prerelease(false)
    // Send the request
    .send()
    .await?;

pub async fn get_asset<'_>(&'_ self, asset_id: usize) -> Result<Asset>

Fetches a single asset by its ID.

let asset = octocrab::instance()
    .repos("owner", "repo")
    .releases()
    .get_asset(42)
    .await?;

pub async fn get_latest<'_>(&'_ self) -> Result<Release>

Gets the latest release.

let release = octocrab::instance()
    .repos("owner", "repo")
    .releases()
    .get_latest()
    .await?;

pub async fn get_by_tag<'_, '_>(&'_ self, tag: &'_ str) -> Result<Release>

Gets the release using its tag.

let release = octocrab::instance()
    .repos("owner", "repo")
    .releases()
    .get_by_tag("v1.0.0")
    .await?;