Metadata-Version: 1.2
Name: github-release-notifier
Version: 0.1.3
Summary: Github Notifier
Home-page: http://github.com/femtopixel/github-release-notifier/
Author: Jay MOULIN
Author-email: jaymoulin+github-release-notifier@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Description: =======================
        Github Release Notifier
        =======================
        
        .. image:: https://img.shields.io/github/release/femtopixel/github-release-notifier.svg
            :alt: latest release
            :target: http://github.com/femtopixel/github-release-notifier/releases
        .. image:: https://img.shields.io/pypi/v/github-release-notifier.svg
            :alt: latest release
            :target: https://pypi.org/project/github-release-notifier/
        .. image:: https://img.shields.io/docker/pulls/femtopixel/github-release-notifier.svg
            :alt: Docker pull
            :target: https://hub.docker.com/r/femtopixel/github-release-notifier/
        .. image:: https://img.shields.io/docker/stars/femtopixel/github-release-notifier.svg
            :alt: Docker stars
            :target: https://hub.docker.com/r/femtopixel/github-release-notifier/
        .. image:: https://github.com/jaymoulin/jaymoulin.github.io/raw/master/btc.png
            :alt: Bitcoin donation
            :target: https://m.freewallet.org/id/374ad82e/btc
        .. image:: https://github.com/jaymoulin/jaymoulin.github.io/raw/master/ltc.png
            :alt: Litecoin donation
            :target: https://m.freewallet.org/id/374ad82e/ltc
        .. image:: https://github.com/jaymoulin/jaymoulin.github.io/raw/master/ppl.png
            :alt: PayPal donation
            :target: https://www.paypal.me/jaymoulin
        
        This program will allow you to be notified of Github new releases
        
        Installation
        ------------
        
        .. code::
        
            pip3 install github-release-notifier
        
        Usage
        -----
        
        .. code::
        
            usage: github-release-notifier [-h] [--action {cron,subscribe,unsubscribe}] [--package PACKAGE]
                          [--webhook WEBHOOK] [--uuid UUID]
        
            optional arguments:
              -h, --help            show this help message and exit
              --action {cron,subscribe,unsubscribe}, -a {cron,subscribe,unsubscribe}
                                    Action to do (default: cron)
              --package PACKAGE, -p PACKAGE
                                    Github package name / url (required for
                                    subscribe/unsubscribe) - prints uuid on subscription
              --webhook WEBHOOK, -w WEBHOOK
                                    URL to your webhook (required for
                                    subscribe/unsubscribe)
              --uuid UUID, -u UUID  UUID of your webhook (required for unsubscribe)
        
        Example
        ~~~~~~~
        
        First, I register my webhook :
        
        .. code::
        
            github-release-notifier --action subscribe --webhook https://acme.com/updated --package jaymoulin/google-music-manager
        
        an UUID is printed. this UUID will be required to unsubscribe the webhook.
        
        When `jaymoulin/google-music-manager` releases a new version, `https://acme.com/updated` will be called with HTTP verb `POST` and body, a JSON like this :
        
        .. code::
        
            {
                "date": [2017, 11, 13, 19, 46, 35, 0, 317, 0],
                "version": "0.7.2",
                "title": "Fixes split modules",
                "content": "",
                "media": "https://avatars0.githubusercontent.com/u/14236493?s=60&v=4",
                "author": "jaymoulin"
                "package_name": "jaymoulin/google-music-manager"
            }
        
        For this to happen, the system should check if a new version have been released.
        We can do that by calling `github-release-notifier` without any parameter or setting `--action` to `cron` (which is default).
        
        To automate this process, we could add this process in a cronjob:
        
        .. code::
        
            (crontab -l ; echo "0 0 * * * github-release-notifier") | sort - | uniq - | crontab -
        
        This will check every day at midnight if new versions have been released.
        
        Docker Usage
        ------------
        
        First run the daemon
        
        .. code::
        
            docker run --name GRN -d femtopixel/github-release-notifier
        
        you can mount a volume to `/root/.github_release_notifier/` to keep tracks of webhooks and versions
        
        example:
        
        .. code::
        
            docker run --name GRN -d -v /path/to/your/saves:/root/.github_release_notifier/ femtopixel/github-release-notifier
        
        Then register your webhook :
        
        .. code::
        
            docker exec GRN -a subscribe -p jaymoulin/google-music-manager -w https://acme.com/updated
        
        
        Submitting bugs and feature requests
        ------------------------------------
        
        Bugs and feature request are tracked on GitHub
        
        Author
        ------
        
        Jay MOULIN jaymoulin+github-release-notifier@gmail.com See also the list of contributors which participated in this program.
        
        License
        -------
        
        Github Release Notifier is licensed under the MIT License
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Pre-processors
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3
