diff options
Diffstat (limited to 'pw_build/py/gn_utils_test.py')
-rw-r--r-- | pw_build/py/gn_utils_test.py | 351 |
1 files changed, 351 insertions, 0 deletions
diff --git a/pw_build/py/gn_utils_test.py b/pw_build/py/gn_utils_test.py new file mode 100644 index 000000000..ee7f59979 --- /dev/null +++ b/pw_build/py/gn_utils_test.py @@ -0,0 +1,351 @@ +# Copyright 2023 The Pigweed Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); you may not +# use this file except in compliance with the License. You may obtain a copy of +# the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations under +# the License. +"""Tests for the pw_build.gn_utils module.""" + +import unittest + +from pw_build.gn_utils import GnLabel, GnPath, GnVisibility + + +class TestGnPath(unittest.TestCase): + """Tests for gn_utils.GnPath.""" + + def test_from_bazel(self): + """Tests creating a GN path from a Bazel string.""" + path = GnPath('$dir_3p_test', bazel='//foo:bar/baz.txt') + self.assertEqual(path.file(), 'baz.txt') + self.assertEqual(path.name(), 'baz') + self.assertEqual(path.extension(), 'txt') + self.assertEqual(path.dir(), '$dir_3p_test/foo/bar') + + def test_from_gn(self): + """Tests creating a GN path from a GN string.""" + path = GnPath('$dir_3p_test', gn='foo/bar/baz.txt') + self.assertEqual(path.file(), 'baz.txt') + self.assertEqual(path.name(), 'baz') + self.assertEqual(path.extension(), 'txt') + self.assertEqual(path.dir(), '$dir_3p_test/foo/bar') + + def test_from_str(self): + """Tests creating a GN path from a raw string.""" + path = GnPath('$dir_3p_test/foo/bar/baz.txt') + self.assertEqual(path.file(), 'baz.txt') + self.assertEqual(path.name(), 'baz') + self.assertEqual(path.extension(), 'txt') + self.assertEqual(path.dir(), '$dir_3p_test/foo/bar') + + +class TestGnLabel(unittest.TestCase): + """Tests for gn_utils.GnLabel.""" + + def test_from_bazel_with_name(self): + """Tests creating a GN label from a Bazel string including a name.""" + label = GnLabel('$dir_3p/test', bazel='//foo/bar:baz') + self.assertEqual(label.name(), 'baz') + self.assertEqual(label.dir(), '$dir_3p/test/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_3p/test/foo/bar:baz') + self.assertEqual( + label.with_toolchain(), + '$dir_3p/test/foo/bar:baz(default_toolchain)', + ) + self.assertFalse(label.repo()) + + def test_from_bazel_without_name(self): + """Tests creating a GN label from a Bazel string without a name.""" + label = GnLabel('$dir_3p/test', bazel='//foo/bar') + self.assertEqual(label.name(), 'bar') + self.assertEqual(label.dir(), '$dir_3p/test/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_3p/test/foo/bar') + self.assertEqual( + label.with_toolchain(), '$dir_3p/test/foo/bar(default_toolchain)' + ) + self.assertFalse(label.repo()) + + def test_from_bazel_with_external_repo(self): + """Tests creating a GN label from a Bazel string with a repo.""" + label = GnLabel('$dir_3p/test', bazel='@com_corp_project//foo/bar:baz') + self.assertEqual(label.name(), 'baz') + self.assertEqual(label.dir(), '$repo/foo/bar') + self.assertEqual(label.no_toolchain(), '$repo/foo/bar:baz') + self.assertEqual( + label.with_toolchain(), + '$repo/foo/bar:baz(default_toolchain)', + ) + self.assertEqual(label.repo(), 'com_corp_project') + + def test_from_gn_absolute(self): + """Tests creating a GN label from an absolute GN label string.""" + label = GnLabel('$dir_3p/test', gn='//foo/bar:baz') + self.assertEqual(label.name(), 'baz') + self.assertEqual(label.dir(), '//foo/bar') + self.assertEqual(label.no_toolchain(), '//foo/bar:baz') + self.assertEqual( + label.with_toolchain(), '//foo/bar:baz(default_toolchain)' + ) + + def test_from_gn_with_variable(self): + """Tests creating a GN label from a GN string with a variable.""" + label = GnLabel('$dir_3p/test', gn='$dir_pw_build/foo/bar') + self.assertEqual(label.name(), 'bar') + self.assertEqual(label.dir(), '$dir_pw_build/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_pw_build/foo/bar') + self.assertEqual( + label.with_toolchain(), '$dir_pw_build/foo/bar(default_toolchain)' + ) + + def test_from_gn_relative(self): + """Tests creating a GN label from a relative GN label string.""" + label = GnLabel('$dir_3p/test', gn='foo/bar') + self.assertEqual(label.name(), 'bar') + self.assertEqual(label.dir(), '$dir_3p/test/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_3p/test/foo/bar') + self.assertEqual( + label.with_toolchain(), '$dir_3p/test/foo/bar(default_toolchain)' + ) + + def test_from_gn_with_dotdot(self): + """Tests creating a GN label from a GN string that ascends the tree.""" + label = GnLabel('$dir_3p/test', gn='../../../foo/../bar') + self.assertEqual(label.name(), 'bar') + self.assertEqual(label.dir(), '../bar') + self.assertEqual(label.no_toolchain(), '../bar') + self.assertEqual(label.with_toolchain(), '../bar(default_toolchain)') + + def test_from_str_with_name(self): + """Tests creating a GN label from a raw string with a target name.""" + label = GnLabel('$dir_3p/test/foo/bar:baz') + self.assertEqual(label.name(), 'baz') + self.assertEqual(label.dir(), '$dir_3p/test/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_3p/test/foo/bar:baz') + self.assertEqual( + label.with_toolchain(), + '$dir_3p/test/foo/bar:baz(default_toolchain)', + ) + + def test_from_str_without_name(self): + """Tests creating a GN label from a raw string without a name.""" + label = GnLabel('$dir_3p/test/foo/bar') + self.assertEqual(label.name(), 'bar') + self.assertEqual(label.dir(), '$dir_3p/test/foo/bar') + self.assertEqual(label.no_toolchain(), '$dir_3p/test/foo/bar') + self.assertEqual( + label.with_toolchain(), '$dir_3p/test/foo/bar(default_toolchain)' + ) + + def test_relative_to_with_name(self): + """Tests creating a relative label from a GN label with a name.""" + label = GnLabel('$dir_3p/foo/bar:baz') + self.assertEqual(label.relative_to('$dir_3p'), 'foo/bar:baz') + self.assertEqual(label.relative_to('$dir_3p/foo'), 'bar:baz') + self.assertEqual(label.relative_to('$dir_3p/foo/bar'), ':baz') + self.assertEqual(label.relative_to('$dir_3p/bar'), '../foo/bar:baz') + self.assertEqual(label.relative_to('//'), '$dir_3p/foo/bar:baz') + self.assertEqual(label.relative_to('$other'), '$dir_3p/foo/bar:baz') + + def test_relative_to_without_name(self): + """Tests creating a relative label from a GN label without a name.""" + label = GnLabel('$dir_3p/foo/bar') + self.assertEqual(label.relative_to('$dir_3p/foo/bar'), ':bar') + + def test_relative_to_absolute_with_name(self): + """Tests creating a relative label from a named absolute GN label.""" + label = GnLabel('//foo/bar:baz') + self.assertEqual(label.relative_to('//'), 'foo/bar:baz') + self.assertEqual(label.relative_to('//bar/baz'), '../../foo/bar:baz') + + def test_relative_to_absolute_without_name(self): + """Tests creating a relative label from an unnamed absolute GN label.""" + label = GnLabel('//foo/bar') + self.assertEqual(label.relative_to('//foo/bar'), ':bar') + + def test_resolve_repo_without_repo(self): + """Tests trying to set the repo placeholder for a local label.""" + label = GnLabel('$dir_3p/test', bazel='//foo/bar:baz') + self.assertEqual(str(label), '$dir_3p/test/foo/bar:baz') + self.assertFalse(label.repo()) + label.resolve_repo('my-external_repo') + self.assertEqual(str(label), '$dir_3p/test/foo/bar:baz') + self.assertFalse(label.repo()) + + def test_resolve_repowith_repo(self): + """Tests setting the repo placeholder.""" + label = GnLabel('$dir_3p/test', bazel='@com_corp_project//foo/bar:baz') + self.assertEqual(str(label), '$repo/foo/bar:baz') + self.assertEqual(label.repo(), 'com_corp_project') + label.resolve_repo('my-external_repo') + self.assertEqual( + str(label), '$dir_pw_third_party/my-external_repo/foo/bar:baz' + ) + self.assertEqual(label.repo(), 'com_corp_project') + + +class TestGnVisibility(unittest.TestCase): + """Tests for gn_utils.GnVisibility.""" + + def test_from_bazel_public(self): + """Tests creating a public visibility scope from a Bazel string.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//visibility:public' + ) + self.assertEqual(str(scope), '//*') + + def test_from_bazel_private(self): + """Tests creating a private visibility scope from a Bazel string.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//visibility:private' + ) + self.assertEqual(str(scope), '$dir_3p/test/foo:*') + + def test_from_bazel_same_subpackage(self): + """Tests creating a visibility for the same subpackage.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//foo:__subpackages__' + ) + self.assertEqual(str(scope), '$dir_3p/test/foo/*') + + def test_from_bazel_same_package(self): + """Tests creating a visibility for the same package.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//foo:__pkg__' + ) + self.assertEqual(str(scope), '$dir_3p/test/foo:*') + + def test_from_bazel_other_subpackages(self): + """Tests creating a visibility for a different subpackage.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//bar:__subpackages__' + ) + self.assertEqual(str(scope), '$dir_3p/test/bar/*') + + def test_from_bazel_other_package(self): + """Tests creating a visibility for a different package.""" + scope = GnVisibility( + '$dir_3p/test', '$dir_3p/test/foo', bazel='//bar:__pkg__' + ) + self.assertEqual(str(scope), '$dir_3p/test/bar:*') + + def test_from_gn_relative(self): + """Tests creating a visibility from a relative GN string.""" + scope = GnVisibility('$dir_3p/test', '$dir_3p/test/foo', gn=':*') + self.assertEqual(str(scope), '$dir_3p/test/foo:*') + + def test_from_gn_with_dotdot(self): + """Tests creating a visibility from a string that ascends the tree.""" + scope = GnVisibility('$dir_3p/test', '$dir_3p/test/foo', gn='../*') + self.assertEqual(str(scope), '$dir_3p/test/*') + + def test_from_gn_absolute(self): + """Tests creating a visibility from an absolute GN string.""" + scope = GnVisibility('$dir_3p/test', '$dir_3p/test/foo', gn='$dir_3p/*') + self.assertEqual(str(scope), '$dir_3p/*') + + def test_from_str(self): + """Tests creating a visibility from a raw string.""" + scope = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + self.assertEqual(str(scope), '$dir_3p/test/foo/bar:*') + + def test_within_equal_discrete(self): + """Tests that two equal, discrete visibilities are within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:baz') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:baz') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope2.within(scope1)) + + def test_within_equal_globbed(self): + """Tests that two equal, globbed visibilities are within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope2.within(scope1)) + + def test_within_equal_subtree(self): + """Tests that two equal, subtree visibilities are within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar/*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar/*') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope2.within(scope1)) + + def test_within_not_equal_both_discrete(self): + """Tests that two unrelated visibilities are not within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:baz') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:qux') + self.assertFalse(scope1.within(scope2)) + self.assertFalse(scope2.within(scope1)) + + def test_within_not_equal_both_globbed(self): + """Tests that two unrelated visibilities are not within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/baz:*') + self.assertFalse(scope1.within(scope2)) + self.assertFalse(scope2.within(scope1)) + + def test_within_not_equal_both_subtree(self): + """Tests that two unrelated visibilities are not within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar/*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/baz/*') + self.assertFalse(scope1.within(scope2)) + self.assertFalse(scope2.within(scope1)) + + def test_within_subset_discrete_in_globbed(self): + """Tests a discrete visibility that is within a globbed one.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:baz') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + self.assertTrue(scope1.within(scope2)) + self.assertFalse(scope2.within(scope1)) + + def test_within_subset_discrete_in_subtree(self): + """Tests a discrete visibility that is within a subtree.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:baz') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/*') + public_scope = GnVisibility('$dir_3p/test', '//*') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope1.within(public_scope)) + self.assertFalse(scope2.within(scope1)) + self.assertFalse(public_scope.within(scope1)) + + def test_within_subset_globbed_in_subtree(self): + """Tests a globbed visibility that is within a subtree.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar:*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/*') + public_scope = GnVisibility('$dir_3p/test', '//*') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope1.within(public_scope)) + self.assertFalse(scope2.within(scope1)) + self.assertFalse(public_scope.within(scope1)) + + def test_within_subset_subtree_in_subtree(self): + """Tests a subtree visibility that is within a subtree.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/bar/*') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/*') + public_scope = GnVisibility('$dir_3p/test', '//*') + self.assertTrue(scope1.within(scope2)) + self.assertTrue(scope1.within(public_scope)) + self.assertFalse(scope2.within(scope1)) + self.assertFalse(public_scope.within(scope1)) + + def test_within_disjoint(self): + """Tests that disjoint visibilities are not within each other.""" + scope1 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo:bar') + scope2 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/baz:*') + scope3 = GnVisibility('$dir_3p/test', '$dir_3p/test/foo/qux/*') + self.assertFalse(scope1.within(scope2)) + self.assertFalse(scope1.within(scope3)) + self.assertFalse(scope2.within(scope1)) + self.assertFalse(scope2.within(scope3)) + self.assertFalse(scope3.within(scope1)) + self.assertFalse(scope3.within(scope2)) + + +if __name__ == '__main__': + unittest.main() |