|
| 1 | +======================= |
| 2 | +Github Connector - Odoo |
| 3 | +======================= |
| 4 | + |
| 5 | +.. |
| 6 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 7 | + !! This file is generated by oca-gen-addon-readme !! |
| 8 | + !! changes will be overwritten. !! |
| 9 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 10 | + !! source digest: sha256:3927fa22d4103a6017b69f601d113148d631556cbc6a4b4cf96f7ac28c1dc8dc |
| 11 | + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 12 | +
|
| 13 | +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png |
| 14 | + :target: https://odoo-community.org/page/development-status |
| 15 | + :alt: Beta |
| 16 | +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png |
| 17 | + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html |
| 18 | + :alt: License: AGPL-3 |
| 19 | +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Finterface--github-lightgray.png?logo=github |
| 20 | + :target: https://github.com/OCA/interface-github/tree/17.0/github_connector_odoo |
| 21 | + :alt: OCA/interface-github |
| 22 | +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png |
| 23 | + :target: https://translation.odoo-community.org/projects/interface-github-17-0/interface-github-17-0-github_connector_odoo |
| 24 | + :alt: Translate me on Weblate |
| 25 | +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png |
| 26 | + :target: https://runboat.odoo-community.org/builds?repo=OCA/interface-github&target_branch=17.0 |
| 27 | + :alt: Try me on Runboat |
| 28 | + |
| 29 | +|badge1| |badge2| |badge3| |badge4| |badge5| |
| 30 | + |
| 31 | +This module was written to extend the functionality of 'Github |
| 32 | +Connector' Module if your repositories contain Odoo Modules. |
| 33 | + |
| 34 | +It extends 'Analysis' features to parse code files (readme / manifest |
| 35 | +files) and add new models and menus. |
| 36 | + |
| 37 | +|menu| |
| 38 | + |
| 39 | +.. |menu| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/menu.png |
| 40 | + |
| 41 | +**Table of contents** |
| 42 | + |
| 43 | +.. contents:: |
| 44 | + :local: |
| 45 | + |
| 46 | +Configuration |
| 47 | +============= |
| 48 | + |
| 49 | +- Once installed, go to your organization, and set extra settings: |
| 50 | + |
| 51 | +1. The name of your organization in the author keys of the manifest odoo |
| 52 | + modules (in the **Default Author Text** field) |
| 53 | +2. The URL of the file that contains IDs of your repositories for the |
| 54 | + runbot |
| 55 | + |
| 56 | +|github_organization_form| |
| 57 | + |
| 58 | +If you had analyzed previously your repositories with the 'github |
| 59 | +Connector' module, you should launch again the Analysis Process for all |
| 60 | +your Repository Branches. |
| 61 | + |
| 62 | +.. |github_organization_form| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/github_organization_form.png |
| 63 | + |
| 64 | +Usage |
| 65 | +===== |
| 66 | + |
| 67 | +**Odoo Modules** |
| 68 | + |
| 69 | +|odoo_module_kanban| |
| 70 | + |
| 71 | +In each module, you can see the description of the module, the authors, |
| 72 | +the available series, and the list of the modules that depend on the |
| 73 | +current module. |
| 74 | + |
| 75 | +|odoo_module_form| |
| 76 | + |
| 77 | +**Odoo Authors** |
| 78 | + |
| 79 | +|odoo_author| |
| 80 | + |
| 81 | +This list is based on the 'author' key of the manifest file. |
| 82 | + |
| 83 | +**Odoo License** |
| 84 | + |
| 85 | +This list is based on the 'license' key of the manifest file. |
| 86 | + |
| 87 | +|odoo_license| |
| 88 | + |
| 89 | +**Odoo Bin Libs** |
| 90 | + |
| 91 | +This list is based on the 'external_dependencies' / 'bin' key of the |
| 92 | +manifest file. |
| 93 | + |
| 94 | +|odoo_bin_libs| |
| 95 | + |
| 96 | +**Odoo Python Libs** |
| 97 | + |
| 98 | +This list is based on the 'external_dependencies' / 'python' key of the |
| 99 | +manifest file. |
| 100 | + |
| 101 | +|odoo_python_libs| |
| 102 | + |
| 103 | +**Analysis source code** |
| 104 | + |
| 105 | +Implements Analysis source code in odoo module versions, now add new |
| 106 | +field called "has_odoo_addons" (boolean) in Analysis rule that allow (if |
| 107 | +defined) analyze odoo_module_versions and save info about it |
| 108 | + |
| 109 | +**Soource code analysis** |
| 110 | + |
| 111 | +Implements Source code analysis odoo module versions, now addiing new |
| 112 | +field called "has_odoo_addons" (boolean) in Analysis rule that (if |
| 113 | +defined) allows to analyze odoo_module_versions and save info about it |
| 114 | + |
| 115 | +In 'Repository Branch' / 'Code Analysis', shows the info related to |
| 116 | +odoo_module_versions rules analysis too. |
| 117 | + |
| 118 | +**Reporting** |
| 119 | + |
| 120 | +This module provide a new reporting. |
| 121 | + |
| 122 | +**Modules by Serie (and Licenses)** |
| 123 | + |
| 124 | +|reporting_module_by_serie| |
| 125 | + |
| 126 | +.. |odoo_module_kanban| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_module_kanban.png |
| 127 | +.. |odoo_module_form| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_module_form.png |
| 128 | +.. |odoo_author| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_author.png |
| 129 | +.. |odoo_license| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_license.png |
| 130 | +.. |odoo_bin_libs| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_bin_libs.png |
| 131 | +.. |odoo_python_libs| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/odoo_python_libs.png |
| 132 | +.. |reporting_module_by_serie| image:: https://raw.githubusercontent.com/OCA/interface-github/17.0/github_connector_odoo/static/description/reporting_module_by_serie.png |
| 133 | + |
| 134 | +Known issues / Roadmap |
| 135 | +====================== |
| 136 | + |
| 137 | +Possible improvements : |
| 138 | + |
| 139 | +- Implement deep code source analysis, like the website |
| 140 | + http://odoo-code-search.com/ and specially: |
| 141 | + |
| 142 | +1. Possibility to search by field or by model name. (Ex: |
| 143 | + field:invoice_id) |
| 144 | +2. Possibility to display the number of XML, Python, Yaml, HTML, CSS |
| 145 | + lines |
| 146 | + |
| 147 | +Bug Tracker |
| 148 | +=========== |
| 149 | + |
| 150 | +Bugs are tracked on `GitHub Issues <https://github.com/OCA/interface-github/issues>`_. |
| 151 | +In case of trouble, please check there if your issue has already been reported. |
| 152 | +If you spotted it first, help us to smash it by providing a detailed and welcomed |
| 153 | +`feedback <https://github.com/OCA/interface-github/issues/new?body=module:%20github_connector_odoo%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. |
| 154 | + |
| 155 | +Do not contact contributors directly about support or help with technical issues. |
| 156 | + |
| 157 | +Credits |
| 158 | +======= |
| 159 | + |
| 160 | +Authors |
| 161 | +------- |
| 162 | + |
| 163 | +* Sylvain LE GAL |
| 164 | +* GRAP |
| 165 | + |
| 166 | +Contributors |
| 167 | +------------ |
| 168 | + |
| 169 | +- Sylvain LE GAL (https://twitter.com/legalsylvain) |
| 170 | +- `Tecnativa <https://www.tecnativa.com>`__: |
| 171 | + |
| 172 | + - Vicent Cubells |
| 173 | + - Alexandre Díaz |
| 174 | + - Pedro M. Baeza |
| 175 | + - Ernesto Tejeda |
| 176 | + - Víctor Martínez |
| 177 | + - Carolina Fernandez |
| 178 | + |
| 179 | +Maintainers |
| 180 | +----------- |
| 181 | + |
| 182 | +This module is maintained by the OCA. |
| 183 | + |
| 184 | +.. image:: https://odoo-community.org/logo.png |
| 185 | + :alt: Odoo Community Association |
| 186 | + :target: https://odoo-community.org |
| 187 | + |
| 188 | +OCA, or the Odoo Community Association, is a nonprofit organization whose |
| 189 | +mission is to support the collaborative development of Odoo features and |
| 190 | +promote its widespread use. |
| 191 | + |
| 192 | +This module is part of the `OCA/interface-github <https://github.com/OCA/interface-github/tree/17.0/github_connector_odoo>`_ project on GitHub. |
| 193 | + |
| 194 | +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
0 commit comments