[ADD] contributors_github

contributors_github/README.rst

@@ -0,0 +1,123 @@
+===================
+Contributors Github
+===================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:a8e0f9c1d4e4a52ce80f62adac679c2c5ee3902079c4f2a398abbff7c6cebd92
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA--contributors%2Fcontributors--module-lightgray.png?logo=github
+    :target: https://github.com/OCA-contributors/contributors-module/tree/18.0/contributors_github
+    :alt: OCA-contributors/contributors-module
+
+|badge1| |badge2| |badge3|
+
+This module allows to get data from github and show it in your odoo
+instance.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+Access the Contributors / Organization module.
+
+Add your organization and one ore more API Keys (it might be faster if
+you add several ones).
+
+Update the repositories.
+
+The system will start fetching the data automatically.
+
+First Load
+----------
+
+Usually, the first load can take a lot of time and you could find time
+constrains on your Odoo database. For this reason we recommend to stop
+the cron in this first load and execute the following code in your shell
+once you have all the repositories created:
+
+.. code:: python
+
+   from datetime import date, datetime, timedelta
+   import time
+   self = self.env["contributors.organization"].search([], limit=1) # Use the organization you prefer
+   clients = self._get_clients()
+   FIXED_DATE = "2026-01-01"
+   repositories = self.env["contributors.repository"].search([("from_date", "<", FIXED_DATE), ("organization_id", "=", self.id)], order="from_date asc")
+   i = 0
+   while repositories:
+       try:
+           for repository in repositories:
+               i = (i+1) % len(clients)
+               repository.update_information(client_for_search=i)
+               self.env.cr.commit()
+       except Exception:
+           date = False
+           for client in clients:
+               rate = client.rate_limit()
+               print(rate)
+               for code in rate["resources"]:
+                   if rate["resources"][code]["remaining"] == 0:
+                       date = max(date or 0, rate["resources"][code]["reset"])
+           if not date:
+               raise
+           print("%s - Sleeping for %s seconds" % (datetime.now().isoformat(), date - time.mktime(datetime.now().timetuple())))
+           time.sleep(date - time.mktime(datetime.now().timetuple()))
+           time.sleep(10)
+       repositories = self.env["contributors.repository"].search([("from_date", "<", FIXED_DATE), ("organization_id", "=", self.id)], order="from_date asc")
+
+Once it has finished, restart the cron.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA-contributors/contributors-module/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-contributors/contributors-module/issues/new?body=module:%20contributors_github%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
+-------
+
+* Dixmit
+
+Contributors
+------------
+
+- `Dixmit <https://www.dixmit.com>`__
+
+  - Enric Tobella
+
+Maintainers
+-----------
+
+.. |maintainer-etobella| image:: https://github.com/etobella.png?size=40px
+    :target: https://github.com/etobella
+    :alt: etobella
+
+Current maintainer:
+
+|maintainer-etobella| 
+
+This module is part of the `OCA-contributors/contributors-module <https://github.com/OCA-contributors/contributors-module/tree/18.0/contributors_github>`_ project on GitHub.
+
+You are welcome to contribute.

contributors_github/__init__.py

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

contributors_github/__manifest__.py

@@ -0,0 +1,38 @@
+# Copyright 2026 Dixmit
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Contributors Github",
+    "summary": """Get Contributors and Contributions from Github""",
+    "version": "18.0.1.0.0",
+    "license": "AGPL-3",
+    "author": "Dixmit, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA-contributors/contributors-module",
+    "maintainers": ["etobella"],
+    "depends": ["portal", "website_partner"],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/menu.xml",
+        "views/contributors_comment.xml",
+        "views/contributors_review.xml",
+        "views/contributors_branch.xml",
+        "views/contributors_pull_request.xml",
+        "views/contributors_repository.xml",
+        "views/contributors_organization.xml",
+        "views/res_partner.xml",
+        "data/ir_cron.xml",
+        "templates/templates.xml",
+    ],
+    "external_dependencies": {"python": ["github3.py", "PyYAML"]},
+    "demo": [],
+    "assets": {
+        "web.assets_frontend": [
+            "contributors_github/static/src/components/**/*.esm.js",
+            "contributors_github/static/src/components/**/*.xml",
+            "contributors_github/static/src/components/**/*.scss",
+        ],
+        "web.assets_tests": [
+            "contributors_github/static/tests/**/*",
+        ],
+    },
+}

contributors_github/controllers/__init__.py

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

contributors_github/controllers/main.py

@@ -0,0 +1,216 @@
+# Copyright 2026 Dixmit
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from math import sqrt
+
+from markupsafe import Markup
+
+from odoo import _, http
+from odoo.http import request
+
+from odoo.addons.portal.controllers.portal import CustomerPortal
+
+
+class ContributorsController(CustomerPortal):
+    @http.route(
+        [
+            "/contributors",
+            "/contributors/<string:organization>",
+        ],
+        type="http",
+        auth="user",
+        website=True,
+    )
+    def contributors_organization(self, organization=None):
+        values = self._prepare_portal_layout_values()
+        values.update(self._prepare_home_portal_values([]))
+        if organization is None:
+            organizations = request.env["contributors.organization"].search([])
+            return request.render(
+                "contributors_github.contributors_template",
+                {"organizations": organizations, **values},
+            )
+        organization_id = (
+            request.env["contributors.organization"]
+            .sudo()
+            .search([("name", "=ilike", organization)], limit=1)
+            .id
+        )
+        return request.render(
+            "contributors_github.contributors_organization_template",
+            {"organization": organization_id, **values},
+        )
+
+    def _get_index(self, data):
+        return round(
+            sqrt(data["created_pull_requests"])
+            + data["merged_pull_requests"]
+            + sqrt(data["comments"])
+            + data["reviews"],
+            2,
+        )
+
+    def _get_field(self, kind):
+        if kind == "contributors":
+            return "partner_id"
+        elif kind == "organizations":
+            return "organization_id"
+        elif kind == "repositories":
+            return "repository_id"
+        return False
+
+    @http.route(["/contributors/fetch"], type="json", auth="user", readonly=True)
+    def fetch_data(self, organization_id, year, month, kind, period, **values):
+        organization = (
+            request.env["contributors.organization"].browse(organization_id).exists()
+        )
+        if not organization:
+            return []
+        start, end = organization._get_dates(year, month, period, **values)
+        data = organization._generate_data(
+            start, end, self._get_field(kind), kind, **values
+        )
+        return {
+            "columns": self._get_columns(kind),
+            "data": self._improve_data(data, kind, **values),
+        }
+
+    def _get_columns(self, kind):
+        if kind == "contributors":
+            return [
+                {"field": "name", "title": _("Name"), "kind": "name"},
+                {
+                    "field": "index",
+                    "title": _("Contributor Index"),
+                    "kind": "float",
+                    "decimals": 2,
+                    "tooltip": Markup(
+                        request.env["ir.qweb"]._render(
+                            "contributors_github.contributor_index_tooltip", {}
+                        )
+                    ),
+                },
+                {
+                    "field": "created_pull_requests",
+                    "title": _("Created Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "merged_pull_requests",
+                    "title": _("Merged Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "comments",
+                    "title": _("Comments"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "reviews",
+                    "title": _("Reviews"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+            ]
+        elif kind == "organizations":
+            return [
+                {"field": "name", "title": _("Organization Name"), "kind": "name"},
+                {
+                    "field": "created_pull_requests",
+                    "title": _("Created Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "merged_pull_requests",
+                    "title": _("Merged Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "comments",
+                    "title": _("Comments"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "reviews",
+                    "title": _("Reviews"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "developers",
+                    "title": _("Developers"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+            ]
+        elif kind == "repositories":
+            return [
+                {"field": "name", "title": _("Repository Name"), "kind": "name"},
+                {
+                    "field": "index",
+                    "title": _("Repository Index"),
+                    "kind": "float",
+                    "decimals": 2,
+                    "tooltip": Markup(
+                        request.env["ir.qweb"]._render(
+                            "contributors_github.contributor_index_tooltip", {}
+                        )
+                    ),
+                },
+                {
+                    "field": "created_pull_requests",
+                    "title": _("Created Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "merged_pull_requests",
+                    "title": _("Merged Pull Requests"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "comments",
+                    "title": _("Comments"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "reviews",
+                    "title": _("Reviews"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+                {
+                    "field": "developers",
+                    "title": _("Developers"),
+                    "kind": "float",
+                    "decimals": 0,
+                },
+            ]
+        return []
+
+    def _improve_data(self, data, kind, **kwargs):
+        for key, values in data.items():
+            if kind == "contributors":
+                partner = request.env["res.partner"].browse(key)
+                values["name"] = partner._get_contributors_name(kind, **kwargs)
+                values["url"] = partner._get_contributor_url()
+                values["index"] = self._get_index(values)
+            elif kind == "organizations":
+                organization = request.env["res.partner"].browse(key)
+                values["name"] = organization._get_contributors_name(kind, **kwargs)
+                values["url"] = organization._get_contributor_url()
+            elif kind == "repositories":
+                repository = request.env["contributors.repository"].browse(key)
+                values["name"] = repository.name
+                github_name = f"{repository.organization_id.name}/{repository.name}"
+                values["url"] = f"https://github.com/{github_name}"
+                values["index"] = self._get_index(values)
+        return data