odoo-addon-pms 16.0.0.4.0.6__py3-none-any.whl → 16.0.0.15.0.10__py3-none-any.whl

odoo/addons/pms/i18n/pms.pot

@@ -10625,6 +10625,16 @@ msgstr ""
 msgid "Terms and conditions"
 msgstr ""
 
+#. module: pms
+#. odoo-python
+#: code:addons/pms/models/pms_reservation_line.py:0
+#, python-format
+msgid ""
+"The '%(incompatible_class)s' is not compatible with the reservation type "
+"class '%(reservation_class)s'. Please select a compatible class room for "
+"this reservation."
+msgstr ""
+
 #. module: pms
 #: model:ir.model.fields,help:pms.field_res_partner_id_number__name
 msgid "The ID itself. For example, Driver License number of this person"
@@ -11061,16 +11071,6 @@ msgstr ""
 msgid "The revenue manager in the folio"
 msgstr ""
 
-#. module: pms
-#. odoo-python
-#: code:addons/pms/models/pms_reservation.py:0
-#, python-format
-msgid ""
-"The room %(room)s (type: %(room_type)s) is not\n"
-"                                compatible with the room type %(record_room_type)s\n"
-"                                (type: %(record_room_class)s)"
-msgstr ""
-
 #. module: pms
 #. odoo-python
 #: code:addons/pms/wizards/wizard_split_join_swap_reservation.py:0

odoo/addons/pms/models/account_move.py

@@ -285,7 +285,7 @@ class AccountMove(models.Model):
                         lambda line,
                         pay_term_lines=pay_term_lines,
                         move=move: line.account_id == pay_term_lines.account_id
-                        and line.folio_ids in move.folio_ids
+                        and line.payment_id.folio_ids in move.folio_ids
                     )
                 )
                 to_reconcile = self.match_pays_by_amount(

odoo/addons/pms/models/pms_availability.py

@@ -89,23 +89,21 @@ class PmsAvailability(models.Model):
         "reservation_line_ids",
         "reservation_line_ids.occupies_availability",
         "room_type_id.total_rooms_count",
+        "reservation_line_ids.room_id",
+        "reservation_line_ids.date",
         "parent_avail_id",
         "parent_avail_id.reservation_line_ids",
         "parent_avail_id.reservation_line_ids.occupies_availability",
+        "parent_avail_id.reservation_line_ids.room_id",
+        "parent_avail_id.reservation_line_ids.date",
         "child_avail_ids",
         "child_avail_ids.reservation_line_ids",
         "child_avail_ids.reservation_line_ids.occupies_availability",
+        "child_avail_ids.reservation_line_ids.room_id",
+        "child_avail_ids.reservation_line_ids.date",
     )
     def _compute_real_avail(self):
         for record in self:
-            Rooms = self.env["pms.room"]
-            total_rooms = Rooms.search_count(
-                [
-                    ("active", "=", True),
-                    ("room_type_id", "=", record.room_type_id.id),
-                    ("pms_property_id", "=", record.pms_property_id.id),
-                ]
-            )
             room_ids = record.room_type_id.room_ids.filtered(
                 lambda r, record=record: r.pms_property_id == record.pms_property_id
                 and r.active
@@ -118,7 +116,7 @@ class PmsAvailability(models.Model):
                     pms_property_id=record.pms_property_id.id,
                 )
             )
-            record.real_avail = total_rooms - count_rooms_not_avail
+            record.real_avail = len(room_ids) - count_rooms_not_avail
 
     @api.depends("reservation_line_ids", "reservation_line_ids.room_id")
     def _compute_parent_avail_id(self):

odoo/addons/pms/models/pms_folio.py

@@ -609,6 +609,10 @@ class PmsFolio(models.Model):
             folio_lines_to_invoice = folio.sale_line_ids.filtered(
                 lambda r: r.id in list(lines_to_invoice.keys())
             )
+            # Avoid create invoices without invoicing lines
+            # (display_type is False)
+            if not folio_lines_to_invoice.filtered(lambda r: not r.display_type):
+                continue
             groups_invoice_lines = folio._get_groups_invoice_lines(
                 lines_to_invoice=folio_lines_to_invoice,
                 partner_invoice_id=partner_invoice_id,
@@ -2318,10 +2322,18 @@ class PmsFolio(models.Model):
             old_note = reservation.sale_line_ids.filtered(
                 lambda x: x.auto_reservation_note
             )
-            if old_note:
-                sale_reservation_vals.append((2, old_note.id))
             note_vals = self._get_reservation_note_vals(reservation, sequence)
-            if note_vals:
+            create_note = True
+            if old_note:
+                if (
+                    not note_vals
+                    or old_note.name != note_vals[2]["name"]
+                    or old_note.reservation_id.id != note_vals[2]["reservation_id"]
+                ):
+                    sale_reservation_vals.append((2, old_note.id))
+                else:
+                    create_note = False
+            if note_vals and create_note:
                 sale_reservation_vals.append(note_vals)
         expected_reservation_lines = self.env["pms.reservation.line"].read_group(
             [

odoo/addons/pms/models/pms_reservation.py

@@ -1088,12 +1088,7 @@ class PmsReservation(models.Model):
         # Reservations can be cancelled
         for record in self:
             record.allowed_cancel = (
-                True
-                if (
-                    record.state not in ["done"]
-                    and fields.Date.today() <= record.checkout
-                )
-                else False
+                True if (record.state not in ["done", "onboard"]) else False
             )
 
     def _compute_ready_for_checkin(self):
@@ -1295,9 +1290,7 @@ class PmsReservation(models.Model):
     @api.depends("service_ids.price_total", "services_discount")
     def _compute_price_services(self):
         for record in self:
-            record.price_services = (
-                sum(record.mapped("service_ids.price_total")) - record.services_discount
-            )
+            record.price_services = sum(record.mapped("service_ids.price_total"))
 
     @api.depends("price_services", "price_total")
     def _compute_price_room_services_set(self):
@@ -1384,7 +1377,9 @@ class PmsReservation(models.Model):
             if record.partner_id and record.partner_id != record.agency_id:
                 record.partner_name = record.partner_id.name
             if (record.folio_id and not record.partner_name) or (
-                record.folio_id.partner_name != record.partner_name
+                record.folio_id
+                and record.folio_id.partner_name
+                and record.folio_id.partner_name != record.partner_name
             ):
                 record.partner_name = record.folio_id.partner_name
             elif record.agency_id and not record.partner_name:
@@ -1842,10 +1837,9 @@ class PmsReservation(models.Model):
                             )
                         )
 
-    @api.constrains(
-        "reservation_line_ids", "reservation_line_ids.room_id", "room_type_id"
-    )
+    @api.constrains("reservation_line_ids", "room_type_id")
     def _check_room_class_compatibility(self):
+        incompatible_class = False
         for record in self:
             if (
                 record.room_type_id
@@ -1854,20 +1848,24 @@ class PmsReservation(models.Model):
             ):
                 for line in record.reservation_line_ids:
                     if (
-                        line.room_id.room_type_id.class_id
-                        != record.room_type_id.class_id
+                        line.room_id.room_type_id.class_id.overnight
+                        != record.room_type_id.class_id.overnight
                     ):
-                        raise ValidationError(
-                            _(
-                                """The room %(room)s (type: %(room_type)s) is not
-                                compatible with the room type %(record_room_type)s
-                                (type: %(record_room_class)s)""",
-                                room=line.room_id.name,
-                                room_type=line.room_id.room_type_id.class_id.name,
-                                record_room_type=record.room_type_id.name,
-                                record_room_class=record.room_type_id.class_id.name,
-                            )
-                        )
+                        incompatible_class = line.room_id.room_type_id.class_id.name
+        if incompatible_class:
+            raise ValidationError(
+                _(
+                    (
+                        "The '%(incompatible_class)s' is not compatible with the "
+                        "reservation type class '%(reservation_class)s'. Please select "
+                        "a compatible class room for this reservation."
+                    ),
+                    {
+                        "incompatible_class": incompatible_class,
+                        "reservation_class": record.room_type_id.class_id.name,
+                    },
+                )
+            )
 
     # Action methods
     def open_partner(self):
@@ -2504,17 +2502,29 @@ class PmsReservation(models.Model):
         self.ensure_one()
         if self.reservation_type != "normal":
             return False
-        tax_products = self._get_tourist_tax_products()
+        tax_products = self._get_tourist_tax_products(
+            pms_property_id=self.pms_property_id.id
+        )
         if not tax_products:
             return []
 
         nightly_dates = self._get_nightly_dates()
-        grouped_lines = self._build_grouped_tax_lines(tax_products, nightly_dates)
+        grouped_lines = self._build_grouped_tax_lines(
+            tax_products,
+            nightly_dates,
+        )
         existing_services = self._get_existing_tourist_tax_services()
         return self._build_service_commands(grouped_lines, existing_services)
 
-    def _get_tourist_tax_products(self):
-        return self.env["product.product"].search([("is_tourist_tax", "=", True)])
+    def _get_tourist_tax_products(self, pms_property_id):
+        return self.env["product.product"].search(
+            [
+                ("is_tourist_tax", "=", True),
+                "|",
+                ("pms_property_ids", "=", False),
+                ("pms_property_ids", "in", pms_property_id),
+            ]
+        )
 
     def _get_nightly_dates(self):
         return [
@@ -2618,7 +2628,7 @@ class PmsReservation(models.Model):
                             "folio_id": self.folio_id.id,
                             "product_id": product.id,
                             "name": product.name,
-                            "per_day": True,
+                            "per_day": False,
                             "service_line_ids": [(0, 0, line) for line in new_lines],
                         },
                     )

odoo/addons/pms/models/pms_reservation_line.py

@@ -660,3 +660,29 @@ class PmsReservationLine(models.Model):
             if record.pms_property_id.block_create_past_reservations:
                 if record.date < fields.Date.today():
                     raise ValidationError(_("You can't create past reservations"))
+
+    @api.constrains("room_id")
+    def _check_room_class_compatibility(self):
+        incompatible_class = False
+        for record in self:
+            if (
+                record.room_id
+                and record.reservation_id.room_type_id
+                and (
+                    record.room_id.room_type_id.class_id.overnight
+                    != record.reservation_id.room_type_id.class_id.overnight
+                )
+            ):
+                incompatible_class = True
+        if incompatible_class:
+            raise ValidationError(
+                _(
+                    "The '%(incompatible_class)s' is not compatible with the "
+                    "reservation type class '%(reservation_class)s'. Please select "
+                    "a compatible class room for this reservation."
+                )
+                % {
+                    "incompatible_class": incompatible_class,
+                    "reservation_class": record.room_id.room_type_id.class_id.name,
+                }
+            )

odoo/addons/pms/static/description/index.html

@@ -372,7 +372,7 @@ ul.auto-toc {
 !! This file is generated by oca-gen-addon-readme !!
 !! changes will be overwritten.                   !!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-!! source digest: sha256:a724bc0473f65c77aa82b77897ea0610ac258b5a83d314f6909b690dfcc45281
+!! source digest: sha256:1932d20cb515244c940884a7573b46a3b589228ee1ebb94ad7f300612769a869
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/license-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/pms/tree/16.0/pms"><img alt="OCA/pms" src="https://img.shields.io/badge/github-OCA%2Fpms-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/pms-16-0/pms-16-0-pms"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/pms&amp;target_branch=16.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
 <p>This module is an all-in-one property management system (PMS) focused on medium-sized properties

odoo/addons/pms/tests/__init__.py

@@ -38,6 +38,7 @@ from . import test_pms_wizard_split_join_swap_reservation
 from . import test_product_template
 from . import test_pms_multiproperty
 from . import test_shared_room
+from . import test_pms_reservation_line
 
 # from . import test_automated_mails
 from . import test_pms_service

odoo/addons/pms/tests/test_pms_reservation.py

@@ -45,6 +45,50 @@ class TestPmsReservations(TestPms, AccountTestInvoicingCommon):
             }
         )
 
+        # Additional room type class for incompatible test
+        cls.room_type_class_day = cls.env["pms.room.type.class"].create(
+            {
+                "name": "Day Use",
+                "overnight": False,
+                "default_code": "DAY",
+            }
+        )
+        cls.room_type_class_overnight = cls.env["pms.room.type.class"].create(
+            {
+                "name": "Overnight",
+                "overnight": True,
+                "default_code": "OVN",
+            }
+        )
+
+        cls.room_type_day = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Day Room",
+                "default_code": "DAY_Test",
+                "class_id": cls.room_type_class_day.id,
+            }
+        )
+
+        cls.room_type_overnight = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Overnight Room",
+                "default_code": "OVN_Test",
+                "class_id": cls.room_type_class_overnight.id,
+            }
+        )
+
+        cls.room_day = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Day 201",
+                "room_type_id": cls.room_type_day.id,
+                "capacity": 1,
+                "extra_beds_allowed": 0,
+            }
+        )
+
         # create rooms
         cls.room1 = cls.env["pms.room"].create(
             {
@@ -3399,3 +3443,63 @@ class TestPmsReservations(TestPms, AccountTestInvoicingCommon):
             "Sale_channel_origin_id of folio must be the same as "
             "sale_channel_origin of rservation",
         )
+
+    @freeze_time("2000-12-01")
+    def test_modify_reservation_with_compatible_overnight_classes(self):
+        """
+        Check that when modifying a reservation with compatible overnight
+        classes, the reservation is modified correctly.
+        """
+        # ARRANGE
+        checkin = fields.date.today()
+        checkout = fields.date.today() + datetime.timedelta(days=3)
+        reservation_vals = {
+            "checkin": checkin,
+            "checkout": checkout,
+            "room_type_id": self.room_type_double.id,
+            "partner_id": self.partner1.id,
+            "pms_property_id": self.pms_property1.id,
+            "sale_channel_origin_id": self.sale_channel_direct.id,
+        }
+        reservation = self.env["pms.reservation"].create(reservation_vals)
+
+        # ACT
+        reservation.write(
+            {
+                "room_type_id": self.room_type_overnight.id,
+            }
+        )
+
+        # ASSERT
+        self.assertEqual(
+            reservation.room_type_id.id,
+            self.room_type_overnight.id,
+            "The reservation should be modified with the new room type",
+        )
+
+    @freeze_time("2000-12-01")
+    def test_modify_reservation_with_incompatible_overnight_classes(self):
+        """
+        Check that when modifying a reservation with incompatible overnight
+        classes, the reservation raises an error.
+        """
+        # ARRANGE
+        checkin = fields.date.today()
+        checkout = fields.date.today() + datetime.timedelta(days=3)
+        reservation_vals = {
+            "checkin": checkin,
+            "checkout": checkout,
+            "room_type_id": self.room_type_double.id,
+            "partner_id": self.partner1.id,
+            "pms_property_id": self.pms_property1.id,
+            "sale_channel_origin_id": self.sale_channel_direct.id,
+        }
+        reservation = self.env["pms.reservation"].create(reservation_vals)
+
+        # ACT & ASSERT
+        with self.assertRaises(ValidationError):
+            reservation.write(
+                {
+                    "room_type_id": self.room_type_day.id,
+                }
+            )

odoo/addons/pms/tests/test_pms_reservation_line.py

@@ -0,0 +1,225 @@
+import datetime
+
+from freezegun import freeze_time
+
+from odoo import fields
+from odoo.exceptions import ValidationError
+from odoo.tests import tagged
+
+from .common import TestPms
+
+
+@tagged("post_install", "-at_install")
+class TestPmsReservationLines(TestPms):
+    @classmethod
+    def setUpClass(cls):
+        super().setUpClass()
+        user = cls.env["res.users"].browse(1)
+        cls.env = cls.env(user=user)
+        # create a room type availability
+        cls.room_type_availability = cls.env["pms.availability.plan"].create(
+            {
+                "name": "Availability plan for TEST",
+                "pms_pricelist_ids": [(6, 0, [cls.pricelist1.id])],
+            }
+        )
+
+        # create room type
+        cls.room_type_double = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Double Test",
+                "default_code": "DBL_Test",
+                "class_id": cls.room_type_class1.id,
+            }
+        )
+
+        cls.room_type_triple = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Triple Test",
+                "default_code": "TRP_Test",
+                "class_id": cls.room_type_class1.id,
+            }
+        )
+
+        # Additional room type class for incompatible test
+        cls.room_type_class_day = cls.env["pms.room.type.class"].create(
+            {
+                "name": "Day Use",
+                "overnight": False,
+                "default_code": "DAY",
+            }
+        )
+        cls.room_type_class_overnight = cls.env["pms.room.type.class"].create(
+            {
+                "name": "Overnight",
+                "overnight": True,
+                "default_code": "OVN",
+            }
+        )
+
+        cls.room_type_day = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Day Room",
+                "default_code": "DAY_Test",
+                "class_id": cls.room_type_class_day.id,
+            }
+        )
+
+        cls.room_type_overnight = cls.env["pms.room.type"].create(
+            {
+                "pms_property_ids": [cls.pms_property1.id],
+                "name": "Overnight Room",
+                "default_code": "OVN_Test",
+                "class_id": cls.room_type_class_overnight.id,
+            }
+        )
+
+        cls.room_day = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Day 201",
+                "room_type_id": cls.room_type_day.id,
+                "capacity": 1,
+                "extra_beds_allowed": 0,
+            }
+        )
+        cls.room_overnight = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Overnight 202",
+                "room_type_id": cls.room_type_overnight.id,
+                "capacity": 1,
+                "extra_beds_allowed": 0,
+            }
+        )
+
+        # create rooms
+        cls.room1 = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Double 101",
+                "room_type_id": cls.room_type_double.id,
+                "capacity": 2,
+                "extra_beds_allowed": 1,
+            }
+        )
+
+        cls.room2 = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Double 102",
+                "room_type_id": cls.room_type_double.id,
+                "capacity": 2,
+                "extra_beds_allowed": 1,
+            }
+        )
+
+        cls.room3 = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Double 103",
+                "room_type_id": cls.room_type_double.id,
+                "capacity": 2,
+                "extra_beds_allowed": 1,
+            }
+        )
+
+        cls.room4 = cls.env["pms.room"].create(
+            {
+                "pms_property_id": cls.pms_property1.id,
+                "name": "Triple 104",
+                "room_type_id": cls.room_type_triple.id,
+                "capacity": 3,
+                "extra_beds_allowed": 1,
+            }
+        )
+        cls.partner1 = cls.env["res.partner"].create(
+            {
+                "firstname": "Jaime",
+                "lastname": "García",
+                "email": "jaime@example.com",
+                "birthdate_date": "1983-03-01",
+                "gender": "male",
+            }
+        )
+        cls.id_category = cls.env["res.partner.id_category"].create(
+            {"name": "DNI", "code": "D"}
+        )
+        cls.sale_channel_direct = cls.env["pms.sale.channel"].create(
+            {"name": "sale channel direct", "channel_type": "direct"}
+        )
+        cls.sale_channel1 = cls.env["pms.sale.channel"].create(
+            {"name": "saleChannel1", "channel_type": "indirect"}
+        )
+        cls.agency1 = cls.env["res.partner"].create(
+            {
+                "firstname": "partner1",
+                "is_agency": True,
+                "invoice_to_agency": "always",
+                "default_commission": 15,
+                "sale_channel_id": cls.sale_channel1.id,
+            }
+        )
+
+    @freeze_time("2000-12-01")
+    def test_modify_reservation_line_with_compatible_overnight_classes(self):
+        """
+        Check that when modifying a reservation with compatible overnight
+        classes, the reservation is modified correctly.
+        """
+        # ARRANGE
+        checkin = fields.date.today()
+        checkout = fields.date.today() + datetime.timedelta(days=3)
+        reservation_vals = {
+            "checkin": checkin,
+            "checkout": checkout,
+            "room_type_id": self.room_type_double.id,
+            "partner_id": self.partner1.id,
+            "pms_property_id": self.pms_property1.id,
+            "sale_channel_origin_id": self.sale_channel_direct.id,
+        }
+        reservation = self.env["pms.reservation"].create(reservation_vals)
+
+        # ACT
+        reservation.reservation_line_ids[0].write(
+            {
+                "room_id": self.room_overnight.id,
+            }
+        )
+
+        # ASSERT
+        self.assertEqual(
+            reservation.reservation_line_ids[0].room_id.room_type_id.id,
+            self.room_type_overnight.id,
+            "The reservation should be modified with the new room type",
+        )
+
+    @freeze_time("2000-12-01")
+    def test_modify_reservation_with_incompatible_overnight_classes(self):
+        """
+        Check that when modifying a reservation with incompatible overnight
+        classes, the reservation raises an error.
+        """
+        # ARRANGE
+        checkin = fields.date.today()
+        checkout = fields.date.today() + datetime.timedelta(days=3)
+        reservation_vals = {
+            "checkin": checkin,
+            "checkout": checkout,
+            "room_type_id": self.room_type_double.id,
+            "partner_id": self.partner1.id,
+            "pms_property_id": self.pms_property1.id,
+            "sale_channel_origin_id": self.sale_channel_direct.id,
+        }
+        reservation = self.env["pms.reservation"].create(reservation_vals)
+
+        # ACT & ASSERT
+        with self.assertRaises(ValidationError):
+            reservation.reservation_line_ids[0].write(
+                {
+                    "room_id": self.room_day.id,
+                }
+            )

odoo/addons/pms/views/pms_property_views.xml

@@ -6,6 +6,7 @@
         <field name="arch" type="xml">
             <form string="Property Configuration">
                 <sheet>
+                    <div class="o_button_box" name="button_box" />
                     <label for="name" class="oe_edit_only" />
                     <h1>
                         <field name="name" class="oe_inline" />

{odoo_addon_pms-16.0.0.4.0.6.dist-info → odoo_addon_pms-16.0.0.15.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: odoo-addon-pms
-Version: 16.0.0.4.0.6
+Version: 16.0.0.15.0.10
 Summary: A property management system
 Home-page: https://github.com/OCA/pms
 Author: Commit [Sun], Odoo Community Association (OCA)
@@ -36,7 +36,7 @@ PMS (Property Management System)
    !! This file is generated by oca-gen-addon-readme !!
    !! changes will be overwritten.                   !!
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-   !! source digest: sha256:a724bc0473f65c77aa82b77897ea0610ac258b5a83d314f6909b690dfcc45281
+   !! source digest: sha256:1932d20cb515244c940884a7573b46a3b589228ee1ebb94ad7f300612769a869
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
 .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png