ya-git-jira 1.2.0 → 1.4.0

package/README.md

@@ -1,13 +1,32 @@
 # ya-git-jira - Yet Another Git Jira
 
-This package installs two applications (for now) that are written to be
+This package installs several scripts that are written to be
 usable as `git` extensions, i.e. sub-commands of the `git` command.
 The extensions faciliate workflow when using `git` for source control and `jira`
 for issue tracking. Other similar packages exist -- thus the "yet another"
 in the name.
 
-This package will likely evolve over time to include some other workflow cases.
-For now, the two commands are:
+This package will likely evolve over time to include more workflow cases.
+
+## gitj -- A test driver to use instead of `git <command>`
+
+It can be useful to run these commands as if they were being invoked through
+`git` but using a proxy for `git` than can only execute the commands in this
+package.
+
+For example, to see the available top level commands, run `gitj --help`:
+
+```
+$ gitj ---help
+Usage: gitj [options] [command]
+
+Options:
+  -h, --help  display help for command
+
+Commands:
+  bump
+  jira        A collection of jira utility commands
+```
 
 ## git-jira-start -- Create a new topic branch for work on an issue
 

package/bin/git-bump.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun run
+#!/usr/bin/env bun
 
 import { createBranch, getCurrentBranch } from "../lib/git"
 import { Command } from 'commander'
@@ -8,6 +8,7 @@ export function create(): Command {
     const program = new Command()
     program
         .name('bump')
+        .description('Bump the version number in the current branch')
         .action(async () => {
             const currentBranch = await getCurrentBranch()
 
@@ -26,8 +27,8 @@ export function create(): Command {
     return program
 }
 
+export default create
+
 if (isMain('git-bump')) {
-    create().parse(process.argv)
+    await create().parseAsync(Bun.argv)
 }
-
-export default create

package/bin/{git-jira-issues.ts → git-jira-issue-list.ts}

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun run
+#!/usr/bin/env bun
 
 import { Command } from 'commander'
 import { myUnresolvedIssues } from "../lib/jira"
@@ -7,8 +7,9 @@ import { isMain } from '../lib/is_main'
 export function create(): Command {
     const program = new Command()
     program
-        .name('issues')
-        .action(async (options) => {
+        .name('list')
+        .description('List your unresolved issues')
+        .action(async () => {
             const issues = await myUnresolvedIssues()
             console.log(`You have ${issues.length} unresolved issues`)
             issues.forEach(issue => {
@@ -18,8 +19,8 @@ export function create(): Command {
     return program
 }
 
-if (isMain('git-jira-issues')) {
-    create().parse(process.argv)
-}
-
 export default create
+
+if (isMain('git-jira-issue-list')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-jira-issue-show.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { getIssue } from "../lib/jira"
+import { isMain } from '../lib/is_main'
+import { getJiraConfig } from '../lib/jira'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('show')
+        .description('Show information about one issue')
+        .argument('issue', 'Issue ID')
+        .option('-v, --verbose', 'Verbose output')
+        .action(async (issueId: string, options) => {
+            const issue = await getIssue(issueId)
+            if (!issue) {
+                console.error(`Issue ${issueId} not found`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(issue)
+            } else {
+                const { host } = await getJiraConfig()
+                const summary = issue.fields.summary
+                const url = `https://${host}/browse/${issueId}`
+                console.log({ issueId, summary, url })
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-jira-issue-show')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-jira-issue.ts

@@ -1,35 +1,25 @@
-#!/usr/bin/env bun run
+#!/usr/bin/env bun
 
 import { Command } from 'commander'
-import { getIssue } from "../lib/jira"
 import { isMain } from '../lib/is_main'
 
-export function create() {
+import list from './git-jira-issue-list'
+import show from './git-jira-issue-show'
+
+export function create(): Command {
     const program = new Command()
     program
         .name('issue')
-        .argument('issue', 'Issue ID')
-        .option('-v, --verbose', 'Verbose output')
-        .option('-u, --url', 'Show the URL of the issue')
-        .action(async (issueId: string, options) => {
-            const issue = await getIssue(issueId)
-            if (!issue) {
-                console.error(`Issue ${issueId} not found`)
-                process.exit(1)
-            }
-            if (options.verbose) {
-                console.log(issue)
-                process.exit(0)
-            }
-            if (options.url) {
-                console.log(issue.self)
-            }
-        })
+        .description('Commands for working with issues')
+        .addCommand(list())
+        .addCommand(show())
+        .action(() => program.help()
+        )
     return program
 }
 
+export default create
+
 if (isMain('git-jira-issue')) {
-    create().parse(process.argv)
+    await create().parseAsync(Bun.argv)
 }
-
-export default create

package/bin/git-jira-start.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun run
+#!/usr/bin/env bun
 
 import { Command } from 'commander'
 import { createBranch } from "../lib/git"
@@ -15,6 +15,7 @@ export function create(): Command {
     const program = new Command()
     program
         .name('start')
+        .description('Start working on an issue by creating a branch')
         .argument('issue', 'Issue ID')
         .action(async (issueId: string) => {
             const issue = await getIssue(issueId)
@@ -31,8 +32,8 @@ export function create(): Command {
     return program
 }
 
-if (isMain('git-jira-issues')) {
-    create().parse(process.argv)
-}
-
 export default create
+
+if (isMain('git-jira-start')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-jira.ts

@@ -1,27 +1,24 @@
-#!/usr/bin/env bun run
+#!/usr/bin/env bun
 
 import { Command } from 'commander'
 import { isMain } from '../lib/is_main'
+import start from './git-jira-start'
+import issue from './git-jira-issue'
+import issues from './git-jira-issue-list'
 
-const start = (await import('./git-jira-start')).create()
-const issue = (await import('./git-jira-issue')).create()
-const issues = (await import('./git-jira-issues')).create()
-
-export function create() {
+export function create(): Command {
     const program = new Command()
     program
         .name('jira')
-        .addCommand(start)
-        .addCommand(issue)
-        .addCommand(issues)
-        .action(() => {
-            program.help()
-        })
+        .description('Commands for working with Jira')
+        .addCommand(start())
+        .addCommand(issue())
+        .addCommand(issues())
     return program
 }
 
+export default create
+
 if (isMain('git-jira')) {
-    create().parse(process.argv)
+    await create().parseAsync(Bun.argv)
 }
-
-export default create

package/bin/git-lab-group-list.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+import { getGroups } from '../lib/gitlab'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('list')
+        .description('List groups for the current user')
+        .option("-v, --verbose", "Verbose output")
+        .action(async (options) => {
+            const groups = await getGroups()
+            if (options.verbose)
+                console.log(groups)
+            else {
+                const filtered = groups.map(g => {
+                    const { id, name, full_path } = g
+                    return { id, name, full_path }
+                })
+                console.log(filtered)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-group-list')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-group.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+import list from './git-lab-group-list'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('group')
+        .description('Commands for working with GitLab groups')
+        .addCommand(list())
+        .action(() => program.help())
+        return program
+}
+
+export default create
+
+if (isMain('git-lab-group')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-merge-active.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { whoami, type User } from "../lib/gitlab"
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('active')
+        .description('List my active MRs')
+        .option('-v, --verbose', 'Verbose output')
+
+        .action(async (options) => {
+            const user: User = await whoami()
+            if (!user) {
+                console.error(`No user!`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(user)
+                process.exit(0)
+            }
+            else {
+                console.log(user.username)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-merge-active')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-merge-todo.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { getMergeRequestsAssignedToMe, type MergeRequest } from "../lib/gitlab"
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('todo')
+        .description('MRs needing my review')
+        .option('-v, --verbose', 'Verbose output')
+        .action(async (options) => {
+            const mrs: MergeRequest[] = await getMergeRequestsAssignedToMe()
+            if (options.verbose) {
+                console.log(mrs)
+            }
+            else {
+                const filtered = mrs.map(mr => {
+                    const { id, title, web_url, source_branch, target_branch, merge_status } = mr
+                    return { id, title, web_url, source_branch, target_branch, merge_status }
+                })
+                console.log(filtered)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-merge-todo')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-merge-train.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('train')
+        .description('Commands for working with GitLab merge trains')
+        .action(() => program.help())
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-merge-train')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-merge.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+import todo from './git-lab-merge-todo'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('merge')
+        .description('Commands for working with GitLab merge requests')
+        .addCommand(todo())
+        .action(() => program.help())
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-merge')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-namespace-list.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+import { getNamespaces } from '../lib/gitlab'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('list')
+        .description('List namespaces for the current user')
+        .action(async () => {
+            const namespaces = await getNamespaces()
+            console.log(namespaces)
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-namespace-list')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-namespace.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+import list from './git-lab-namespace-list'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('namespace')
+        .description('Commands for working with GitLab namespaces')
+        .addCommand(list())
+        .action(() => program.help())
+        return program
+}
+
+export default create
+
+if (isMain('git-lab-namespace')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-project-list.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { getProjects, type Project } from "../lib/gitlab"
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('list')
+        .description('List projects for current user')
+        .option('-v, --verbose', 'Verbose output')
+        .option('-m, --match <match>', 'Match projects with paths containing <match>')
+        .action(async (options) => {
+            const projects: Array<Project> = await getProjects(options.match)
+            if (!projects) {
+                console.error(`No projects!`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(projects)
+            }
+            else {
+                let filtered = projects.map((p: Project) => {
+                    const { id, name, path_with_namespace, ssh_url_to_repo } = p
+                    return { id, name, path_with_namespace, ssh_url_to_repo }
+                })
+                console.log(filtered)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-project-list')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-project-pipeline-list.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { getProjectPipelines, type Pipeline } from "../lib/gitlab"
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('list')
+        .description('List recent successful pipelines')
+        .option('-v, --verbose', 'Verbose output')
+        .option('-d, --days <days>', 'Number of days to look back', '7')
+        .option('-s, --status <status>', 'Status of pipelines to list: success | runnning | ', 'success')
+        .action(async (options) => {
+            const pipelines: Array<Pipeline> = await getProjectPipelines(options)
+            console.debug(`pipelines: ${pipelines}`)
+            if (!pipelines) {
+                console.error(`No pipelines!`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(pipelines)
+            }
+            else {
+                let filtered = pipelines.map((p: Pipeline) => {
+                    const { id, web_url, updated_at, ref, sha } = p
+                    return { id, web_url, updated_at, ref, sha }
+                })
+                console.log(filtered)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-project-pipeline-list')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-project-pipeline.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+import list from './git-lab-project-pipeline-list'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('pipeline')
+        .description('Commands for working with GitLab pipelines')
+        .addCommand(list())
+        .action(() => program.help())
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-project-pipeline')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-project-whereami.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { findProject } from "../lib/gitlab"
+import { getRemote } from '../lib/git'
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('whereami')
+        .description('Show current project based on current directory')
+        .option('-v, --verbose', 'Verbose output')
+        .action(async (options) => {
+            const ssh_url = await getRemote();
+            if (!ssh_url) {
+                console.error(`No remote!`)
+                process.exit(1)
+            }
+            console.log(`Remote: ${ssh_url}`)
+            const project = await findProject(ssh_url);
+            if (!project) {
+                console.error(`No project!`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(project)
+            } else {
+                const { id, name, path_with_namespace, ssh_url_to_repo } = project
+                console.log({id, name, path_with_namespace, ssh_url_to_repo })
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-project-whereami')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-project.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { isMain } from '../lib/is_main'
+
+import list from './git-lab-project-list'
+import whereami from './git-lab-project-whereami'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('projects')
+        .description('Commands for working with GitLab projects')
+        .addCommand(list())
+        .addCommand(whereami())
+        .action(() => {
+            program.help()
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-project')) {
+    await create().parseAsync(Bun.argv)
+}

package/bin/git-lab-whoami.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from 'commander'
+import { whoami, type User } from "../lib/gitlab"
+import { isMain } from '../lib/is_main'
+
+export function create(): Command {
+    const program = new Command()
+    program
+        .name('whoami')
+        .description('get GitLab user information for current user')
+        .option('-v, --verbose', 'Verbose output')
+        .action(async (options) => {
+            const user: User = await whoami()
+            if (!user) {
+                console.error(`No user!`)
+                process.exit(1)
+            }
+            if (options.verbose) {
+                console.log(user)
+                process.exit(0)
+            }
+            else {
+                console.log(user.username)
+            }
+        })
+    return program
+}
+
+export default create
+
+if (isMain('git-lab-whoami')) {
+    await create().parseAsync(Bun.argv)
+}