Create branch from azure devops assigned tasks

cb.ts

#!/usr/bin/env deno run --quiet --no-check --allow-net=dev.azure.com --allow-run --allow-env=AZURE_DEVOPS_READ_WORK_ITEMS_TOKEN
import * as Colors from "https://deno.land/[email protected]/fmt/colors.ts";
import { DOMParser } from "https://deno.land/x/deno_dom/deno-dom-wasm.ts";

const prefix = Deno.args[0] ?? "feature";

const ids_query =
  "SELECT [System.Id] FROM workitems WHERE [System.TeamProject] = @project AND [System.State] <> 'Ready for test' AND [System.State] <> 'Parked' AND [System.State] <> 'Removed' AND [System.State] <> 'Tested OK' AND [System.State] <> 'Done' AND [System.AssignedTo] = @me";

const organizationName = "x";
const projectName = "xx";
const username = "xxx";

const password = Deno.env.get("AZURE_DEVOPS_READ_WORK_ITEMS_TOKEN");

if (!password) {
  throw new Error("missing env AZURE_DEVOPS_READ_WORK_ITEMS_TOKEN");
}

const Authorization = "Basic " + btoa(username + ":" + password);

const idsResponse = await fetch(
  `https://dev.azure.com/${organizationName}/${projectName}/_apis/wit/wiql?api-version=6.0`,
  {
    body: JSON.stringify({ query: ids_query }),
    headers: {
      "Content-type": "application/json",
      Authorization,
    },
    method: "POST",
  }
).then((r) => (r.ok ? r.json() : Promise.reject(r.statusText)));

const ids = idsResponse.workItems.map((wi: any) => wi.id);

if (ids.length === 0) {
  throw new Error("No assigned workitems");
}

const workItemsResponse = await fetch(
  `https://dev.azure.com/${organizationName}/_apis/wit/workitems?ids=${ids.join(
    ","
  )}&api-version=6.0`,
  {
    headers: {
      "Content-type": "application/json",
      Authorization,
    },
  }
).then((r) => r.json());

function formatWorkItemType(workItemType: string): string {
  switch (workItemType) {
    case "Bug":
      return Colors.red(workItemType);
    case "Task":
      return Colors.yellow(workItemType);
    case "Product Backlog Item":
      return Colors.blue("PBI");
    default:
      return workItemType;
  }
}

function getDescription(description: string | undefined) {
  if (description) {
    return (
      new DOMParser().parseFromString(description, "text/html")?.textContent ??
      ""
    );
  } else {
    return "";
  }
}

const workItems = workItemsResponse.value.map((v: any) => {
  const id = v.id;
  const title = v.fields["System.Title"];
  const state = v.fields["System.State"];
  const description = getDescription(v.fields["System.Description"]);
  const workItemType = v.fields["System.WorkItemType"];

  const fields = [
    `${id} ${title}`,
    formatWorkItemType(workItemType),
    state,
    description,
  ];

  return fields.join("\t");
});

const p = Deno.run({
  cmd: [
    "fzf",
    `--with-nth=1`,
    `--delimiter=\\t`,
    `--preview=printf "Type: %s\nState: %s\nDescription:\n%s\n" {2} {3} {4}`,
    "--preview-window=bottom:wrap",
  ],
  stdin: "piped",
  stdout: "piped",
});

await p.stdin?.write(new TextEncoder().encode(workItems.join("\n")));
p.stdin?.close();

const status = await p.status();

if (!status.success) {
  Deno.exit(1);
}

const output = new TextDecoder().decode(await p.output());

const [selectedWorkItem] = output.split("\t");

let s = selectedWorkItem
  .toLowerCase()
  .replace(/['"]/g, "")
  .replace(/[\W_]/g, " ")
  .trim()
  .replace(/\s+/g, "-");

s = `${prefix}/${s}`;

if (s.length > 100) {
  s = s.substr(0, 100);
  const lastDash = s.lastIndexOf("-");
  s = s.substring(0, lastDash);
}
console.log(s);

const git = Deno.run({
  cmd: ["git", "checkout", "-b", s],
  stdin: "inherit",
  stdout: "inherit",
  stderr: "inherit",
});

const { code } = await git.status();

Deno.exit(code);

cb

Creates a branch with name based on selected task/PBI/bug from Azure Boards.

The maximum branch name length is 100 characters and the name will be cut at the last white space.

Dependencies

Depends on: fzf, git, deno.

Usage

$ cb [prefix] # (will default to "feature")

$ cb 
# => feature/121212-selected-task-converted-to-branch-name

$ cb hotfix
# => hotfix/343434-selected-task-converted-to-branch-name

Compiling (optional)

If desired, compile with:

deno compile --allow-net=dev.azure.com --allow-run --allow-env=AZURE_DEVOPS_READ_WORK_ITEMS_TOKEN cb.ts