From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 192.55.52.43, mailfrom: nathaniel.l.desimone@intel.com) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by groups.io with SMTP; Tue, 11 Jun 2019 16:58:50 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 11 Jun 2019 16:58:50 -0700 X-ExtLoop1: 1 Received: from orsmsx106.amr.corp.intel.com ([10.22.225.133]) by fmsmga008.fm.intel.com with ESMTP; 11 Jun 2019 16:58:50 -0700 Received: from orsmsx122.amr.corp.intel.com (10.22.225.227) by ORSMSX106.amr.corp.intel.com (10.22.225.133) with Microsoft SMTP Server (TLS) id 14.3.408.0; Tue, 11 Jun 2019 16:58:49 -0700 Received: from orsmsx114.amr.corp.intel.com ([169.254.8.154]) by ORSMSX122.amr.corp.intel.com ([169.254.11.228]) with mapi id 14.03.0415.000; Tue, 11 Jun 2019 16:58:49 -0700 From: "Nate DeSimone" To: "devel@edk2.groups.io" , "rfc@edk2.groups.io" Subject: [RFC] EdkRepo - The Multi-Repository Tool for EDK II Thread-Topic: [RFC] EdkRepo - The Multi-Repository Tool for EDK II Thread-Index: AdUgrn1EOfxpchJTTZ+5jroxh0qkZA== Date: Tue, 11 Jun 2019 23:58:49 +0000 Message-ID: <02A34F284D1DA44BB705E61F7180EF0AAEC023ED@ORSMSX114.amr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.2.0.6 dlp-reaction: no-action x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiZjc5MzI2MWQtOTk4OC00NzI4LWE1ZmUtYmJmZmM5NmI1ODg1IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiMGh0T1pySUJJVmNvVkZRUlBjVEFyNzBGMm9LQUVubnRTdW9zc1wvM0dUR0lhWnFMR2c5XC9PK3kzK0dHcnhBXC9qUSJ9 x-ctpclassification: CTP_NT x-originating-ip: [10.22.254.138] MIME-Version: 1.0 Return-Path: nathaniel.l.desimone@intel.com Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Hi All, This RFC is raised to add EdkRepo, the multi-repository tool for EDK II fir= mware development to TianoCore. EdkRepo is built on top of git. It is intended to automate common developer= workflows for projects that use more than one git repository. For example = many of the new projects in the edk2-platforms repository require the user = to clone several git repositories. EdkRepo makes it easier to set up and up= stream changes for these projects. EdkRepo does not replace git, rather it = provides higher level extensions that make it easier to work with git. EdkR= epo uses "manifest XML" files to describe the git repositories and EDK II p= ackages that a project uses. EdkRepo is aware of the DSC file format and is= able to combine this XML with metadata from DSC files to create a developm= ent experience tailored specifically for EDK II firmware development. EdkRe= po is written in Python and is compatible with Python 3.5 or later. EdkRepo has been internally developed at Intel for 2.5 years. EdkRepo was o= riginally created to support our own product development. With the recent r= elease of MinPlatformPkg, the number of complete open source UEFI firmware = implementations available at TianoCore has been growing rapidly. We see tha= t many of the development workflows we encounter for our product work now a= pply more broadly to the TianoCore community. Accordingly, we would like to= open EdkRepo to community. We see this process going through several phases. First, we provide an init= ial commit of EdkRepo via edk2-staging. We envision two branches being adde= d to edk2-staging: 1. EdkRepo - Contains the source code for the EdkRepo tool. 2. EdkRepo-Manifest - Contains an initial set of example manifest files whi= ch can be used to try EdkRepo I will send out patches to create these two branches shortly. After these branches are created, we will send a series of commits to popul= ate the first open source version of EdkRepo. At this point the community c= an take a look and provide feedback. There are several options for where th= e final location where this tool might live: 1. edk2-platforms 2. edk2-pytool-library 3. The edk2-toolenv repository proposed by Sean (assuming approval of Sean'= s RFC) 4. A new, separate repository created for EdkRepo In addition, we recommend that a new TianoCore owned repository be created = to host the manifest XML content. The initial proposed maintainer list for EdkRepo is: M: Nate DeSimone M: Ashley DeSimone R: Puja Pandya I believe a community discussion is needed to make a decision on the exact = final location. Once consensus is reached, we can retire the edk2-staging v= ersion of EdkRepo. As always, feedback on this proposal is welcome and appr= eciated. With Best Regards, Nate