Metadata-Version: 2.1
Name: papersize
Version: 1.5.0
Summary: Paper size related tools
Project-URL: Homepage, http://framagit.org/spalax/papersize
Project-URL: Issues, https://framagit.org/spalax/papersize/issues
Project-URL: Documentation, http://papersize.readthedocs.io
Author-email: Louis Paternault <spalax@gresille.org>
License-File: AUTHORS
License-File: LICENSE
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.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.8
Description-Content-Type: text/markdown

# 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
