ccpr 1.0.2

AWS CodeCommit PR CLI

AWS CodeCommit PR CLI

The ccpr script attempts to replicate the basic AWS CodeCommit Console from the CLI when dealing with pull requests. It does abit more such as enable recursive remote repo searches and CodePipeline build status/linking

This is achieved via context of current working git repo and branch, a bit of commandline completion and rich colours!

why?

Using CodeCommit console in one account at same time as accessing console in another account can be a pain (yes, maybe incognito could work..) CLI access should allow for quicker workflow for creating/reviewing/approving and merging PRs

Usage

usage: ccpr [-h] {approve,a,create,c,close,x,comment,C,diff,d,grep,g,merge,m,pipeline,p,pr,id,prs,ls,repos,r} ...

AWS CodeCommit PR CLI

positional arguments:
  {approve,a,create,c,close,x,comment,C,diff,d,grep,g,merge,m,pipeline,p,pr,id,prs,ls,repos,r}
    approve (a)         approve PR
    create (c)          create PR
    close (x)           close PR
    comment (C)         comment on PR, general if file and lineno not specified
    diff (d)            diff two local files
    grep (g)            grep the remote repo(s)
    merge (m)           merge PR
    pipeline (p)        show codepipeline status
    pr (id)             show details for specific PR (colorized diffs with comments etc)
    prs (ls)            list PRs for repo - OPEN by default
    repos (r)           list repos

optional arguments:
  -h, --help            show this help message and exit

Installation

$ pip install ccpr

ccpr uses argcomplete for commandline completion, see https://kislyuk.github.io/argcomplete/#installation

Zsh

Add the following to your ~/.zshrc file and start new terminal window once saved

autoload -U bashcompinit
bashcompinit
eval "$(register-python-argcomplete ccpr)"

Bash

Add following to ~/.bash_profile and start new terminal window once saved

eval "$(register-python-argcomplete ccpr)"

Authentication

See https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html

Eg:

export AWS_DEFAULT_PROFILE=devops-account
export AWS_DEFAULT_REGION=us-east-1

If using SAML with Azure, then something like https://github.com/Versent/saml2aws might help

Examples

List repos

$ ccpr repos -f tool
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ name                                 ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ developer-tools                      │
│ monitoring-tools                     │
│ some-other-tool                      │
└──────────────────────────────────────┘

Create PR

Change to CodeCommit repo directory and create PR on the 'foobar' branch. The latest commit message is used as default PR title

$ cd developer-tools/
$ git branch
  master
* foobar

$ ccpr create
Enter PR title (foobar baz biz fiz):
created PR 351
link: https://us-east-1.console.aws.amazon.com/codesuite/codecommit/repositories/developer-tools/pull-requests/351/changes?region=us-east-1

List PRs in current repo

$ ccpr prs
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ id  ┃ title              ┃ author        ┃ activity    ┃ status ┃ approvals              ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 351 │ foobar baz biz fiz │ [e-mail]   │ 3 hours ago │ CLOSED │ 1 of 2 rules satisfied │
└─────┴────────────────────┴───────────────┴─────────────┴────────┴────────────────────────┘

List details of PR

Show colorized diff

$ ccpr pr 351 -d
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ id  ┃ title              ┃ author        ┃ activity    ┃ status ┃ approvals              ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 351 │ foobar baz biz fiz │ [e-mail]   │ 3 hours ago │ CLOSED │ 1 of 2 rules satisfied │
└─────┴────────────────────┴───────────────┴─────────────┴────────┴────────────────────────┘
some-file1.txt
────────────────────────────────────────────────────────────────────────────────────────────
   1    1:   abc
   2     : - def
        2: + defghi
   3     : - hij
        3: + xyz
        4: +

Recursive grep across remote repos

$ ccpr grep -R -i baz '*.txt' --repo 'myrepo1,somerepo*'
myrepo1: /folder1/somefile1.txt:    fooBar
somerepo1: /folder1/somefile3.txt:    fooBar
somerepo1: /folder2/somefile4.txt:    FOOBAR

Show Code Pipeline status

Depends how pipeline setup, but a sensible generic convention could be in format <repo>_<branch>, if not use the --name option

Use -m for master branch, current repo will be used without --name

The -c argument will show commits which can be clicked on linking to AWS

$ ccpr pipeline -m -c
link: https://us-east-1.console.aws.amazon.com/codesuite/codepipeline/pipelines/
repo1_master/view?region=us-east-1
┏━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━┓
┃ stage   ┃ status     ┃ updated         ┃ commit    ┃ summary         ┃ error ┃
┡━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━┩
│ source  │ Succeeded  │ 2 hours ago     │ #34567890 │ fix something   │       │
│ build   │ Succeeded  │ 2 hours ago     │ #34567890 │                 │       │
│ approve │ Succeeded  │ 2 hours ago     │ #34567890 │ Approved by     │       │
│ test    │ Failed     │ 2 hours ago     │ #34567890 │                 │ ohno! │
│ deploy  │ InProgress │ 4 hours ago     │ #99999999 │ InProgress...   │       │
│ deploy  │ Succeeded  │ 4 hours ago     │ #99999999 │                 │       │
└─────────┴────────────┴─────────────────┴───────────┴─────────────────┴───────┘
commits:
┏━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━┓
┃ # ┃ commit    ┃ updated             ┃ build     ┃ summary  ┃
┡━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━┩
│ 1 │ #34567890 │ 2020-01-01 00:00:00 │ #34567890 │ foo      │
│ 2 │ #99999999 │ 2020-01-01 00:00:00 │ #99999999 │ bar      │
└───┴───────────┴─────────────────────┴───────────┴──────────┘

License

The license is Apache 2.0, see LICENSE for the details.