Metadata-Version: 1.1
Name: Passbook
Version: 1.0.2
Summary: Passbook file generator
Home-page: http://github.com/devartis/passbook/
Author: Fernando Aramendi
Author-email: fernando@devartis.com
License: Copyright (c) 2012 devartis

Permission is hereby granted, free of charge, to any
person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the
Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the
Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice
shall be included in all copies or substantial portions of
the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Download-URL: http://pypi.python.org/packages/source/P/Passbook/Passbook-1.0.2.tar.gz
Description: # Passbook
        
        [![Build Status](https://travis-ci.org/devartis/passbook.svg?branch=master)](https://travis-ci.org/devartis/passbook)
        
        Python library to create Apple Wallet (.pkpass) files (Apple Wallet 
        has previously been known as Passbook in iOS 6 to iOS 8).
        
        See the [Wallet Topic Page](https://developer.apple.com/wallet/) and the
        [Wallet Developer Guide](https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/PassKit_PG/index.html#//apple_ref/doc/uid/TP40012195) for more information about Apple Wallet.
        
        > If you need the server side implementation (API / WebServices) in django you should check http://github.com/devartis/django-passbook.
        
        
        ## Getting Started
        
        1) Get a Pass Type Id
        
        * Visit the iOS Provisioning Portal -> Pass Type IDs -> New Pass Type ID
        * Select pass type id -> Configure (Follow steps and download generated pass.cer file)
        * Use Keychain tool to export a Certificates.p12 file (need Apple Root Certificate installed)
        
        2) Generate the necessary certificate and key .pem files
        
            openssl pkcs12 -in "Certificates.p12" -clcerts -nokeys -out certificate.pem 
            openssl pkcs12 -in "Certificates.p12" -nocerts -out key.pem
        
        3) Ensure you have M2Crypto installed
        
            sudo easy_install M2Crypto
        
        ## Typical Usage
        
            #!/usr/bin/env python
        
            from passbook.models import Pass, Barcode, StoreCard
        
            cardInfo = StoreCard()
            cardInfo.addPrimaryField('name', 'John Doe', 'Name')
        
            organizationName = 'Your organization' 
            passTypeIdentifier = 'pass.com.your.organization' 
            teamIdentifier = 'AGK5BZEN3E'
            
            passfile = Pass(cardInfo, \
                passTypeIdentifier=passTypeIdentifier, \
                organizationName=organizationName, \
                teamIdentifier=teamIdentifier)
            passfile.serialNumber = '1234567' 
            passfile.barcode = Barcode(message = 'Barcode message')    
        
            # Including the icon and logo is necessary for the passbook to be valid.
            passfile.addFile('icon.png', open('images/icon.png', 'r'))
            passfile.addFile('logo.png', open('images/logo.png', 'r'))
            
            # Create and output the Passbook file (.pkpass) 
            passfile.create('certificate.pem', 'key.pem', 'wwdr.pem', '123456', 'test.pkpass')
        
        ## Note: Getting WWDR Certificate
        
        Certificate is available @ http://developer.apple.com/certificationauthority/AppleWWDRCA.cer
        
        It can be exported from KeyChain into a .pem (e.g. wwdr.pem).
        
        ## Testing
        
        You can run the tests with `py.test` or optionally with coverage support 
        (install `pytest-cov` first): 
        
            py.test --cov
            
        You can also generate a HTML report of the coverage:
        
            py.test --cov-report html
        
        You can run the tests against multiple versions of Python by running `tox` 
        which you need to install first.
        
        ## Credits
        
        Developed by [devartis](http://www.devartis.com).
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
