1195bfbe11
systemic gap argus flagged on PR #798 (timeline verb). every `pub fn run` in hive-forge/src/verbs/*.rs lacked a `# Errors` block — violates Rust API guidelines + obscures the failure surface for operators reading the source. uniform doc per verb category: - pure GET + print verbs: "transport error from the Forgejo REST call + I/O error from stdout" - body-from-file verbs (comment/comment_edit/issue_create/issue_edit/ pr_create): adds 'I/O error from --body-file/stdin input' - file-upload verbs (attach-issue, attach-comment): adds 'file read/exist check' - pr_create: also mentions the --push shellout 23 `pub fn run` signatures touched. no behaviour change; pure documentation sweep. cargo test green (38 tests).
45 lines
1.4 KiB
Rust
45 lines
1.4 KiB
Rust
//! `issue-create --title <t> [body sources] [--assignee <u>] [repo]`
|
|
//! — create an issue. Prints the issue URL.
|
|
|
|
use anyhow::Result;
|
|
use clap::Args as ClapArgs;
|
|
use serde_json::{Value, json};
|
|
|
|
use crate::body;
|
|
use crate::client::Client;
|
|
|
|
#[derive(ClapArgs)]
|
|
pub struct Args {
|
|
/// Issue title (required).
|
|
#[arg(long)]
|
|
title: String,
|
|
/// Inline body text.
|
|
#[arg(long, conflicts_with = "body_file")]
|
|
body: Option<String>,
|
|
/// Read body from a file. `-` means stdin.
|
|
#[arg(long = "body-file")]
|
|
body_file: Option<String>,
|
|
/// Initial assignee login.
|
|
#[arg(long)]
|
|
assignee: Option<String>,
|
|
}
|
|
|
|
/// # Errors
|
|
///
|
|
/// Propagates any I/O error from the body input (`--body-file`,
|
|
/// stdin), any transport error from the Forgejo REST call (network
|
|
/// unreachable, 4xx/5xx response, token missing/invalid), and any
|
|
/// I/O error from writing the issue URL to stdout.
|
|
pub fn run(client: &Client, args: Args) -> Result<()> {
|
|
let body = body::resolve(args.body.as_deref(), args.body_file.as_deref())?.unwrap_or_default();
|
|
let repo = client.repo();
|
|
let mut payload = json!({ "title": args.title, "body": body });
|
|
if let Some(a) = args.assignee {
|
|
payload["assignees"] = json!([a]);
|
|
}
|
|
let resp = client.post_json(&format!("/repos/{repo}/issues"), &payload)?;
|
|
if let Some(url) = resp.get("html_url").and_then(Value::as_str) {
|
|
println!("{url}");
|
|
}
|
|
Ok(())
|
|
}
|