Skip to main content

A frustration-free compression tool for PKPass archives.

Project description

airpress

PyPI version PyPI version Build Status

AirPress lets you create, sign and zip PKPass archives for Apple Wallet in runtime memory without a need for temporary files or directories.

Installation

From PyPI:

pip install airpress

Quickstart

from airpress import PKPass

# PKPass compressor operates on `bytes` objects as input/output
p = PKPass(
    ('icon.png', bytes(...)),
    ('logo.png', bytes(...)),
    ('pass.json', bytes(...)),
    ...
)
p.sign(cert=bytes(...), key=bytes(...), password=bytes(...))  # `password` argument is optional
_ = bytes(p)  # Creates `bytes` object containing signed and compressed `.pkpass` archive

In most cases you're likely to return pkpass as http response and bytes object is exactly what you need. PKPass will raise human-readable errors in case something is wrong with pass package you're trying to sign and compress.

Manage assets in pass package

Accessing PKPass assets that are already added to pass package is as easy as working with dictionary.

Retrieve asset:

icon = p['icon.png']

It can also be used as alternative to add/update asset:

p['icon.png'] = bytes(...)

Remove asset from pass package:

del p['logo.png']

Prepare Pass Type ID certificate

If you don't have your pass type certificate, follow this guide to create one.

Export your developer certificate as .p12 file and convert it into a pair of cert and key .pem files:

openssl pkcs12 -in "Certificates.p12" -clcerts -nokeys -out certificate.pem

openssl pkcs12 -in "Certificates.p12" -nocerts -out key.pem

You will be asked for an export password (or export phrase), you may leave it blank or provide a passphrase. It's this value that you later should supply to PKPass compressor (or leave blank).

Example with local files

In case you'd like to play around with locally stored files, or your server keeps assets in the same file storage as source code, this example shows you how to read locally stored assets as bytes objects, compress pkpass archive and save it to script's parent directory.

import os
from airpress import PKPass


# Create empty pass package
p = PKPass()

# Add locally stored assets
for filename in os.listdir('your_dir_with_assets'):
    with open(os.path.join(os.path.dirname(__file__), 'your_dir_with_assets', filename), 'rb') as file:
        data = file.read()
        # Add each individual asset to pass package
        p.add_to_pass_package((filename, data))

# Add locally stored credentials
with open(
        os.path.join(os.path.dirname(__file__), 'your_dir_with_credentials/key.pem'), 'rb'
) as key, open(
    os.path.join(os.path.dirname(__file__), 'your_dir_with_credentials/certificate.pem'), 'rb'
) as cert:
    # Add credentials to pass package 
    p.key = key.read()
    p.cert = cert.read()
    p.password = bytes('passpass', 'utf8')

# As we've added credentials to pass package earlier we don't need to supply them to `.sign()`
# This is an alternative to calling .sign() method with credentials as arguments. 
p.sign()

# Create pkpass file with pass data 
with open('your_dir_for_output/data.pkpass', 'wb') as file:
    file.write(bytes(p))

Hope you find this package useful! I'd love to hear your feedback and suggestions for this tiny library as there's always room for improvement.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airpress-1.0.3.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

airpress-1.0.3-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file airpress-1.0.3.tar.gz.

File metadata

  • Download URL: airpress-1.0.3.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for airpress-1.0.3.tar.gz
Algorithm Hash digest
SHA256 4fe33b7c080002404ac4c227e83cf32e2a7b563133ab1ef46f33c3cda1989340
MD5 e38c2be70167e18a58db685034429e0b
BLAKE2b-256 39b206afd2cce4aad06e2f4adc0af6aa891bf4b1bcfdccbdd8163dda70c1a23e

See more details on using hashes here.

File details

Details for the file airpress-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: airpress-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 9.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for airpress-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c0e79116bbad3f3e042c8ff3f453bd6c1c263cf432189d7dbe14e42b137e626d
MD5 a383bebdd45158e98c11a0cee24d02b6
BLAKE2b-256 f67aa84df71e72d2778bcec7b80bfb511904ee877277ca7b0c989e692cc534ea

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page