Struct CommentsService 

pub struct CommentsService<'a> { /* private fields */ }

Comment operations, obtained via LinearClient::comments.

let client = linear_api::LinearClient::from_env()?;
let comment = client
    .comments()
    .create_on(linear_api::IssueRef::identifier("ENG-123"), "On it.")
    .await?;
println!("created {}", comment.url);

Implementations

impl<'a> CommentsService<'a>

pub async fn list_for_issue( &self, issue: impl Into<IssueRef>, req: CommentListRequest, ) -> Result<Page<Comment>>

Fetches one page of an issue’s comment thread (issue(id:) { comments }).

For the “latest N comments” pattern pass first: N on the request; ordering follows Linear’s default connection order (createdAt).

use linear_api::IssueRef;
use linear_api::comments::CommentListRequest;

let page = client
    .comments()
    .list_for_issue(
        IssueRef::identifier("ENG-123"),
        CommentListRequest::builder().first(5).build(),
    )
    .await?;

pub fn list_for_issue_stream( &self, issue: impl Into<IssueRef>, req: CommentListRequest, ) -> impl Stream<Item = Result<Comment>> + 'a

Lazily streams an issue’s whole comment thread across pages via paginate.

req.first controls the page size; a pre-set req.after seeds the first page’s cursor.

use futures::TryStreamExt;
use linear_api::IssueRef;
use linear_api::comments::CommentListRequest;

let comments: Vec<_> = client
    .comments()
    .list_for_issue_stream(
        IssueRef::identifier("ENG-123"),
        CommentListRequest::builder().build(),
    )
    .try_collect()
    .await?;

pub async fn create(&self, input: CommentCreateInput) -> Result<Comment>

Creates a comment (commentCreate). Thread replies via parent_id.

use linear_api::comments::CommentCreateInput;

let comment = client
    .comments()
    .create(
        CommentCreateInput::builder()
            .issue_id("ENG-123")
            .body("Run finished: all green.".to_owned())
            .build(),
    )
    .await?;

pub async fn create_on( &self, issue: impl Into<IssueRef>, body: impl Into<String>, ) -> Result<Comment>

Convenience: creates a plain markdown comment on an issue.

use linear_api::IssueRef;

client
    .comments()
    .create_on(IssueRef::identifier("ENG-123"), "On it.")
    .await?;

pub async fn update( &self, id: &CommentId, body: impl Into<String>, ) -> Result<Comment>

Replaces a comment’s markdown body (commentUpdate).

use linear_api::CommentId;

let id = CommentId::new("9d2a…");
client.comments().update(&id, "Edited: rollout done.").await?;

pub async fn delete(&self, id: &CommentId) -> Result<()>

Deletes a comment (commentDelete).

use linear_api::CommentId;

let id = CommentId::new("9d2a…");
client.comments().delete(&id).await?;

Trait Implementations

impl<'a> Clone for CommentsService<'a>

fn clone(&self) -> CommentsService<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for CommentsService<'a>