Skip to main content

Check your GitLab pipelines from the commandline

Install

The program is available on PyPi and can be installed via pip:

$ pip install pipe-stat

Config

This file is needed in order to use the program.

Example config:

{
  "projects": {
    "parallel": 23234375,
    "gitlab": 278964
  },
  "base_url": "https://gitlab.com",
  "access_token": "YOUR-TOKEN"
}

The application will look for a file named .pipe_stat in your home dir (~) and your current working dir (pwd) by default. This file must be an valid JSON file with the following entries:

  • projects: A mapping of <project_name:project_id> (some_project": 278964). You can name the project however you want. Just remember that the name will be used later when using the program (pipe-stat some_project). If you do not know your project id, you can get it from your projects GitLab page.
  • base_url: The base url of your gitlab instance. E.g. https://gitlab.com
  • access_token: A valid access token, that you can create on your gitlab site.

Usage

The following examples are based on the example configuration. So you might need to adjust the commands slightly.

  1. Get the last recent pipelines for the project parallel (remember that the program will use the name, that you gave it in the config file and not the real name):

    $ pipe-stat gitlab
     ╒═══════════════════╤══════════════════════════════╤══════════════╤══════════╤═══════════╤════════════════╕
     │ Project           │ Commit                       │ User         │ Status   │ User      │ Finished       │
     ╞═══════════════════╪══════════════════════════════╪══════════════╪══════════╪═══════════╪════════════════╡
     │ gitlab-org/gitlab │ Merge branch '293679_intr... │ minac        │ running  │ post-qa   │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '36046-extra... │ vshushlin    │ running  │ post-test │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '254325-remo... │ avielle      │ running  │ post-qa   │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch 'hchouraria-... │ hchouraria   │ failed   │ review    │ 12 minutes ago │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch 'increase_di... │ igor.drozdov │ running  │ post-qa   │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch 'only-render... │ euko         │ running  │ test      │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Refactor pages feature sp... │ vshushlin    │ running  │ test      │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Add allowed to push super... │ marc_shaw    │ running  │ post-qa   │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch 'a_akgun-mas... │ gitlab-bot   │ running  │ pages     │ -              │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '295625-incl... │ dbalexandre  │ failed   │ post-test │ 5 minutes ago  │
     ╘═══════════════════╧══════════════════════════════╧══════════════╧══════════╧═══════════╧════════════════╛
    
  2. Get the most recent failed pipelines for the project parallel:

    $ pipe-stat gitlab -s failed
     ╒═══════════════════╤══════════════════════════════╤═════════════════════╤══════════╤═══════════╤════════════════╕
     │ Project           │ Commit                       │ User                │ Status   │ User      │ Finished       │
     ╞═══════════════════╪══════════════════════════════╪═════════════════════╪══════════╪═══════════╪════════════════╡
     │ gitlab-org/gitlab │ Merge branch 'hchouraria-... │ hchouraria          │ failed   │ review    │ 13 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '295625-incl... │ dbalexandre         │ failed   │ post-test │ 6 minutes ago  │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch 'only-render... │ euko                │ failed   │ post-qa   │ 31 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '7749-rolldo... │ acroitor            │ failed   │ post-qa   │ 12 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '285509-glob... │ tnir                │ failed   │ post-qa   │ 27 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '295625-incl... │ tnir                │ failed   │ post-test │ 38 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Merge branch '229708-migr... │ pgascouvaillancourt │ failed   │ post-qa   │ 47 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Fix lint errors...           │ nmilojevic1         │ failed   │ post-qa   │ 37 minutes ago │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Fix gitlab pot...            │ nmilojevic1         │ failed   │ post-qa   │ 2 hours ago    │
     ├───────────────────┼──────────────────────────────┼─────────────────────┼──────────┼───────────┼────────────────┤
     │ gitlab-org/gitlab │ Use getters for derived p... │ euko                │ failed   │ post-qa   │ 3 hours ago    │
     ╘═══════════════════╧══════════════════════════════╧═════════════════════╧══════════╧═══════════╧════════════════╛
    
  3. Get the most recent succeeded pipeline:

    $ pipe-stat gitlab -s success -n 1
     ╒═══════════════════╤══════════════════════════════╤════════╤══════════╤═════════╤════════════════╕
     │ Project           │ Commit                       │ User   │ Status   │ User    │ Finished       │
     ╞═══════════════════╪══════════════════════════════╪════════╪══════════╪═════════╪════════════════╡
     │ gitlab-org/gitlab │ Merge branch '288812-clea... │ 10io   │ success  │ post-qa │ 52 minutes ago │
     ╘═══════════════════╧══════════════════════════════╧════════╧══════════╧═════════╧════════════════╛
    
  4. Get currently running pipelines:

     $ pipe-stat gitlab -s running
     ╒═══════════════════╤══════════════════════════════╤══════════════╤══════════╤═══════════╤════════════╕
     │ Project           │ Commit                       │ User         │ Status   │ User      │ Finished   │
     ╞═══════════════════╪══════════════════════════════╪══════════════╪══════════╪═══════════╪════════════╡
     │ gitlab-org/gitlab │ Merge branch '293679_intr... │ minac        │ running  │ post-qa   │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch '36046-extra... │ vshushlin    │ running  │ post-test │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch '254325-remo... │ avielle      │ running  │ post-qa   │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch 'increase_di... │ igor.drozdov │ running  │ post-qa   │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch 'only-render... │ euko         │ running  │ test      │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Refactor pages feature sp... │ vshushlin    │ running  │ test      │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Add allowed to push super... │ marc_shaw    │ running  │ post-qa   │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch 'a_akgun-mas... │ gitlab-bot   │ running  │ pages     │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Add invisible captcha app... │ alexbuijs    │ running  │ post-qa   │ -          │
     ├───────────────────┼──────────────────────────────┼──────────────┼──────────┼───────────┼────────────┤
     │ gitlab-org/gitlab │ Merge branch '295240-save... │ gitlab-bot   │ running  │ pages     │ -          │
     ╘═══════════════════╧══════════════════════════════╧══════════════╧══════════╧═══════════╧════════════╛
    
  5. Use a non-default configuration file:

     $ pipe-stat parallel -f ./pipe_stat 
     $ # or
     $ pipe-stat parallel -f ~/Downloads/some_file
    

Release files for pipe-stat 0.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pipe-stat 0.0.6
File Size Uploaded
pipe_stat-0.0.6.tar.gz 11.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pipe-stat 0.0.6
File Interpreter ABI Platform
pipe_stat-0.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 23.6 kB

Release files / pipe_stat-0.0.6.tar.gz

Download URL pipe_stat-0.0.6.tar.gz
Size 11.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5c2b523f48dba28537f399e48e952560aaff39358de765e26975a2ef0ef7e70f
BLAKE2b-256 checksum
How to use checksums
0445ed2be9f82979e10b29c943c802cd4b1ef98769e2eec6738ded06fad1d24e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/51.1.0.post20201221 requests-toolbelt/0.9.1 tqdm/4.55.0 CPython/3.8.5

Release files / pipe_stat-0.0.6-py3-none-any.whl

Download URL pipe_stat-0.0.6-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e900ae340087153cbf4e0b91da687544a4d5b0c486276b0f620b4912fa2286ee
BLAKE2b-256 checksum
How to use checksums
e19cf347a260fd1f2026e78511a6cf834cb0462efea2b116e8a9402e72f8565c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/51.1.0.post20201221 requests-toolbelt/0.9.1 tqdm/4.55.0 CPython/3.8.5

Release history Release notifications | RSS feed

This release

0.0.6 This release

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page