diff --git a/muk_attachment_lobject/LICENSE b/muk_attachment_lobject/LICENSE new file mode 100644 index 0000000..0a04128 --- /dev/null +++ b/muk_attachment_lobject/LICENSE @@ -0,0 +1,165 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. diff --git a/muk_attachment_lobject/README.rst b/muk_attachment_lobject/README.rst new file mode 100644 index 0000000..890c940 --- /dev/null +++ b/muk_attachment_lobject/README.rst @@ -0,0 +1,128 @@ +============================ +MuK Large Objects Attachment +============================ + +Provides a new attachment location to save attachments as PostgreSQL large objects. +To enable the large object storage option change the `ir_attachment.location` +parameter to `lobject`. + +**Advantages over the in-database storage** + +* Better RAM efficiency (This is more important for large files than for small ones.) +* Possibility to easily dump the base without the large objects (This can be useful for reproducing bugs.) + +**Advantages over the file system storage** + +* Large objects are transactional (fully ACID) +* They work out of the box in multi-system setups (So there is no need for NFS or similar file sharing tools.) +* Enables you to easily create backups of the entire system + +Installation +============ + +To install this module, you need to: + +Download the module and add it to your Odoo addons folder. Afterward, log on to +your Odoo server and go to the Apps menu. Trigger the debug mode and update the +list by clicking on the "Update Apps List" link. Now install the module by +clicking on the install button. + +Another way to install this module is via the package management for Python +(`PyPI `_). + +To install our modules using the package manager make sure +`odoo-autodiscover `_ is installed +correctly. Note that for Odoo version 11.0 and later this is not necessary anymore. +Then open a console and install the module by entering the following command: + +``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +The module name consists of the Odoo version and the module name, where +underscores are replaced by a dash. + +**Module:** + +``odoo-addon-`` + +**Example:** + +``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo13-addon-muk-utils`` + +Once the installation has been successfully completed, the app is already in the +correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the +debug mode and update the list by clicking on the "Update Apps List" link. Now +install the module by clicking on the install button. + +The biggest advantage of this variant is that you can now also update the app +using the "pip" command. To do this, enter the following command in your console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo. The steps are the same as for the installation only the button has changed +from "Install" to "Upgrade". + +You can also view available Apps directly in our `repository `_ +and find a more detailed installation guide on our `website `_. + +For modules licensed under a proprietary license, you will receive the access data after you purchased +the module. If the purchase were made at the Odoo store please contact our `support `_ +with a confirmation of the purchase to receive the corresponding access data. + +Upgrade +============ + +To upgrade this module, you need to: + +Download the module and add it to your Odoo addons folder. Restart the server +and log on to your Odoo server. Select the Apps menu and upgrade the module by +clicking on the upgrade button. + +If you installed the module using the "pip" command, you can also update the +module in the same way. Just type the following command into the console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo, just like you would normally. + + +Configuration +============= + +The module has an init hook, which automatically stores all attachments in +large objects. To activate this hook the config parameter `auto_storage_migration` +has to be set to `true`. + +Usage +===== + +This module has no direct visible effect on the system. However, existing and +future attachments are stored as large objects. + +Credit +====== + +Contributors +------------ + +* Mathias Markl + +Images +------ + +Some pictures are based on or inspired by the icon set of Font Awesome: + +* `Font Awesome `_ + +Author & Maintainer +------------------- + +This module is maintained by the `MuK IT GmbH `_. + +MuK IT is an Austrian company specialized in customizing and extending Odoo. +We develop custom solutions for your individual needs to help you focus on +your strength and expertise to grow your business. + +If you want to get in touch please contact us via `mail `_ +or visit our `website `_. diff --git a/muk_attachment_lobject/__init__.py b/muk_attachment_lobject/__init__.py new file mode 100644 index 0000000..1151893 --- /dev/null +++ b/muk_attachment_lobject/__init__.py @@ -0,0 +1,43 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +from odoo import SUPERUSER_ID, api +from odoo.tools import config + +from . import models + + +def _install_force_storage(cr, registry): + if config.get("auto_storage_migration", False): + env = api.Environment(cr, SUPERUSER_ID, {}) + params = env["ir.config_parameter"].sudo() + params.set_param("ir_attachment.location", "lobject") + env["ir.attachment"].sudo().force_storage() + + +def _uninstall_force_storage(cr, registry): + env = api.Environment(cr, SUPERUSER_ID, {}) + params = env["ir.config_parameter"].sudo() + location = params.get_param("ir_attachment.location") + if location == "lobject": + params.set_param("ir_attachment.location", "file") + env["ir.attachment"].sudo().force_storage() diff --git a/muk_attachment_lobject/__manifest__.py b/muk_attachment_lobject/__manifest__.py new file mode 100644 index 0000000..e9d2c69 --- /dev/null +++ b/muk_attachment_lobject/__manifest__.py @@ -0,0 +1,41 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +{ + "name": "MuK Large Objects Attachment", + "summary": """Large Objects Attachment Location""", + "version": "13.0.1.0.0", + "category": "Extra Tools", + "license": "LGPL-3", + "website": "http://www.mukit.at", + "live_test_url": "https://mukit.at/r/SgN", + "author": "MuK IT", + "contributors": ["Mathias Markl "], + "depends": ["muk_fields_lobject"], + "data": ["views/ir_attachment.xml"], + "images": ["static/description/banner.png"], + "application": False, + "installable": True, + "auto_install": False, + "post_init_hook": "_install_force_storage", + "uninstall_hook": "_uninstall_force_storage", +} diff --git a/muk_attachment_lobject/doc/changelog.rst b/muk_attachment_lobject/doc/changelog.rst new file mode 100644 index 0000000..ea96db5 --- /dev/null +++ b/muk_attachment_lobject/doc/changelog.rst @@ -0,0 +1,14 @@ +`2.1.0` +------- + +- Added Auto Migration + +`2.0.0` +------- + +- Migrated to Python 3 + +`1.0.0` +------- + +- Init version diff --git a/muk_attachment_lobject/doc/index.rst b/muk_attachment_lobject/doc/index.rst new file mode 100644 index 0000000..890c940 --- /dev/null +++ b/muk_attachment_lobject/doc/index.rst @@ -0,0 +1,128 @@ +============================ +MuK Large Objects Attachment +============================ + +Provides a new attachment location to save attachments as PostgreSQL large objects. +To enable the large object storage option change the `ir_attachment.location` +parameter to `lobject`. + +**Advantages over the in-database storage** + +* Better RAM efficiency (This is more important for large files than for small ones.) +* Possibility to easily dump the base without the large objects (This can be useful for reproducing bugs.) + +**Advantages over the file system storage** + +* Large objects are transactional (fully ACID) +* They work out of the box in multi-system setups (So there is no need for NFS or similar file sharing tools.) +* Enables you to easily create backups of the entire system + +Installation +============ + +To install this module, you need to: + +Download the module and add it to your Odoo addons folder. Afterward, log on to +your Odoo server and go to the Apps menu. Trigger the debug mode and update the +list by clicking on the "Update Apps List" link. Now install the module by +clicking on the install button. + +Another way to install this module is via the package management for Python +(`PyPI `_). + +To install our modules using the package manager make sure +`odoo-autodiscover `_ is installed +correctly. Note that for Odoo version 11.0 and later this is not necessary anymore. +Then open a console and install the module by entering the following command: + +``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +The module name consists of the Odoo version and the module name, where +underscores are replaced by a dash. + +**Module:** + +``odoo-addon-`` + +**Example:** + +``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo13-addon-muk-utils`` + +Once the installation has been successfully completed, the app is already in the +correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the +debug mode and update the list by clicking on the "Update Apps List" link. Now +install the module by clicking on the install button. + +The biggest advantage of this variant is that you can now also update the app +using the "pip" command. To do this, enter the following command in your console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo. The steps are the same as for the installation only the button has changed +from "Install" to "Upgrade". + +You can also view available Apps directly in our `repository `_ +and find a more detailed installation guide on our `website `_. + +For modules licensed under a proprietary license, you will receive the access data after you purchased +the module. If the purchase were made at the Odoo store please contact our `support `_ +with a confirmation of the purchase to receive the corresponding access data. + +Upgrade +============ + +To upgrade this module, you need to: + +Download the module and add it to your Odoo addons folder. Restart the server +and log on to your Odoo server. Select the Apps menu and upgrade the module by +clicking on the upgrade button. + +If you installed the module using the "pip" command, you can also update the +module in the same way. Just type the following command into the console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo, just like you would normally. + + +Configuration +============= + +The module has an init hook, which automatically stores all attachments in +large objects. To activate this hook the config parameter `auto_storage_migration` +has to be set to `true`. + +Usage +===== + +This module has no direct visible effect on the system. However, existing and +future attachments are stored as large objects. + +Credit +====== + +Contributors +------------ + +* Mathias Markl + +Images +------ + +Some pictures are based on or inspired by the icon set of Font Awesome: + +* `Font Awesome `_ + +Author & Maintainer +------------------- + +This module is maintained by the `MuK IT GmbH `_. + +MuK IT is an Austrian company specialized in customizing and extending Odoo. +We develop custom solutions for your individual needs to help you focus on +your strength and expertise to grow your business. + +If you want to get in touch please contact us via `mail `_ +or visit our `website `_. diff --git a/muk_attachment_lobject/i18n/ar.po b/muk_attachment_lobject/i18n/ar.po new file mode 100644 index 0000000..e1e7fb4 --- /dev/null +++ b/muk_attachment_lobject/i18n/ar.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:24+0000\n" +"PO-Revision-Date: 2019-07-12 23:24+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "مرفق" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/de.po b/muk_attachment_lobject/i18n/de.po new file mode 100644 index 0000000..c7a7236 --- /dev/null +++ b/muk_attachment_lobject/i18n/de.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:24+0000\n" +"PO-Revision-Date: 2019-07-12 23:24+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Dateianhang" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "Daten" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "Speicher" diff --git a/muk_attachment_lobject/i18n/es.po b/muk_attachment_lobject/i18n/es.po new file mode 100644 index 0000000..0682762 --- /dev/null +++ b/muk_attachment_lobject/i18n/es.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:25+0000\n" +"PO-Revision-Date: 2019-07-12 23:25+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Adjunto" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/fr.po b/muk_attachment_lobject/i18n/fr.po new file mode 100644 index 0000000..6297796 --- /dev/null +++ b/muk_attachment_lobject/i18n/fr.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:25+0000\n" +"PO-Revision-Date: 2019-07-12 23:25+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Pièce jointe" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/hi.po b/muk_attachment_lobject/i18n/hi.po new file mode 100644 index 0000000..0dfa14c --- /dev/null +++ b/muk_attachment_lobject/i18n/hi.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:25+0000\n" +"PO-Revision-Date: 2019-07-12 23:25+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/muk_attachment_lobject.pot b/muk_attachment_lobject/i18n/muk_attachment_lobject.pot new file mode 100644 index 0000000..0b5464e --- /dev/null +++ b/muk_attachment_lobject/i18n/muk_attachment_lobject.pot @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:24+0000\n" +"PO-Revision-Date: 2019-07-12 23:24+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/nl.po b/muk_attachment_lobject/i18n/nl.po new file mode 100644 index 0000000..01a7861 --- /dev/null +++ b/muk_attachment_lobject/i18n/nl.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:25+0000\n" +"PO-Revision-Date: 2019-07-12 23:25+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Bijlage" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/pt.po b/muk_attachment_lobject/i18n/pt.po new file mode 100644 index 0000000..7afd8ba --- /dev/null +++ b/muk_attachment_lobject/i18n/pt.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:26+0000\n" +"PO-Revision-Date: 2019-07-12 23:26+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Anexo" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/i18n/ru.po b/muk_attachment_lobject/i18n/ru.po new file mode 100644 index 0000000..fb1e908 --- /dev/null +++ b/muk_attachment_lobject/i18n/ru.po @@ -0,0 +1,37 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * muk_attachment_lobject +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0-20190522\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-07-12 23:26+0000\n" +"PO-Revision-Date: 2019-07-12 23:26+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: muk_attachment_lobject +#: model:ir.model,name:muk_attachment_lobject.model_ir_attachment +msgid "Attachment" +msgstr "Приложение" + +#. module: muk_attachment_lobject +#: model:ir.model.fields,field_description:muk_attachment_lobject.field_ir_attachment__store_lobject +msgid "Data" +msgstr "" + +#. module: muk_attachment_lobject +#: code:addons/muk_attachment_lobject/models/ir_attachment.py:68 +#, python-format +msgid "Only administrators can execute this action." +msgstr "" + +#. module: muk_attachment_lobject +#: model_terms:ir.ui.view,arch_db:muk_attachment_lobject.view_attachment_form +msgid "Storage" +msgstr "" diff --git a/muk_attachment_lobject/models/__init__.py b/muk_attachment_lobject/models/__init__.py new file mode 100644 index 0000000..78fcd8a --- /dev/null +++ b/muk_attachment_lobject/models/__init__.py @@ -0,0 +1,23 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +from . import ir_attachment diff --git a/muk_attachment_lobject/models/ir_attachment.py b/muk_attachment_lobject/models/ir_attachment.py new file mode 100644 index 0000000..c954753 --- /dev/null +++ b/muk_attachment_lobject/models/ir_attachment.py @@ -0,0 +1,98 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +import base64 +import logging + +from odoo import api, models +from odoo.addons.muk_fields_lobject.fields.lobject import LargeObject + +_logger = logging.getLogger(__name__) + + +class LObjectIrAttachment(models.Model): + + _inherit = "ir.attachment" + + # ---------------------------------------------------------- + # Database + # ---------------------------------------------------------- + + store_lobject = LargeObject(string="Data") + + # ---------------------------------------------------------- + # Helper + # ---------------------------------------------------------- + + @api.model + def _get_storage_domain(self, storage): + if storage == "lobject": + return [("store_lobject", "=", False)] + return super(LObjectIrAttachment, self)._get_storage_domain(storage) + + # ---------------------------------------------------------- + # Function + # ---------------------------------------------------------- + + @api.model + def storage_locations(self): + locations = super(LObjectIrAttachment, self).storage_locations() + locations.append("lobject") + return locations + + # ---------------------------------------------------------- + # Read + # ---------------------------------------------------------- + + @api.depends("store_lobject") + def _compute_datas(self): + bin_size = self._context.get("bin_size") + for attach in self: + if attach.store_lobject: + if bin_size: + attach.datas = attach.with_context( + {"human_size": True} + ).store_lobject + else: + attach.datas = attach.with_context({"base64": True}).store_lobject + else: + super(LObjectIrAttachment, attach)._compute_datas() + + # ---------------------------------------------------------- + # Create, Write, Delete + # ---------------------------------------------------------- + + def _get_datas_related_values(self, data, mimetype): + if self._storage() == "lobject": + bin_data = base64.b64decode(data) if data else b"" + values = { + "file_size": len(bin_data), + "checksum": self._compute_checksum(bin_data), + "index_content": self._index(bin_data, mimetype), + "store_lobject": bin_data, + "store_fname": False, + "db_datas": False, + } + return values + return super(LObjectIrAttachment, attach)._get_datas_related_values( + data, mimetype + ) diff --git a/muk_attachment_lobject/static/description/banner.png b/muk_attachment_lobject/static/description/banner.png new file mode 100644 index 0000000..4c36d0c Binary files /dev/null and b/muk_attachment_lobject/static/description/banner.png differ diff --git a/muk_attachment_lobject/static/description/icon.png b/muk_attachment_lobject/static/description/icon.png new file mode 100644 index 0000000..8425938 Binary files /dev/null and b/muk_attachment_lobject/static/description/icon.png differ diff --git a/muk_attachment_lobject/static/description/icon.svg b/muk_attachment_lobject/static/description/icon.svg new file mode 100644 index 0000000..c92a352 --- /dev/null +++ b/muk_attachment_lobject/static/description/icon.svg @@ -0,0 +1 @@ + diff --git a/muk_attachment_lobject/static/description/index.html b/muk_attachment_lobject/static/description/index.html new file mode 100644 index 0000000..4634af9 --- /dev/null +++ b/muk_attachment_lobject/static/description/index.html @@ -0,0 +1,197 @@ +
+
+

MuK Large Objects Attachment

+

Large Objects Attachment Location

+

+ MuK IT GmbH - www.mukit.at +

+
+
+ +
+
+
+

Overview

+
+

+ Provides a new attachment location to save attachment as large + objects. To enable the large object storage option change the + ir_attachment.location + parameter to + lobject + . +

+
+ Advantages over the in-database storage +
+
    +
  • + Better RAM efficiency (This is more important for large files than + for small ones.) +
    • +
  • + Possibility to easily dump the base without the large objects (This + can be useful for reproducing bugs.) +
    • +
+
+ Advantages over the file system storage +
+
    +
  • Large objects are transactional (fully ACID)
    • +
  • + They work out of the box in multi-system setups (So there is no need + for NFS or similar file sharing tools.) +
    • +
  • Enables you to easily create backups of the entire system
    • +
+
+
+
+
+ +
+
+

Our Services

+ +
+
+ +
+
+
+ + + +
+
+
+ +
+

Help and Support

+
+ Feel free to contact us, if you need any help with your Odoo integration or + addiontal features. +
+
+ + Website + + + Contact Us + + + Issues + +
+ +
diff --git a/muk_attachment_lobject/static/description/logo.png b/muk_attachment_lobject/static/description/logo.png new file mode 100644 index 0000000..9427ce3 Binary files /dev/null and b/muk_attachment_lobject/static/description/logo.png differ diff --git a/muk_attachment_lobject/static/description/preview.png b/muk_attachment_lobject/static/description/preview.png new file mode 100644 index 0000000..1deb1cc Binary files /dev/null and b/muk_attachment_lobject/static/description/preview.png differ diff --git a/muk_attachment_lobject/static/description/service_customization.png b/muk_attachment_lobject/static/description/service_customization.png new file mode 100644 index 0000000..3eac664 Binary files /dev/null and b/muk_attachment_lobject/static/description/service_customization.png differ diff --git a/muk_attachment_lobject/static/description/service_development.png b/muk_attachment_lobject/static/description/service_development.png new file mode 100644 index 0000000..580d460 Binary files /dev/null and b/muk_attachment_lobject/static/description/service_development.png differ diff --git a/muk_attachment_lobject/static/description/service_implementation.png b/muk_attachment_lobject/static/description/service_implementation.png new file mode 100644 index 0000000..d64b66b Binary files /dev/null and b/muk_attachment_lobject/static/description/service_implementation.png differ diff --git a/muk_attachment_lobject/static/description/service_integration.png b/muk_attachment_lobject/static/description/service_integration.png new file mode 100644 index 0000000..76c5e80 Binary files /dev/null and b/muk_attachment_lobject/static/description/service_integration.png differ diff --git a/muk_attachment_lobject/static/description/service_support.png b/muk_attachment_lobject/static/description/service_support.png new file mode 100644 index 0000000..4c530fa Binary files /dev/null and b/muk_attachment_lobject/static/description/service_support.png differ diff --git a/muk_attachment_lobject/tests/__init__.py b/muk_attachment_lobject/tests/__init__.py new file mode 100644 index 0000000..9a737ca --- /dev/null +++ b/muk_attachment_lobject/tests/__init__.py @@ -0,0 +1,23 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +from . import test_attachment, test_download diff --git a/muk_attachment_lobject/tests/test_attachment.py b/muk_attachment_lobject/tests/test_attachment.py new file mode 100644 index 0000000..514aacd --- /dev/null +++ b/muk_attachment_lobject/tests/test_attachment.py @@ -0,0 +1,65 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +import base64 +import logging +import unittest + +from odoo.tests import common + +_logger = logging.getLogger(__name__) + + +class AttachmentTestCase(common.HttpCase): + def setUp(self): + super(AttachmentTestCase, self).setUp() + self.attachment = self.env["ir.attachment"].sudo() + self.params = self.env["ir.config_parameter"].sudo() + self.location = self.params.get_param("ir_attachment.location") + self.params.set_param("ir_attachment.location", "lobject") + + def tearDown(self): + self.params.set_param("ir_attachment.location", self.location) + super(AttachmentTestCase, self).tearDown() + + def test_attachment(self): + attach = self.attachment.create( + {"name": "Test", "datas": base64.b64encode(b"\xff data")} + ) + self.assertTrue(attach.datas) + self.assertTrue(attach.store_lobject) + self.assertTrue(attach.with_context({"bin_size": True}).datas) + self.assertTrue(attach.with_context({"bin_size": True}).store_lobject) + self.assertTrue(attach.with_context({"human_size": True}).store_lobject) + self.assertTrue(attach.with_context({"base64": True}).store_lobject) + self.assertTrue(attach.with_context({"stream": True}).store_lobject) + oid = attach.with_context({"oid": True}).store_lobject + self.assertTrue(oid) + attach.write({"datas": base64.b64encode(b"\xff data")}) + self.assertTrue(oid != attach.with_context({"oid": True}).store_lobject) + self.assertTrue(attach.export_data(["datas"])) + self.assertTrue(attach.export_data(["datas"], raw_data=True)) + attach.unlink() + + @unittest.skip("The test takes a long time and is therefore skipped by default.") + def test_migration(self): + self.attachment.force_storage() diff --git a/muk_attachment_lobject/tests/test_download.py b/muk_attachment_lobject/tests/test_download.py new file mode 100644 index 0000000..36c10f8 --- /dev/null +++ b/muk_attachment_lobject/tests/test_download.py @@ -0,0 +1,61 @@ +################################################################################### +# +# Copyright (c) 2017-2019 MuK IT GmbH. +# +# This file is part of MuK Large Objects Attachment +# (see https://mukit.at). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with this program. If not, see . +# +################################################################################### + +import base64 +import logging +import os + +from odoo.addons.muk_utils.tests import common + +_path = os.path.dirname(os.path.dirname(__file__)) +_logger = logging.getLogger(__name__) + + +class DownloadTestCase(common.HttpCase): + def setUp(self): + super(DownloadTestCase, self).setUp() + self.attachment = self.env["ir.attachment"].sudo() + self.params = self.env["ir.config_parameter"].sudo() + self.location = self.params.get_param("ir_attachment.location") + self.params.set_param("ir_attachment.location", "lobject") + + def tearDown(self): + self.params.set_param("ir_attachment.location", self.location) + super(DownloadTestCase, self).tearDown() + + def test_attachment_download(self): + self.authenticate("admin", "admin") + attach_01 = self.attachment.create( + {"name": "Test_01", "datas": base64.b64encode(b"\xff data")} + ) + attach_02 = self.attachment.create({"name": "Test_02"}) + self.assertTrue(attach_01.datas) + self.assertFalse(attach_02.datas) + data = { + "model": "ir.attachment", + "field": "store_lobject", + "filename_field": "datas_fname", + } + data.update({"id": attach_01.id}) + self.assertTrue(self.url_open("/binary/content", data=data, csrf=True)) + data.update({"id": attach_02.id}) + self.assertTrue(self.url_open("/binary/content", data=data, csrf=True)) diff --git a/muk_attachment_lobject/views/ir_attachment.xml b/muk_attachment_lobject/views/ir_attachment.xml new file mode 100644 index 0000000..a013481 --- /dev/null +++ b/muk_attachment_lobject/views/ir_attachment.xml @@ -0,0 +1,41 @@ + + + + + + + + + ir_attachment.form + ir.attachment + + + + + + + + + + +