Merge Requests Monitor

A System Tray app for Mac OSX that monitors your open merge requests and let you access them quickly. So far it only supports Gitlab's pull requests.

Usage

First configure your Gitlab's feed url going to Preferences menu:

Choose the desired refresh frequency:

You're all set! Now you can click on any of the merge requests listed:

to open it in your default browser:

Installation

Download the latest DMG installer file from Releases section and install it.

IMPORTANT: Before running the app, please go to System Preferences --> Privacy & Security and allow "MergeRequestsMonitor" app to be executed. This is a necessary step since by default MacOS won't allow you to run any app you download from places other than the App Store.

Build & run

Alternatively, you can locally build the app bundle:

  pip install -r requirements.txt
  python setup.py py2app

And the just run the app:

  ./dist/main.app/Contents/MacOS/main

TIP: Move the above .app bundle to /Applications folder if you want to run it as any other install app.

Running as a Python app

If you don't want to build the MacOS app, you still can run this as a simple Python script. You need hatch installed. then just:

hatch run app

Notice it might take a few seconds for hatch to build and setup an environment :)

Testing

The project includes a comprehensive test suite with 26 tests covering all functionality.

Run all tests

hatch run test:test

Run tests with coverage report

hatch run test:cov

For detailed information about test coverage and testing patterns, see tests/README.md.

Roadmap

• Contexts: work, personal, etc
• Add support for Github Pull Requests
• Notifications
• Maybe: publish it @ the App Store

See Milestones for more details about the roadmap.

Authors.

• @matagus

License

GPL v3

Acknowledgements

• Two steps to turn a Python file to a macOS installer helped me quickly understand how to build a DMG using create-dmg.
• Understanding setup.py, setup.cfg and pyproject.toml in Python
• create-dmg: A shell script to build fancy DMGs (macOs app installer)
• rumps: Ridiculously uncomplicated macOS Python statusbar apps
• py2app: a Python setuptools command which will allow you to make standalone Mac OS X application bundles.
• README.md file was generated using readme.so
• Icon by Remix Design