from __future__ import annotations import contextlib import pathlib import re from collections import OrderedDict from collections.abc import ( Generator, ) from typing import ( Any, Iterable, Iterator, IO, ) from .debian import Changelog, PackageArchitecture, \ Version, _ControlFileDict from .utils import Templates class PackagesList(OrderedDict): def append(self, package) -> None: self[package['Package']] = package def extend(self, packages) -> None: for package in packages: self[package['Package']] = package def setdefault(self, package) -> Any: return super().setdefault(package['Package'], package) class Makefile: rules: dict[str, MakefileRule] def __init__(self) -> None: self.rules = {} def add_cmds(self, name: str, cmds) -> None: rule = self.rules.setdefault(name, MakefileRule(name)) rule.add_cmds(MakefileRuleCmdsSimple(cmds)) def add_deps(self, name: str, deps) -> None: rule = self.rules.setdefault(name, MakefileRule(name)) rule.add_deps(deps) for i in deps: self.rules.setdefault(i, MakefileRule(i)) def add_rules(self, name: str, target, makeflags, packages=set(), packages_extra=set()) -> None: rule = self.rules.setdefault(name, MakefileRule(name)) rule.add_cmds(MakefileRuleCmdsRules(target, makeflags, packages, packages_extra)) def write(self, out) -> None: out.write('''\ .NOTPARALLEL: .PHONY: packages_enabled := $(shell dh_listpackages) define if_package $(if $(filter $(1),$(packages_enabled)),$(2)) endef ''') for k, rule in sorted(self.rules.items()): rule.write(out) class MakefileRule: name: str cmds: list[MakefileRuleCmds] deps: set[str] def __init__(self, name: str) -> None: self.name = name self.cmds = [] self.deps = set() def add_cmds(self, cmds: MakefileRuleCmds) -> None: self.cmds.append(cmds) def add_deps(self, deps: Iterable[str]) -> None: self.deps.update(deps) def write(self, out: IO) -> None: if self.cmds: out.write(f'{self.name}:{" ".join(sorted(self.deps))}\n') for c in self.cmds: c.write(out) else: out.write(f'{self.name}:{" ".join(sorted(self.deps))}\n') class MakefileRuleCmds: def write(self, out: IO) -> None: raise NotImplementedError class MakefileRuleCmdsRules(MakefileRuleCmds): def __init__(self, target, makeflags, packages, packages_extra) -> None: self.target = target self.makeflags = makeflags.copy() self.packages = packages self.packages_extra = packages_extra packages_all = packages | packages_extra if packages_all: if len(packages_all) == 1: package_name = list(packages_all)[0] self.makeflags['PACKAGE_NAME'] = package_name self.makeflags['DESTDIR'] = f'$(CURDIR)/debian/{package_name}' else: self.makeflags['DESTDIR'] = '$(CURDIR)/debian/tmp' self.makeflags['DH_OPTIONS'] = ' '.join(f'-p{i}' for i in sorted(packages_all)) def write(self, out: IO) -> None: cmd = f'$(MAKE) -f debian/rules.real {self.target} {self.makeflags}' if self.packages: out.write(f'\t$(call if_package, {" ".join(sorted(self.packages))}, {cmd})\n') else: out.write(f'\t{cmd}\n') class MakefileRuleCmdsSimple(MakefileRuleCmds): cmds: list[str] def __init__(self, cmds: list[str]) -> None: self.cmds = cmds def write(self, out: IO) -> None: for i in self.cmds: out.write(f'\t{i}\n') class MakeFlags(dict): def __str__(self) -> str: return ' '.join("%s='%s'" % i for i in sorted(self.items())) def copy(self) -> MakeFlags: return self.__class__(super(MakeFlags, self).copy()) class PackagesBundle: name: str | None templates: Templates base: pathlib.Path makefile: Makefile packages: PackagesList def __init__( self, name: str | None, templates: Templates, base: pathlib.Path = pathlib.Path('debian'), ) -> None: self.name = name self.templates = templates self.base = base self.makefile = Makefile() self.packages = PackagesList() def add( self, pkgid: str, ruleid: Iterable[str], makeflags: MakeFlags, replace: dict[str, str], *, arch: str | None = None, check_packages: bool = True, ) -> list[Any]: ret = [] for raw_package in self.templates.get_control(f'{pkgid}.control', replace): package = self.packages.setdefault(raw_package) package_name = package['Package'] ret.append(package) package.meta.setdefault('rules-ruleids', {})[ruleid] = makeflags if arch: package.meta.setdefault('architectures', PackageArchitecture()).add(arch) package.meta['rules-check-packages'] = check_packages for name in ( 'NEWS', 'bug-presubj', 'lintian-overrides', 'maintscript', 'postinst', 'postrm', 'preinst', 'prerm', ): try: template = self.templates.get(f'{pkgid}.{name}', replace | {'package': package_name}) except KeyError: pass else: with self.open(f'{package_name}.{name}') as f: f.write(template) return ret def add_packages( self, packages: Iterable[_ControlFileDict], ruleid: Iterable[str], makeflags: MakeFlags, *, arch: str | None = None, check_packages: bool = True, ) -> None: for package in packages: package = self.packages.setdefault(package) package.meta.setdefault('rules-ruleids', {})[ruleid] = makeflags if arch: package.meta.setdefault('architectures', PackageArchitecture()).add(arch) package.meta['rules-check-packages'] = check_packages def path(self, name) -> pathlib.Path: if self.name: return self.base / f'generated.{self.name}/{name}' return self.base / name @staticmethod def __ruleid_deps(ruleid: tuple[str], name: str) -> Iterator[tuple[str, str]]: """ Generate all the rules dependencies. ``` build: build_a build_a: build_a_b build_a_b: build_a_b_image ``` """ r = ruleid + (name, ) yield ( '', '_' + '_'.join(r[:1]), ) for i in range(1, len(r)): yield ( '_' + '_'.join(r[:i]), '_' + '_'.join(r[:i + 1]), ) @contextlib.contextmanager def open(self, name: str, mode: str = 'w') -> Generator[IO, None, None]: path = self.path(name) path.parent.mkdir(parents=True, exist_ok=True) with path.open(mode=mode, encoding='utf-8') as f: yield f def extract_makefile(self) -> None: targets: dict[frozenset[str], dict] = {} for package_name, package in self.packages.items(): target_name = package.meta.get('rules-target') ruleids = package.meta.get('rules-ruleids') makeflags = MakeFlags({ # Requires Python 3.9+ k.removeprefix('rules-makeflags-').upper(): v for (k, v) in package.meta.items() if k.startswith('rules-makeflags-') }) if ruleids: arches = package.meta.get('architectures') if arches: package['Architecture'] = arches else: arches = package.get('Architecture') if target_name: for ruleid, makeflags_package in ruleids.items(): target_key = frozenset( [target_name, ruleid] + [f'{k}_{v}' for (k, v) in makeflags.items()] ) target = targets.setdefault( target_key, { 'name': target_name, 'ruleid': ruleid, }, ) if package.meta['rules-check-packages']: target.setdefault('packages', set()).add(package_name) else: target.setdefault('packages_extra', set()).add(package_name) makeflags_package = makeflags_package.copy() makeflags_package.update(makeflags) target['makeflags'] = makeflags_package if arches == set(['all']): target['type'] = 'indep' else: target['type'] = 'arch' for target in targets.values(): name = target['name'] ruleid = target['ruleid'] packages = target.get('packages', set()) packages_extra = target.get('packages_extra', set()) makeflags = target['makeflags'] ttype = target['type'] rule = '_'.join(ruleid + (name, )) self.makefile.add_rules(f'setup_{rule}', f'setup_{name}', makeflags, packages, packages_extra) self.makefile.add_rules(f'build-{ttype}_{rule}', f'build_{name}', makeflags, packages, packages_extra) self.makefile.add_rules(f'binary-{ttype}_{rule}', f'binary_{name}', makeflags, packages, packages_extra) for i, j in self.__ruleid_deps(ruleid, name): self.makefile.add_deps(f'setup{i}', [f'setup{j}']) self.makefile.add_deps(f'build-{ttype}{i}', [f'build-{ttype}{j}']) self.makefile.add_deps(f'binary-{ttype}{i}', [f'binary-{ttype}{j}']) def merge_build_depends(self) -> None: # Merge Build-Depends pseudo-fields from binary packages into the # source package source = self.packages["source"] arch_all = PackageArchitecture("all") for name, package in self.packages.items(): if name == "source": continue dep = package.get("Build-Depends") if not dep: continue del package["Build-Depends"] if package["Architecture"] == arch_all: dep_type = "Build-Depends-Indep" else: dep_type = "Build-Depends-Arch" for group in dep: for item in group: if package["Architecture"] != arch_all and not item.arches: item.arches = package["Architecture"] if package.get("Build-Profiles") and not item.restrictions: item.restrictions = package["Build-Profiles"] source.setdefault(dep_type).merge(group) def write(self) -> None: self.write_control() self.write_makefile() def write_control(self) -> None: with self.open('control') as f: self.write_rfc822(f, self.packages.values()) def write_makefile(self) -> None: with self.open('rules.gen') as f: self.makefile.write(f) def write_rfc822(self, f: IO, entries: Iterable) -> None: for entry in entries: for key, value in entry.items(): if value: f.write(u"%s: %s\n" % (key, value)) f.write('\n') def iter_featuresets(config) -> Iterable[str]: for featureset in config['base', ]['featuresets']: if config.merge('base', None, featureset).get('enabled', True): yield featureset def iter_arches(config) -> Iterable[str]: return iter(config['base', ]['arches']) def iter_arch_featuresets(config, arch) -> Iterable[str]: for featureset in config['base', arch].get('featuresets', []): if config.merge('base', arch, featureset).get('enabled', True): yield featureset def iter_flavours(config, arch, featureset) -> Iterable[str]: return iter(config['base', arch, featureset]['flavours']) class Gencontrol(object): vars: dict[str, str] bundles: dict[str, PackagesBundle] def __init__(self, config, templates, version=Version) -> None: self.config, self.templates = config, templates self.changelog = Changelog(version=version) self.vars = {} self.bundles = {'': PackagesBundle(None, templates)} @property def bundle(self) -> PackagesBundle: return self.bundles[''] def __call__(self) -> None: self.do_source() self.do_main() self.do_extra() self.write() def do_source(self) -> None: source = self.templates.get_source_control("source.control", self.vars)[0] if not source.get('Source'): source['Source'] = self.changelog[0].source self.bundle.packages['source'] = source def do_main(self) -> None: vars = self.vars.copy() makeflags = MakeFlags() self.do_main_setup(vars, makeflags) self.do_main_makefile(makeflags) self.do_main_packages(vars, makeflags) self.do_main_recurse(vars, makeflags) def do_main_setup(self, vars, makeflags) -> None: pass def do_main_makefile(self, makeflags) -> None: pass def do_main_packages(self, vars, makeflags) -> None: pass def do_main_recurse(self, vars, makeflags) -> None: for featureset in iter_featuresets(self.config): self.do_indep_featureset(featureset, vars.copy(), makeflags.copy()) for arch in iter_arches(self.config): self.do_arch(arch, vars.copy(), makeflags.copy()) def do_extra(self) -> None: try: packages_extra = self.templates.get_control("extra.control", self.vars) except KeyError: return extra_arches: dict[str, Any] = {} for package in packages_extra: arches = package['Architecture'] for arch in arches: i = extra_arches.get(arch, []) i.append(package) extra_arches[arch] = i for arch in sorted(extra_arches.keys()): self.bundle.add_packages(packages_extra, (arch, ), MakeFlags(), check_packages=False) def do_indep_featureset(self, featureset, vars, makeflags) -> None: vars['localversion'] = '' if featureset != 'none': vars['localversion'] = '-' + featureset self.do_indep_featureset_setup(vars, makeflags, featureset) self.do_indep_featureset_makefile(featureset, makeflags) self.do_indep_featureset_packages(featureset, vars, makeflags) def do_indep_featureset_setup(self, vars, makeflags, featureset) -> None: pass def do_indep_featureset_makefile(self, featureset, makeflags) -> None: makeflags['FEATURESET'] = featureset def do_indep_featureset_packages(self, featureset, vars, makeflags) -> None: pass def do_arch(self, arch, vars, makeflags) -> None: vars['arch'] = arch self.do_arch_setup(vars, makeflags, arch) self.do_arch_makefile(arch, makeflags) self.do_arch_packages(arch, vars, makeflags) self.do_arch_recurse(arch, vars, makeflags) def do_arch_setup(self, vars, makeflags, arch) -> None: pass def do_arch_makefile(self, arch, makeflags) -> None: makeflags['ARCH'] = arch def do_arch_packages(self, arch, vars, makeflags) -> None: pass def do_arch_recurse(self, arch, vars, makeflags) -> None: for featureset in iter_arch_featuresets(self.config, arch): self.do_featureset(arch, featureset, vars.copy(), makeflags.copy()) def do_featureset(self, arch, featureset, vars, makeflags) -> None: vars['localversion'] = '' if featureset != 'none': vars['localversion'] = '-' + featureset self.do_featureset_setup(vars, makeflags, arch, featureset) self.do_featureset_makefile(arch, featureset, makeflags) self.do_featureset_packages(arch, featureset, vars, makeflags) self.do_featureset_recurse(arch, featureset, vars, makeflags) def do_featureset_setup(self, vars, makeflags, arch, featureset) -> None: pass def do_featureset_makefile(self, arch, featureset, makeflags) -> None: makeflags['FEATURESET'] = featureset def do_featureset_packages(self, arch, featureset, vars, makeflags) -> None: pass def do_featureset_recurse(self, arch, featureset, vars, makeflags) -> None: for flavour in iter_flavours(self.config, arch, featureset): self.do_flavour(arch, featureset, flavour, vars.copy(), makeflags.copy()) def do_flavour(self, arch, featureset, flavour, vars, makeflags): vars['localversion'] += '-' + flavour self.do_flavour_setup(vars, makeflags, arch, featureset, flavour) self.do_flavour_makefile(arch, featureset, flavour, makeflags) self.do_flavour_packages(arch, featureset, flavour, vars, makeflags) def do_flavour_setup(self, vars, makeflags, arch, featureset, flavour) -> None: for i in ( ('kernel-arch', 'KERNEL_ARCH'), ('localversion', 'LOCALVERSION'), ): if i[0] in vars: makeflags[i[1]] = vars[i[0]] def do_flavour_makefile(self, arch, featureset, flavour, makeflags) -> None: makeflags['FLAVOUR'] = flavour def do_flavour_packages(self, arch, featureset, flavour, vars, makeflags) -> None: pass def substitute(self, s: str | list | tuple, vars) -> str | list: if isinstance(s, (list, tuple)): return [self.substitute(i, vars) for i in s] def subst(match) -> str: return vars[match.group(1)] return re.sub(r'@([-_a-z0-9]+)@', subst, str(s)) def write(self) -> None: for bundle in self.bundles.values(): bundle.extract_makefile() bundle.merge_build_depends() bundle.write() def merge_packages(packages, new, arch) -> None: for new_package in new: name = new_package['Package'] if name in packages: package = packages.get(name) package['Architecture'].add(arch) for field in ('Depends', 'Provides', 'Suggests', 'Recommends', 'Conflicts'): if field in new_package: if field in package: v = package[field] v.extend(new_package[field]) else: package[field] = new_package[field] else: new_package['Architecture'] = arch packages.append(new_package)