Struct Forge 

pub struct Forge<R: ProcessRunner = JobRunner> { /* private fields */ }

A cwd-bound, forge-agnostic handle. Operations run against the bound directory (cwd); the CLI infers the repository from that directory’s git remote. Use at for a sibling handle bound elsewhere.

Implementations

impl Forge<JobRunner>

pub fn github(cwd: impl Into<PathBuf>) -> Self

A GitHub-backed handle bound to cwd, using the real job-backed runner.

pub fn gitlab(cwd: impl Into<PathBuf>) -> Self

A GitLab-backed handle bound to cwd, using the real job-backed runner.

pub fn gitea(cwd: impl Into<PathBuf>) -> Self

A Gitea-backed handle bound to cwd, using the real job-backed runner.

impl<R: ProcessRunner> Forge<R>

pub fn for_github(cwd: impl Into<PathBuf>, client: GitHub<R>) -> Self

Build a GitHub-backed handle from an explicit client — for a custom runner (e.g. a test seam) or a pre-configured GitHub.

pub fn for_gitlab(cwd: impl Into<PathBuf>, client: GitLab<R>) -> Self

Build a GitLab-backed handle from an explicit GitLab client.

pub fn for_gitea(cwd: impl Into<PathBuf>, client: Gitea<R>) -> Self

Build a Gitea-backed handle from an explicit Gitea client.

pub fn kind(&self) -> ForgeKind

Which forge drives this handle.

pub fn cwd(&self) -> &Path

The directory operations run against.

pub fn at(&self, dir: impl Into<PathBuf>) -> Self

A sibling handle bound to dir, sharing this handle’s client.

pub async fn auth_status(&self) -> Result<bool>

Whether the user is authenticated (GitHub/GitLab: a zero-exit auth status; Gitea: at least one configured login).

pub async fn repo_view(&self) -> Result<ForgeRepo>

The repository/project for the bound directory. Unsupported on Gitea (tea has no current-repo view).

pub async fn pr_list(&self) -> Result<Vec<ForgePr>>

Open pull/merge requests for the bound directory.

pub async fn pr_view(&self, number: u64) -> Result<ForgePr>

A single PR/MR by number (GitLab iid). On Gitea this lists and filters (tea has no single-PR view).

pub async fn pr_create(&self, spec: PrCreate) -> Result<String>

Open a PR/MR (see PrCreate), returning the CLI’s success output — a URL on GitHub/GitLab; tea prints a textual summary (no URL).

pub async fn pr_merge(&self, number: u64, strategy: MergeStrategy) -> Result<()>

Merge a PR/MR with the given MergeStrategy.

pub async fn pr_mark_ready(&self, number: u64) -> Result<()>

Mark a draft PR/MR as ready for review. Unsupported on Gitea (tea has no draft toggle — a Gitea draft is a WIP: title prefix, edited via the raw client).

pub async fn pr_close(&self, number: u64, delete_branch: bool) -> Result<()>

Close a PR/MR without merging. delete_branch applies to GitHub only (gh pr close --delete-branch); GitLab and Gitea ignore it.

pub async fn pr_checks(&self, number: u64) -> Result<CiStatus>

The PR/MR’s coarse CI status (see CiStatus). Unsupported on Gitea (tea has no checks command).

pub async fn issue_list(&self) -> Result<Vec<ForgeIssue>>

Open issues for the bound directory (up to 100; drop to the underlying client for more).

pub async fn issue_view(&self, number: u64) -> Result<ForgeIssue>

A single issue by number (GitLab iid), with body/url filled.

pub async fn issue_create(&self, title: &str, body: &str) -> Result<String>

Open an issue, returning the CLI’s success output — a URL on GitHub/GitLab; tea prints a textual summary whose final line is the URL. (The same honest-output contract as pr_create.)

pub async fn release_list(&self) -> Result<Vec<ForgeRelease>>

Releases for the bound directory, newest first (up to 100; drop to the underlying client for more).

pub async fn release_view(&self, tag: &str) -> Result<ForgeRelease>

A single release by tag. Unsupported on Gitea (tea releases always lists — it has no single-release view; filter release_list instead).

Trait Implementations

impl<R: ProcessRunner> ForgeApi for Forge<R>

fn kind(&self) -> ForgeKind

Which forge drives this handle.

fn cwd(&self) -> &Path

The directory operations run against.

fn auth_status<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::auth_status.

fn repo_view<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ForgeRepo>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::repo_view.

fn pr_list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<ForgePr>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_list.

fn pr_view<'life0, 'async_trait>( &'life0 self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<ForgePr>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_view.

fn pr_create<'life0, 'async_trait>( &'life0 self, spec: PrCreate, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_create.

fn pr_merge<'life0, 'async_trait>( &'life0 self, number: u64, strategy: MergeStrategy, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_merge.

fn pr_mark_ready<'life0, 'async_trait>( &'life0 self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_mark_ready.

fn pr_close<'life0, 'async_trait>( &'life0 self, number: u64, delete_branch: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_close.

fn pr_checks<'life0, 'async_trait>( &'life0 self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<CiStatus>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::pr_checks.

fn issue_list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<ForgeIssue>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::issue_list.

fn issue_view<'life0, 'async_trait>( &'life0 self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<ForgeIssue>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::issue_view.

fn issue_create<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, title: &'life1 str, body: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

See Forge::issue_create.

fn release_list<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<ForgeRelease>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

See Forge::release_list.

fn release_view<'life0, 'life1, 'async_trait>( &'life0 self, tag: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ForgeRelease>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

See Forge::release_view.