When using the as_pdf() method of a bundle, add parameter to ensure an odd or even number of pages

[nonprofittechy]

Adds a parameter ensure_parity to the ALDocumentBundle.as_pdf(), and default_parity as an attribute of the bundle.

parity means odd or even number of pages. When either parameter or attribute is set, the as_pdf() method of the bundle may pad the output with an additional page, if needed to match the desired parity.

The purpose is primarily to assist with double-sided printing.

• ALDocumentBundle.default_parity: can be "odd", "even", or None.
• ALDocumentBundle.as_pdf(ensure_parity) can be "odd", "even", or None. Overrides default_parity.

Test document: test_bundle_parity.yml.

Example usage:

---
objects:
  - even_bundle: ALDocumentBundle.using(
          title="Even bundle",
          filename="the_bundle",
          elements=[
            the_doc
          ],
          default_parity="even",
          enabled=True
      )

Fix #828

[samglover]

Spotted one typo in the documentation. Setting aside punctuation errors in the code, which I'm not yet confident I would spot, it seems like it should do what it is supposed to!