feat: poc octo run list

README.md

@@ -142,6 +142,16 @@ require"octo".setup({
     auto_show_threads = true,              -- automatically show comment threads on cursor move
     focus             = "right",           -- focus right buffer on diff open
   },
+  runs = {
+    icons = {
+      pending = "🕖",
+      in_progress = "🔄",
+      failed = "❌",
+      succeeded = "",
+      skipped = "⏩",
+      cancelled = "✖",
+    },
+  },
   pull_requests = {
     order_by = {                           -- criteria to sort the results of `Octo pr list`
       field = "CREATED_AT",                -- either COMMENTS, CREATED_AT or UPDATED_AT (https://docs.github.com/en/graphql/reference/enums#issueorderfield)
@@ -169,6 +179,11 @@ require"octo".setup({
   },
   mappings_disable_default = false,        -- disable default mappings if true, but will still adapt user mappings
   mappings = {
+    runs = {
+      expand_step = { lhs = "o", desc = "expand workflow step" },
+      open_in_browser = { lhs = "<C-b>", desc = "open workflow run in browser" },
+      refresh = { lhs = "<C-r>", desc = "refresh workflow" },
+    },
     issue = {
       close_issue = { lhs = "<localleader>ic", desc = "close issue" },
       reopen_issue = { lhs = "<localleader>io", desc = "reopen issue" },
@@ -382,6 +397,7 @@ If no command is passed, the argument to `Octo` is treated as a URL from where a
 |          | close                                             | Close the review window and return to the PR                                                                                                           |
 | actions  |                                                   | Lists all available Octo actions                                                                                                                       |
 | search   | <query>                                           | Search GitHub for issues and PRs matching the [query](https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests) |
+| run      | list                                              | List workflow runs                                                                                                                                     |
 | notification | list                                          | Shows current unread notifications |
 
 0. `[repo]`: If repo is not provided, it will be derived from `<cwd>/.git/config`.

lua/octo/commands.lua

@@ -63,6 +63,16 @@ function M.setup()
 
   -- supported commands
   M.commands = {
+    run = {
+      list = function()
+        local function co_wrapper()
+          require("octo.workflow_runs").list()
+        end
+
+        local co = coroutine.create(co_wrapper)
+        coroutine.resume(co)
+      end,
+    },
     actions = function()
       M.actions()
     end,

lua/octo/config.lua

@@ -1,7 +1,7 @@
 local vim = vim
 local M = {}
 
----@alias OctoMappingsWindow "issue" | "pull_request" | "review_thread" | "submit_win" | "review_diff" | "file_panel" | "repo" | "notification"
+---@alias OctoMappingsWindow "issue" | "pull_request" | "review_thread" | "submit_win" | "review_diff" | "file_panel" | "repo" | "notification" | "runs"
 ---@alias OctoMappingsList { [string]: table}
 ---@alias OctoPickers "telescope" | "fzf-lua"
 ---@alias OctoSplit "right" | "left"
@@ -43,6 +43,17 @@ local M = {}
 ---@class OctoConfigDiscussions
 ---@field order_by OctoConfigOrderBy
 
+---@class OctoConfigWorkflowIcons
+---@field pending string
+---@field skipped string
+---@field in_progress string
+---@field failed string
+---@field succeeded string
+---@field cancelled string
+
+---@class OctoConfigRuns
+---@field icons OctoConfigWorkflowIcons
+
 ---@class OctoConfigPR
 ---@field order_by OctoConfigOrderBy
 ---@field always_select_remote_on_create boolean
@@ -85,6 +96,7 @@ local M = {}
 ---@field ui OctoConfigUi
 ---@field issues OctoConfigIssues
 ---@field reviews OctoConfigReviews
+---@field runs OctoConfigRuns
 ---@field pull_requests OctoConfigPR
 ---@field file_panel OctoConfigFilePanel
 ---@field colors OctoConfigColors
@@ -154,6 +166,16 @@ function M.get_default_values()
       auto_show_threads = true,
       focus = "right",
     },
+    runs = {
+      icons = {
+        pending = "🕖",
+        in_progress = "🔄",
+        failed = "❌",
+        succeeded = "",
+        skipped = "⏩",
+        cancelled = "✖",
+      },
+    },
     pull_requests = {
       order_by = {
         field = "CREATED_AT",
@@ -181,6 +203,11 @@ function M.get_default_values()
     },
     mappings_disable_default = false,
     mappings = {
+      runs = {
+        expand_step = { lhs = "o", desc = "expand workflow step" },
+        open_in_browser = { lhs = "<C-b>", desc = "open workflow run in browser" },
+        refresh = { lhs = "<C-r>", desc = "refresh workflow" },
+      },
       issue = {
         close_issue = { lhs = "<localleader>ic", desc = "close issue" },
         reopen_issue = { lhs = "<localleader>io", desc = "reopen issue" },

lua/octo/constants.lua

@@ -17,6 +17,8 @@ M.OCTO_EMPTY_MSG_VT_NS = vim.api.nvim_create_namespace "octo_empty_msg_vt"
 M.OCTO_THREAD_HEADER_VT_NS = vim.api.nvim_create_namespace "octo_thread_header_vt"
 M.OCTO_EVENT_VT_NS = vim.api.nvim_create_namespace "octo_event_vt"
 
+M.OCTO_WORKFLOW_NS = vim.api.nvim_create_namespace "octo_workflow"
+
 M.NO_BODY_MSG = "No description provided."
 
 M.LONG_ISSUE_PATTERN = "([A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+)#(%d+)"

lua/octo/navigation.lua

@@ -62,6 +62,8 @@ function M.open_in_browser(kind, repo, number)
       cmd = string.format("gh gist view --web %s", number)
     elseif kind == "project" then
       cmd = string.format("gh project view --owner %s --web %s", repo, number)
+    elseif kind == "workflow_run" then
+      cmd = string.format("gh run view %s --web", number)
     end
   end
   pcall(vim.cmd, "silent !" .. cmd)

lua/octo/pickers/telescope/entry_maker.lua

@@ -198,6 +198,16 @@ function M.gen_from_git_changed_files()
   end
 end
 
+function M.gen_from_workflow_run()
+  return function(workflow_run)
+    return {
+      display = workflow_run.display,
+      value = workflow_run,
+      ordinal = workflow_run.display,
+    }
+  end
+end
+
 function M.gen_from_review_thread(linenr_length)
   local make_display = function(entry)
     if not entry then

lua/octo/pickers/telescope/previewers.lua

@@ -7,6 +7,7 @@ local previewers = require "telescope.previewers"
 local pv_utils = require "telescope.previewers.utils"
 local ts_utils = require "telescope.utils"
 local defaulter = ts_utils.make_default_callable
+local workflow_runs_previewer = require("octo.workflow_runs").previewer
 
 local vim = vim
 
@@ -224,7 +225,14 @@ local issue_template = defaulter(function(opts)
   }
 end, {})
 
+local workflow_runs = defaulter(function(opts)
+  return previewers.new_buffer_previewer {
+    define_preview = workflow_runs_previewer,
+  }
+end, {})
+
 return {
+  workflow_runs = workflow_runs,
   discussion = discussion,
   issue = issue,
   gist = gist,

lua/octo/pickers/telescope/provider.lua

@@ -638,6 +638,30 @@ function M.pending_threads(threads)
     :find()
 end
 
+function M.workflow_runs(workflow_runs, title, on_select_cb)
+  pickers
+    .new({}, {
+      prompt_title = title or false,
+      results_title = false,
+      preview_title = false,
+      finder = finders.new_table {
+        results = workflow_runs,
+        entry_maker = entry_maker.gen_from_workflow_run(),
+      },
+      sorter = conf.generic_sorter {},
+      previewer = previewers.workflow_runs.new {},
+      attach_mappings = function()
+        actions.select_default:replace(function(prompt_bufnr)
+          local selection = action_state.get_selected_entry(prompt_bufnr)
+          actions.close(prompt_bufnr)
+          on_select_cb(selection.value)
+        end)
+        return true
+      end,
+    })
+    :find()
+end
+
 ---
 -- PROJECTS
 ---