Skip to content

Overview

doing is a CLI tool for Azure DevOps that helps mimic the common repository/issue workflow from Github and Gitlab.

In Azure DevOps an issue (work item) is not directly related to a repository (here's why). doing solves this by adding a .doing-cli-config.yml file to the root of a repository containing information on the associated area and iteration paths. This enables doing to list, create and quickly access repository-related issues.

Highlights

quickly starting work on a new issue

$ doing workon "fixing a small typo"
> Created work item #146545 'fixing a small typo' (User Story)
        > added area-path '{your area path}'
        > added iteration-path '{your iteration path}'
        > added assignee '{your azure account}'
> Created remote branch '146545_fixing_a_small_typo'
> Created pull request #49281 'fixing a small typo'
        > linked work item #146545
        > marked as draft pull request
        > set auto-complete to 'True'
        > set to delete remote source branch after PR completion
        > added reviewers: '{your azure account}'
        $ Running command: git fetch origin
        $ Running command: git checkout -b 146545_fixing_a_small_typo origin/146545_fixing_a_small_typo

listing issues linked to a repository

$ doing list
                 Work-items in current iteration project_name\team_name                  
┏━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━┓
┃     ID ┃                  Title ┃   Assignee ┃       Type ┃       Created ┃   PRs ┃
┡━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━┩
│  36893 │           explore data │ John       │ User Story │ 2 months ago  │       │
│  43769 │       feature pipeline │ Artur      │ User Story │ 5 days ago    │       │
│  99035 │             window bug │ Artur      │       Task │ 3 hours ago   │ 39949 │
│ 104436 │ data loading functions │ Jane       │       Task │ just now      │       │
└────────┴────────────────────────┴────────────┴────────────┴───────────────┴───────┘

Documentation

  • Getting started: A hands-on introduction to doing for developers. Recommended for all new users
  • How-to guides: Step-by-step guides. Covers key tasks and operations and common problems.
  • Commands: Technical reference covering the all commands.
  • Config: Technical reference covering configuration using a config file or environment variables.
  • Discussion: Explanation. Clarification and discussion of key topics.

--help

Note that all commands are also documented in the CLI app:

$ doing --help

Usage: doing [OPTIONS] COMMAND [ARGS]...

  CLI for repository/issue workflow on Azure Devops.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  init    Create a .doing-cli-config file.
  list    List issues related to the project.
  issue   Work with issues.
  pr      Work with pull requests.
  workon  Create issue with PR and switch git branch.
  open    Quickly open certain links.