👾 Introduction

This package provides an Emacs interface to Azure DevOps boards. You can:

• View recent tickets (non-closed, last 90 days)
• Create new tickets
• Update existing tickets

All from the comfort of an Emacs buffer.

🚨 Warning

This library is in extremely early stages. It modifies data within your Azure DevOps instance, so please use it at your own risk.

🛠 Setup

1. Place azure-devops.el in your load-path or use a package manager.
2. Add this to your Emacs config:

(use-package azure-devops
  :if (and (boundp 'my/adoel-path) my/adoel-path)
  :load-path my/adoel-path
  :init
  ;; Provide values for your DevOps variables.
  (setq azure-devops-username           ""
        azure-devops-organization-url   ""
        azure-devops-project-name       ""
        azure-devops-pat                "")
  :bind
  ("C-c d" . azure-devops-menu))

Make sure your Personal Access Token (PAT) has the appropriate scopes (e.g., Work Items: Read/Write).

💿 Usage

Once installed and configured:

1. Invoke the Hydra menu via:
   • #+BEGIN_EXAMPLE M-x azure-devops-menu ;; or if you set a keybinding: C-c d
2. Pick a command from the Hydra:

   t

   View Recent Tickets

   u

   Update Ticket

   c

   Create Ticket

   q

   Quit the menu

🕹 View Recent Tickets

• Displays an Org buffer with tickets from the last 90 days (non-Closed).
• Organized into “Current Sprint” vs. “Backlog” sections.

💾 Create Ticket

• Prompts you for:
  1. Work Item Type (Enhancement or Bug)
  2. Title
  3. Description in a temporary Org buffer (C-c C-c to confirm)
  4. Story Points
• Creates the new ticket in Azure DevOps and displays a success message with the ticket ID.

🖥 Update Ticket

• Prompts you for a substring of the ticket’s Title.
• Displays matching results for you to pick from.
• Opens the chosen ticket in an Org buffer. You can edit fields, then press C-c C-c to PATCH (update) the ticket.

📟 Contributing

Feel free to open issues or pull requests to improve the code.

💽 License

This project is MIT-licensed