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 : BuildDriver.pm

# Copyright © 2020-2024 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::BuildDriver - drive the build of a Debian package

=head1 DESCRIPTION

This class is used by dpkg-buildpackage to drive the build of a Debian
package.

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

=cut

package Dpkg::BuildDriver 0.01;

use strict;
use warnings;

use Dpkg ();
use Dpkg::Gettext;
use Dpkg::ErrorHandling;

=head1 METHODS

=over 4

=item $bd = Dpkg::BuildDriver->new(%opts)

Create a new Dpkg::BuildDriver object.
It will load a build driver module as requested in the B<Build-Drivers> field
in the $opts{ctrl} L<Dpkg::Control::Info> object or if not present,
it will fall back to load the default B<debian-rules> driver.

Options:

=over

=item B<ctrl> (required)

A L<Dpkg::Control::Info> object.

=item B<root_cmd>

A string with the gain-root-command to use when needing to execute a command
with root-like rights.
If needed and unset, it will default to L<fakeroot> if it is available or
the module will error out.

=item B<as_root>

A boolean to force F<debian/rules> target calls as root-like, even if they
would normally not require to be executed as root-like.
This option is applied to all targets globally.

B<Note>: This option is only relevant for drivers that use F<debian/rules>.

=item B<debian_rules>

An array containing the command to execute the F<debian/rules> file and any
additional arguments.
It defaults to B<debian/rules>.

B<Note>: This option is only relevant for drivers that use F<debian/rules>.

=item B<rrr_override>

A string that overrides the B<Rules-Requires-Root> field value.

B<Note>: This option is only relevant for drivers that use F<debian/rules>.

=back

=cut

sub _load_driver {
    my ($name, %opts) = @_;

# Normalize the driver name.
    $name = join q{}, map { ucfirst lc } split /-/, $name;

my $module = "Dpkg::BuildDriver::$name";
    eval qq{
        require $module;
    };
    error(g_('build driver %s is unknown: %s'), $name, $@) if $@;

return $module->new(%opts);
}

sub new {
    my ($this, %opts) = @_;
    my $class = ref($this) || $this;

my $ctrl_src = $opts{ctrl}->get_source();
    my $name = $ctrl_src->{'Build-Driver'} // 'debian-rules';
    my $self = {
        driver => _load_driver($name, %opts),
    };
    bless $self, $class;
    return $self;
}

=item $bd->pre_check()

Perform build driver specific checks, before anything else.

This will run after the B<init> hook, and before C<dpkg-source --before-build>.

B<Note>: This is an optional method that can be omitted from the driver
implementation.

=cut

sub pre_check {
    my $self = shift;

return unless $self->{driver}->can('pre_check');
    return $self->{driver}->pre_check();
}

=item $bool = $bd->need_build_task($build_task, binary_task)

Returns whether we need to use the build task.

B<Note>: This method is needed as long as we support building as root-like.
Once that is not needed this method will be deprecated.

=cut

sub need_build_task {
    my ($self, $build_task, $binary_task) = @_;

return $self->{driver}->need_build_task($build_task, $binary_task);
}

=item $bd->run_build_task($build_task, $binary_task)

Executes the build task for the build.

B<Note>: This is an optional method needed as long as we support building as
root-like.
Once that is not needed this method will be deprecated.

=cut

sub run_build_task {
    my ($self, $build_task, $binary_task) = @_;

$self->{driver}->run_build_task($build_task, $binary_task);

return;
}

=item $bd->run_task($task)

Executes the given task for the build.

=cut

sub run_task {
    my ($self, $task) = @_;

$self->{driver}->run_task($task);

return;
}

=back

=head1 CHANGES

=head2 Version 0.xx

This is a private module.

=cut

${this.title}

Code Editor : BuildDriver.pm