|Author:||Hartmut Goebel <email@example.com>|
|Copyright:||GNU Public License v3 (GPLv3)|
Ghostscript is a well known interpreter for the PostScript language and for PDF. This package implements a interface to the Ghostscript C-API using ctypes. Both a low-level and a pythonic, high-level interface are provided.
This package is currently tested only under GNU/Linux. Please report whether it works in your environment, too. Thanks.
Here is an example for how to use the high-level interface of python-ghostscript. This implements a very basic ps2pdf-tool:
import sys import locale import ghostscript args = [ "ps2pdf", # actual value doesn't matter "-dNOPAUSE", "-dBATCH", "-dSAFER", "-sDEVICE=pdfwrite", "-sOutputFile=" + sys.argv, "-c", ".setpdfwrite", "-f", sys.argv ] # arguments have to be bytes, encode them encoding = locale.getpreferredencoding() args = [a.encode(encoding) for a in args] ghostscript.Ghostscript(*args)
Here an example for passing a string document to Ghostscript:
doc = b"""%! /Helvetica findfont 20 scalefont setfont 50 50 moveto (Hello World) show showpage quit """ import ghostscript args = b"""test.py -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile=/tmp/out.pdf -c .setpdfwrite""".split() with ghostscript.Ghostscript(*args) as gs: gs.run_string(doc)
More examples can be found in the examples subdirectory of the distribution archive.
Requirements and Installation
|Please note:||This package is meant for developers. Even if there are some usable examples included, installations instructions are meant for developers.|
- Python 2.7 or higher (tested with Python 2.7 and 3.4)
- setuptools for installation (see below)
- Ghostscript Version 8.x or higher
Since this package is meant for developers, we assume you have experience in installing Python packages.
python-ghostscript is listed on PyPI (Python Package Index), so you can install it using pip install ghostscript as usual. Please refer to the manuals of pip for further information.
Alternatively you my download and unpack the source package of python-ghostscript from http://pypi.python.org/pypi/ghostscript and run:
python ./setup.py install