.. _library:

Library
=======

The package includes a Python library for PDF imposition, ``pdfimpose``.

Most of the objects defined in the library are not *private*, in that their names do not
start with an underscore.
However, only those objects listed below should be considered stable.
Use the others at your own risk!

.. note::

   The description of each imposition schema would be a lot more understandable with a nice drawing or video.
   I cannot do any of those. If you can, and you have some time to spare, it would be very welcome!

.. toctree::
   :maxdepth: 1

   lib/schema
   lib/cards
   lib/copycutfold
   lib/cutstackfold
   lib/onepagezine
   lib/hardcover
   lib/saddle
   lib/wire

.. deprecated:: 2.5.0

   The ``perfect`` imposition schema was superseded by the ``hardcover`` imposition scheme in version 2.5.0.
   The ``perfect`` imposition schema will be removed in a future version.