Metadata-Version: 1.0
Name: apns-client
Version: 0.2
Summary: Python client for Apple Push Notification service (APNs)
Home-page: https://bitbucket.org/sardarnl/apns-client
Author: Sardar Yumatov
Author-email: ja.doma@gmail.com
License: Apache 2.0
Description: apns-client.
        ====================================
        Python client for `Apple Push Notification service (APNs) <https://developer.apple.com/library/mac/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushService.html>`_.
        Check `documentation <http://apns-client.readthedocs.org>`_ to learn how to use it.
        
        Check the client with similar interface for `Google Cloud Messaging <https://pypi.python.org/pypi/gcm-client/>`_.
        
        
        Requirements
        ------------
        
        - `six <https://pypi.python.org/pypi/six/>`_ - Python 2 and 3 compatibility library.
        - `pyOpenSSL <https://pypi.python.org/pypi/pyOpenSSL/>`_ - OpenSSL wrapper.
          Required by standard networking back-end.
        
        Standard library has support for `SSL transport
        <http://docs.python.org/2/library/ssl.html>`_. However, it is impossible to use
        it with certificates provided as a string. We store certificates in database,
        because we handle different apps on many Celery worker machines. A dirty
        solution would be to create temporary files, but it is insecure and slow. So,
        we have decided to use a better OpenSSL wrapper and ``pyOpenSSL`` was the
        easiest to handle. ``pyOpenSSL`` is loaded on demand by standard networking
        back-end. If you use your own back-end, based on some other SSL implementation,
        then you don't have to install ``pyOpenSSL``.
        
        
        Alternatives
        ------------
        
        There are `many alternatives
        <https://pypi.python.org/pypi?%3Aaction=search&term=apns&submit=search>`_
        available. We have started with `pyapns <https://pypi.python.org/pypi/pyapns>`_
        and `APNSWrapper <https://pypi.python.org/pypi/APNSWrapper>`_. This library
        differs in the following design decisions:
        
        - *Support certificates from strings*. We do not distribute certificate files
          on worker machines, they fetch it from the database when needed. This
          approach simplifies deployment, upgrades and maintenance.
        - *Keep connections persistent*. An SSL handshaking round is slow. Once
          connection is established, it should remain open for at least few minutes,
          waiting for the next batch.
        - *Support enhanced format*. Apple developers have designed a notoriously bad
          push protocol. They have upgraded it to enhanced version, which makes it
          possible to detect which messages in the batch have failed.
        - *Clean pythonic API*. No need for lots of classes, long lists of exceptions etc.
        - *Do not hard-code validation, let APNs fail*. This decision makes library
          a little bit more future proof.
        
        Changelog
        ---------
        *v0.2*
            Networking layer became pluggable, making ``gevent`` based implementations
            possible. Everything is refactored, such that IO, multi-threading and SSL
            are now loaded and used on demand, allowing you to cleanly override any
            part of the client. The API is largely backward compatible. IO related
            configuration is moved to transport layer and exception handling is a bit
            more verbose. The client is using standard logging to send fine grained
            debug messages.
        
        *v0.1*
            First simple implementation, hardwired with raw sockets and ``pyOpenSSL``.
            It does not work in ``gevent`` or any other *green* environment.
        
        
        Support
        -------
        APNs client was created by `Sardar Yumatov <mailto:ja.doma@gmail.com>`_,
        contact me if you find any bugs or need help. Contact `Getlogic
        <http://getlogic.nl>`_ if you need a full-featured push notification service
        for all popular platforms. You can view outstanding issues on the `APNs
        Bitbucket page <https://bitbucket.org/sardarnl/apns-client/>`_.
        
Keywords: apns push notification apple messaging iOS
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
