{
    "info": {
        "author": "Odoo Community Association (OCA), GRAP, Akretion, Sylvain LE GAL",
        "author_email": "support@odoo-community.org",
        "bugtrack_url": null,
        "classifiers": [
            "Framework :: Odoo",
            "License :: OSI Approved :: GNU Affero General Public License v3",
            "Programming Language :: Python"
        ],
        "description": ".. figure:: https://img.shields.io/badge/licence-AGPL--3-blue.svg\n   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n   :alt: License: AGPL-3\n\n======================================\nLoad Github Data in your Odoo Instance\n======================================\n\nThis module allows you to:\n\n* Fetch into Odoo social information from Github (Organizations, Teams, Users)\n* Fetch into Odoo Code structure information from Github (Repositories, Branches)\n* Download source code from Github\n\nConfiguration\n=============\n\nOnce installed, you have to:\n\n#. Open your odoo.conf file and add extra settings to mention Github\n   credentials, and the local path where the source code will be downloaded:\n\n   * ``github_login = your_github_login``\n   * ``github_password = your_github_password``\n   * ``source_code_local_path = /workspace/source_code/``\n\n   Note: make sure that Odoo process has read / write access on that folder\n\n#. go to 'Settings' / 'Technical' / 'Parameters' / 'System Parameters'\n   and define the following values:\n\n   #. ``github.max_try``: number of call to the API before an error\n      is raised. The more unstable/slow tyour connection, the higher should be\n      this value\n   #. ``git.partial_commit_during_analysis``: Set to ``True`` if you want to\n      commit the result of the analysis in the database after each repository\n      analysis. We recommend to set to ``True`` when you perform the initial\n      download (potentially with a lot of repositories) in order to reduce the\n      size of the transaction\n\n   .. image:: /github_connector/static/description/github_settings.png\n\n#. Go to your(s) user(s) form to add them in the new 'Connector Github Manager'\n   groups. The members of this group will have the possibility to run Github\n   synchronization.\n\nUsage\n=====\n\nInitial upload from Github\n----------------------------\n\nTo fetch information from Github, you have to:\n\n#. go to 'Github' / 'Settings' / 'Sync Object'\n#. Select the object type you want to synchronize and its Gthub name\n\n   .. image:: /github_connector/static/description/sync_organization.png\n\n#. Once done for your organization(s), go to 'Github' / 'Github Commnunity' /\n   'Organizations'\n\n   .. image:: /github_connector/static/description/github_organization_kanban.png\n\n#. Optionally, once organization is created, you can create series for your\n   projects. Go to 'Github' / 'Organizations' / click on your organization /\n   'Organization Series' Tabs\n\n   .. image:: /github_connector/static/description/github_organization_series.png\n\nSelect branches to download\n---------------------------\nThis setting will prevent to download undesired branches, downloading only\nmain branches (releases):\n\n#. In the 'Settings' tab, set repositories you don't want to download\n   (or repositories you want to download). If 'Specific repositories' is set,\n   'Ignored Repositories' value is ignored.\n\n#. In the 'Settings' tab, set the URL of the 'External Services' you use\n   for Continuous Integration and Coverage.\n\n   .. image:: /github_connector/static/description/github_organization_external_services.png\n\n#. Once done, click on buttons 'Syncs', to synchronize repositories, teams and\n   members. (This process can take a while depending of your size)\n\n   .. image:: /github_connector/static/description/github_organization_sync_buttons.png\n\nTeam / members synchronization\n------------------------------\nYou can synchronize members teams:\n\n#. Go to 'Teams' / tree view / 'Actions' / 'Update from Github'.\n\n   .. image:: /github_connector/static/description/github_team_kanban.png\n\n#. In each team, you can see the members list and the role of the members\n\n   .. image:: /github_connector/static/description/github_team_partner_kanban.png\n\n#. In each team, you can see the repositories list but not the permissions of the\n   team. (See 'Known Issues' Section)\n\n   .. image:: /github_connector/static/description/github_team_repository_kanban.png\n\nRepositories synchronization\n----------------------------\nYou can synchronize the branches of your repositories:\n\n#. Go to 'Repositories' /\n   tree view / 'Actions' / 'Update from Github'\n\n   .. image:: /github_connector/static/description/github_repository_kanban.png\n\n#. In each repository, you can see the main branches list and the size of code\n   source.\n\n   .. image:: /github_connector/static/description/github_repository_branch_kanban.png\n\nFetching the source code\n------------------------\nFinally, you can download locally the source code of all your branches:\n\n#. Go to 'Repository Branches' / tree view / 'Actions' / 'Download and Analyse Source Code'.\n\n   .. image:: /github_connector/static/description/wizard_download_analyze.png\n\n#. In the tree view you can update manually source code or refresh analysis.\n\n   .. image:: /github_connector/static/description/github_repository_branch_list.png\n\nData creation in Github\n-----------------------\n\nYou have the possibility to creates two items in Github directly from Odoo\n\n#. Teams:\n\n   #. Go to 'Settings' / 'Create Team in Github'.\n   #. Set the information and click on Create in Github.\n   #. Odoo will try to create the team. If access right and datas are correct,\n      the creation will be done directly in Github\n   #. Later on, a synchronization will be performed, to create the according\n      team in the Odoo instance.\n\n   .. image:: /github_connector/static/description/wizard_create_team.png\n\n#. Repositories:\n\n   #. Go to 'Settings' / 'Create Team in Github'.\n   #. Set the information and click on Create in Github.\n\n   .. image:: /github_connector/static/description/wizard_create_repository.png\n\nNote\n----\nAnalysis in this module is basic: for the time being, it just gives branches\nsize.\n\nNevertheless, you can develop an extra Odoo Custom module to extend analysis\nfunction and get extra statistics, depending on your needs.\n\nIn that way, you can see the module github_connector_odoo, if your repositories\ncontain Odoo modules.\n\n.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas\n   :alt: Try me on Runbot\n   :target: https://runbot.odoo-community.org/runbot/229/10.0\n\nReporting\n=========\n\nThis module provides several reports\n\n**Branches by Serie**\n\n.. image:: /github_connector/static/description/reporting_branches_by_serie.png\n\n**Sizes by Serie**\n\n.. image:: /github_connector/static/description/reporting_sizes_by_serie.png\n\nTechnical Information\n=====================\n\nThis module provides 4 crons that you can enable:\n\n* Synchronize All Organizations and Teams (``cron_update_organization``)\n* Synchronize Branches List for All repositories (``cron_update_branch_list``)\n* Download Source Code for All Github Branches (``cron_download_code``)\n* Analyze Source Code for All Github Branches (``cron_analyze_code``)\n\nRoadmap / Known Issues\n======================\n\n* For the time being, Github API doesn't provide some informations that are\n  available by the classic UI, that includes:\n\n  1. team hierarchy: the field is present in the model github_team.parent_id,\n     but unused.\n\n* Possible improvements:\n\n1. Create a new module github_connector_website, that could display\n   teams / repositories / branches informations for non logged users.\n\n2. Analyze commits (author, quantity by series, etc...):\n   this feature has been partially implemented in a V8.0 PR.\n\n3. Synchronize Pull Request, Issues, Comments: \n   this feature has been partially implemented in a V8.0 PR.\n\n* Refactor the github connector:\n\n  A python library called PyGitHub is available. It could be interesting\n  to use it, instead of using custom code. However, this lib doesn't provide\n  good access to child object, generating for the time being, unnecessary\n  API calls. For example, updating a repository should call before a call to\n  the parent organization (The current module is so faster).\n\n.. code-block:: bash\n\n   ``sudo pip install PyGitHub``\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues\n<https://github.com/OCA/interface-github/issues>`_. In case of trouble, please\ncheck there if your issue has already been reported. If you spotted it first,\nhelp us smash it by providing detailed and welcomed feedback.\n\nCredits\n=======\n\nContributors\n------------\n\n* Sylvain LE GAL (https://twitter.com/legalsylvain)\n* S\u00e9bastien BEAU (sebastien.beau@akretion.com)\n* Beno\u00eet GUILLOT (benoit.guillot@akretion.com)\n\nMaintainer\n----------\n\n.. image:: https://odoo-community.org/logo.png\n   :alt: Odoo Community Association\n   :target: https://odoo-community.org\n\nThis module is maintained by the OCA.\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nTo contribute to this module, please visit https://odoo-community.org.\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "",
        "keywords": "",
        "license": "AGPL-3",
        "maintainer": "",
        "maintainer_email": "",
        "name": "odoo10-addon-github-connector",
        "package_url": "https://pypi.org/project/odoo10-addon-github-connector/",
        "platform": "",
        "project_url": "https://pypi.org/project/odoo10-addon-github-connector/",
        "project_urls": null,
        "release_url": "https://pypi.org/project/odoo10-addon-github-connector/10.0.1.0.0.99.dev25/",
        "requires_dist": [
            "git",
            "odoo (<10.1dev,>=10.0)"
        ],
        "requires_python": "~=2.7",
        "summary": "Synchronize information from Github repositories",
        "version": "10.0.1.0.0.99.dev25"
    },
    "last_serial": 3809065,
    "releases": {
        "10.0.1.0.0.99.dev23": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3879a299fb86b13364db438d4476dd09",
                    "sha256": "598400bb7ce38d33866ac531418c3485429285b361def74e0488408ca64bd746"
                },
                "downloads": -1,
                "filename": "odoo10_addon_github_connector-10.0.1.0.0.99.dev23-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "3879a299fb86b13364db438d4476dd09",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": "~=2.7",
                "size": 508787,
                "upload_time": "2017-10-31T05:30:14",
                "url": "https://files.pythonhosted.org/packages/ec/a7/a688cb824df2912a8932fc20d827954924d5b5ded1ac43e836398332274b/odoo10_addon_github_connector-10.0.1.0.0.99.dev23-py2-none-any.whl"
            }
        ],
        "10.0.1.0.0.99.dev24": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "bbeab857353645a1f785d1e466dd6d84",
                    "sha256": "889baf8b4317359d52405f925967b63bcd89eba08bf2fd9333cdb5a7f2aac0c2"
                },
                "downloads": -1,
                "filename": "odoo10_addon_github_connector-10.0.1.0.0.99.dev24-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "bbeab857353645a1f785d1e466dd6d84",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": "~=2.7",
                "size": 508785,
                "upload_time": "2018-01-29T05:30:04",
                "url": "https://files.pythonhosted.org/packages/a5/70/e5a2a682feb2793aa8c146f5da8c35e9b7f3199edbc68e53fcead65b9f7b/odoo10_addon_github_connector-10.0.1.0.0.99.dev24-py2-none-any.whl"
            }
        ],
        "10.0.1.0.0.99.dev25": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f033a2ae3c863c23c385c44caeb8ea22",
                    "sha256": "f87ec98a004e2d1164d1f1bd8fb1ef75bd5f2e4537ee30ea1f6a7ea396b7de87"
                },
                "downloads": -1,
                "filename": "odoo10_addon_github_connector-10.0.1.0.0.99.dev25-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "f033a2ae3c863c23c385c44caeb8ea22",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": "~=2.7",
                "size": 508784,
                "upload_time": "2018-04-26T04:34:17",
                "url": "https://files.pythonhosted.org/packages/fd/d5/5b090f8cb64d3abf0058f4b1a1c229ee7cbe8667c1e2d695406298d671b2/odoo10_addon_github_connector-10.0.1.0.0.99.dev25-py2-none-any.whl"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "f033a2ae3c863c23c385c44caeb8ea22",
                "sha256": "f87ec98a004e2d1164d1f1bd8fb1ef75bd5f2e4537ee30ea1f6a7ea396b7de87"
            },
            "downloads": -1,
            "filename": "odoo10_addon_github_connector-10.0.1.0.0.99.dev25-py2-none-any.whl",
            "has_sig": false,
            "md5_digest": "f033a2ae3c863c23c385c44caeb8ea22",
            "packagetype": "bdist_wheel",
            "python_version": "py2",
            "requires_python": "~=2.7",
            "size": 508784,
            "upload_time": "2018-04-26T04:34:17",
            "url": "https://files.pythonhosted.org/packages/fd/d5/5b090f8cb64d3abf0058f4b1a1c229ee7cbe8667c1e2d695406298d671b2/odoo10_addon_github_connector-10.0.1.0.0.99.dev25-py2-none-any.whl"
        }
    ]
}