Metadata-Version: 1.0
Name: gntp
Version: 0.8
Summary: Growl Notification Transport Protocol for Python
Home-page: http://github.com/kfdm/gntp/
Author: Paul Traylor
Author-email: UNKNOWN
License: UNKNOWN
Description: GNTP
        ====
        
        This is a Python library for working with the `Growl Notification
        Transport Protocol <http://www.growlforwindows.com/gfw/help/gntp.aspx>`_
        
        It should work as a dropin replacement for the older Python bindings
        
        Installation
        ------------
        
        You can install with pip
        
        ::
        
            $ pip install gntp
        
        then test the module
        
        ::
        
            $ python -m gntp.notifier
        
        Simple Usage
        ------------
        
        ::
        
            import gntp.notifier
        
            # Simple "fire and forget" notification
            gntp.notifier.mini("Here's a quick message")
        
            # More complete example
            growl = gntp.notifier.GrowlNotifier(
                applicationName = "My Application Name",
                notifications = ["New Updates","New Messages"],
                defaultNotifications = ["New Messages"],
                # hostname = "computer.example.com", # Defaults to localhost
                # password = "abc123" # Defaults to a blank password
            )
            growl.register()
        
            # Send one message
            growl.notify(
                noteType = "New Messages",
                title = "You have a new message",
                description = "A longer message description",
                icon = "http://example.com/icon.png",
                sticky = False,
                priority = 1,
            )
        
            # Try to send a different type of message
            # This one may fail since it is not in our list
            # of defaultNotifications
            growl.notify(
                noteType = "New Updates",
                title = "There is a new update to download",
                description = "A longer message description",
                icon = "http://example.com/icon.png",
                sticky = False,
                priority = -1,
            )
        
        
        URL based images do not work in the OSX version of
        `growl <http://code.google.com/p/growl/issues/detail?id=423>`_ 1.4
        You can send the image along with the notification to get around this.
        
        ::
        
            image = open('/path/to/image.png').read()
            growl.notify(
                noteType = "New Messages",
                title = "You have a new message",
                description = "This time we embed the image",
                icon = image,
            )
        
        
        Bugs
        ----
        
        `GitHub issue tracker <https://github.com/kfdm/gntp/issues>`_
        
        
        Changelog
        ---------
        
        `v0.8 <https://github.com/kfdm/gntp/compare/v0.7...v0.8>`_
            - Fix a bug where resource sections were missing a CRLF
            - Fix a bug where the cli client was using config values over options
            - Add support for coalescing
        
        `v0.7 <https://github.com/kfdm/gntp/compare/0.6...v0.7>`_
            - Support for images
            - Better test coverage support
        
        `0.6 <https://github.com/kfdm/gntp/compare/0.5...0.6>`_
            - ConfigParser aware GrowlNotifier that reads settings from ~/.gntp
        
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
