"""Real dpkg lifecycle tests in disposable roots; run on Linux as root. No host /usr/bin links are changed. A PATH guard rejects unrooted alternatives calls. """ import os from pathlib import Path import subprocess import tempfile import unittest REPO = Path(__file__).resolve().parents[1] TOOLS = ('adsctl', 'ads-agent', 'ads-client', 'ads-usb') class DebCliTests(unittest.TestCase): def setUp(self): self.temp = tempfile.TemporaryDirectory(prefix='ads-deb-test-') self.addCleanup(self.temp.cleanup) self.base = Path(self.temp.name) self.root = self.base / 'root' for path in ('usr/bin', 'etc/alternatives', 'var/lib/dpkg/alternatives', 'var/log'): (self.root / path).mkdir(parents=True, exist_ok=True) (self.root / 'var/lib/dpkg/status').write_text('') guard = self.base / 'guard' guard.mkdir() script = guard / 'update-alternatives' script.write_text('#!/bin/sh\nset -eu\n[ "$1" = --root ] || exit 99\n[ "$2" = "'+str(self.root)+'" ] || exit 99\nexec /usr/bin/update-alternatives "$@"\n') script.chmod(0o755) self.env = dict(os.environ, PATH=str(guard)+':'+os.environ['PATH']) def run_command(self, args): result = subprocess.run(args, env=self.env, text=True, capture_output=True) self.assertEqual(result.returncode, 0, f'{args}\n{result.stdout}\n{result.stderr}') return result.stdout def package(self, kind, version='0.2.4', legacy=False): name = 'ads-'+kind tree = self.base / (name+'-'+version) control = tree / 'DEBIAN' control.mkdir(parents=True, exist_ok=True) (control / 'control').write_text(f'Package: {name}\nVersion: {version}\nArchitecture: all\nMaintainer: ADS test\nDescription: isolated CLI lifecycle fixture\n') tools = TOOLS if kind != 'agent' else TOOLS[:2] for tool in tools: binary = tree / 'opt/ttstd' / name / tool binary.parent.mkdir(parents=True, exist_ok=True) binary.write_text('#!/bin/sh\necho '+name+' '+version+'\n') binary.chmod(0o755) if legacy: entry = tree / 'usr/bin' entry.mkdir(parents=True) (entry / 'ads-agent').write_text('#!/bin/sh\nexec /opt/ttstd/ads-agent/ads-agent "$@"\n') (entry / 'ads-agent').chmod(0o755) (entry / 'adsctl').symlink_to('/opt/ttstd/ads-agent/adsctl') else: template = (REPO / 'deploy/deb-cli-links.sh').read_text() priority = {'agent':80, 'avalonia':60, 'flutter':50}[kind] for hook in ('postinst', 'prerm', 'postrm'): target = control / hook target.write_text(template.replace('@PACKAGE@',name).replace('@PRIORITY@',str(priority)).replace('@HOOK@',hook)) target.chmod(0o755) (control / 'triggers').write_text('interest-noawait /usr/bin/adsctl\ninterest-noawait /usr/bin/ads-agent\n') output = self.base / (name+'-'+version+'.deb') self.run_command(['dpkg-deb','--root-owner-group','--build',str(tree),str(output)]) return output def dpkg(self, *args): return self.run_command(['dpkg','--root='+str(self.root),'--force-script-chrootless',*map(str,args)]) def target(self, tool): current = self.root / 'usr/bin' / tool for _ in range(8): if not current.is_symlink(): return current if current.is_file() else None link = os.readlink(current) current = self.root / link.lstrip('/') if link.startswith('/') else current.parent / link self.fail('symlink loop: '+tool) def assert_provider(self, tool, kind): self.assertEqual(self.target(tool),self.root / 'opt/ttstd' / ('ads-'+kind) / tool) def assert_no_entry(self, tool): self.assertFalse(os.path.lexists(self.root / 'usr/bin' / tool), 'Stale public link: '+tool) self.assertFalse(os.path.lexists(self.root / 'etc/alternatives' / tool), 'Stale alternatives link: '+tool) def test_desktop_coinstall_manual_choice_and_removal(self): desktop = self.package('avalonia') agent = self.package('agent') self.dpkg('-i',desktop) for tool in TOOLS: self.assert_provider(tool,'avalonia') self.dpkg('-i',desktop) # Reinstallation is idempotent. self.dpkg('-i',agent) self.assert_provider('adsctl','agent') self.assert_provider('ads-client','avalonia') self.run_command(['/usr/bin/update-alternatives','--root',str(self.root),'--set','adsctl','/opt/ttstd/ads-avalonia/adsctl']) self.dpkg('-i',agent) self.assert_provider('adsctl','avalonia') # Preserve manual selection. self.dpkg('-r','ads-avalonia') self.assert_provider('adsctl','agent') self.assert_provider('ads-agent','agent') self.assert_no_entry('ads-client') self.assert_no_entry('ads-usb') self.dpkg('--purge','ads-agent') for tool in TOOLS: self.assert_no_entry(tool) def test_legacy_agent_removal_restores_desktop_links(self): self.dpkg('-i',self.package('agent','0.2.3',legacy=True)) self.dpkg('-i',self.package('avalonia')) self.dpkg('-r','ads-agent') for tool in TOOLS: self.assert_provider(tool,'avalonia') def test_legacy_agent_upgrade_and_fallback(self): self.dpkg('-i',self.package('agent','0.2.3',legacy=True)) self.dpkg('-i',self.package('avalonia')) self.dpkg('-i',self.package('agent')) self.assert_provider('adsctl','agent') self.assert_provider('ads-agent','agent') self.dpkg('-r','ads-agent') for tool in TOOLS: self.assert_provider(tool,'avalonia') def test_flutter_and_avalonia_link_fallback(self): self.dpkg('-i',self.package('flutter')) self.dpkg('-i',self.package('avalonia')) for tool in TOOLS: self.assert_provider(tool,'avalonia') self.dpkg('--purge','ads-avalonia') for tool in TOOLS: self.assert_provider(tool,'flutter') @unittest.skipUnless(os.environ.get('ADS_DEB_PACKAGE_DIR'), 'Real release packages not supplied') def test_real_release_packages(self): folder=Path(os.environ['ADS_DEB_PACKAGE_DIR']) version=os.environ.get('ADS_DEB_VERSION','0.2.4') kind=os.environ.get('ADS_DEB_DESKTOP_KIND','avalonia') self.dpkg('--force-depends','-i',folder/f'ads-{kind}_{version}_amd64.deb') for tool in TOOLS: self.assert_provider(tool,kind) self.assertIn(version,self.run_command([str(self.target(tool)),'--version'])) if kind=='flutter': payload=self.root/'opt/ttstd/ads-flutter' self.assertTrue((self.root/'usr/share/applications/com.ttstd.ads.ads_manager.desktop').is_file()) tools=payload/'tools/scrcpy' if tools.is_dir(): self.assertIn('Android Debug Bridge',self.run_command([str(tools/'adb'),'version'])) self.assertIn('scrcpy',self.run_command([str(tools/'scrcpy'),'--version'])) self.dpkg('--force-depends','-i',folder/f'ads-agent_{version}_amd64.deb') self.assert_provider('adsctl','agent') self.dpkg('-r','ads-agent') for tool in TOOLS: self.assert_provider(tool,kind) self.dpkg('--purge','ads-'+kind) for tool in TOOLS: self.assert_no_entry(tool) def test_existing_real_local_command_is_not_overwritten(self): custom = self.root / 'usr/bin/ads-client' custom.write_text('local custom command') self.dpkg('-i',self.package('avalonia')) self.assertEqual(custom.read_text(),'local custom command') self.dpkg('--purge','ads-avalonia') self.assertEqual(custom.read_text(),'local custom command') if __name__ == '__main__': if os.name != 'posix' or os.geteuid() != 0: raise SystemExit('Run in Linux as root; all dpkg operations use disposable roots') unittest.main(verbosity=2)