aboutsummaryrefslogtreecommitdiff
path: root/src/hydrilla/builder/piggybacking.py
blob: 3e4084f1efd660a5fdd691f73ef2372f467d7f37 (about) (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
# SPDX-License-Identifier: GPL-3.0-or-later

# Handling of software packaged for other distribution systems.
#
# This file is part of Hydrilla
#
# Copyright (C) 2022 Wojtek Kosior
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.
#
#
# I, Wojtek Kosior, thereby promise not to sue for violation of this
# file's license. Although I request that you do not make use of this
# code in a proprietary program, I am not going to enforce this in
# court.

"""
This module contains definitions that may be reused by multiple piggybacked
software system backends.
"""

# Enable using with Python 3.7.
from __future__ import annotations

import typing as t

from pathlib import Path, PurePosixPath

from ..translations import smart_gettext as _
from .common_errors import *

here = Path(__file__).resolve().parent

class Piggybacked:
    """
    Store information about foreign resources in use.

    Public attributes:
        'resource_must_depend' (read-only)
        'package_license_files' (read-only)
    """
    def __init__(
            self,
            archives:              dict[str, Path]     = {},
            roots:                 dict[str, Path]     = {},
            package_license_files: list[PurePosixPath] = [],
            resource_must_depend:  list[dict]          = []
    ) -> None:
        """
        Initialize this Piggybacked object.

        'archives' maps piggybacked system names to directories that contain
        package(s)' archive files. An 'archives' object may look like
        {'apt': PosixPath('/path/to/dir/with/debs/and/tarballs')}.

        'roots' associates directory names to be virtually inserted under
        Hydrilla source package directory with paths to real filesystem
        directories that hold their desired contents, i.e. unpacked foreign
        packages.

        'package_license_files' lists paths to license files that should be
        included with the Haketilo package that will be produced. The paths are
        to be resolved using 'roots' dictionary.

        'resource_must_depend' lists names of Haketilo packages that the
        produced resources will additionally depend on. This is meant to help
        distribute common licenses with a separate Haketilo package.
        """
        self.archives              = archives
        self.roots                 = roots
        self.package_license_files = package_license_files
        self.resource_must_depend  = resource_must_depend

    def resolve_file(self, file_ref_name: PurePosixPath) -> t.Optional[Path]:
        """
        'file_ref_name' is a path as may appear in an index.json file. Check if
        the file belongs to one of the roots we have and return either a path
        to the relevant file under this root or None.

        It is not being checked whether the file actually exists in the
        filesystem.
        """
        parts = file_ref_name.parts
        if not parts:
            return None

        root_path = self.roots.get(parts[0])
        if root_path is None:
            return None

        path = root_path

        for part in parts[1:]:
            path = path / part

        path = path.resolve()

        if not path.is_relative_to(root_path):
            raise FileReferenceError(_('loading_{}_outside_piggybacked_dir')
                                     .format(file_ref_name))

        return path

    def archive_files(self) -> t.Iterator[tuple[PurePosixPath, Path]]:
        """
        Yield all archive files in use. Each yielded tuple holds file's desired
        path relative to the piggybacked archives directory to be created and
        its current real path.
        """
        for system, real_dir in self.archives.items():
            for path in real_dir.rglob('*'):
                yield PurePosixPath(system) / path.relative_to(real_dir), path