============= cloudprinting

A simple interface to Google Cloud Print.

Usage::

>>> from cloudprinting import *
>>> auth = OAuth2(access_token="qwertyuiopasdfghjkl", token_token="Bearer")
>>> r = list_jobs(auth=auth)
>>> r['jobs']
[{"id": ...}, ...]
>>> r = submit_job(printer="0e506d12-dbe0-54d3-7392-fd69d45ff2fc", content="test.pdf", auth=auth)
>>> r['job']
{"id": "abcdefgh", ...}
>>> delete_job("abcdefgh", auth=auth)

Supports both Python 2 and 3:

• ≥ Python 2.6
• ≥ Python 3.2

Install

Use pip to install the latest version from PyPI::

pip install cloudprinting

Command line interface

The module can be used from the command line via::

python -m cloudprinting ...

See --help for details.

Tests

The test suite requires three environment variables:

• CP_CLIENT_ID -- application "client id" (Google API)
• CP_CLIENT_SECRET -- application "client secret" (Google API)
• CP_REFRESH_TOKEN -- refresh token for an authorised Google Account
• CP_PRINTER_ID -- printer ID (optional, default: __google__docs)

During the tests a PDF is printed. By default the Google Docs printer is used, however it is more forgiving than typical printers, so I don't recommend using it.

Example::

CP_CLIENT_ID=1234567890.apps.googleusercontent.com \
CP_CLIENT_SECRET=asdfghjklzxcvbnmqwertyuiop \
CP_REFESH_TOKEN=mnbvcxzlkjhgfdspoiuytr \
CP_PRINTER_ID=0e50ed12-dbe0-54d3-a4bd-fdf9d45ff2fc \
tox

Change log

0.3.2

• Fix bug in auto-refreshing of OAuth2
• Remove expiration time recording from OAuth2

0.3.1

• Make OAuth2 arguments all optional
• Fix MANIFEST.in
• Fix README bugs

0.3.0

• Add OAuth2 authentication
• ClientLoginAuth only available on Python 2.x
• By default send capabilities (even if it's [{}]). This fixes some issues
• Print jobs now default to using the filename as the title (no more automatic inclusion of datetime)
• Added a crude command line interface

0.2.0

• Make ClientLoginAuth cache authentication token

0.1.0

• Initial version