Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/matagus/merge-requests-monitor
📦 A System Tray app for Mac OSX that monitors your merge requests and let you access them quickly
https://github.com/matagus/merge-requests-monitor
gitlab macos merge-requests python rumps system-tray
Last synced: 2 months ago
JSON representation
📦 A System Tray app for Mac OSX that monitors your merge requests and let you access them quickly
- Host: GitHub
- URL: https://github.com/matagus/merge-requests-monitor
- Owner: matagus
- License: gpl-3.0
- Created: 2023-11-22T21:57:40.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-19T11:35:26.000Z (9 months ago)
- Last Synced: 2024-03-19T16:20:03.170Z (9 months ago)
- Topics: gitlab, macos, merge-requests, python, rumps, system-tray
- Language: Python
- Homepage:
- Size: 3.61 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# 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](https://github.com/matagus/merge-requests-monitor/releases) 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:
```bash
pip install -r requirements.txt
python setup.py py2app
```
And the just run the app:
```bash
./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](https://hatch.pypa.io/latest/install/) installed. then just:
```bash
hatch run app
```
Notice it might take a few seconds for hatch to build and setup an environment :)
## Roadmap
- Contexts: work, personal, etc
- Add support for Github Pull Requests
- Notifications
- Maybe: publish it @ the App Store
See [Milestones](https://github.com/matagus/merge-requests-monitor/milestones) for more details about the roadmap.
## Authors.
- [@matagus](https://www.github.com/matagus)
## License
[GPL v3](https://choosealicense.com/licenses/gpl-3.0/)
Acknowledgements
================
- [Two steps to turn a Python file to a macOS installer](https://gist.github.com/Kvnbbg/84871ae4d642c2dd896e0423471b1b52) helped me quickly understand how to build a DMG using `create-dmg`.
- [Understanding setup.py, setup.cfg and pyproject.toml in Python](https://ianhopkinson.org.uk/2022/02/understanding-setup-py-setup-cfg-and-pyproject-toml-in-python/)
- [create-dmg](https://github.com/create-dmg/create-dmg): A shell script to build fancy DMGs (macOs app installer)
- [rumps](https://github.com/jaredks/rumps): Ridiculously uncomplicated macOS Python statusbar apps
- [py2app](https://github.com/ronaldoussoren/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](https://readme.so/editor)
- Icon by [Remix Design](https://github.com/Remix-Design/RemixIcon)