pub struct GitLabIssueProvider<R: CommandRunner = RealCommandRunner> { /* private fields */ }Expand description
GitLab Issue 提供者,通过 glab CLI 操作。
该结构体通过调用 glab CLI 实现 IssueProvider trait 的所有方法,
使上层命令能够以统一的方式操作 GitLab Issue。
命令执行通过 CommandRunner 抽象,生产环境默认使用
RealCommandRunner,测试可注入自定义 runner 以模拟成功或失败场景。
§Examples
use gitflow_gitlab::GitLabIssueProvider;
let provider = GitLabIssueProvider::new("gitlab-org/gitlab");Implementations§
Source§impl GitLabIssueProvider<RealCommandRunner>
impl GitLabIssueProvider<RealCommandRunner>
Sourcepub fn new(repo: impl Into<String>) -> Self
pub fn new(repo: impl Into<String>) -> Self
创建新的 GitLab Issue 提供者,使用真实的进程执行器。
repo 格式为 namespace/project。
Sourcepub fn with_session(session: &Session) -> Self
pub fn with_session(session: &Session) -> Self
Create a new provider from a shared [Session].
This enables state reuse across multiple operations in workflow chains.
Sourcepub fn with_remote_url(
repo: impl Into<String>,
remote_url: impl Into<String>,
) -> Self
pub fn with_remote_url( repo: impl Into<String>, remote_url: impl Into<String>, ) -> Self
使用完整 git remote URL 作为 glab issue ... 的 --repo 目标创建提供者。
repo 仍为裸 namespace/project(供 REST notes API 路径编码使用),
remote_url 为完整 git remote URL。glab 官方文档确认 --repo 接受
完整 URL/Git URL 形式,借此在自建 GitLab 实例上显式锁定 host。
Source§impl<R: CommandRunner> GitLabIssueProvider<R>
impl<R: CommandRunner> GitLabIssueProvider<R>
Sourcepub fn with_runner(repo: impl Into<String>, runner: R) -> Self
pub fn with_runner(repo: impl Into<String>, runner: R) -> Self
使用自定义 CommandRunner 创建提供者。
主要用于测试,可注入模拟 runner 以控制 glab CLI 的输出。
repo 格式为 namespace/project。
Sourcepub fn with_runner_and_repo_target(
repo: impl Into<String>,
repo_target: impl Into<String>,
runner: R,
) -> Self
pub fn with_runner_and_repo_target( repo: impl Into<String>, repo_target: impl Into<String>, runner: R, ) -> Self
使用自定义 CommandRunner 并显式指定 --repo 目标创建提供者。
主要用于测试,验证 repo_target(如完整 remote URL)被正确传给 glab,
无需引入真实进程执行器。
Trait Implementations§
Source§impl<R: Clone + CommandRunner> Clone for GitLabIssueProvider<R>
impl<R: Clone + CommandRunner> Clone for GitLabIssueProvider<R>
Source§impl<R: Debug + CommandRunner> Debug for GitLabIssueProvider<R>
impl<R: Debug + CommandRunner> Debug for GitLabIssueProvider<R>
Source§impl<R: CommandRunner + Clone + 'static> IssueProvider for GitLabIssueProvider<R>
impl<R: CommandRunner + Clone + 'static> IssueProvider for GitLabIssueProvider<R>
Source§fn edit<'life0, 'async_trait>(
&'life0 self,
number: u64,
args: EditIssueArgs,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn edit<'life0, 'async_trait>(
&'life0 self,
number: u64,
args: EditIssueArgs,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Source§fn close<'life0, 'async_trait>(
&'life0 self,
number: u64,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn close<'life0, 'async_trait>(
&'life0 self,
number: u64,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Source§fn reopen<'life0, 'async_trait>(
&'life0 self,
number: u64,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn reopen<'life0, 'async_trait>(
&'life0 self,
number: u64,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Source§fn comment<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
body: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<CommentData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn comment<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
body: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<CommentData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
在指定 Issue 上添加评论。
调用 glab api --method POST /projects/{repo-encoded}/issues/{number}/notes
发布评论,其中 {repo-encoded} 为全量 URL 编码的项目路径
(如 group/subgroup/project → group%2Fsubgroup%2Fproject),
并返回评论文数据。
§Errors
当 Issue 不存在、body 为空或 glab CLI 调用失败时返回错误。
Source§fn list_comments<'life0, 'async_trait>(
&'life0 self,
number: u64,
limit: Option<u32>,
) -> Pin<Box<dyn Future<Output = Result<Paged<CommentData>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn list_comments<'life0, 'async_trait>(
&'life0 self,
number: u64,
limit: Option<u32>,
) -> Pin<Box<dyn Future<Output = Result<Paged<CommentData>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
列出指定 Issue 的评论。
调用 glab api /projects/{repo-encoded}/issues/{iid}/notes 获取评论列表,
其中 {repo-encoded} 为全量 URL 编码的项目路径
(如 group/subgroup/project → group%2Fsubgroup%2Fproject),
通过 per_page/page 查询参数逐页取到 limit。
§Errors
当 Issue 不存在或 glab CLI 调用失败时返回错误。
Source§fn add_labels<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
labels: &'life1 [String],
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn add_labels<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
labels: &'life1 [String],
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn remove_label<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
label: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn remove_label<'life0, 'life1, 'async_trait>(
&'life0 self,
number: u64,
label: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
从指定 Issue 移除一个标签。
调用 glab issue update <number> --repo <repo> --unlabel <label> 移除标签。
§Errors
当 Issue 不存在、标签未附加到该 Issue 或 glab CLI 调用失败时返回错误。
Source§fn create<'life0, 'async_trait>(
&'life0 self,
args: CreateIssueArgs,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn create<'life0, 'async_trait>(
&'life0 self,
args: CreateIssueArgs,
) -> Pin<Box<dyn Future<Output = Result<IssueData>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Auto Trait Implementations§
impl<R> Freeze for GitLabIssueProvider<R>where
R: Freeze,
impl<R> RefUnwindSafe for GitLabIssueProvider<R>where
R: RefUnwindSafe,
impl<R> Send for GitLabIssueProvider<R>
impl<R> Sync for GitLabIssueProvider<R>
impl<R> Unpin for GitLabIssueProvider<R>where
R: Unpin,
impl<R> UnsafeUnpin for GitLabIssueProvider<R>where
R: UnsafeUnpin,
impl<R> UnwindSafe for GitLabIssueProvider<R>where
R: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
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