Index: third_party/dpkg-dev/scripts/Dpkg/Changelog/Entry.pm |
diff --git a/third_party/dpkg-dev/scripts/Dpkg/Changelog/Entry.pm b/third_party/dpkg-dev/scripts/Dpkg/Changelog/Entry.pm |
deleted file mode 100644 |
index 3277ab65667e8cf9d1534c1e6bcce5b952843725..0000000000000000000000000000000000000000 |
--- a/third_party/dpkg-dev/scripts/Dpkg/Changelog/Entry.pm |
+++ /dev/null |
@@ -1,306 +0,0 @@ |
-# Copyright © 2009 Raphaël Hertzog <hertzog@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/>. |
- |
-package Dpkg::Changelog::Entry; |
- |
-use strict; |
-use warnings; |
- |
-our $VERSION = '1.00'; |
- |
-use Carp; |
- |
-use Dpkg::Gettext; |
-use Dpkg::ErrorHandling; |
-use Dpkg::Control::Changelog; |
- |
-use overload |
- '""' => \&output, |
- 'eq' => sub { defined($_[1]) and "$_[0]" eq "$_[1]" }, |
- fallback => 1; |
- |
-=encoding utf8 |
- |
-=head1 NAME |
- |
-Dpkg::Changelog::Entry - represents a changelog entry |
- |
-=head1 DESCRIPTION |
- |
-This object represents a changelog entry. It is composed |
-of a set of lines with specific purpose: an header line, changes lines, a |
-trailer line. Blank lines can be between those kind of lines. |
- |
-=head1 FUNCTIONS |
- |
-=over 4 |
- |
-=item my $entry = Dpkg::Changelog::Entry->new() |
- |
-Creates a new object. It doesn't represent a real changelog entry |
-until one has been successfully parsed or built from scratch. |
- |
-=cut |
- |
-sub new { |
- my ($this) = @_; |
- my $class = ref($this) || $this; |
- |
- my $self = { |
- header => undef, |
- changes => [], |
- trailer => undef, |
- blank_after_header => [], |
- blank_after_changes => [], |
- blank_after_trailer => [], |
- }; |
- bless $self, $class; |
- return $self; |
-} |
- |
-=item my $str = $entry->output() |
- |
-=item "$entry" |
- |
-Get a string representation of the changelog entry. |
- |
-=item $entry->output($fh) |
- |
-Print the string representation of the changelog entry to a |
-filehandle. |
- |
-=cut |
- |
-sub _format_output_block { |
- my $lines = shift; |
- return join('', map { $_ . "\n" } @{$lines}); |
-} |
- |
-sub output { |
- my ($self, $fh) = @_; |
- my $str = ''; |
- $str .= $self->{header} . "\n" if defined($self->{header}); |
- $str .= _format_output_block($self->{blank_after_header}); |
- $str .= _format_output_block($self->{changes}); |
- $str .= _format_output_block($self->{blank_after_changes}); |
- $str .= $self->{trailer} . "\n" if defined($self->{trailer}); |
- $str .= _format_output_block($self->{blank_after_trailer}); |
- print { $fh } $str if defined $fh; |
- return $str; |
-} |
- |
-=item $entry->get_part($part) |
- |
-Return either a string (for a single line) or an array ref (for multiple |
-lines) corresponding to the requested part. $part can be |
-"header, "changes", "trailer", "blank_after_header", |
-"blank_after_changes", "blank_after_trailer". |
- |
-=cut |
- |
-sub get_part { |
- my ($self, $part) = @_; |
- croak "invalid part of changelog entry: $part" unless exists $self->{$part}; |
- return $self->{$part}; |
-} |
- |
-=item $entry->set_part($part, $value) |
- |
-Set the value of the corresponding part. $value can be a string |
-or an array ref. |
- |
-=cut |
- |
-sub set_part { |
- my ($self, $part, $value) = @_; |
- croak "invalid part of changelog entry: $part" unless exists $self->{$part}; |
- if (ref($self->{$part})) { |
- if (ref($value)) { |
- $self->{$part} = $value; |
- } else { |
- $self->{$part} = [ $value ]; |
- } |
- } else { |
- $self->{$part} = $value; |
- } |
-} |
- |
-=item $entry->extend_part($part, $value) |
- |
-Concatenate $value at the end of the part. If the part is already a |
-multi-line value, $value is added as a new line otherwise it's |
-concatenated at the end of the current line. |
- |
-=cut |
- |
-sub extend_part { |
- my ($self, $part, $value, @rest) = @_; |
- croak "invalid part of changelog entry: $part" unless exists $self->{$part}; |
- if (ref($self->{$part})) { |
- if (ref($value)) { |
- push @{$self->{$part}}, @$value; |
- } else { |
- push @{$self->{$part}}, $value; |
- } |
- } else { |
- if (defined($self->{$part})) { |
- if (ref($value)) { |
- $self->{$part} = [ $self->{$part}, @$value ]; |
- } else { |
- $self->{$part} .= $value; |
- } |
- } else { |
- $self->{$part} = $value; |
- } |
- } |
-} |
- |
-=item $is_empty = $entry->is_empty() |
- |
-Returns 1 if the changelog entry doesn't contain anything at all. |
-Returns 0 as soon as it contains something in any of its non-blank |
-parts. |
- |
-=cut |
- |
-sub is_empty { |
- my ($self) = @_; |
- return !(defined($self->{header}) || defined($self->{trailer}) || |
- scalar(@{$self->{changes}})); |
-} |
- |
-=item $entry->normalize() |
- |
-Normalize the content. Strip whitespaces at end of lines, use a single |
-empty line to separate each part. |
- |
-=cut |
- |
-sub normalize { |
- my ($self) = @_; |
- if (defined($self->{header})) { |
- $self->{header} =~ s/\s+$//g; |
- $self->{blank_after_header} = ['']; |
- } else { |
- $self->{blank_after_header} = []; |
- } |
- if (scalar(@{$self->{changes}})) { |
- s/\s+$//g foreach @{$self->{changes}}; |
- $self->{blank_after_changes} = ['']; |
- } else { |
- $self->{blank_after_changes} = []; |
- } |
- if (defined($self->{trailer})) { |
- $self->{trailer} =~ s/\s+$//g; |
- $self->{blank_after_trailer} = ['']; |
- } else { |
- $self->{blank_after_trailer} = []; |
- } |
-} |
- |
-=item my $src = $entry->get_source() |
- |
-Return the name of the source package associated to the changelog entry. |
- |
-=cut |
- |
-sub get_source { |
- return; |
-} |
- |
-=item my $ver = $entry->get_version() |
- |
-Return the version associated to the changelog entry. |
- |
-=cut |
- |
-sub get_version { |
- return; |
-} |
- |
-=item my @dists = $entry->get_distributions() |
- |
-Return a list of target distributions for this version. |
- |
-=cut |
- |
-sub get_distributions { |
- return; |
-} |
- |
-=item $fields = $entry->get_optional_fields() |
- |
-Return a set of optional fields exposed by the changelog entry. |
-It always returns a Dpkg::Control object (possibly empty though). |
- |
-=cut |
- |
-sub get_optional_fields { |
- return Dpkg::Control::Changelog->new(); |
-} |
- |
-=item $urgency = $entry->get_urgency() |
- |
-Return the urgency of the associated upload. |
- |
-=cut |
- |
-sub get_urgency { |
- return; |
-} |
- |
-=item my $maint = $entry->get_maintainer() |
- |
-Return the string identifying the person who signed this changelog entry. |
- |
-=cut |
- |
-sub get_maintainer { |
- return; |
-} |
- |
-=item my $time = $entry->get_timestamp() |
- |
-Return the timestamp of the changelog entry. |
- |
-=cut |
- |
-sub get_timestamp { |
- return; |
-} |
- |
-=item my $str = $entry->get_dpkg_changes() |
- |
-Returns a string that is suitable for usage in a C<Changes> field |
-in the output format of C<dpkg-parsechangelog>. |
- |
-=cut |
- |
-sub get_dpkg_changes { |
- my ($self) = @_; |
- my $header = $self->get_part('header') || ''; |
- $header =~ s/\s+$//; |
- return "\n$header\n\n" . join("\n", @{$self->get_part('changes')}); |
-} |
- |
-=back |
- |
-=head1 AUTHOR |
- |
-Raphaël Hertzog <hertzog@debian.org>. |
- |
-=cut |
- |
-1; |