Gecko [ 0.0.0.0 ]

Name	Size	Permission
Archive	[ DIR ]	drwxr-xr-x
Build	[ DIR ]	drwxr-xr-x
BuildDriver	[ DIR ]	drwxr-xr-x
Changelog	[ DIR ]	drwxr-xr-x
Compression	[ DIR ]	drwxr-xr-x
Control	[ DIR ]	drwxr-xr-x
Deps	[ DIR ]	drwxr-xr-x
Dist	[ DIR ]	drwxr-xr-x
Interface	[ DIR ]	drwxr-xr-x
OpenPGP	[ DIR ]	drwxr-xr-x
Shlibs	[ DIR ]	drwxr-xr-x
Source	[ DIR ]	drwxr-xr-x
Vendor	[ DIR ]	drwxr-xr-x
Arch.pm	14.73 KB	-rw-r--r--
BuildAPI.pm	3.33 KB	-rw-r--r--
BuildDriver.pm	4.34 KB	-rw-r--r--
BuildEnv.pm	2.23 KB	-rw-r--r--
BuildFlags.pm	14.4 KB	-rw-r--r--
BuildInfo.pm	3.09 KB	-rw-r--r--
BuildOptions.pm	6.3 KB	-rw-r--r--
BuildProfiles.pm	3.48 KB	-rw-r--r--
BuildTree.pm	2.49 KB	-rw-r--r--
BuildTypes.pm	6.02 KB	-rw-r--r--
Changelog.pm	20.55 KB	-rw-r--r--
Checksums.pm	11.14 KB	-rw-r--r--
Compression.pm	11.94 KB	-rw-r--r--
Conf.pm	5.96 KB	-rw-r--r--
Control.pm	8.4 KB	-rw-r--r--
Deps.pm	14.72 KB	-rw-r--r--
ErrorHandling.pm	5.9 KB	-rw-r--r--
Exit.pm	2.42 KB	-rw-r--r--
File.pm	2.06 KB	-rw-r--r--
Getopt.pm	1.52 KB	-rw-r--r--
Gettext.pm	5.31 KB	-rw-r--r--
IPC.pm	11.66 KB	-rw-r--r--
Index.pm	11.54 KB	-rw-r--r--
Lock.pm	2.11 KB	-rw-r--r--
OpenPGP.pm	3.99 KB	-rw-r--r--
Package.pm	2.22 KB	-rw-r--r--
Path.pm	8.67 KB	-rw-r--r--
Shlibs.pm	5.69 KB	-rw-r--r--
Substvars.pm	12.99 KB	-rw-r--r--
Vendor.pm	6.66 KB	-rw-r--r--
Version.pm	12.91 KB	-rw-r--r--

Code Editor : BuildAPI.pm

# Copyright © 2020-2022 Guillem Jover <guillem@debian.org>
#
# 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 2 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/>.

=encoding utf8

=head1 NAME

Dpkg::BuildAPI - handle build API versions

=head1 DESCRIPTION

The Dpkg::BuildAPI module provides functions to fetch the current dpkg
build API level.

B<Note>: This is a private module, its API can change at any time.

=cut

package Dpkg::BuildAPI 0.01;

use strict;
use warnings;

our @EXPORT_OK = qw(
    get_build_api
    reset_build_api
);

use Exporter qw(import);

use Dpkg::Gettext;
use Dpkg::ErrorHandling;
use Dpkg::BuildEnv;
use Dpkg::Version;
use Dpkg::Deps;

use constant {
    DEFAULT_BUILD_API => '0',
    MAX_BUILD_API => '1',
};

my $build_api;

=head1 FUNCTIONS

=over 4

=item $level = get_build_api([$ctrl])

Get the build API level, from the environment variable B<DPKG_BUILD_API>,
or if not defined and a $ctrl L<Dpkg::Control::Info> object passed as an
argument, from its build dependency fields. If no $ctrl object gets passed
the previous value obtained is returned.

=cut

sub get_build_api {
    my $ctrl = shift;

return $build_api if defined $build_api && ! defined $ctrl;

if (Dpkg::BuildEnv::has('DPKG_BUILD_API')) {
        $build_api = Dpkg::BuildEnv::get('DPKG_BUILD_API');
    } elsif (defined $ctrl) {
        my $src = $ctrl->get_source();
        my @dep_list = deps_concat(map {
            $src->{$_ }
        } qw(Build-Depends Build-Depends-Indep Build-Depends-Arch));

my $deps = deps_parse(@dep_list,
            build_dep => 1,
            reduce_restrictions => 1,
        );

if (not defined $deps) {
            $build_api = DEFAULT_BUILD_API;
            return $build_api;
        }

deps_iterate($deps, sub {
            my $dep = shift;

return 1 if $dep->{package} ne 'dpkg-build-api';

if (! defined $dep->{relation} || $dep->{relation} ne REL_EQ) {
                error(g_('dpkg build API level needs an exact version'));
            }

if (defined $build_api and $build_api ne $dep->{version}) {
                error(g_('dpkg build API level with conflicting versions: %s vs %s'),
                      $build_api, $dep->{version});
            }

$build_api = $dep->{version};

return 1;
        });
    }

$build_api //= DEFAULT_BUILD_API;

if ($build_api !~ m/^[0-9]+$/) {
        error(g_("invalid dpkg build API level '%s'"), $build_api);
    }

if ($build_api > MAX_BUILD_API) {
        error(g_("dpkg build API level '%s' greater than max '%s'"),
              $build_api, MAX_BUILD_API);
    }

return $build_api;
}

=item reset_build_api()

Reset the cached build API level.

=cut

sub reset_build_api {
    $build_api = undef;
}

=back

=head1 CHANGES

=head2 Version 0.xx

This is a private module.

=cut

${this.title}

Code Editor : BuildAPI.pm