octocrab 0.49.8

use chrono::{DateTime, Utc};

use crate::models::checks::{AutoTriggerCheck, CheckSuite, CheckSuitePreferences};
use crate::models::{AppId, CheckRunId, CheckSuiteId};
use crate::params::checks::{
    CheckRunAnnotation, CheckRunConclusion, CheckRunOutput, CheckRunStatus,
};
use crate::params::repos::Commitish;
use crate::{models, Octocrab, Result};

/// Handler for GitHub's Checks API.
///
/// Created with [`Octocrab::checks`].
pub struct ChecksHandler<'octo> {
    crab: &'octo Octocrab,
    owner: String,
    repo: String,
}

#[derive(serde::Serialize)]
pub struct GetCheckRunBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_run_id: CheckRunId,
}

impl<'octo, 'r> GetCheckRunBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_run_id: CheckRunId) -> Self {
        Self {
            handler,
            check_run_id,
        }
    }

    pub async fn send(self) -> Result<models::checks::CheckRun> {
        let route = format!(
            "/repos/{owner}/{repo}/check-runs/{check_run_id}",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_run_id = self.check_run_id
        );

        self.handler.crab.get(route, None::<&()>).await
    }
}

#[derive(serde::Serialize)]
pub struct CreateCheckRunBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    name: String,
    head_sha: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    details_url: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    external_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    status: Option<CheckRunStatus>,
    #[serde(skip_serializing_if = "Option::is_none")]
    conclusion: Option<CheckRunConclusion>,
    #[serde(skip_serializing_if = "Option::is_none")]
    completed_at: Option<DateTime<Utc>>,
    #[serde(skip_serializing_if = "Option::is_none")]
    output: Option<CheckRunOutput>,
}

impl<'octo, 'r> CreateCheckRunBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, name: String, head_sha: String) -> Self {
        Self {
            handler,
            name,
            head_sha,
            details_url: None,
            external_id: None,
            status: None,
            conclusion: None,
            completed_at: None,
            output: None,
        }
    }

    /// The URL of the integrator's site that has the full details of the check.
    /// If the integrator does not provide this, then the homepage of the GitHub app is used.
    pub fn details_url(mut self, details_url: impl Into<String>) -> Self {
        self.details_url = Some(details_url.into());
        self
    }

    /// A reference for the run on the integrator's system.
    pub fn external_id(mut self, external_id: impl Into<String>) -> Self {
        self.external_id = Some(external_id.into());
        self
    }

    /// The current status.
    /// Can be one of `queued`, `in_progress`, or `completed`.
    pub fn status(mut self, status: CheckRunStatus) -> Self {
        self.status = Some(status);
        self
    }

    /// The final conclusion of the check.
    pub fn conclusion(mut self, conclusion: CheckRunConclusion) -> Self {
        self.conclusion = Some(conclusion);
        self
    }

    /// The time that the check run completed.
    pub fn completed_at(mut self, completed_at: DateTime<Utc>) -> Self {
        self.completed_at = Some(completed_at);
        self
    }

    /// Check runs can accept a variety of data in the output object,
    /// including a title and summary and can optionally provide
    /// descriptive details about the run.
    pub fn output(mut self, output: CheckRunOutput) -> Self {
        self.output = Some(output);
        self
    }

    /// Sends the actual request.
    pub async fn send(self) -> Result<models::checks::CheckRun> {
        let route = format!(
            "/repos/{owner}/{repo}/check-runs",
            owner = self.handler.owner,
            repo = self.handler.repo
        );

        self.handler.crab.post(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct UpdateCheckRunBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_run_id: CheckRunId,
    #[serde(skip_serializing_if = "Option::is_none")]
    name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    details_url: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    external_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    started_at: Option<DateTime<Utc>>,
    #[serde(skip_serializing_if = "Option::is_none")]
    status: Option<CheckRunStatus>,
    #[serde(skip_serializing_if = "Option::is_none")]
    conclusion: Option<CheckRunConclusion>,
    #[serde(skip_serializing_if = "Option::is_none")]
    completed_at: Option<DateTime<Utc>>,
    #[serde(skip_serializing_if = "Option::is_none")]
    output: Option<CheckRunOutput>,
}

impl<'octo, 'r> UpdateCheckRunBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_run_id: CheckRunId) -> Self {
        Self {
            handler,
            check_run_id,
            name: None,
            details_url: None,
            external_id: None,
            started_at: None,
            status: None,
            conclusion: None,
            completed_at: None,
            output: None,
        }
    }

    /// The name of the check. For example, "code-coverage".
    pub fn name(mut self, name: impl Into<String>) -> Self {
        self.name = Some(name.into());
        self
    }

    /// The URL of the integrator's site that has the full details of the check.
    /// If the integrator does not provide this, then the homepage of the GitHub app is used.
    pub fn details_url(mut self, details_url: impl Into<String>) -> Self {
        self.details_url = Some(details_url.into());
        self
    }

    /// A reference for the run on the integrator's system.
    pub fn external_url(mut self, external_id: impl Into<String>) -> Self {
        self.external_id = Some(external_id.into());
        self
    }

    /// The time that the check run began.
    pub fn started_at(mut self, started_at: DateTime<Utc>) -> Self {
        self.started_at = Some(started_at);
        self
    }

    /// The current status.
    /// Can be one of `queued`, `in_progress`, or `completed`.
    pub fn status(mut self, status: CheckRunStatus) -> Self {
        self.status = Some(status);
        self
    }

    /// The final conclusion of the check.
    pub fn conclusion(mut self, conclusion: CheckRunConclusion) -> Self {
        self.conclusion = Some(conclusion);
        self
    }

    /// The time that the check run completed.
    pub fn completed_at(mut self, completed_at: DateTime<Utc>) -> Self {
        self.completed_at = Some(completed_at);
        self
    }

    /// Check runs can accept a variety of data in the output object,
    /// including a title and summary and can optionally provide
    /// descriptive details about the run.
    pub fn output(mut self, output: CheckRunOutput) -> Self {
        self.output = Some(output);
        self
    }

    /// Sends the actual request.
    pub async fn send(self) -> Result<models::checks::CheckRun> {
        let route = format!(
            "/repos/{owner}/{repo}/check-runs/{check_run_id}",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_run_id = self.check_run_id
        );
        self.handler.crab.patch(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct ListCheckRunsInCheckSuiteBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_suite_id: CheckSuiteId,
    #[serde(skip_serializing_if = "Option::is_none")]
    check_name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    status: Option<CheckRunStatus>,
    #[serde(skip_serializing_if = "Option::is_none")]
    per_page: Option<u8>,
    #[serde(skip_serializing_if = "Option::is_none")]
    page: Option<u32>,
}

impl<'octo, 'r> ListCheckRunsInCheckSuiteBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_suite_id: CheckSuiteId) -> Self {
        Self {
            handler,
            check_suite_id,
            check_name: None,
            status: None,
            per_page: None,
            page: None,
        }
    }

    /// Results per page (max 100).
    pub fn per_page(mut self, per_page: impl Into<u8>) -> Self {
        self.per_page = Some(per_page.into());
        self
    }

    /// Page number of the results to fetch.
    pub fn page(mut self, page: impl Into<u32>) -> Self {
        self.page = Some(page.into());
        self
    }

    /// Returns check runs with the specified `name`.
    pub fn check_name(mut self, check_name: impl Into<String>) -> Self {
        self.check_name = Some(check_name.into());
        self
    }

    /// Returns check runs with the specified `status`.
    pub fn status(mut self, status: CheckRunStatus) -> Self {
        self.status = Some(status);
        self
    }

    /// Send the actual request.
    pub async fn send(self) -> Result<models::checks::ListCheckRuns> {
        let route = format!(
            "/repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_suite_id = self.check_suite_id,
        );

        self.handler.crab.get(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct ListCheckRunsForGitRefBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    #[serde(skip)]
    git_ref: Commitish,
    #[serde(skip_serializing_if = "Option::is_none")]
    per_page: Option<u8>,
    #[serde(skip_serializing_if = "Option::is_none")]
    page: Option<u32>,
}

impl<'octo, 'r> ListCheckRunsForGitRefBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, git_ref: Commitish) -> Self {
        Self {
            handler,
            git_ref,
            per_page: None,
            page: None,
        }
    }

    /// Results per page (max 100).
    pub fn per_page(mut self, per_page: impl Into<u8>) -> Self {
        self.per_page = Some(per_page.into());
        self
    }

    /// Page number of the results to fetch.
    pub fn page(mut self, page: impl Into<u32>) -> Self {
        self.page = Some(page.into());
        self
    }

    /// Send the actual request.
    pub async fn send(self) -> Result<models::checks::ListCheckRuns> {
        let route = format!(
            "/repos/{owner}/{repo}/commits/{ref}/check-runs",
            owner = self.handler.owner,
            repo = self.handler.repo,
            ref = self.git_ref,
        );

        self.handler.crab.get(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct ListCheckSuitesForGitRefBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    #[serde(skip)]
    git_ref: Commitish,
    per_page: Option<u8>,
    page: Option<u32>,
    ///Filters check suites by GitHub App id.
    app_id: Option<AppId>,
    ///Returns check runs with the specified name.
    check_name: Option<String>,
}

impl<'octo, 'r> crate::checks::ListCheckSuitesForGitRefBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, git_ref: Commitish) -> Self {
        Self {
            handler,
            git_ref,
            page: None,
            per_page: None,
            app_id: None,
            check_name: None,
        }
    }

    /// Send the actual request to /repos/{owner}/{repo}/commits/{ref}/check-suites
    /// See <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#list-check-suites-for-a-git-reference>
    pub async fn send(self) -> Result<models::checks::ListCheckSuites> {
        let route = format!(
            "/repos/{owner}/{repo}/commits/{ref}/check-suites",
            owner = self.handler.owner,
            repo = self.handler.repo,
            ref = self.git_ref,
        );

        self.handler.crab.get(route, Some(&self)).await
    }

    /// Results per page (max 100).
    pub fn per_page(mut self, per_page: impl Into<u8>) -> Self {
        self.per_page = Some(per_page.into());
        self
    }

    /// Page number of the results to fetch.
    pub fn page(mut self, page: impl Into<u32>) -> Self {
        self.page = Some(page.into());
        self
    }

    /// Filters check suites by GitHub App id.
    pub fn app_id(mut self, app_id: impl Into<AppId>) -> Self {
        self.app_id = Some(app_id.into());
        self
    }

    /// Returns check runs with the specified name.
    pub fn check_name(mut self, check_name: impl Into<String>) -> Self {
        self.check_name = Some(check_name.into());
        self
    }
}

impl<'octo> ChecksHandler<'octo> {
    pub(crate) fn new(crab: &'octo Octocrab, owner: String, repo: String) -> Self {
        Self { crab, owner, repo }
    }

    /// ```no_run
    /// # async fn run() -> octocrab::Result<()> {
    /// let check_runs = octocrab::instance()
    ///     .checks("owner", "repo")
    ///     .list_check_runs_in_a_check_suite(123456.into())
    ///     .send()
    ///     .await?;
    /// # Ok(())
    /// # }
    /// ```
    pub fn list_check_runs_in_a_check_suite(
        &self,
        suite_id: CheckSuiteId,
    ) -> ListCheckRunsInCheckSuiteBuilder<'_, '_> {
        ListCheckRunsInCheckSuiteBuilder::new(self, suite_id)
    }

    /// ```no_run
    /// # use octocrab::params::repos::Commitish;
    ///  async fn run() -> octocrab::Result<()> {
    ///    let check_runs = octocrab::instance()
    ///      .checks("owner", "repo")
    ///      .list_check_runs_for_git_ref(Commitish("ref".to_string()))
    ///      .send()
    ///      .await?;
    /// # Ok(())
    /// # }
    pub fn list_check_runs_for_git_ref(
        &self,
        git_ref: Commitish,
    ) -> ListCheckRunsForGitRefBuilder<'_, '_> {
        ListCheckRunsForGitRefBuilder::new(self, git_ref)
    }

    ///Lists check suites for a commit ref.
    ///See <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#list-check-suites-for-a-git-reference>
    ///```no_run
    /// use octocrab::models::checks::ListCheckSuites;
    /// use octocrab::params::repos::Commitish;
    ///  async fn run() -> octocrab::Result<ListCheckSuites> {
    ///    let check_suites = octocrab::instance()
    ///      .checks("owner", "repo")
    ///      .list_check_suites_for_git_ref(Commitish("ref".to_string()))
    ///      .send()
    ///      .await;
    ///     check_suites
    /// }
    pub fn list_check_suites_for_git_ref(
        &self,
        git_ref: Commitish,
    ) -> ListCheckSuitesForGitRefBuilder<'_, '_> {
        ListCheckSuitesForGitRefBuilder::new(self, git_ref)
    }

    /// ```no_run
    /// # async fn run() -> octocrab::Result<()> {
    /// let check_run = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .create_check_run("name", "head_sha")
    ///    .details_url("https://example.com")
    ///    .external_id("external_id")
    ///    .status(octocrab::params::checks::CheckRunStatus::InProgress)
    ///    .send()
    ///    .await?;
    /// # Ok(())
    /// # }
    /// ```
    pub fn create_check_run(
        &self,
        name: impl Into<String>,
        head_sha: impl Into<String>,
    ) -> CreateCheckRunBuilder<'_, '_> {
        CreateCheckRunBuilder::new(self, name.into(), head_sha.into())
    }

    /// ```no_run
    /// # async fn run() -> octocrab::Result<()> {
    /// let check_run = octocrab::instance()
    ///   .checks("owner", "repo")
    ///  .update_check_run(123456.into())
    /// .name("name")
    /// .details_url("https://example.com")
    /// .external_url("external_id")
    /// .status(octocrab::params::checks::CheckRunStatus::InProgress)
    /// .send()
    /// .await?;
    /// # Ok(())
    /// # }
    /// ```
    pub fn update_check_run(&self, check_run_id: CheckRunId) -> UpdateCheckRunBuilder<'_, '_> {
        UpdateCheckRunBuilder::new(self, check_run_id)
    }

    /// Creates a check suite manually. see <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#create-a-check-suite>
    /// ```no_run
    /// use octocrab::models::checks::CheckSuite;
    ///  async fn run() -> octocrab::Result<CheckSuite> {
    ///   let check_suite_create_result = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .create_check_suite("head_sha")
    ///    .send()
    ///    .await;
    ///     check_suite_create_result
    /// }
    /// ```
    pub fn create_check_suite(
        &self,
        head_sha: impl Into<String>,
    ) -> CreateCheckSuiteBuilder<'_, '_> {
        CreateCheckSuiteBuilder::new(self, head_sha.into())
    }

    /// Changes the default automatic flow when creating check suites. By default, a check suite is automatically created each time code is pushed to a repository. When you disable the automatic creation of check suites, you can manually Create a check suite. You must have admin permissions in the repository to set preferences for check suites.
    /// see <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#update-repository-preferences-for-check-suites>
    /// ```no_run
    /// use octocrab::models::{AppId, checks::AutoTriggerCheck};
    /// use octocrab::models::checks::CheckSuitePreferences;
    ///  async fn run() -> octocrab::Result<CheckSuitePreferences> {
    ///   let check_suite_run = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .update_preferences(
    ///       vec![ AutoTriggerCheck {app_id: AppId(23874), setting: false},
    ///             AutoTriggerCheck {app_id: AppId(42), setting: false} ]
    ///     )
    ///    .send()
    ///    .await;
    /// check_suite_run
    /// }
    /// ```
    pub fn update_preferences(
        &self,
        auto_trigger_checks: Vec<AutoTriggerCheck>,
    ) -> CheckSuitePreferencesBuilder<'_, '_> {
        CheckSuitePreferencesBuilder::new(self, auto_trigger_checks)
    }

    /// Gets a single check suite using its id.
    /// See <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#get-a-check-suite>
    /// ```no_run
    /// use octocrab::models::checks::CheckSuite;
    /// use octocrab::models::CheckSuiteId;
    ///  async fn run() -> octocrab::Result<CheckSuite> {
    ///   let get_check_suite_result = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .get_check_suite(CheckSuiteId(42))
    ///    .send()
    ///    .await;
    ///     get_check_suite_result
    /// }
    /// ```
    pub fn get_check_suite(&self, check_suite_id: CheckSuiteId) -> GetCheckSuiteBuilder<'_, '_> {
        GetCheckSuiteBuilder::new(self, check_suite_id)
    }

    ///Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository.
    ///See <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#rerequest-a-check-suite>
    ///```no_run
    /// use octocrab::models::CheckSuiteId;
    ///  async fn run() -> octocrab::Result<()> {
    ///   let rerequest_check_suite_result = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .rerequest_check_suite(CheckSuiteId(42))
    ///    .send()
    ///    .await;
    ///     rerequest_check_suite_result
    /// }
    /// ```
    pub fn rerequest_check_suite(
        &self,
        check_suite_id: CheckSuiteId,
    ) -> crate::api::checks::RerequestCheckSuiteBuilder<'_, '_> {
        RerequestCheckSuiteBuilder::new(self, check_suite_id)
    }

    ///Triggers GitHub to rerequest an existing check run, without pushing new code to a repository.
    ///See <https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#rerequest-a-check-run>
    ///```no_run
    /// use octocrab::models::CheckRunId;
    ///  async fn run() -> octocrab::Result<()> {
    ///   let rerequest_check_run_result = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .rerequest_check_run(CheckRunId(42))
    ///    .send()
    ///    .await;
    ///     rerequest_check_run_result
    /// }
    /// ```
    pub fn rerequest_check_run(
        &self,
        check_run_id: CheckRunId,
    ) -> crate::api::checks::RerequestCheckRunBuilder<'_, '_> {
        RerequestCheckRunBuilder::new(self, check_run_id)
    }

    ///Lists annotations for a check run using the annotation id.
    ///See <https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-run-annotations>
    ///```no_run
    /// use octocrab::models::CheckRunId;
    /// use octocrab::params::checks::CheckRunAnnotation;
    ///  async fn run() -> octocrab::Result<Vec<CheckRunAnnotation>> {
    ///   let check_run_annotations_result = octocrab::instance()
    ///    .checks("owner", "repo")
    ///    .list_annotations(CheckRunId(42))
    ///    .send()
    ///    .await;
    ///     check_run_annotations_result
    /// }
    /// ```
    pub fn list_annotations(
        &self,
        check_run_id: CheckRunId,
    ) -> crate::api::checks::CheckRunAnnotationsBuilder<'_, '_> {
        CheckRunAnnotationsBuilder::new(self, check_run_id)
    }

    /// ```no_run
    /// # async fn run() -> octocrab::Result<()> {
    /// let check_run = octocrab::instance()
    ///   .checks("owner", "repo")
    ///  .get_check_run(123456.into())
    /// .send()
    /// .await?;
    /// # Ok(())
    /// # }
    /// ```
    pub fn get_check_run(&self, check_run_id: CheckRunId) -> GetCheckRunBuilder<'_, '_> {
        GetCheckRunBuilder::new(self, check_run_id)
    }
}

#[derive(serde::Serialize)]
pub struct CreateCheckSuiteBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    head_sha: String,
}

impl<'octo, 'r> CreateCheckSuiteBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, head_sha: String) -> Self {
        Self { handler, head_sha }
    }

    /// Sends the actual request.
    pub async fn send(self) -> Result<models::checks::CheckSuite> {
        let route = format!(
            "/repos/{owner}/{repo}/check-suites",
            owner = self.handler.owner,
            repo = self.handler.repo
        );
        self.handler.crab.post(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct CheckSuitePreferencesBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    auto_trigger_checks: Vec<AutoTriggerCheck>,
}

impl<'octo, 'r> CheckSuitePreferencesBuilder<'octo, 'r> {
    pub(crate) fn new(
        handler: &'r ChecksHandler<'octo>,
        auto_trigger_checks: Vec<AutoTriggerCheck>,
    ) -> Self {
        Self {
            handler,
            auto_trigger_checks,
        }
    }

    /// Sends the actual request of [`ChecksHandler.update_preferences()`]
    /// see <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#update-repository-preferences-for-check-suites>
    ///
    /// [`ChecksHandler.update_preferences()`]: ChecksHandler#method.update_preferences()
    pub async fn send(self) -> Result<CheckSuitePreferences> {
        let route = format!(
            "/repos/{owner}/{repo}/check-suites/preferences",
            owner = self.handler.owner,
            repo = self.handler.repo
        );
        self.handler.crab.patch(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct GetCheckSuiteBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_suite_id: CheckSuiteId,
}

impl<'octo, 'r> GetCheckSuiteBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_suite_id: CheckSuiteId) -> Self {
        Self {
            handler,
            check_suite_id,
        }
    }

    /// Sends the actual request of [`ChecksHandler.get_check_suite()`]
    /// see <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#get-a-check-suite>
    ///
    /// [`ChecksHandler.get_check_suite()`]: ChecksHandler#method.get_check_suite()
    pub async fn send(self) -> Result<CheckSuite> {
        let route = format!(
            "/repos/{owner}/{repo}/check-suites/{check_suite_id}",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_suite_id = self.check_suite_id
        );
        self.handler.crab.get(route, Some(&self)).await
    }
}

#[derive(serde::Serialize)]
pub struct RerequestCheckSuiteBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_suite_id: CheckSuiteId,
}

impl<'octo, 'r> crate::checks::RerequestCheckSuiteBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_suite_id: CheckSuiteId) -> Self {
        Self {
            handler,
            check_suite_id,
        }
    }

    /// Sends the actual request of [`ChecksHandler.rerequest_check_suite()`]
    /// see <https://docs.github.com/en/rest/checks/suites?apiVersion=2022-11-28#rerequest-a-check-suite>
    ///
    /// [`ChecksHandler.rerequest_check_suite()`]: ChecksHandler#method.rerequest_check_suite()
    pub async fn send(self) -> Result<()> {
        let route = format!(
            "/repos/{owner}/{repo}/check-suites/{check_suite_id}/rerequest",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_suite_id = self.check_suite_id
        );
        let response = self.handler.crab._post(route, Some(&self)).await?;
        if !response.status().is_success() {
            return Err(crate::map_github_error(response).await.unwrap_err());
        }

        Ok(())
    }
}

#[derive(serde::Serialize)]
pub struct RerequestCheckRunBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_run_id: CheckRunId,
}

impl<'octo, 'r> crate::checks::RerequestCheckRunBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_run_id: CheckRunId) -> Self {
        Self {
            handler,
            check_run_id,
        }
    }

    /// Sends the actual request of [`ChecksHandler.rerequest_check_run()`]
    /// see <https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#rerequest-a-check-run>
    ///
    /// [`ChecksHandler.rerequest_check_run()`]: ChecksHandler#method.rerequest_check_run()
    pub async fn send(self) -> Result<()> {
        let route = format!(
            "/repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_run_id = self.check_run_id
        );
        let response = self.handler.crab._post(route, Some(&self)).await?;
        if !response.status().is_success() {
            return Err(crate::map_github_error(response).await.unwrap_err());
        }

        Ok(())
    }
}

#[derive(serde::Serialize)]
pub struct CheckRunAnnotationsBuilder<'octo, 'r> {
    #[serde(skip)]
    handler: &'r ChecksHandler<'octo>,
    check_run_id: CheckRunId,
    per_page: Option<u8>,
    page: Option<u32>,
}

impl<'octo, 'r> crate::checks::CheckRunAnnotationsBuilder<'octo, 'r> {
    pub(crate) fn new(handler: &'r ChecksHandler<'octo>, check_run_id: CheckRunId) -> Self {
        Self {
            handler,
            check_run_id,
            page: None,
            per_page: None,
        }
    }

    /// Sends the actual request of [`ChecksHandler.list_annotations()`]
    /// see <https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#list-check-run-annotations>
    ///
    /// [`ChecksHandler.list_annotations()`]: ChecksHandler#method.list_annotations()
    pub async fn send(self) -> Result<Vec<CheckRunAnnotation>> {
        let route = format!(
            "/repos/{owner}/{repo}/check-runs/{check_run_id}/annotations",
            owner = self.handler.owner,
            repo = self.handler.repo,
            check_run_id = self.check_run_id
        );
        self.handler.crab.get(route, Some(&self)).await
    }

    /// Results per page (max 100).
    pub fn per_page(mut self, per_page: impl Into<u8>) -> Self {
        self.per_page = Some(per_page.into());
        self
    }

    /// Page number of the results to fetch.
    pub fn page(mut self, page: impl Into<u32>) -> Self {
        self.page = Some(page.into());
        self
    }
}