Initial commit: Odoo 18.0-20251222 extra-addons

sentry/README.rst

@@ -0,0 +1,198 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+======
+Sentry
+======
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:e2f1d0bc83bf031b61df768de9c2f6d4f1feb303facf171a8d1889fc6a2635ca
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/license-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/18.0/sentry
+    :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-18-0/server-tools-18-0-sentry
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/server-tools&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module allows painless `Sentry <https://sentry.io/>`__ integration
+with Odoo.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Installation
+============
+
+The module can be installed just like any other Odoo module, by adding
+the module's directory to Odoo *addons_path*. In order for the module to
+correctly wrap the Odoo WSGI application, it also needs to be loaded as
+a server-wide module. This can be done with the ``server_wide_modules``
+parameter in your Odoo config file or with the ``--load`` command-line
+parameter.
+
+This module additionally requires the sentry-sdk Python package to be
+available on the system. It can be installed using pip:
+
+::
+
+   pip install sentry-sdk
+
+Configuration
+=============
+
+The following additional configuration options can be added to your Odoo
+configuration file:
+
+[TABLE]
+
+Other `client
+arguments <https://docs.sentry.io/platforms/python/configuration/>`__
+can be configured by prepending the argument name with *sentry\_* in
+your Odoo config file. Currently supported additional client arguments
+are:
+``with_locals, max_breadcrumbs, release, environment, server_name, shutdown_timeout, in_app_include, in_app_exclude, default_integrations, dist, sample_rate, send_default_pii, http_proxy, https_proxy, request_bodies, debug, attach_stacktrace, ca_certs, propagate_traces, traces_sample_rate, auto_enabling_integrations``.
+
+Example Odoo configuration
+--------------------------
+
+Below is an example of Odoo configuration file with *Odoo Sentry*
+options:
+
+::
+
+   [options]
+   sentry_dsn = https://<public_key>:<secret_key>@sentry.example.com/<project id>
+   sentry_enabled = true
+   sentry_logging_level = warn
+   sentry_exclude_loggers = werkzeug
+   sentry_ignore_exceptions = odoo.exceptions.AccessDenied,
+       odoo.exceptions.AccessError,odoo.exceptions.MissingError,
+       odoo.exceptions.RedirectWarning,odoo.exceptions.UserError,
+       odoo.exceptions.ValidationError,odoo.exceptions.Warning,
+       odoo.exceptions.except_orm
+   sentry_include_context = true
+   sentry_environment = production
+   sentry_release = 1.3.2
+   sentry_odoo_dir = /home/odoo/odoo/
+
+Usage
+=====
+
+Once configured and installed, the module will report any logging event
+at and above the configured Sentry logging level, no additional actions
+are necessary.
+
+|Try me on Runbot|
+
+.. |Try me on Runbot| image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
+   :target: https://runbot.odoo-community.org/runbot/149/14.0
+
+Known issues / Roadmap
+======================
+
+- **No database separation** -- This module functions by intercepting
+  all Odoo logging records in a running Odoo process. This means that
+  once installed in one database, it will intercept and report errors
+  for all Odoo databases, which are used on that Odoo server.
+- **Frontend integration** -- In the future, it would be nice to add
+  Odoo client-side error reporting to this module as well, by
+  integrating `raven-js <https://github.com/getsentry/raven-js>`__.
+  Additionally, `Sentry user feedback
+  form <https://docs.sentry.io/learn/user-feedback/>`__ could be
+  integrated into the Odoo client error dialog window to allow users
+  shortly describe what they were doing when things went wrong.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/server-tools/issues/new?body=module:%20sentry%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Mohammed Barsi
+* Versada
+* Nicolas JEUDY
+* Vauxoo
+
+Contributors
+------------
+
+- Mohammed Barsi <barsintod@gmail.com>
+- Andrius Preimantas <andrius@versada.eu>
+- Naglis Jonaitis <naglis@versada.eu>
+- Atte Isopuro <atte.isopuro@avoin.systems>
+- Florian Mounier <florian.mounier@akretion.com>
+- Jon Ashton <jon@monkeyinferno.com>
+- Mark Schuit <mark@gig.solutions>
+- Atchuthan <atchuthan@sodexis.com>
+
+Other credits
+-------------
+
+- Vauxoo
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+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.
+
+.. |maintainer-barsi| image:: https://github.com/barsi.png?size=40px
+    :target: https://github.com/barsi
+    :alt: barsi
+.. |maintainer-naglis| image:: https://github.com/naglis.png?size=40px
+    :target: https://github.com/naglis
+    :alt: naglis
+.. |maintainer-versada| image:: https://github.com/versada.png?size=40px
+    :target: https://github.com/versada
+    :alt: versada
+.. |maintainer-moylop260| image:: https://github.com/moylop260.png?size=40px
+    :target: https://github.com/moylop260
+    :alt: moylop260
+.. |maintainer-fernandahf| image:: https://github.com/fernandahf.png?size=40px
+    :target: https://github.com/fernandahf
+    :alt: fernandahf
+
+Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-barsi| |maintainer-naglis| |maintainer-versada| |maintainer-moylop260| |maintainer-fernandahf| 
+
+This module is part of the `OCA/server-tools <https://github.com/OCA/server-tools/tree/18.0/sentry>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

sentry/__init__.py

@@ -0,0 +1 @@
+from .hooks import post_load

sentry/__manifest__.py

@@ -0,0 +1,27 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+{
+    "name": "Sentry",
+    "summary": "Report Odoo errors to Sentry",
+    "version": "18.0.1.0.3",
+    "category": "Extra Tools",
+    "website": "https://github.com/OCA/server-tools",
+    "author": "Mohammed Barsi,"
+    "Versada,"
+    "Nicolas JEUDY,"
+    "Odoo Community Association (OCA),"
+    "Vauxoo",
+    "maintainers": ["barsi", "naglis", "versada", "moylop260", "fernandahf"],
+    "license": "AGPL-3",
+    "application": False,
+    "installable": True,
+    "external_dependencies": {
+        "python": [
+            "sentry_sdk>=2.0.0,<=2.22.0",
+        ]
+    },
+    "depends": [
+        "base",
+    ],
+    "post_load": "post_load",
+}

sentry/const.py

@@ -0,0 +1,134 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+import collections
+import logging
+
+from sentry_sdk import HttpTransport
+from sentry_sdk.consts import DEFAULT_OPTIONS
+from sentry_sdk.integrations.logging import LoggingIntegration
+
+import odoo.loglevels
+
+
+def split_multiple(string, delimiter=",", strip_chars=None):
+    """Splits :param:`string` and strips :param:`strip_chars` from values."""
+    if not string:
+        return []
+    return [v.strip(strip_chars) for v in string.split(delimiter)]
+
+
+def to_int_if_defined(value):
+    if value == "" or value is None:
+        return
+    return int(value)
+
+
+def to_float_if_defined(value):
+    if value == "" or value is None:
+        return
+    return float(value)
+
+
+SentryOption = collections.namedtuple("SentryOption", ["key", "default", "converter"])
+
+# Mapping of Odoo logging level -> Python stdlib logging library log level.
+LOG_LEVEL_MAP = {
+    getattr(odoo.loglevels, f"LOG_{x}"): getattr(logging, x)
+    for x in ("CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG", "NOTSET")
+}
+DEFAULT_LOG_LEVEL = "warn"
+
+ODOO_USER_EXCEPTIONS = [
+    "odoo.exceptions.AccessDenied",
+    "odoo.exceptions.AccessError",
+    "odoo.exceptions.DeferredException",
+    "odoo.exceptions.MissingError",
+    "odoo.exceptions.RedirectWarning",
+    "odoo.exceptions.UserError",
+    "odoo.exceptions.ValidationError",
+    "odoo.exceptions.Warning",
+    "odoo.exceptions.except_orm",
+]
+DEFAULT_IGNORED_EXCEPTIONS = ",".join(ODOO_USER_EXCEPTIONS)
+
+EXCLUDE_LOGGERS = ("werkzeug",)
+DEFAULT_EXCLUDE_LOGGERS = ",".join(EXCLUDE_LOGGERS)
+
+DEFAULT_ENVIRONMENT = "develop"
+
+DEFAULT_TRANSPORT = "threaded"
+
+
+def select_transport(name=DEFAULT_TRANSPORT):
+    return {
+        "threaded": HttpTransport,
+    }.get(name, HttpTransport)
+
+
+def get_sentry_logging(level=DEFAULT_LOG_LEVEL):
+    if level not in LOG_LEVEL_MAP:
+        level = DEFAULT_LOG_LEVEL
+
+    return LoggingIntegration(
+        # Gather warnings into breadcrumbs regardless of actual logging level
+        level=logging.WARNING,
+        event_level=LOG_LEVEL_MAP[level],
+    )
+
+
+def get_sentry_options():
+    res = [
+        SentryOption("dsn", "", str.strip),
+        SentryOption("transport", DEFAULT_OPTIONS["transport"], select_transport),
+        SentryOption("logging_level", DEFAULT_LOG_LEVEL, get_sentry_logging),
+        SentryOption(
+            "include_local_variables", DEFAULT_OPTIONS["include_local_variables"], None
+        ),
+        SentryOption(
+            "max_breadcrumbs", DEFAULT_OPTIONS["max_breadcrumbs"], to_int_if_defined
+        ),
+        SentryOption("release", DEFAULT_OPTIONS["release"], None),
+        SentryOption("environment", DEFAULT_OPTIONS["environment"], None),
+        SentryOption("server_name", DEFAULT_OPTIONS["server_name"], None),
+        SentryOption("shutdown_timeout", DEFAULT_OPTIONS["shutdown_timeout"], None),
+        SentryOption("integrations", DEFAULT_OPTIONS["integrations"], None),
+        SentryOption(
+            "in_app_include", DEFAULT_OPTIONS["in_app_include"], split_multiple
+        ),
+        SentryOption(
+            "in_app_exclude", DEFAULT_OPTIONS["in_app_exclude"], split_multiple
+        ),
+        SentryOption(
+            "default_integrations", DEFAULT_OPTIONS["default_integrations"], None
+        ),
+        SentryOption("dist", DEFAULT_OPTIONS["dist"], None),
+        SentryOption(
+            "sample_rate", DEFAULT_OPTIONS["sample_rate"], to_float_if_defined
+        ),
+        SentryOption("send_default_pii", DEFAULT_OPTIONS["send_default_pii"], None),
+        SentryOption("http_proxy", DEFAULT_OPTIONS["http_proxy"], None),
+        SentryOption("https_proxy", DEFAULT_OPTIONS["https_proxy"], None),
+        SentryOption("ignore_exceptions", DEFAULT_IGNORED_EXCEPTIONS, split_multiple),
+        SentryOption(
+            "max_request_body_size", DEFAULT_OPTIONS["max_request_body_size"], None
+        ),
+        SentryOption("attach_stacktrace", DEFAULT_OPTIONS["attach_stacktrace"], None),
+        SentryOption("ca_certs", DEFAULT_OPTIONS["ca_certs"], None),
+        SentryOption("propagate_traces", DEFAULT_OPTIONS["propagate_traces"], None),
+        SentryOption(
+            "traces_sample_rate",
+            DEFAULT_OPTIONS["traces_sample_rate"],
+            to_float_if_defined,
+        ),
+    ]
+
+    if "auto_enabling_integrations" in DEFAULT_OPTIONS:
+        res.append(
+            SentryOption(
+                "auto_enabling_integrations",
+                DEFAULT_OPTIONS["auto_enabling_integrations"],
+                None,
+            )
+        )
+
+    return res

sentry/generalutils.py

@@ -0,0 +1,62 @@
+try:
+    from collections.abc import Mapping
+except ImportError:  # pragma: no cover
+    # Python < 3.3
+    from collections.abc import Mapping  # pragma: no cover
+
+
+def string_types():
+    """Taken from https://git.io/JIv5J"""
+
+    return (str,)
+
+
+def is_namedtuple(value):
+    """https://stackoverflow.com/a/2166841/1843746
+    But modified to handle subclasses of namedtuples.
+    Taken from https://git.io/JIsfY
+    """
+    if not isinstance(value, tuple):
+        return False
+    f = getattr(type(value), "_fields", None)
+    if not isinstance(f, tuple):
+        return False
+    return all(isinstance(n, str) for n in f)
+
+
+def iteritems(d, **kw):
+    """Override iteritems for support multiple versions python.
+    Taken from https://git.io/JIvMi
+    """
+    return iter(d.items(**kw))
+
+
+def varmap(func, var, context=None, name=None):
+    """Executes ``func(key_name, value)`` on all values
+    recurisively discovering dict and list scoped
+    values. Taken from https://git.io/JIvMN
+    """
+    if context is None:
+        context = {}
+    objid = id(var)
+    if objid in context:
+        return func(name, "<...>")
+    context[objid] = 1
+
+    if isinstance(var, list | tuple) and not is_namedtuple(var):
+        ret = [varmap(func, f, context, name) for f in var]
+    else:
+        ret = func(name, var)
+        if isinstance(ret, Mapping):
+            ret = {k: varmap(func, v, context, k) for k, v in iteritems(var)}
+    del context[objid]
+    return ret
+
+
+def get_environ(environ):
+    """Returns our whitelisted environment variables.
+    Taken from https://git.io/JIsf2
+    """
+    for key in ("REMOTE_ADDR", "SERVER_NAME", "SERVER_PORT"):
+        if key in environ:
+            yield key, environ[key]

sentry/hooks.py

@@ -0,0 +1,154 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+import logging
+import warnings
+from collections import abc
+
+import odoo.http
+from odoo.service.server import server
+from odoo.tools import config as odoo_config
+
+from . import const
+from .logutils import (
+    InvalidGitRepository,
+    SanitizeOdooCookiesProcessor,
+    fetch_git_sha,
+    get_extra_context,
+)
+
+_logger = logging.getLogger(__name__)
+HAS_SENTRY_SDK = True
+try:
+    import sentry_sdk
+    from sentry_sdk.integrations.logging import ignore_logger
+    from sentry_sdk.integrations.threading import ThreadingIntegration
+    from sentry_sdk.integrations.wsgi import SentryWsgiMiddleware
+except ImportError:  # pragma: no cover
+    HAS_SENTRY_SDK = False  # pragma: no cover
+    _logger.debug(
+        "Cannot import 'sentry-sdk'.\
+                        Please make sure it is installed."
+    )  # pragma: no cover
+
+
+def before_send(event, hint):
+    """Prevent the capture of any exceptions in
+    the DEFAULT_IGNORED_EXCEPTIONS list
+        -- or --
+    Add context to event if include_context is True
+    and sanitize sensitive data"""
+
+    exc_info = hint.get("exc_info")
+    if exc_info is None and "log_record" in hint:
+        # Odoo handles UserErrors by logging the raw exception rather
+        # than a message string in odoo/http.py
+        try:
+            module_name = hint["log_record"].msg.__module__
+            class_name = hint["log_record"].msg.__class__.__name__
+            qualified_name = module_name + "." + class_name
+        except AttributeError:
+            qualified_name = "not found"
+
+        if qualified_name in const.DEFAULT_IGNORED_EXCEPTIONS:
+            return None
+
+    if event.setdefault("tags", {}).get("include_context"):
+        cxtest = get_extra_context(odoo.http.request)
+        info_request = ["tags", "user", "extra", "request"]
+
+        for item in info_request:
+            info_item = event.setdefault(item, {})
+            info_item.update(cxtest.setdefault(item, {}))
+
+    raven_processor = SanitizeOdooCookiesProcessor()
+    raven_processor.process(event)
+
+    return event
+
+
+def get_odoo_commit(odoo_dir):
+    """Attempts to get Odoo git commit from :param:`odoo_dir`."""
+    if not odoo_dir:
+        return
+    try:
+        return fetch_git_sha(odoo_dir)
+    except InvalidGitRepository:
+        _logger.debug("Odoo directory: '%s' not a valid git repository", odoo_dir)
+
+
+def initialize_sentry(config):
+    """Setup an instance of :class:`sentry_sdk.Client`.
+    :param config: Sentry configuration
+    :param client: class used to instantiate the sentry_sdk client.
+    """
+    enabled = config.get("sentry_enabled", False)
+    if not (HAS_SENTRY_SDK and enabled):
+        return
+    _logger.info("Initializing sentry...")
+    if config.get("sentry_odoo_dir") and config.get("sentry_release"):
+        _logger.debug(
+            "Both sentry_odoo_dir and \
+                       sentry_release defined, choosing sentry_release"
+        )
+    if config.get("sentry_transport"):
+        warnings.warn(
+            "`sentry_transport` has been deprecated.  "
+            "Its not neccesary send it, will use `HttpTranport` by default.",
+            DeprecationWarning,
+            stacklevel=1,
+        )
+    options = {}
+    for option in const.get_sentry_options():
+        value = config.get(f"sentry_{option.key}", option.default)
+        if isinstance(option.converter, abc.Callable):
+            value = option.converter(value)
+        options[option.key] = value
+
+    exclude_loggers = const.split_multiple(
+        config.get("sentry_exclude_loggers", const.DEFAULT_EXCLUDE_LOGGERS)
+    )
+
+    if not options.get("release"):
+        options["release"] = config.get(
+            "sentry_release", get_odoo_commit(config.get("sentry_odoo_dir"))
+        )
+
+    # Change name `ignore_exceptions` (with raven)
+    # to `ignore_errors' (sentry_sdk)
+    options["ignore_errors"] = options["ignore_exceptions"]
+    del options["ignore_exceptions"]
+
+    options["before_send"] = before_send
+
+    options["integrations"] = [
+        options["logging_level"],
+        ThreadingIntegration(propagate_hub=True),
+    ]
+    # Remove logging_level, since in sentry_sdk is include in 'integrations'
+    del options["logging_level"]
+
+    client = sentry_sdk.init(**options)
+
+    sentry_sdk.set_tag("include_context", config.get("sentry_include_context", True))
+
+    if exclude_loggers:
+        for item in exclude_loggers:
+            ignore_logger(item)
+
+    # The server app is already registered so patch it here
+    if server:
+        server.app = SentryWsgiMiddleware(server.app)
+
+    # Patch the wsgi server in case of further registration
+    odoo.http.Application = SentryWsgiMiddleware(odoo.http.Application)
+
+    with sentry_sdk.new_scope() as scope:
+        scope.set_extra("debug", False)
+        sentry_sdk.capture_message("Starting Odoo Server", "info")
+
+    return client
+
+
+def post_load():
+    initialize_sentry(odoo_config)

sentry/i18n/it.po

@@ -0,0 +1,14 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 16.0\n"
+"Report-Msgid-Bugs-To: \n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: it\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"

sentry/i18n/sentry.pot

@@ -0,0 +1,13 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 18.0\n"
+"Report-Msgid-Bugs-To: \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"

sentry/logutils.py

@@ -0,0 +1,117 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+import os.path
+import urllib.parse
+
+from werkzeug import datastructures
+
+from .generalutils import get_environ
+from .processor import SanitizePasswordsProcessor
+
+
+def get_request_info(request):
+    """
+    Returns context data extracted from :param:`request`.
+
+    Heavily based on flask integration for Sentry: https://git.io/vP4i9.
+    """
+    urlparts = urllib.parse.urlsplit(request.url)
+    return {
+        "url": f"{urlparts.scheme}://{urlparts.netloc}{urlparts.path}",
+        "query_string": urlparts.query,
+        "method": request.method,
+        "headers": dict(datastructures.EnvironHeaders(request.environ)),
+        "env": dict(get_environ(request.environ)),
+    }
+
+
+def get_extra_context(request):
+    """
+    Extracts additional context from the current request (if such is set).
+    """
+    try:
+        session = getattr(request, "session", {})
+    except RuntimeError:
+        ctx = {}
+    else:
+        ctx = {
+            "tags": {
+                "database": session.get("db", None),
+            },
+            "user": {
+                "email": session.get("login", None),
+                "id": session.get("uid", None),
+            },
+            "extra": {
+                "context": session.get("context", {}),
+            },
+        }
+        if request.httprequest:
+            ctx.update({"request": get_request_info(request.httprequest)})
+    return ctx
+
+
+class SanitizeOdooCookiesProcessor(SanitizePasswordsProcessor):
+    """Custom :class:`raven.processors.Processor`.
+    Allows to sanitize sensitive Odoo cookies, namely the "session_id" cookie.
+    """
+
+    KEYS = frozenset(
+        [
+            "session_id",
+        ]
+    )
+
+
+class InvalidGitRepository(Exception):
+    pass
+
+
+def fetch_git_sha(path, head=None):
+    """>>> fetch_git_sha(os.path.dirname(__file__))
+    Taken from https://git.io/JITmC
+    """
+    if not head:
+        head_path = os.path.join(path, ".git", "HEAD")
+        if not os.path.exists(head_path):
+            raise InvalidGitRepository(
+                f"Cannot identify HEAD for git repository at {path}"
+            )
+
+        with open(head_path) as fp:
+            head = str(fp.read()).strip()
+
+        if head.startswith("ref: "):
+            head = head[5:]
+            revision_file = os.path.join(path, ".git", *head.split("/"))
+        else:
+            return head
+    else:
+        revision_file = os.path.join(path, ".git", "refs", "heads", head)
+
+    if not os.path.exists(revision_file):
+        if not os.path.exists(os.path.join(path, ".git")):
+            raise InvalidGitRepository(
+                f"{path} does not seem to be the root of a git repository"
+            )
+
+        # Check for our .git/packed-refs' file since a `git gc` may have run
+        # https://git-scm.com/book/en/v2/Git-Internals-Maintenance-and-Data-Recovery
+        packed_file = os.path.join(path, ".git", "packed-refs")
+        if os.path.exists(packed_file):
+            with open(packed_file) as fh:
+                for line in fh:
+                    line = line.rstrip()
+                    if line and line[:1] not in ("#", "^"):
+                        try:
+                            revision, ref = line.split(" ", 1)
+                        except ValueError:
+                            continue
+                        if ref == head:
+                            return str(revision)
+
+        raise InvalidGitRepository(f"Unable to find ref to head {head} in repository")
+
+    with open(revision_file) as fh:
+        return str(fh.read()).strip()

sentry/processor.py

@@ -0,0 +1,134 @@
+"""Custom class of raven.core.processors taken of https://git.io/JITko
+This is a custom class of processor to filter and sanitize
+passwords and keys from request data, it does not exist in
+sentry-sdk.
+"""
+
+import re
+
+from .generalutils import string_types, varmap
+
+
+class SanitizeKeysProcessor:
+    """Class from raven for sanitize keys, cookies, etc
+    Asterisk out things that correspond to a configurable set of keys."""
+
+    MASK = "*" * 8
+
+    def process(self, data, **kwargs):
+        if "exception" in data:
+            if "values" in data["exception"]:
+                for value in data["exception"].get("values", []):
+                    if "stacktrace" in value:
+                        self.filter_stacktrace(value["stacktrace"])
+
+        if "request" in data:
+            self.filter_http(data["request"])
+
+        if "extra" in data:
+            data["extra"] = self.filter_extra(data["extra"])
+
+        if "level" in data:
+            data["level"] = self.filter_level(data["level"])
+
+        return data
+
+    @property
+    def sanitize_keys(self):
+        pass
+
+    def sanitize(self, item, value):
+        if value is None:
+            return
+
+        if not item:  # key can be a NoneType
+            return value
+
+        # Just in case we have bytes here, we want to make them into text
+        # properly without failing so we can perform our check.
+        if isinstance(item, bytes):
+            item = item.decode("utf-8", "replace")
+        else:
+            item = str(item)
+
+        item = item.lower()
+        for key in self.sanitize_keys:
+            if key in item:
+                # store mask as a fixed length for security
+                return self.MASK
+        return value
+
+    def filter_stacktrace(self, data):
+        for frame in data.get("frames", []):
+            if "vars" not in frame:
+                continue
+            frame["vars"] = varmap(self.sanitize, frame["vars"])
+
+    def filter_http(self, data):
+        for n in ("data", "cookies", "headers", "env", "query_string"):
+            if n not in data:
+                continue
+
+            # data could be provided as bytes and if it's python3
+            if isinstance(data[n], bytes):
+                data[n] = data[n].decode("utf-8", "replace")
+
+            if isinstance(data[n], string_types()) and "=" in data[n]:
+                # at this point we've assumed it's a standard HTTP query
+                # or cookie
+                if n == "cookies":
+                    delimiter = ";"
+                else:
+                    delimiter = "&"
+
+                data[n] = self._sanitize_keyvals(data[n], delimiter)
+            else:
+                data[n] = varmap(self.sanitize, data[n])
+                if n == "headers" and "Cookie" in data[n]:
+                    data[n]["Cookie"] = self._sanitize_keyvals(data[n]["Cookie"], ";")
+
+    def filter_extra(self, data):
+        return varmap(self.sanitize, data)
+
+    def filter_level(self, data):
+        return re.sub(r"\x1b(\[.*?[@-~]|\].*?(\x07|\x1b\\))", "", data)
+
+    def _sanitize_keyvals(self, keyvals, delimiter):
+        sanitized_keyvals = []
+        for keyval in keyvals.split(delimiter):
+            keyval = keyval.split("=")
+            if len(keyval) == 2:
+                sanitized_keyvals.append((keyval[0], self.sanitize(*keyval)))
+            else:
+                sanitized_keyvals.append(keyval)
+
+        return delimiter.join("=".join(keyval) for keyval in sanitized_keyvals)
+
+
+class SanitizePasswordsProcessor(SanitizeKeysProcessor):
+    """Asterisk out things that look like passwords, credit card numbers,
+    and API keys in frames, http, and basic extra data."""
+
+    KEYS = frozenset(
+        [
+            "password",
+            "secret",
+            "passwd",
+            "authorization",
+            "api_key",
+            "apikey",
+            "sentry_dsn",
+            "access_token",
+        ]
+    )
+    VALUES_RE = re.compile(r"^(?:\d[ -]*?){13,16}$")
+
+    @property
+    def sanitize_keys(self):
+        return self.KEYS
+
+    def sanitize(self, item, value):
+        value = super().sanitize(item, value)
+        if isinstance(value, string_types()) and self.VALUES_RE.match(value):
+            return self.MASK
+        return value

sentry/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["whool"]
+build-backend = "whool.buildapi"

sentry/readme/CONFIGURE.md

@@ -0,0 +1,30 @@
+The following additional configuration options can be added to your Odoo
+configuration file:
+
+[TABLE]
+
+Other [client
+arguments](https://docs.sentry.io/platforms/python/configuration/) can
+be configured by prepending the argument name with *sentry\_* in your
+Odoo config file. Currently supported additional client arguments are:
+`with_locals, max_breadcrumbs, release, environment, server_name, shutdown_timeout, in_app_include, in_app_exclude, default_integrations, dist, sample_rate, send_default_pii, http_proxy, https_proxy, request_bodies, debug, attach_stacktrace, ca_certs, propagate_traces, traces_sample_rate, auto_enabling_integrations`.
+
+## Example Odoo configuration
+
+Below is an example of Odoo configuration file with *Odoo Sentry*
+options:
+
+    [options]
+    sentry_dsn = https://<public_key>:<secret_key>@sentry.example.com/<project id>
+    sentry_enabled = true
+    sentry_logging_level = warn
+    sentry_exclude_loggers = werkzeug
+    sentry_ignore_exceptions = odoo.exceptions.AccessDenied,
+        odoo.exceptions.AccessError,odoo.exceptions.MissingError,
+        odoo.exceptions.RedirectWarning,odoo.exceptions.UserError,
+        odoo.exceptions.ValidationError,odoo.exceptions.Warning,
+        odoo.exceptions.except_orm
+    sentry_include_context = true
+    sentry_environment = production
+    sentry_release = 1.3.2
+    sentry_odoo_dir = /home/odoo/odoo/

sentry/readme/CONTRIBUTORS.md

@@ -0,0 +1,8 @@
+- Mohammed Barsi \<<barsintod@gmail.com>\>
+- Andrius Preimantas \<<andrius@versada.eu>\>
+- Naglis Jonaitis \<<naglis@versada.eu>\>
+- Atte Isopuro \<<atte.isopuro@avoin.systems>\>
+- Florian Mounier \<<florian.mounier@akretion.com>\>
+- Jon Ashton \<<jon@monkeyinferno.com>\>
+- Mark Schuit \<<mark@gig.solutions>\>
+- Atchuthan \<<atchuthan@sodexis.com>\>

sentry/readme/CREDITS.md

@@ -0,0 +1 @@
+- Vauxoo

sentry/readme/DESCRIPTION.md

@@ -0,0 +1,2 @@
+This module allows painless [Sentry](https://sentry.io/) integration
+with Odoo.

sentry/readme/INSTALL.md

@@ -0,0 +1,11 @@
+The module can be installed just like any other Odoo module, by adding
+the module's directory to Odoo *addons_path*. In order for the module to
+correctly wrap the Odoo WSGI application, it also needs to be loaded as
+a server-wide module. This can be done with the `server_wide_modules`
+parameter in your Odoo config file or with the `--load` command-line
+parameter.
+
+This module additionally requires the sentry-sdk Python package to be
+available on the system. It can be installed using pip:
+
+    pip install sentry-sdk

sentry/readme/ROADMAP.md

@@ -0,0 +1,11 @@
+- **No database separation** -- This module functions by intercepting
+  all Odoo logging records in a running Odoo process. This means that
+  once installed in one database, it will intercept and report errors
+  for all Odoo databases, which are used on that Odoo server.
+- **Frontend integration** -- In the future, it would be nice to add
+  Odoo client-side error reporting to this module as well, by
+  integrating [raven-js](https://github.com/getsentry/raven-js).
+  Additionally, [Sentry user feedback
+  form](https://docs.sentry.io/learn/user-feedback/) could be integrated
+  into the Odoo client error dialog window to allow users shortly
+  describe what they were doing when things went wrong.

sentry/readme/USAGE.md

@@ -0,0 +1,5 @@
+Once configured and installed, the module will report any logging event
+at and above the configured Sentry logging level, no additional actions
+are necessary.
+
+[![Try me on Runbot](https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas)](https://runbot.odoo-community.org/runbot/149/14.0)

sentry/static/description/index.html

@@ -0,0 +1,526 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils: https://docutils.sourceforge.io/" />
+<title>README.rst</title>
+<style type="text/css">
+
+/*
+:Author: David Goodger (goodger@python.org)
+:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+Despite the name, some widely supported CSS2 features are used.
+
+See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+  border: 0 }
+
+table.borderless td, table.borderless th {
+  /* Override padding for "table.docutils td" with "! important".
+     The right padding separates the table cells. */
+  padding: 0 0.5em 0 0 ! important }
+
+.first {
+  /* Override more specific margin styles with "! important". */
+  margin-top: 0 ! important }
+
+.last, .with-subtitle {
+  margin-bottom: 0 ! important }
+
+.hidden {
+  display: none }
+
+.subscript {
+  vertical-align: sub;
+  font-size: smaller }
+
+.superscript {
+  vertical-align: super;
+  font-size: smaller }
+
+a.toc-backref {
+  text-decoration: none ;
+  color: black }
+
+blockquote.epigraph {
+  margin: 2em 5em ; }
+
+dl.docutils dd {
+  margin-bottom: 0.5em }
+
+object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
+  overflow: hidden;
+}
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+  font-weight: bold }
+*/
+
+div.abstract {
+  margin: 2em 5em }
+
+div.abstract p.topic-title {
+  font-weight: bold ;
+  text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+  margin: 2em ;
+  border: medium outset ;
+  padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+  font-weight: bold ;
+  font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title, .code .error {
+  color: red ;
+  font-weight: bold ;
+  font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+   compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+  margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+  margin-top: 0.5em }
+*/
+
+div.dedication {
+  margin: 2em 5em ;
+  text-align: center ;
+  font-style: italic }
+
+div.dedication p.topic-title {
+  font-weight: bold ;
+  font-style: normal }
+
+div.figure {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+div.footer, div.header {
+  clear: both;
+  font-size: smaller }
+
+div.line-block {
+  display: block ;
+  margin-top: 1em ;
+  margin-bottom: 1em }
+
+div.line-block div.line-block {
+  margin-top: 0 ;
+  margin-bottom: 0 ;
+  margin-left: 1.5em }
+
+div.sidebar {
+  margin: 0 0 0.5em 1em ;
+  border: medium outset ;
+  padding: 1em ;
+  background-color: #ffffee ;
+  width: 40% ;
+  float: right ;
+  clear: right }
+
+div.sidebar p.rubric {
+  font-family: sans-serif ;
+  font-size: medium }
+
+div.system-messages {
+  margin: 5em }
+
+div.system-messages h1 {
+  color: red }
+
+div.system-message {
+  border: medium outset ;
+  padding: 1em }
+
+div.system-message p.system-message-title {
+  color: red ;
+  font-weight: bold }
+
+div.topic {
+  margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+  margin-top: 0.4em }
+
+h1.title {
+  text-align: center }
+
+h2.subtitle {
+  text-align: center }
+
+hr.docutils {
+  width: 75% }
+
+img.align-left, .figure.align-left, object.align-left, table.align-left {
+  clear: left ;
+  float: left ;
+  margin-right: 1em }
+
+img.align-right, .figure.align-right, object.align-right, table.align-right {
+  clear: right ;
+  float: right ;
+  margin-left: 1em }
+
+img.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+table.align-center {
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+  text-align: left }
+
+.align-center {
+  clear: both ;
+  text-align: center }
+
+.align-right {
+  text-align: right }
+
+/* reset inner alignment in figures */
+div.align-right {
+  text-align: inherit }
+
+/* div.align-center * { */
+/*   text-align: left } */
+
+.align-top    {
+  vertical-align: top }
+
+.align-middle {
+  vertical-align: middle }
+
+.align-bottom {
+  vertical-align: bottom }
+
+ol.simple, ul.simple {
+  margin-bottom: 1em }
+
+ol.arabic {
+  list-style: decimal }
+
+ol.loweralpha {
+  list-style: lower-alpha }
+
+ol.upperalpha {
+  list-style: upper-alpha }
+
+ol.lowerroman {
+  list-style: lower-roman }
+
+ol.upperroman {
+  list-style: upper-roman }
+
+p.attribution {
+  text-align: right ;
+  margin-left: 50% }
+
+p.caption {
+  font-style: italic }
+
+p.credits {
+  font-style: italic ;
+  font-size: smaller }
+
+p.label {
+  white-space: nowrap }
+
+p.rubric {
+  font-weight: bold ;
+  font-size: larger ;
+  color: maroon ;
+  text-align: center }
+
+p.sidebar-title {
+  font-family: sans-serif ;
+  font-weight: bold ;
+  font-size: larger }
+
+p.sidebar-subtitle {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+p.topic-title {
+  font-weight: bold }
+
+pre.address {
+  margin-bottom: 0 ;
+  margin-top: 0 ;
+  font: inherit }
+
+pre.literal-block, pre.doctest-block, pre.math, pre.code {
+  margin-left: 2em ;
+  margin-right: 2em }
+
+pre.code .ln { color: gray; } /* line numbers */
+pre.code, code { background-color: #eeeeee }
+pre.code .comment, code .comment { color: #5C6576 }
+pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
+pre.code .literal.string, code .literal.string { color: #0C5404 }
+pre.code .name.builtin, code .name.builtin { color: #352B84 }
+pre.code .deleted, code .deleted { background-color: #DEB0A1}
+pre.code .inserted, code .inserted { background-color: #A3D289}
+
+span.classifier {
+  font-family: sans-serif ;
+  font-style: oblique }
+
+span.classifier-delimiter {
+  font-family: sans-serif ;
+  font-weight: bold }
+
+span.interpreted {
+  font-family: sans-serif }
+
+span.option {
+  white-space: nowrap }
+
+span.pre {
+  white-space: pre }
+
+span.problematic, pre.problematic {
+  color: red }
+
+span.section-subtitle {
+  /* font-size relative to parent (h1..h6 element) */
+  font-size: 80% }
+
+table.citation {
+  border-left: solid 1px gray;
+  margin-left: 1px }
+
+table.docinfo {
+  margin: 2em 4em }
+
+table.docutils {
+  margin-top: 0.5em ;
+  margin-bottom: 0.5em }
+
+table.footnote {
+  border-left: solid 1px black;
+  margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+  padding-left: 0.5em ;
+  padding-right: 0.5em ;
+  vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+  font-weight: bold ;
+  text-align: left ;
+  white-space: nowrap ;
+  padding-left: 0 }
+
+/* "booktabs" style (no vertical lines) */
+table.docutils.booktabs {
+  border: 0px;
+  border-top: 2px solid;
+  border-bottom: 2px solid;
+  border-collapse: collapse;
+}
+table.docutils.booktabs * {
+  border: 0px;
+}
+table.docutils.booktabs th {
+  border-bottom: thin solid;
+  text-align: left;
+}
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+  font-size: 100% }
+
+ul.auto-toc {
+  list-style-type: none }
+
+</style>
+</head>
+<body>
+<div class="document">
+
+
+<a class="reference external image-reference" href="https://odoo-community.org/get-involved?utm_source=readme">
+<img alt="Odoo Community Association" src="https://odoo-community.org/readme-banner-image" />
+</a>
+<div class="section" id="sentry">
+<h1>Sentry</h1>
+<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!! This file is generated by oca-gen-addon-readme !!
+!! changes will be overwritten.                   !!
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!! source digest: sha256:e2f1d0bc83bf031b61df768de9c2f6d4f1feb303facf171a8d1889fc6a2635ca
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
+<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/server-tools/tree/18.0/sentry"><img alt="OCA/server-tools" src="https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/server-tools-18-0/server-tools-18-0-sentry"><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/server-tools&amp;target_branch=18.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
+<p>This module allows painless <a class="reference external" href="https://sentry.io/">Sentry</a> integration
+with Odoo.</p>
+<p><strong>Table of contents</strong></p>
+<div class="contents local topic" id="contents">
+<ul class="simple">
+<li><a class="reference internal" href="#installation" id="toc-entry-1">Installation</a></li>
+<li><a class="reference internal" href="#configuration" id="toc-entry-2">Configuration</a><ul>
+<li><a class="reference internal" href="#example-odoo-configuration" id="toc-entry-3">Example Odoo configuration</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#usage" id="toc-entry-4">Usage</a></li>
+<li><a class="reference internal" href="#known-issues-roadmap" id="toc-entry-5">Known issues / Roadmap</a></li>
+<li><a class="reference internal" href="#bug-tracker" id="toc-entry-6">Bug Tracker</a></li>
+<li><a class="reference internal" href="#credits" id="toc-entry-7">Credits</a><ul>
+<li><a class="reference internal" href="#authors" id="toc-entry-8">Authors</a></li>
+<li><a class="reference internal" href="#contributors" id="toc-entry-9">Contributors</a></li>
+<li><a class="reference internal" href="#other-credits" id="toc-entry-10">Other credits</a></li>
+<li><a class="reference internal" href="#maintainers" id="toc-entry-11">Maintainers</a></li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="installation">
+<h2><a class="toc-backref" href="#toc-entry-1">Installation</a></h2>
+<p>The module can be installed just like any other Odoo module, by adding
+the module’s directory to Odoo <em>addons_path</em>. In order for the module to
+correctly wrap the Odoo WSGI application, it also needs to be loaded as
+a server-wide module. This can be done with the <tt class="docutils literal">server_wide_modules</tt>
+parameter in your Odoo config file or with the <tt class="docutils literal"><span class="pre">--load</span></tt> command-line
+parameter.</p>
+<p>This module additionally requires the sentry-sdk Python package to be
+available on the system. It can be installed using pip:</p>
+<pre class="literal-block">
+pip install sentry-sdk
+</pre>
+</div>
+<div class="section" id="configuration">
+<h2><a class="toc-backref" href="#toc-entry-2">Configuration</a></h2>
+<p>The following additional configuration options can be added to your Odoo
+configuration file:</p>
+<p>[TABLE]</p>
+<p>Other <a class="reference external" href="https://docs.sentry.io/platforms/python/configuration/">client
+arguments</a>
+can be configured by prepending the argument name with <em>sentry_</em> in
+your Odoo config file. Currently supported additional client arguments
+are:
+<tt class="docutils literal">with_locals, max_breadcrumbs, release, environment, server_name, shutdown_timeout, in_app_include, in_app_exclude, default_integrations, dist, sample_rate, send_default_pii, http_proxy, https_proxy, request_bodies, debug, attach_stacktrace, ca_certs, propagate_traces, traces_sample_rate, auto_enabling_integrations</tt>.</p>
+<div class="section" id="example-odoo-configuration">
+<h3><a class="toc-backref" href="#toc-entry-3">Example Odoo configuration</a></h3>
+<p>Below is an example of Odoo configuration file with <em>Odoo Sentry</em>
+options:</p>
+<pre class="literal-block">
+[options]
+sentry_dsn = https://&lt;public_key&gt;:&lt;secret_key&gt;&#64;sentry.example.com/&lt;project id&gt;
+sentry_enabled = true
+sentry_logging_level = warn
+sentry_exclude_loggers = werkzeug
+sentry_ignore_exceptions = odoo.exceptions.AccessDenied,
+    odoo.exceptions.AccessError,odoo.exceptions.MissingError,
+    odoo.exceptions.RedirectWarning,odoo.exceptions.UserError,
+    odoo.exceptions.ValidationError,odoo.exceptions.Warning,
+    odoo.exceptions.except_orm
+sentry_include_context = true
+sentry_environment = production
+sentry_release = 1.3.2
+sentry_odoo_dir = /home/odoo/odoo/
+</pre>
+</div>
+</div>
+<div class="section" id="usage">
+<h2><a class="toc-backref" href="#toc-entry-4">Usage</a></h2>
+<p>Once configured and installed, the module will report any logging event
+at and above the configured Sentry logging level, no additional actions
+are necessary.</p>
+<p><a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/149/14.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a></p>
+</div>
+<div class="section" id="known-issues-roadmap">
+<h2><a class="toc-backref" href="#toc-entry-5">Known issues / Roadmap</a></h2>
+<ul class="simple">
+<li><strong>No database separation</strong> – This module functions by intercepting
+all Odoo logging records in a running Odoo process. This means that
+once installed in one database, it will intercept and report errors
+for all Odoo databases, which are used on that Odoo server.</li>
+<li><strong>Frontend integration</strong> – In the future, it would be nice to add
+Odoo client-side error reporting to this module as well, by
+integrating <a class="reference external" href="https://github.com/getsentry/raven-js">raven-js</a>.
+Additionally, <a class="reference external" href="https://docs.sentry.io/learn/user-feedback/">Sentry user feedback
+form</a> could be
+integrated into the Odoo client error dialog window to allow users
+shortly describe what they were doing when things went wrong.</li>
+</ul>
+</div>
+<div class="section" id="bug-tracker">
+<h2><a class="toc-backref" href="#toc-entry-6">Bug Tracker</a></h2>
+<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/server-tools/issues">GitHub Issues</a>.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+<a class="reference external" href="https://github.com/OCA/server-tools/issues/new?body=module:%20sentry%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
+<p>Do not contact contributors directly about support or help with technical issues.</p>
+</div>
+<div class="section" id="credits">
+<h2><a class="toc-backref" href="#toc-entry-7">Credits</a></h2>
+<div class="section" id="authors">
+<h3><a class="toc-backref" href="#toc-entry-8">Authors</a></h3>
+<ul class="simple">
+<li>Mohammed Barsi</li>
+<li>Versada</li>
+<li>Nicolas JEUDY</li>
+<li>Vauxoo</li>
+</ul>
+</div>
+<div class="section" id="contributors">
+<h3><a class="toc-backref" href="#toc-entry-9">Contributors</a></h3>
+<ul class="simple">
+<li>Mohammed Barsi &lt;<a class="reference external" href="mailto:barsintod&#64;gmail.com">barsintod&#64;gmail.com</a>&gt;</li>
+<li>Andrius Preimantas &lt;<a class="reference external" href="mailto:andrius&#64;versada.eu">andrius&#64;versada.eu</a>&gt;</li>
+<li>Naglis Jonaitis &lt;<a class="reference external" href="mailto:naglis&#64;versada.eu">naglis&#64;versada.eu</a>&gt;</li>
+<li>Atte Isopuro &lt;<a class="reference external" href="mailto:atte.isopuro&#64;avoin.systems">atte.isopuro&#64;avoin.systems</a>&gt;</li>
+<li>Florian Mounier &lt;<a class="reference external" href="mailto:florian.mounier&#64;akretion.com">florian.mounier&#64;akretion.com</a>&gt;</li>
+<li>Jon Ashton &lt;<a class="reference external" href="mailto:jon&#64;monkeyinferno.com">jon&#64;monkeyinferno.com</a>&gt;</li>
+<li>Mark Schuit &lt;<a class="reference external" href="mailto:mark&#64;gig.solutions">mark&#64;gig.solutions</a>&gt;</li>
+<li>Atchuthan &lt;<a class="reference external" href="mailto:atchuthan&#64;sodexis.com">atchuthan&#64;sodexis.com</a>&gt;</li>
+</ul>
+</div>
+<div class="section" id="other-credits">
+<h3><a class="toc-backref" href="#toc-entry-10">Other credits</a></h3>
+<ul class="simple">
+<li>Vauxoo</li>
+</ul>
+</div>
+<div class="section" id="maintainers">
+<h3><a class="toc-backref" href="#toc-entry-11">Maintainers</a></h3>
+<p>This module is maintained by the OCA.</p>
+<a class="reference external image-reference" href="https://odoo-community.org">
+<img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
+</a>
+<p>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.</p>
+<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainers</a>:</p>
+<p><a class="reference external image-reference" href="https://github.com/barsi"><img alt="barsi" src="https://github.com/barsi.png?size=40px" /></a> <a class="reference external image-reference" href="https://github.com/naglis"><img alt="naglis" src="https://github.com/naglis.png?size=40px" /></a> <a class="reference external image-reference" href="https://github.com/versada"><img alt="versada" src="https://github.com/versada.png?size=40px" /></a> <a class="reference external image-reference" href="https://github.com/moylop260"><img alt="moylop260" src="https://github.com/moylop260.png?size=40px" /></a> <a class="reference external image-reference" href="https://github.com/fernandahf"><img alt="fernandahf" src="https://github.com/fernandahf.png?size=40px" /></a></p>
+<p>This module is part of the <a class="reference external" href="https://github.com/OCA/server-tools/tree/18.0/sentry">OCA/server-tools</a> project on GitHub.</p>
+<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
+</div>
+</div>
+</div>
+</div>
+</body>
+</html>

sentry/tests/__init__.py

@@ -0,0 +1,4 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from . import test_client, test_logutils, test_processor, test_generalutils

sentry/tests/test_client.py

@@ -0,0 +1,268 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+import logging
+import sys
+from unittest.mock import patch
+
+from sentry_sdk.integrations.logging import _IGNORED_LOGGERS
+from sentry_sdk.transport import HttpTransport
+
+from odoo import exceptions
+from odoo.tests import TransactionCase
+from odoo.tools import config
+
+from ..const import to_int_if_defined
+from ..hooks import before_send, initialize_sentry
+
+GIT_SHA = "d670460b4b4aece5915caf5c68d12f560a9fe3e4"
+RELEASE = "test@1.2.3"
+
+
+def remove_handler_ignore(handler_name):
+    """Removes handlers of handlers ignored list."""
+    _IGNORED_LOGGERS.discard(handler_name)
+
+
+class TestException(exceptions.UserError):
+    pass
+
+
+class InMemoryTransport(HttpTransport):
+    """A :class:`sentry_sdk.Hub.transport` subclass which simply stores events
+    in a list.
+
+    Extended based on the one found in raven-python to avoid additional testing
+    dependencies: https://git.io/vyGO3
+    """
+
+    def __init__(self, *args, **kwargs):
+        self.events = []
+        self.envelopes = []
+
+    def capture_envelope(self, envelope, *args, **kwargs):
+        self.envelopes.append(envelope)
+
+    def has_event(self, event_level, event_msg):
+        for envelope in self.envelopes:
+            event = envelope.get_event()
+            if (
+                event.get("level") == event_level
+                and event.get("logentry", {}).get("message") == event_msg
+            ):
+                return event
+        return False
+
+    def flush(self, *args, **kwargs):
+        pass
+
+    def kill(self, *args, **kwargs):
+        pass
+
+
+class NoopHandler(logging.Handler):
+    """
+    A Handler subclass that does nothing with any given log record.
+
+    Sentry's log patching works by having the integration process things after
+    the normal log handlers are run, so we use this handler to do nothing and
+    move to Sentry logic ASAP.
+    """
+
+    def emit(self, record):
+        pass
+
+
+class TestClientSetup(TransactionCase):
+    def setUp(self):
+        super().setUp()
+        self.dsn = "http://public:secret@example.com/1"
+        self.patch_config(
+            {
+                "sentry_enabled": True,
+                "sentry_dsn": self.dsn,
+                "sentry_logging_level": "error",
+            }
+        )
+        self.client = initialize_sentry(config)._client
+        self.client.transport = InMemoryTransport({"dsn": self.dsn})
+
+        # Setup our own logger so we don't flood stderr with error logs
+        self.logger = logging.getLogger("odoo.sentry.test.logger")
+        # Do not mutate list while iterating it
+        handlers = [handler for handler in self.logger.handlers]
+        for handler in handlers:
+            self.logger.removeHandler(handler)
+        self.logger.addHandler(NoopHandler())
+        self.logger.propagate = False
+
+    def patch_config(self, options: dict):
+        """
+        Patch Odoo's config with the given `options`, ensuring that the patch
+        is undone when the test completes.
+        """
+        _config_patcher = patch.dict(
+            in_dict=config.options,
+            values=options,
+        )
+        _config_patcher.start()
+        self.addCleanup(_config_patcher.stop)
+
+    def log(self, level, msg, exc_info=None):
+        self.logger.log(level, msg, exc_info=exc_info)
+
+    def assertEventCaptured(self, client, event_level, event_msg):
+        self.assertTrue(
+            client.transport.has_event(event_level, event_msg),
+            msg=f"Event: {event_msg} was not captured",
+        )
+
+    def assertEventNotCaptured(self, client, event_level, event_msg):
+        self.assertFalse(
+            client.transport.has_event(event_level, event_msg),
+            msg=f"Event: {event_msg} was captured",
+        )
+
+    def test_initialize_raven_sets_dsn(self):
+        self.assertEqual(self.client.dsn, self.dsn)
+
+    def test_ignore_low_level_event(self):
+        level, msg = logging.WARNING, "Test event, can be ignored"
+        self.log(level, msg)
+        level = "warning"
+        self.assertEventNotCaptured(self.client, level, msg)
+
+    def test_capture_event(self):
+        level, msg = logging.ERROR, "Test event, should be captured"
+        self.log(level, msg)
+        level = "error"
+        self.assertEventCaptured(self.client, level, msg)
+
+    def test_capture_event_exc(self):
+        level, msg = logging.ERROR, "Test event, can be ignored exception"
+        try:
+            raise TestException(msg)
+        except TestException:
+            exc_info = sys.exc_info()
+        self.log(level, msg, exc_info)
+        level = "error"
+        self.assertEventCaptured(self.client, level, msg)
+
+    def test_capture_events_no_tags(self):
+        """Our 'before_send' can handle events without tags"""
+        level, msg = logging.ERROR, "Test event, can be ignored exception"
+        try:
+            raise TestException(msg)
+        except TestException:
+            exc_info = sys.exc_info()
+        self.log(level, msg, exc_info)
+        level = "error"
+        event = self.client.transport.has_event(level, msg)
+        self.assertTrue(event)
+        # Offer an event without tags to the before_send hook
+        if "tags" in event:
+            del event["tags"]
+        self.assertTrue(before_send(event, {}))
+
+    def test_ignore_exceptions(self):
+        self.patch_config(
+            {
+                "sentry_ignore_exceptions": "odoo.exceptions.UserError",
+            }
+        )
+        client = initialize_sentry(config)._client
+        client.transport = InMemoryTransport({"dsn": self.dsn})
+        level, msg = logging.ERROR, "Test exception"
+        try:
+            raise exceptions.UserError(msg)
+        except exceptions.UserError:
+            exc_info = sys.exc_info()
+        self.log(level, msg, exc_info)
+        level = "error"
+        self.assertEventNotCaptured(client, level, msg)
+
+    def test_capture_exceptions_with_no_exc_info(self):
+        """A UserError that isn't in the DEFAULT_IGNORED_EXCEPTIONS list is captured
+        (there is no exc_info in the ValidationError exception)."""
+        client = initialize_sentry(config)._client
+        client.transport = InMemoryTransport({"dsn": self.dsn})
+        level, msg = logging.ERROR, "Test exception"
+
+        # Odoo handles UserErrors by logging the exception
+        with patch("odoo.addons.sentry.const.DEFAULT_IGNORED_EXCEPTIONS", new=[]):
+            self.log(level, exceptions.ValidationError(msg))
+
+        level = "error"
+        self.assertEventCaptured(client, level, msg)
+
+    def test_ignore_exceptions_with_no_exc_info(self):
+        """A UserError that is in the DEFAULT_IGNORED_EXCEPTIONS is not captured
+        (there is no exc_info in the ValidationError exception)."""
+        client = initialize_sentry(config)._client
+        client.transport = InMemoryTransport({"dsn": self.dsn})
+        level, msg = logging.ERROR, "Test exception"
+
+        # Odoo handles UserErrors by logging the exception
+        self.log(level, exceptions.ValidationError(msg))
+
+        level = "error"
+        self.assertEventNotCaptured(client, level, msg)
+
+    def test_exclude_logger(self):
+        self.patch_config(
+            {
+                "sentry_enabled": True,
+                "sentry_exclude_loggers": self.logger.name,
+            }
+        )
+        client = initialize_sentry(config)._client
+        client.transport = InMemoryTransport({"dsn": self.dsn})
+        level, msg = logging.ERROR, f"Test exclude logger {__name__}"
+        self.log(level, msg)
+        level = "error"
+        # Revert ignored logger so it doesn't affect other tests
+        remove_handler_ignore(self.logger.name)
+        self.assertEventNotCaptured(client, level, msg)
+
+    def test_invalid_logging_level(self):
+        self.patch_config(
+            {
+                "sentry_logging_level": "foo_bar",
+            }
+        )
+        client = initialize_sentry(config)._client
+        client.transport = InMemoryTransport({"dsn": self.dsn})
+        level, msg = logging.WARNING, "Test we use the default"
+        self.log(level, msg)
+        level = "warning"
+        self.assertEventCaptured(client, level, msg)
+
+    def test_undefined_to_int(self):
+        self.assertIsNone(to_int_if_defined(""))
+
+    @patch("odoo.addons.sentry.hooks.get_odoo_commit", return_value=GIT_SHA)
+    def test_config_odoo_dir(self, get_odoo_commit):
+        self.patch_config({"sentry_odoo_dir": "/opt/odoo/core"})
+        client = initialize_sentry(config)._client
+
+        self.assertEqual(
+            client.options["release"],
+            GIT_SHA,
+            "Failed to use 'sentry_odoo_dir' parameter appropriately",
+        )
+
+    @patch("odoo.addons.sentry.hooks.get_odoo_commit", return_value=GIT_SHA)
+    def test_config_release(self, get_odoo_commit):
+        self.patch_config(
+            {
+                "sentry_odoo_dir": "/opt/odoo/core",
+                "sentry_release": RELEASE,
+            }
+        )
+        client = initialize_sentry(config)._client
+
+        self.assertEqual(
+            client.options["release"],
+            RELEASE,
+            "Failed to use 'sentry_release' parameter appropriately",
+        )

sentry/tests/test_generalutils.py

@@ -0,0 +1,48 @@
+import typing
+from collections import namedtuple
+
+from odoo.tests import TransactionCase
+
+from .. import generalutils
+
+
+class TestGeneralUtils(TransactionCase):
+    def test_is_namedtuple(self):
+        self.assertFalse(generalutils.is_namedtuple(["a list"]))
+        self.assertFalse(generalutils.is_namedtuple(("a normal tuple",)))
+        a_namedtuple = namedtuple("a_namedtuple", ["some_string"])
+        self.assertTrue(generalutils.is_namedtuple(a_namedtuple("a namedtuple")))
+
+        class AnotherNamedtuple(typing.NamedTuple):
+            some_string: str
+
+        self.assertTrue(
+            generalutils.is_namedtuple(AnotherNamedtuple("a subclassed namedtuple"))
+        )
+
+    def test_varmap(self):
+        top = {
+            "middle": [
+                "a list",
+                "that contains",
+                "the outer dict",
+            ],
+        }
+        top["middle"].append(top)
+
+        def func(_, two):
+            return two
+
+        # Don't care about the result, just that we don't get a recursion error
+        generalutils.varmap(func, top)
+
+    def test_get_environ(self):
+        fake_environ = {
+            "REMOTE_ADDR": None,
+            "SERVER_PORT": None,
+            "FORBIDDEN_VAR": None,
+        }
+        self.assertEqual(
+            ["REMOTE_ADDR", "SERVER_PORT"],
+            list(key for key, _ in generalutils.get_environ(fake_environ)),
+        )

sentry/tests/test_logutils.py

@@ -0,0 +1,75 @@
+# Copyright 2016-2017 Versada <https://versada.eu/>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+import os
+
+from odoo.tests import TransactionCase
+
+from .. import logutils
+
+
+class TestOdooCookieSanitizer(TransactionCase):
+    def test_cookie_as_string(self):
+        data = {
+            "request": {
+                "cookies": "website_lang=en_us;"
+                "session_id=hello;"
+                "Session_ID=hello;"
+                "foo=bar"
+            }
+        }
+
+        proc = logutils.SanitizeOdooCookiesProcessor()
+        result = proc.process(data)
+
+        self.assertTrue("request" in result)
+        http = result["request"]
+        self.assertEqual(
+            http["cookies"],
+            "website_lang=en_us;"
+            f"session_id={proc.MASK};"
+            f"Session_ID={proc.MASK};"
+            "foo=bar",
+        )
+
+    def test_cookie_as_string_with_partials(self):
+        data = {"request": {"cookies": "website_lang=en_us;session_id;foo=bar"}}
+
+        proc = logutils.SanitizeOdooCookiesProcessor()
+        result = proc.process(data)
+
+        self.assertTrue("request" in result)
+        http = result["request"]
+        self.assertEqual(
+            http["cookies"],
+            "website_lang=en_us;session_id;foo=bar",
+        )
+
+    def test_cookie_header(self):
+        data = {
+            "request": {
+                "headers": {
+                    "Cookie": "foo=bar;"
+                    "session_id=hello;"
+                    "Session_ID=hello;"
+                    "a_session_id_here=hello"
+                }
+            }
+        }
+
+        proc = logutils.SanitizeOdooCookiesProcessor()
+        result = proc.process(data)
+
+        self.assertTrue("request" in result)
+        http = result["request"]
+        self.assertEqual(
+            http["headers"]["Cookie"],
+            "foo=bar;"
+            f"session_id={proc.MASK};"
+            f"Session_ID={proc.MASK};"
+            f"a_session_id_here={proc.MASK}",
+        )
+
+    def test_git_sha_failure(self):
+        with self.assertRaises(logutils.InvalidGitRepository):
+            # Assume this test file is not in the repo root
+            logutils.fetch_git_sha(os.path.dirname(__file__))

sentry/tests/test_processor.py

@@ -0,0 +1,48 @@
+from odoo.tests import TransactionCase
+
+from .. import processor
+
+
+class TestSanitizers(TransactionCase):
+    def test_sanitize_password(self):
+        sanitizer = processor.SanitizePasswordsProcessor()
+        for password in [
+            "1234-5678-9012-3456",
+            "1234 5678 9012 3456",
+            "1234 - 5678- -0987---1234",
+            "123456789012345",
+        ]:
+            with self.subTest(
+                password=password,
+                msg="password should have been sanitized",
+            ):
+                self.assertEqual(
+                    sanitizer.sanitize(None, password),
+                    sanitizer.MASK,
+                )
+        for not_password in [
+            "1234",
+            "hello",
+            "text long enough",
+            "numbers and 73X7",
+            "12345678901234567890",
+            b"12345678901234567890",
+            b"1234 5678 9012 3456",
+            "1234-5678-9012-3456-7890",
+        ]:
+            with self.subTest(
+                not_password=password,
+                msg="not_password should not have been sanitized",
+            ):
+                self.assertEqual(
+                    sanitizer.sanitize(None, not_password),
+                    not_password,
+                )
+
+    def test_sanitize_keys(self):
+        sanitizer = processor.SanitizeKeysProcessor()
+        self.assertIsNone(sanitizer.sanitize_keys)
+
+    def test_sanitize_none(self):
+        sanitizer = processor.SanitizePasswordsProcessor()
+        self.assertIsNone(sanitizer.sanitize(None, None))