# -*- coding:utf-8 -*- # # Copyright (C) 2015 The Android Open Source Project # # 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 # # http://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. """Unittests for the wrapper.py module.""" from __future__ import print_function import os import re import shutil import tempfile import unittest from pyversion import is_python3 import wrapper if is_python3(): from unittest import mock from io import StringIO else: import mock from StringIO import StringIO def fixture(*paths): """Return a path relative to tests/fixtures. """ return os.path.join(os.path.dirname(__file__), 'fixtures', *paths) class RepoWrapperTestCase(unittest.TestCase): """TestCase for the wrapper module.""" def setUp(self): """Load the wrapper module every time.""" wrapper._wrapper_module = None self.wrapper = wrapper.Wrapper() if not is_python3(): self.assertRegex = self.assertRegexpMatches class RepoWrapperUnitTest(RepoWrapperTestCase): """Tests helper functions in the repo wrapper """ def test_version(self): """Make sure _Version works.""" with self.assertRaises(SystemExit) as e: with mock.patch('sys.stdout', new_callable=StringIO) as stdout: with mock.patch('sys.stderr', new_callable=StringIO) as stderr: self.wrapper._Version() self.assertEqual(0, e.exception.code) self.assertEqual('', stderr.getvalue()) self.assertIn('repo launcher version', stdout.getvalue()) def test_init_parser(self): """Make sure 'init' GetParser works.""" parser = self.wrapper.GetParser(gitc_init=False) opts, args = parser.parse_args([]) self.assertEqual([], args) self.assertIsNone(opts.manifest_url) def test_gitc_init_parser(self): """Make sure 'gitc-init' GetParser works.""" parser = self.wrapper.GetParser(gitc_init=True) opts, args = parser.parse_args([]) self.assertEqual([], args) self.assertIsNone(opts.manifest_file) def test_get_gitc_manifest_dir_no_gitc(self): """ Test reading a missing gitc config file """ self.wrapper.GITC_CONFIG_FILE = fixture('missing_gitc_config') val = self.wrapper.get_gitc_manifest_dir() self.assertEqual(val, '') def test_get_gitc_manifest_dir(self): """ Test reading the gitc config file and parsing the directory """ self.wrapper.GITC_CONFIG_FILE = fixture('gitc_config') val = self.wrapper.get_gitc_manifest_dir() self.assertEqual(val, '/test/usr/local/google/gitc') def test_gitc_parse_clientdir_no_gitc(self): """ Test parsing the gitc clientdir without gitc running """ self.wrapper.GITC_CONFIG_FILE = fixture('missing_gitc_config') self.assertEqual(self.wrapper.gitc_parse_clientdir('/something'), None) self.assertEqual(self.wrapper.gitc_parse_clientdir('/gitc/manifest-rw/test'), 'test') def test_gitc_parse_clientdir(self): """ Test parsing the gitc clientdir """ self.wrapper.GITC_CONFIG_FILE = fixture('gitc_config') self.assertEqual(self.wrapper.gitc_parse_clientdir('/something'), None) self.assertEqual(self.wrapper.gitc_parse_clientdir('/gitc/manifest-rw/test'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/gitc/manifest-rw/test/'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/gitc/manifest-rw/test/extra'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/test/usr/local/google/gitc/test'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/test/usr/local/google/gitc/test/'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/test/usr/local/google/gitc/test/extra'), 'test') self.assertEqual(self.wrapper.gitc_parse_clientdir('/gitc/manifest-rw/'), None) self.assertEqual(self.wrapper.gitc_parse_clientdir('/test/usr/local/google/gitc/'), None) class SetGitTrace2ParentSid(RepoWrapperTestCase): """Check SetGitTrace2ParentSid behavior.""" KEY = 'GIT_TRACE2_PARENT_SID' VALID_FORMAT = re.compile(r'^repo-[0-9]{8}T[0-9]{6}Z-P[0-9a-f]{8}$') def test_first_set(self): """Test env var not yet set.""" env = {} self.wrapper.SetGitTrace2ParentSid(env) self.assertIn(self.KEY, env) value = env[self.KEY] self.assertRegex(value, self.VALID_FORMAT) def test_append(self): """Test env var is appended.""" env = {self.KEY: 'pfx'} self.wrapper.SetGitTrace2ParentSid(env) self.assertIn(self.KEY, env) value = env[self.KEY] self.assertTrue(value.startswith('pfx/')) self.assertRegex(value[4:], self.VALID_FORMAT) def test_global_context(self): """Check os.environ gets updated by default.""" os.environ.pop(self.KEY, None) self.wrapper.SetGitTrace2ParentSid() self.assertIn(self.KEY, os.environ) value = os.environ[self.KEY] self.assertRegex(value, self.VALID_FORMAT) class RunCommand(RepoWrapperTestCase): """Check run_command behavior.""" def test_capture(self): """Check capture_output handling.""" ret = self.wrapper.run_command(['echo', 'hi'], capture_output=True) self.assertEqual(ret.stdout, 'hi\n') def test_check(self): """Check check handling.""" self.wrapper.run_command(['true'], check=False) self.wrapper.run_command(['true'], check=True) self.wrapper.run_command(['false'], check=False) with self.assertRaises(self.wrapper.RunError): self.wrapper.run_command(['false'], check=True) class RunGit(RepoWrapperTestCase): """Check run_git behavior.""" def test_capture(self): """Check capture_output handling.""" ret = self.wrapper.run_git('--version') self.assertIn('git', ret.stdout) def test_check(self): """Check check handling.""" with self.assertRaises(self.wrapper.CloneFailure): self.wrapper.run_git('--version-asdfasdf') self.wrapper.run_git('--version-asdfasdf', check=False) class ParseGitVersion(RepoWrapperTestCase): """Check ParseGitVersion behavior.""" def test_autoload(self): """Check we can load the version from the live git.""" ret = self.wrapper.ParseGitVersion() self.assertIsNotNone(ret) def test_bad_ver(self): """Check handling of bad git versions.""" ret = self.wrapper.ParseGitVersion(ver_str='asdf') self.assertIsNone(ret) def test_normal_ver(self): """Check handling of normal git versions.""" ret = self.wrapper.ParseGitVersion(ver_str='git version 2.25.1') self.assertEqual(2, ret.major) self.assertEqual(25, ret.minor) self.assertEqual(1, ret.micro) self.assertEqual('2.25.1', ret.full) def test_extended_ver(self): """Check handling of extended distro git versions.""" ret = self.wrapper.ParseGitVersion( ver_str='git version 1.30.50.696.g5e7596f4ac-goog') self.assertEqual(1, ret.major) self.assertEqual(30, ret.minor) self.assertEqual(50, ret.micro) self.assertEqual('1.30.50.696.g5e7596f4ac-goog', ret.full) class CheckGitVersion(RepoWrapperTestCase): """Check _CheckGitVersion behavior.""" def test_unknown(self): """Unknown versions should abort.""" with mock.patch.object(self.wrapper, 'ParseGitVersion', return_value=None): with self.assertRaises(self.wrapper.CloneFailure): self.wrapper._CheckGitVersion() def test_old(self): """Old versions should abort.""" with mock.patch.object( self.wrapper, 'ParseGitVersion', return_value=self.wrapper.GitVersion(1, 0, 0, '1.0.0')): with self.assertRaises(self.wrapper.CloneFailure): self.wrapper._CheckGitVersion() def test_new(self): """Newer versions should run fine.""" with mock.patch.object( self.wrapper, 'ParseGitVersion', return_value=self.wrapper.GitVersion(100, 0, 0, '100.0.0')): self.wrapper._CheckGitVersion() class ResolveRepoRev(RepoWrapperTestCase): """Check resolve_repo_rev behavior.""" GIT_DIR = None REV_LIST = None @classmethod def setUpClass(cls): # Create a repo to operate on, but do it once per-class. cls.GIT_DIR = tempfile.mkdtemp(prefix='repo-rev-tests') run_git = wrapper.Wrapper().run_git remote = os.path.join(cls.GIT_DIR, 'remote') os.mkdir(remote) run_git('init', cwd=remote) run_git('commit', '--allow-empty', '-minit', cwd=remote) run_git('branch', 'stable', cwd=remote) run_git('tag', 'v1.0', cwd=remote) run_git('commit', '--allow-empty', '-m2nd commit', cwd=remote) cls.REV_LIST = run_git('rev-list', 'HEAD', cwd=remote).stdout.splitlines() run_git('init', cwd=cls.GIT_DIR) run_git('fetch', remote, '+refs/heads/*:refs/remotes/origin/*', cwd=cls.GIT_DIR) @classmethod def tearDownClass(cls): if not cls.GIT_DIR: return shutil.rmtree(cls.GIT_DIR) def test_explicit_branch(self): """Check refs/heads/branch argument.""" rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, 'refs/heads/stable') self.assertEqual('refs/heads/stable', rrev) self.assertEqual(self.REV_LIST[1], lrev) with self.assertRaises(wrapper.CloneFailure): self.wrapper.resolve_repo_rev(self.GIT_DIR, 'refs/heads/unknown') def test_explicit_tag(self): """Check refs/tags/tag argument.""" rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, 'refs/tags/v1.0') self.assertEqual('refs/tags/v1.0', rrev) self.assertEqual(self.REV_LIST[1], lrev) with self.assertRaises(wrapper.CloneFailure): self.wrapper.resolve_repo_rev(self.GIT_DIR, 'refs/tags/unknown') def test_branch_name(self): """Check branch argument.""" rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, 'stable') self.assertEqual('refs/heads/stable', rrev) self.assertEqual(self.REV_LIST[1], lrev) rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, 'master') self.assertEqual('refs/heads/master', rrev) self.assertEqual(self.REV_LIST[0], lrev) def test_tag_name(self): """Check tag argument.""" rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, 'v1.0') self.assertEqual('refs/tags/v1.0', rrev) self.assertEqual(self.REV_LIST[1], lrev) def test_full_commit(self): """Check specific commit argument.""" commit = self.REV_LIST[0] rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, commit) self.assertEqual(commit, rrev) self.assertEqual(commit, lrev) def test_partial_commit(self): """Check specific (partial) commit argument.""" commit = self.REV_LIST[0][0:20] rrev, lrev = self.wrapper.resolve_repo_rev(self.GIT_DIR, commit) self.assertEqual(self.REV_LIST[0], rrev) self.assertEqual(self.REV_LIST[0], lrev) def test_unknown(self): """Check unknown ref/commit argument.""" with self.assertRaises(wrapper.CloneFailure): self.wrapper.resolve_repo_rev(self.GIT_DIR, 'boooooooya') if __name__ == '__main__': unittest.main()