manifest: add support for revision in include

Attribute groups can now be added to manifest include, thus
all projects in an included manifest file can easily modify
default branch without modifying all projects in that manifest file.

For example,
the main manifest.xml has an include node contain revision attribute,
```
<include name="include.xml" revision="r1" />
```
and the include.xml has some projects,
```
<project path="project1_path" name="project1_name" revision="r2" />
<project path="project2_path" name="project2_name" />
```
With this change, the final manifest will have revision="r1" for project2.
```
<project name="project1_name" path="project1_path" revision="r2" />
<project name="project2_name" path="project2_path" revision="r1" />
```

Test: added unit tests to cover the inheritance

Change-Id: I4b8547a7198610ec3a3c6aeb2136e0c0f3557df0
Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/369714
Reviewed-by: Mike Frysinger <vapier@google.com>
Commit-Queue: Shuchuan Zeng <zengshuchuan@allwinnertech.com>
Tested-by: Shuchuan Zeng <zengshuchuan@allwinnertech.com>

1 files changed, 39 insertions, 0 deletions

diff --git a/tests/test_manifest_xml.py b/tests/test_manifest_xml.py
index 648acde8..ef511055 100644
--- a/tests/test_manifest_xml.py
+++ b/tests/test_manifest_xml.py
@@ -389,6 +389,45 @@ class XmlManifestTests(ManifestParseTestCase):
 class IncludeElementTests(ManifestParseTestCase):
     """Tests for <include>."""
 
+    def test_revision_default(self):
+        """Check handling of revision attribute."""
+        root_m = os.path.join(self.manifest_dir, "root.xml")
+        with open(root_m, "w") as fp:
+            fp.write(
+                """
+<manifest>
+  <remote name="test-remote" fetch="http://localhost" />
+  <default remote="test-remote" revision="refs/heads/main" />
+  <include name="stable.xml" revision="stable-branch" />
+  <project name="root-name1" path="root-path1" />
+  <project name="root-name2" path="root-path2" />
+</manifest>
+"""
+            )
+        with open(os.path.join(self.manifest_dir, "stable.xml"), "w") as fp:
+            fp.write(
+                """
+<manifest>
+  <project name="stable-name1" path="stable-path1" />
+  <project name="stable-name2" path="stable-path2" revision="stable-branch2" />
+</manifest>
+"""
+            )
+        include_m = manifest_xml.XmlManifest(self.repodir, root_m)
+        for proj in include_m.projects:
+            if proj.name == "root-name1":
+                # Check include revision not set on root level proj.
+                self.assertNotEqual("stable-branch", proj.revisionExpr)
+            if proj.name == "root-name2":
+                # Check root proj revision not removed.
+                self.assertEqual("refs/heads/main", proj.revisionExpr)
+            if proj.name == "stable-name1":
+                # Check stable proj has inherited revision include node.
+                self.assertEqual("stable-branch", proj.revisionExpr)
+            if proj.name == "stable-name2":
+                # Check stable proj revision can override include node.
+                self.assertEqual("stable-branch2", proj.revisionExpr)
+
     def test_group_levels(self):
         root_m = os.path.join(self.manifest_dir, "root.xml")
         with open(root_m, "w") as fp: