Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A Java based driver for py3o

Project Description

Juno for py3o

py3o.renderers.juno is a Java driver for py3o to transform an OpenOffice document into a PDF

It is intended to be used in conjunction with py3o.renderserver But can be used outside it if you wish.

Note for end-users

If you just search for an easy way to render LibreOffice files to PDF or DOCX, with ot without templating capabilities, you should directly look at py3o.fusion

py3o.fusion is a packaged webservice that lets you send a template, a target format and your data

and will return the resulting file.

Prerequisites

Since this is a Java implementation you will need to install jpype1 and to have a recent Java runtime on the rendering machine. You will also need a running OpenOffice instance. (If you are on windows this can be addressed by using the py3o.renderserver Open Office service.)

This has been tested to build correctly with:

  • Oracle JDK 1.6 and OpenOffice 3.2.1 on Windows 7 and Windows server 2003
  • Oracle JDK 1.6 and LibreOffice 3.4 on Windows 7 64bit
  • OpenJDK 6 and LibreOffice 3.4 on Linux (Ubuntu and RHEL 5)
  • OpenJDK 7 and LibreOffice 4.0.4 on Linux (Ubuntu 13.04)
  • OpenJDK 7 and LibreOffice 4.2.4.2 on Linux (Ubuntu 14.04)

For example if you are on Ubuntu you should run this command:

$ sudo apt-get install default-jdk

Usage

from py3o.renderers.juno import start_jvm, Convertor, formats
import datetime

# first arg is the jvm.so or .dll
# second arg is the basedir where we can find the basis3.3/program/classes/unoil.jar
# third argument it the ure basedir where we can find ure/share/java/*.jar containing
# java_uno.jar, juh.jar, jurt.jar, unoloader.jar
# the fourth argument was the openoffice version but is no more used
# fifth argument is the max memory you want to give to the JVM
start_jvm(
        "/usr/lib/jvm/java-7-openjdk-amd64/jre/lib/amd64/server/libjvm.so",
        "/usr/lib/libreoffice",
        "/usr/lib",
        "",
        140)
c = Convertor("127.0.0.1", "8997")

t1 = datetime.datetime.now()
c.convert("py3o_example.odt", "py3o_example.pdf", formats['PDF'])
t2 = datetime.datetime.now()

For more information please read the example provided in the examples dir and read the API documentation.

Installation

$ pip install –upgrade py3o.renderers.juno

Requirements

We just made a change of requirement from jpype to jpype1 in version 0.6 which should be pip installable by anyone with the correct toolchain. This means all requirements should now install automatically on a development machine.

Driver compilation and installation

NOTE: this is optionnal and reserved for developpers who want to compile the jar file by themselves

If you want to install from source you’ll need to clone our repository:

$ hg clone http://bitbucket.org/faide/py3o.renderers.juno
$ cd py3o.renderers.juno/java/py3oconvertor
$ ./compile.sh
$ cd ../../
$ python setup.py develop

Please note how you must first compile the jar file with our script (some more example scripts are available for windows and OpenOffice). If something fails, first try to edit the script and find if all referenced jar files are present on your system.

Contributors

By order of appearance:

  • Florent Aide
  • Thomas Desvenain
  • Eric Bréhault

Release Notes

2016-11-28 0.8

Update java classpath depending on plateform (Thomas Desvenain & Eric Bréhault)

Release History

Release History

This version
History Node

0.8

History Node

0.7

History Node

0.6.1

History Node

0.6

History Node

0.5

History Node

0.3.1

History Node

0.3

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
py3o.renderers.juno-0.8-py2.7.egg (12.8 kB) Copy SHA256 Checksum SHA256 2.7 Egg Nov 28, 2016
py3o.renderers.juno-0.8-py2-none-any.whl (12.4 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Nov 28, 2016
py3o.renderers.juno-0.8.tar.gz (41.0 kB) Copy SHA256 Checksum SHA256 Source Nov 28, 2016
py3o.renderers.juno-0.8.zip (52.8 kB) Copy SHA256 Checksum SHA256 Source Nov 28, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting