From 9a0cbc1bef05648ea68c217956f4ecda9ec3017d Mon Sep 17 00:00:00 2001 From: ernesto Date: Fri, 1 Feb 2019 10:55:06 -0500 Subject: [PATCH] [MIG] datetime_formatter: Migration to 12.0 --- datetime_formatter/README.rst | 73 ++- datetime_formatter/__manifest__.py | 6 +- datetime_formatter/models/res_lang.py | 2 +- datetime_formatter/readme/CONTRIBUTORS.rst | 5 + datetime_formatter/readme/DESCRIPTION.rst | 3 + datetime_formatter/readme/USAGE.rst | 21 + .../static/description/index.html | 456 ++++++++++++++++++ 7 files changed, 542 insertions(+), 24 deletions(-) create mode 100644 datetime_formatter/readme/CONTRIBUTORS.rst create mode 100644 datetime_formatter/readme/DESCRIPTION.rst create mode 100644 datetime_formatter/readme/USAGE.rst create mode 100644 datetime_formatter/static/description/index.html diff --git a/datetime_formatter/README.rst b/datetime_formatter/README.rst index 9c0ef02f1..358083258 100644 --- a/datetime_formatter/README.rst +++ b/datetime_formatter/README.rst @@ -1,15 +1,39 @@ -.. 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 - ===================== Date & Time Formatter ===================== +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github + :target: https://github.com/OCA/server-tools/tree/12.0/datetime_formatter + :alt: OCA/server-tools +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/server-tools-12-0/server-tools-12-0-datetime_formatter + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/149/12.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| |badge5| + This module was written to extend the functionality of Odoo language engine to support formatting `Date`, `Time` and `Datetime` fields easily and allow you to print them in the best format for the user. +**Table of contents** + +.. contents:: + :local: + Usage ===== @@ -35,38 +59,47 @@ If you are a developer, to use this module, you need to: * ``models.ResLang.datetime_formatter`` docstring explains its 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/149/11.0 - Bug Tracker =========== -Bugs are tracked on `GitHub 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. +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. Credits ======= +Authors +~~~~~~~ + +* Grupo ESOC Ingeniería de Servicios +* Tecnativa + Contributors ------------- +~~~~~~~~~~~~ + +* `Tecnativa `_: -* Jairo Llopis -* Vicent Cubells + * Jairo Llopis + * Vicent Cubells + * Ernesto Tejeda -Maintainer ----------- +Maintainers +~~~~~~~~~~~ + +This module is maintained by the OCA. .. 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 http://odoo-community.org. +This module is part of the `OCA/server-tools `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/datetime_formatter/__manifest__.py b/datetime_formatter/__manifest__.py index 59a27dece..c5cb99912 100644 --- a/datetime_formatter/__manifest__.py +++ b/datetime_formatter/__manifest__.py @@ -6,11 +6,11 @@ { "name": "Date & Time Formatter", "summary": "Helper functions to give correct format to date[time] fields", - "version": "11.0.1.0.0", + "version": "12.0.1.0.0", "category": "Tools", - "website": "https://www.tecnativa.com", + "website": "https://github.com/OCA/server-tools", "author": "Grupo ESOC Ingeniería de Servicios, " - "Tecnativa," + "Tecnativa, " "Odoo Community Association (OCA)", "license": "AGPL-3", "installable": True, diff --git a/datetime_formatter/models/res_lang.py b/datetime_formatter/models/res_lang.py index de94a79c5..66b9eece1 100644 --- a/datetime_formatter/models/res_lang.py +++ b/datetime_formatter/models/res_lang.py @@ -105,7 +105,7 @@ class ResLang(models.Model): # Convert str to datetime objects if isinstance(value, str): try: - value = fields.Datetime.from_string(value) + value = fields.Datetime.to_datetime(value) except ValueError: # Probably failed due to value being only time value = datetime.strptime(value, DEFAULT_SERVER_TIME_FORMAT) diff --git a/datetime_formatter/readme/CONTRIBUTORS.rst b/datetime_formatter/readme/CONTRIBUTORS.rst new file mode 100644 index 000000000..281c29e28 --- /dev/null +++ b/datetime_formatter/readme/CONTRIBUTORS.rst @@ -0,0 +1,5 @@ +* `Tecnativa `_: + + * Jairo Llopis + * Vicent Cubells + * Ernesto Tejeda diff --git a/datetime_formatter/readme/DESCRIPTION.rst b/datetime_formatter/readme/DESCRIPTION.rst new file mode 100644 index 000000000..785e26bc8 --- /dev/null +++ b/datetime_formatter/readme/DESCRIPTION.rst @@ -0,0 +1,3 @@ +This module was written to extend the functionality of Odoo language engine to +support formatting `Date`, `Time` and `Datetime` fields easily and allow you to +print them in the best format for the user. diff --git a/datetime_formatter/readme/USAGE.rst b/datetime_formatter/readme/USAGE.rst new file mode 100644 index 000000000..e461738d8 --- /dev/null +++ b/datetime_formatter/readme/USAGE.rst @@ -0,0 +1,21 @@ +This module adds a technical programming feature, and it should be used by +addon developers, not by end users. This means that you must not expect to see +any changes if you are a user and install this, but if you find you have it +already installed, it's probably because you have another modules that depend +on this one. + +If you are a developer, to use this module, you need to: + +* Call anywhere in your code:: + + formatted_string = self.env["res.lang"].datetime_formatter(datetime_value) + +* If you use Qweb:: + + + +* If you call it from a record that has a `lang` field:: + + formatted_string = record.lang.datetime_formatter(record.datetime_field) + +* ``models.ResLang.datetime_formatter`` docstring explains its usage. diff --git a/datetime_formatter/static/description/index.html b/datetime_formatter/static/description/index.html new file mode 100644 index 000000000..f2c137f53 --- /dev/null +++ b/datetime_formatter/static/description/index.html @@ -0,0 +1,456 @@ + + + + + + +Date & Time Formatter + + + +
+

Date & Time Formatter

+ + +

Beta License: AGPL-3 OCA/server-tools Translate me on Weblate Try me on Runbot

+

This module was written to extend the functionality of Odoo language engine to +support formatting Date, Time and Datetime fields easily and allow you to +print them in the best format for the user.

+

Table of contents

+ +
+

Usage

+

This module adds a technical programming feature, and it should be used by +addon developers, not by end users. This means that you must not expect to see +any changes if you are a user and install this, but if you find you have it +already installed, it’s probably because you have another modules that depend +on this one.

+

If you are a developer, to use this module, you need to:

+
    +

  • Call anywhere in your code:

    +
    +formatted_string = self.env["res.lang"].datetime_formatter(datetime_value)
+
    +
    • +

  • If you use Qweb:

    +
    +<t t-esc="env['res.lang'].datetime_formatter(datetime_value)"/>
+
    +
    • +

  • If you call it from a record that has a lang field:

    +
    +formatted_string = record.lang.datetime_formatter(record.datetime_field)
+
    +
    • +

  • models.ResLang.datetime_formatter docstring explains its usage.

    +
    • +
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Grupo ESOC Ingeniería de Servicios
    • +
  • Tecnativa
    • +
+
+
+

Contributors

+
    +
  • Tecnativa:
      +
    • Jairo Llopis
      • +
    • Vicent Cubells
      • +
    • Ernesto Tejeda
      • +
    +
    • +
+
+
+

Maintainers

+

This module is maintained by the OCA.

+Odoo Community Association +

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.

+

This module is part of the OCA/server-tools project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ +