Edit a release through the API and oh release edit ced6d3afc5cf

- **Edit a release (#72).** `PATCH /api/v1/repos/{owner}/{name}/releases/{tag}` changes a release's title, notes or prerelease flag, keeping what it is not given, and `oh release edit TAG [--title] [--notes TEXT|-] [--prerelease true|false]` sends it. `oh api -X METHOD` without a body now sends the method asked for (#75).

/// `PATCH /repos/{owner}/{name}/releases/{tag}`: what to change; fields

/// left out stay as they are.

#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize, JsonSchema)]

pub struct ReleaseEdit {

    #[serde(default, skip_serializing_if = "Option::is_none")]

    pub title: Option<String>,

    #[serde(default, skip_serializing_if = "Option::is_none")]

    pub notes: Option<String>,

    #[serde(default, skip_serializing_if = "Option::is_none")]

    pub prerelease: Option<bool>,

}

        .route("/repos/{owner}/{name}/releases/{tag}", axum::routing::patch(edit_release))

/// `PATCH …/releases/{tag}` (oxygenhub#72): change a release's title,

/// notes or prerelease flag, as the release page's Edit does.

async fn edit_release(

    State(app): State<Shared>,

    headers: HeaderMap,

    Path((owner, name, tag)): Path<(String, String, String)>,

    Json(body): Json<ReleaseEdit>,

) -> Result<Json<Release>, ApiError> {

    let c = caller(&app, &headers).await?;

    let me = c.require("repo:write")?.clone();

    let (repo, row, _) = reach(&app, &c, &owner, &name, Access::Write).await?;

    let r = db::releases::get(&app.db, row.id, &tag).await?.ok_or_else(|| not_found("no such release"))?;

    let title = body.title.as_deref().map(str::trim).filter(|t| !t.is_empty()).unwrap_or(&r.title);

    let notes = body.notes.as_deref().map(str::trim).unwrap_or(&r.notes);

    db::releases::edit(&app.db, r.id, title, notes, body.prerelease.unwrap_or(r.prerelease)).await?;

    db::accounts::audit(&app.db, Some(&me), "release.edited", &format!("{owner}/{name}@{tag}"), "").await.ok();

    let r = crate::web::releases::api_views(&app, &repo, &row)

        .await?

        .into_iter()

        .find(|r| r.tag == tag)

        .ok_or_else(|| not_found("no such release"))?;

    Ok(Json(r))

}

    // oxygenhub#72: a release's notes and flags change through the API;

    // what is left out stays.

    let r = send(

        app,

        "PATCH",

        "/api/v1/repos/andy/demo/releases/v0.2",

        None,

        Some("site"),

        Some("application/json"),

        br#"{"notes":"Corrected notes.","prerelease":true}"#.to_vec(),

    )

    .await;

    assert_eq!(r.status, StatusCode::OK, "{}", r.text());

    let v: serde_json::Value = serde_json::from_slice(&r.body).unwrap();

    assert_eq!(

        (v["notes"].as_str(), v["prerelease"].as_bool(), v["title"].as_str()),

        (Some("Corrected notes."), Some(true), Some("Zero two"))

    );

    let r = send(app, "PATCH", "/api/v1/repos/andy/demo/releases/none", None, Some("site"), Some("application/json"), b"{}".to_vec()).await;

    assert_eq!(r.status, StatusCode::NOT_FOUND);

    /// Change a release's title, notes or prerelease flag

    Edit {

        tag: String,

        #[arg(long, short)]

        title: Option<String>,

        /// New notes in Markdown ("-" reads them from stdin)

        #[arg(long, short)]

        notes: Option<String>,

        /// Mark it a prerelease (true) or not (false)

        #[arg(long)]

        prerelease: Option<bool>,

    },

            }

        }

        ReleaseCmd::Edit { tag, title, notes, prerelease } => {

            let notes = match notes.as_deref() {

                Some("-") => Some(body_of(None, Some("-".into()))?),

                _ => notes,

            };

            if title.is_none() && notes.is_none() && prerelease.is_none() {

                bail!("say what to change: --title, --notes or --prerelease");

            }

            let edit = hub_api::ReleaseEdit { title, notes, prerelease };

            let r: Release = c.send("PATCH", &format!("{base}/releases/{tag}"), &edit)?;

            if json {

                println!("{}", serde_json::to_string(&r)?);

            } else {

                println!("{} edited {} {}", ui::ok("✔"), r.tag, ui::dim(&r.url));