[12.0][MIG] report_py3o and report_py3o_fusion_server

.travis.yml

@@ -8,6 +8,7 @@ addons:
       - expect-dev  # provides unbuffer utility
       - python-lxml # because pip installation is slow
       - pdftk
+      - libreoffice
 
 language: python
 

report_py3o/README.rst

@@ -0,0 +1,223 @@
+.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
+   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+   :alt: License: AGPL-3
+
+===========
+Report Py3o
+===========
+
+The py3o reporting engine is a reporting engine for Odoo based on `Libreoffice <http://www.libreoffice.org/>`_:
+
+* the report is created with Libreoffice (ODT or ODS),
+* the report is stored on the server in OpenDocument format (.odt or .ods file)
+* the report is sent to the user in OpenDocument format or in any output format supported by Libreoffice (PDF, HTML, DOC, DOCX, Docbook, XLS, etc.)
+
+The key advantages of a Libreoffice based reporting engine are:
+
+* no need to be a developer to create or modify a report: the report is created and modified with Libreoffice. So this reporting engine has a full WYSIWYG report development tool!
+* For a PDF report in A4/Letter format, it's easier to develop it with a tool such as Libreoffice that is designed to create A4/Letter documents than to develop it in HTML/CSS, also some print peculiarities (backgrounds, margin boxes) are not very well supported by the HTML/CSS based solutions.
+* If you want your users to be able to modify the document after its generation by Odoo, just configure the document with ODT output (or DOC or DOCX) and the user will be able to modify the document with Libreoffice (or Word) after its generation by Odoo.
+* Easy development of spreadsheet reports in ODS format (XLS output possible).
+
+This module *report_py3o* is the base module for the Py3o reporting engine. If used alone, it will spawn a libreoffice process for each ODT to PDF (or ODT to DOCX, ..) document conversion. This is slow and can become a problem if you have a lot of reports to convert from ODT to another format. In this case, you should consider the additionnal module *report_py3o_fusion_server* which is designed to work with a libreoffice daemon. With *report_py3o_fusion_server*, the technical environnement is more complex to setup because you have to install additionnal software components and run 2 daemons, but you have much better performances and you can configure the libreoffice PDF export options in Odoo (allows to generate PDF forms, PDF/A documents, password-protected PDFs, watermarked PDFs, etc.).
+
+This reporting engine is an alternative to `Aeroo <https://github.com/aeroo-community/aeroo_reports>`_: these two reporting engines have similar features but their implementation is entirely different. You cannot use aeroo templates as drop in replacement though, you'll have to change a few details.
+
+Installation
+============
+
+Install the required python libs:
+
+.. code::
+
+  pip install py3o.template
+  pip install py3o.formats
+
+To allow the conversion of ODT or ODS reports to other formats (PDF, DOC, DOCX, etc.), install libreoffice:
+
+.. code::
+
+  apt-get --no-install-recommends install libreoffice
+
+Configuration
+=============
+
+For example, to replace the native invoice report by a custom py3o report, add the following XML file in your custom module:
+
+.. code::
+
+  <?xml version="1.0" encoding="utf-8"?>
+  <odoo>
+
+  <record id="account.account_invoices" model="ir.actions.report.xml">
+      <field name="report_type">py3o</field>
+      <field name="py3o_filetype">odt</field>
+      <field name="module">my_custom_module_base</field>
+      <field name="py3o_template_fallback">report/account_invoice.odt</field>
+  </record>
+
+  </odoo>
+
+where *my_custom_module_base* is the name of the custom Odoo module. In this example, the invoice ODT file is located in *my_custom_module_base/report/account_invoice.odt*.
+
+It's also possible to reference a template located in a trusted path of your
+Odoo server. In this case you must let the *module* entry empty and specify
+the path to the template as *py3o_template_fallback*.
+
+.. code::
+
+  <?xml version="1.0" encoding="utf-8"?>
+  <odoo>
+
+  <record id="account.account_invoices" model="ir.actions.report.xml">
+      <field name="report_type">py3o</field>
+      <field name="py3o_filetype">odt</field>
+      <field name="py3o_template_fallback">/odoo/templates/py3o/report/account_invoice.odt</field>
+  </record>
+
+  </odoo>
+
+Moreover, you must also modify the Odoo server configuration file to declare
+the allowed root directory for your py3o templates. Only templates located
+into this directory can be loaded by py3o report.
+
+.. code::
+
+  [options]
+  ...
+
+  [report_py3o]
+  root_tmpl_path=/odoo/templates/py3o
+
+If you want an invoice in PDF format instead of ODT format, the XML file should look like:
+
+.. code::
+
+  <?xml version="1.0" encoding="utf-8"?>
+  <odoo>
+
+  <record id="account.account_invoices" model="ir.actions.report.xml">
+      <field name="report_type">py3o</field>
+      <field name="py3o_filetype">pdf</field>
+      <field name="module">my_custom_module_base</field>
+      <field name="py3o_template_fallback">report/account_invoice.odt</field>
+  </record>
+
+  </odoo>
+
+If you want to add a new py3o PDF report (and not replace a native report), the XML file should look like this:
+
+.. code::
+
+  <?xml version="1.0" encoding="utf-8"?>
+  <odoo>
+
+  <record id="partner_summary_report" model="ir.actions.report.xml">
+      <field name="name">Partner Summary</field>
+      <field name="model">res.partner</field>
+      <field name="report_name">res.partner.summary</field>
+      <field name="report_type">py3o</field>
+      <field name="py3o_filetype">pdf</field>
+      <field name="module">my_custom_module_base</field>
+      <field name="py3o_template_fallback">report/partner_summary.odt</field>
+  </record>
+
+  <!-- Add entry in "Print" drop-down list -->
+  <record id="button_partner_summary_report" model="ir.values">
+      <field name="key2">client_print_multi</field>
+      <field name="model">res.partner</field>
+      <field name="name">Partner Summary</field>
+      <field name="value" eval="'ir.actions.report.xml,%d'%partner_summary_report" />
+  </record>
+
+  </odoo>
+
+Configuration parameters
+------------------------
+
+py3o.conversion_command
+    The command to be used to run the conversion, ``libreoffice`` by default. If you change this, whatever you set here must accept the parameters ``--headless --convert-to $ext $file`` and put the resulting file into ``$file``'s directory with extension ``$ext``. The command will be started in ``$file``'s directory.
+
+Usage
+=====
+
+.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
+   :alt: Try me on Runbot
+   :target: https://runbot.odoo-community.org/runbot/143/10.0
+
+The templating language is `extensively documented <http://py3otemplate.readthedocs.io/en/latest/templating.html>`_, the records are exposed in libreoffice as ``objects``, on which you can also call functions.
+
+Available functions and objects
+-------------------------------
+
+user
+    Browse record of current user
+lang
+    The user's company's language as string (ISO code)
+b64decode
+    ``base64.b64decode``
+format_multiline_value(string)
+    Generate the ODF equivalent of ``<br/>`` and ``&nbsp;`` for multiline fields (ODF is XML internally, so those would be skipped otherwise)
+html_sanitize(string)
+    Sanitize HTML string
+time
+    Python's ``time`` module
+display_address(partner)
+    Return a formatted string of the partner's address
+formatLang(value, digits=None, date=False, date_time=False, grouping=True, monetary=False, dp=False, currency_obj=False)
+    Return a formatted numeric, monetary, date or time value according to the context language and timezone
+    (old implementation kept for compatibility and ease migration)
+o_format_lang(value, lang_code=False, digits=None, grouping=True, monetary=False, dp=False, currency_obj=False, no_break_space=True)
+    Return a formatted numeric or monetary value according to the context language and timezone
+o_format_date(value, lang_code=False, date_format=False)
+    Return a formatted date or time value according to the context language and timezone
+
+
+Sample report templates
+-----------------------
+
+Sample py3o report templates for the main Odoo native reports (invoice, sale order, purchase order, picking, ...) are available on the Github project `odoo-py3o-report-templates <https://github.com/akretion/odoo-py3o-report-templates>`_.
+
+Known issues / Roadmap
+======================
+
+* generate barcode ?
+* add more detailed example in demo file to showcase features
+* add migration guide aeroo -> py3o
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues
+<https://github.com/OCA/reporting-engine/issues>`_. In case of trouble, please
+check there if your issue has already been reported. If you spotted it first,
+help us smashing it by providing a detailed and welcomed feedback.
+
+Credits
+=======
+
+Contributors
+------------
+
+* Florent Aide (`XCG Consulting <http://odoo.consulting/>`_)
+* Laurent Mignon <laurent.mignon@acsone.eu>,
+* Alexis de Lattre <alexis.delattre@akretion.com>,
+* Guewen Baconnier <guewen.baconnier@camptocamp.com>
+* Omar Castiñeira <omar@comunitea.com>
+* Holger Brunn <hbrunn@therp.nl>
+
+
+Maintainer
+----------
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+This module is maintained by the OCA.
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+To contribute to this module, please visit https://odoo-community.org.

report_py3o/__init__.py

@@ -0,0 +1,2 @@
+from . import models
+from . import controllers

report_py3o/__manifest__.py

@@ -0,0 +1,29 @@
+# Copyright 2013 XCG Consulting (http://odoo.consulting)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+{
+    'name': 'Py3o Report Engine',
+    'summary': 'Reporting engine based on Libreoffice (ODT -> ODT, '
+               'ODT -> PDF, ODT -> DOC, ODT -> DOCX, ODS -> ODS, etc.)',
+    'version': '12.0.2.0.2',
+    'category': 'Reporting',
+    'license': 'AGPL-3',
+    'author': 'XCG Consulting,'
+              'ACSONE SA/NV,'
+              'Odoo Community Association (OCA)',
+    'website': 'http://odoo.consulting/',
+    'depends': ['web'],
+    'external_dependencies': {
+        'python': ['py3o.template',
+                   'py3o.formats',
+                   'PyPDF2']
+    },
+    'data': [
+        'security/ir.model.access.csv',
+        'views/menu.xml',
+        'views/py3o_template.xml',
+        'views/ir_actions_report.xml',
+        'views/report_py3o.xml',
+        'demo/report_py3o.xml',
+    ],
+    'installable': True,
+}

report_py3o/controllers/__init__.py

@@ -0,0 +1 @@
+from . import main

report_py3o/controllers/main.py

@@ -0,0 +1,97 @@
+# Copyright 2017 ACSONE SA/NV
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
+import json
+import mimetypes
+from werkzeug import exceptions, url_decode
+
+from odoo.http import route, request
+
+from odoo.addons.web.controllers import main
+from odoo.addons.web.controllers.main import (
+    _serialize_exception,
+    content_disposition
+)
+from odoo.tools import html_escape
+
+
+class ReportController(main.ReportController):
+
+    @route()
+    def report_routes(self, reportname, docids=None, converter=None, **data):
+        if converter != 'py3o':
+            return super(ReportController, self).report_routes(
+                reportname=reportname, docids=docids, converter=converter,
+                **data)
+        context = dict(request.env.context)
+
+        if docids:
+            docids = [int(i) for i in docids.split(',')]
+        if data.get('options'):
+            data.update(json.loads(data.pop('options')))
+        if data.get('context'):
+            # Ignore 'lang' here, because the context in data is the
+            # one from the webclient *but* if the user explicitely wants to
+            # change the lang, this mechanism overwrites it.
+            data['context'] = json.loads(data['context'])
+            if data['context'].get('lang'):
+                del data['context']['lang']
+            context.update(data['context'])
+
+        ir_action = request.env['ir.actions.report']
+        action_py3o_report = ir_action.get_from_report_name(
+            reportname, "py3o").with_context(context)
+        if not action_py3o_report:
+            raise exceptions.HTTPException(
+                description='Py3o action report not found for report_name '
+                            '%s' % reportname)
+        res, filetype = action_py3o_report.render(docids, data)
+        filename = action_py3o_report.gen_report_download_filename(
+            docids, data)
+        if not filename.endswith(filetype):
+            filename = "{}.{}".format(filename, filetype)
+        content_type = mimetypes.guess_type("x." + filetype)[0]
+        http_headers = [('Content-Type', content_type),
+                        ('Content-Length', len(res)),
+                        ('Content-Disposition', content_disposition(filename))
+                        ]
+        return request.make_response(res, headers=http_headers)
+
+    @route()
+    def report_download(self, data, token):
+        """This function is used by 'qwebactionmanager.js' in order to trigger
+        the download of a py3o/controller report.
+
+        :param data: a javascript array JSON.stringified containg report
+        internal url ([0]) and type [1]
+        :returns: Response with a filetoken cookie and an attachment header
+        """
+        requestcontent = json.loads(data)
+        url, report_type = requestcontent[0], requestcontent[1]
+        if 'py3o' not in report_type:
+            return super(ReportController, self).report_download(data, token)
+        try:
+            reportname = url.split('/report/py3o/')[1].split('?')[0]
+            docids = None
+            if '/' in reportname:
+                reportname, docids = reportname.split('/')
+
+            if docids:
+                # Generic report:
+                response = self.report_routes(
+                    reportname, docids=docids, converter='py3o')
+            else:
+                # Particular report:
+                # decoding the args represented in JSON
+                data = list(url_decode(url.split('?')[1]).items())
+                response = self.report_routes(
+                    reportname, converter='py3o', **dict(data))
+            response.set_cookie('fileToken', token)
+            return response
+        except Exception as e:
+            se = _serialize_exception(e)
+            error = {
+                'code': 200,
+                'message': "Odoo Server Error",
+                'data': se
+            }
+            return request.make_response(html_escape(json.dumps(error)))

report_py3o/demo/report_py3o.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright 2016 ACSONE SA/NV
+     License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). -->
+
+<odoo>
+
+    <record id="res_users_report_py3o" model="ir.actions.report">
+      <field name="name">Py3o Demo Report</field>
+      <field name="type">ir.actions.report</field>
+      <field name="model">res.users</field>
+      <field name="report_name">py3o_user_info</field>
+      <field name="report_type">py3o</field>
+      <field name="py3o_filetype">odt</field>
+      <field name="module">report_py3o</field>
+      <field name="py3o_template_fallback">demo/res_user.odt</field>
+      <field name="binding_model_id" ref="base.model_res_users" />
+      <field name="binding_type">report</field>
+    </record>
+
+ </odoo>