Metadata-Version: 2.1
Name: papersize
Version: 1.4.0
Summary: Paper size related tools
Home-page: http://framagit.org/spalax/papersize
Author: Louis Paternault
Author-email: spalax@gresille.org
License: GPLv3 or any later version
Project-URL: Documentation, http://papersize.readthedocs.io
Project-URL: Source, https://framagit.org/spalax/papersize
Project-URL: Tracker, https://framagit.org/spalax/papersize/issues
Keywords: paper size standard
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Printing
Requires-Python: <4,>=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS

papersize 📏 Paper size related tools
=====================================

This module provides tools to manipulate paper sizes, that is:

- a dictionary of several named standard names (e.g. A4, letter) , with their
  respective sizes (width and height);
- functions to convert sizes from one unit (e.g. inches) to another (e.g. centimeters);
- functions to manipulate paper orientation (portrait or landscape);
- tools to parse paper sizes, so that you do not have to worry about the format
  of paper sizes provided by your user, it being `"a4"` or `"21cm x 29.7cm"`.

What's new?
-----------

See `changelog <https://git.framasoft.org/spalax/papersize/blob/main/CHANGELOG.md>`_.

Install
-------

See the end of list for a (quick and dirty) Debian package.

* From sources:

  * Download: https://pypi.python.org/pypi/papersize
  * Install (in a `virtualenv`, if you do not want to mess with your distribution installation system)::

      python3 setup.py install

* From pip::

    pip install papersize

* Quick and dirty Debian (and Ubuntu?) package

  This requires `stdeb <https://github.com/astraw/stdeb>`_ to be installed::

      python3 setup.py --command-packages=stdeb.command bdist_deb
      sudo dpkg -i deb_dist/python-papersize-<VERSION>_all.deb

Test
----

* Current python version::

    python3 setup.py test

* All supported python versions (using `tox <http://tox.testrun.org>`_)::

    tox

Documentation
-------------

The documentation is available on `readthedocs <http://papersize.readthedocs.io>`_.  You can build it using::

  cd doc && make html
