| Index: third_party/dpkg-dev/scripts/Dpkg/Changelog/Debian.pm
|
| diff --git a/third_party/dpkg-dev/scripts/Dpkg/Changelog/Debian.pm b/third_party/dpkg-dev/scripts/Dpkg/Changelog/Debian.pm
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..1643fb3a0cf07c0fd2ed281c60ec41a880d4804e
|
| --- /dev/null
|
| +++ b/third_party/dpkg-dev/scripts/Dpkg/Changelog/Debian.pm
|
| @@ -0,0 +1,208 @@
|
| +# Copyright © 1996 Ian Jackson
|
| +# Copyright © 2005 Frank Lichtenheld <frank@lichtenheld.de>
|
| +# Copyright © 2009 Raphaël Hertzog <hertzog@debian.org>
|
| +# Copyright © 2012-2013 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::Changelog::Debian - parse Debian changelogs
|
| +
|
| +=head1 DESCRIPTION
|
| +
|
| +Dpkg::Changelog::Debian parses Debian changelogs as described in the Debian
|
| +policy (version 3.6.2.1 at the time of this writing). See section
|
| +L<"SEE ALSO"> for locations where to find this definition.
|
| +
|
| +The parser tries to ignore most cruft like # or /* */ style comments,
|
| +CVS comments, vim variables, emacs local variables and stuff from
|
| +older changelogs with other formats at the end of the file.
|
| +NOTE: most of these are ignored silently currently, there is no
|
| +parser error issued for them. This should become configurable in the
|
| +future.
|
| +
|
| +=head2 METHODS
|
| +
|
| +=cut
|
| +
|
| +package Dpkg::Changelog::Debian;
|
| +
|
| +use strict;
|
| +use warnings;
|
| +
|
| +our $VERSION = '1.00';
|
| +
|
| +use Dpkg::Gettext;
|
| +use Dpkg::File;
|
| +use Dpkg::Changelog qw(:util);
|
| +use parent qw(Dpkg::Changelog);
|
| +use Dpkg::Changelog::Entry::Debian qw(match_header match_trailer);
|
| +
|
| +use constant {
|
| + FIRST_HEADING => _g('first heading'),
|
| + NEXT_OR_EOF => _g('next heading or eof'),
|
| + START_CHANGES => _g('start of change data'),
|
| + CHANGES_OR_TRAILER => _g('more change data or trailer'),
|
| +};
|
| +
|
| +=over 4
|
| +
|
| +=item $c->parse($fh, $description)
|
| +
|
| +Read the filehandle and parse a Debian changelog in it. Returns the number
|
| +of changelog entries that have been parsed with success.
|
| +
|
| +=cut
|
| +
|
| +sub parse {
|
| + my ($self, $fh, $file) = @_;
|
| + $file = $self->{reportfile} if exists $self->{reportfile};
|
| +
|
| + $self->reset_parse_errors;
|
| +
|
| + $self->{data} = [];
|
| + $self->set_unparsed_tail(undef);
|
| +
|
| + my $expect = FIRST_HEADING;
|
| + my $entry = Dpkg::Changelog::Entry::Debian->new();
|
| + my @blanklines = ();
|
| + my $unknowncounter = 1; # to make version unique, e.g. for using as id
|
| +
|
| + while (<$fh>) {
|
| + chomp;
|
| + if (match_header($_)) {
|
| + unless ($expect eq FIRST_HEADING || $expect eq NEXT_OR_EOF) {
|
| + $self->parse_error($file, $.,
|
| + sprintf(_g('found start of entry where expected %s'),
|
| + $expect), "$_");
|
| + }
|
| + unless ($entry->is_empty) {
|
| + push @{$self->{data}}, $entry;
|
| + $entry = Dpkg::Changelog::Entry::Debian->new();
|
| + last if $self->abort_early();
|
| + }
|
| + $entry->set_part('header', $_);
|
| + foreach my $error ($entry->check_header()) {
|
| + $self->parse_error($file, $., $error, $_);
|
| + }
|
| + $expect= START_CHANGES;
|
| + @blanklines = ();
|
| + } elsif (m/^(;;\s*)?Local variables:/io) {
|
| + last; # skip Emacs variables at end of file
|
| + } elsif (m/^vim:/io) {
|
| + last; # skip vim variables at end of file
|
| + } elsif (m/^\$\w+:.*\$/o) {
|
| + next; # skip stuff that look like a CVS keyword
|
| + } elsif (m/^\# /o) {
|
| + next; # skip comments, even that's not supported
|
| + } elsif (m{^/\*.*\*/}o) {
|
| + next; # more comments
|
| + } elsif (m/^(\w+\s+\w+\s+\d{1,2} \d{1,2}:\d{1,2}:\d{1,2}\s+[\w\s]*\d{4})\s+(.*)\s+(<|\()(.*)(\)|>)/o
|
| + || m/^(\w+\s+\w+\s+\d{1,2},?\s*\d{4})\s+(.*)\s+(<|\()(.*)(\)|>)/o
|
| + || m/^(\w[-+0-9a-z.]*) \(([^\(\) \t]+)\)\;?/io
|
| + || m/^([\w.+-]+)(-| )(\S+) Debian (\S+)/io
|
| + || m/^Changes from version (.*) to (.*):/io
|
| + || m/^Changes for [\w.+-]+-[\w.+-]+:?\s*$/io
|
| + || m/^Old Changelog:\s*$/io
|
| + || m/^(?:\d+:)?\w[\w.+~-]*:?\s*$/o) {
|
| + # save entries on old changelog format verbatim
|
| + # we assume the rest of the file will be in old format once we
|
| + # hit it for the first time
|
| + $self->set_unparsed_tail("$_\n" . file_slurp($fh));
|
| + } elsif (m/^\S/) {
|
| + $self->parse_error($file, $., _g('badly formatted heading line'), "$_");
|
| + } elsif (match_trailer($_)) {
|
| + unless ($expect eq CHANGES_OR_TRAILER) {
|
| + $self->parse_error($file, $.,
|
| + sprintf(_g('found trailer where expected %s'), $expect), "$_");
|
| + }
|
| + $entry->set_part('trailer', $_);
|
| + $entry->extend_part('blank_after_changes', [ @blanklines ]);
|
| + @blanklines = ();
|
| + foreach my $error ($entry->check_trailer()) {
|
| + $self->parse_error($file, $., $error, $_);
|
| + }
|
| + $expect = NEXT_OR_EOF;
|
| + } elsif (m/^ \-\-/) {
|
| + $self->parse_error($file, $., _g('badly formatted trailer line'), "$_");
|
| + } elsif (m/^\s{2,}(\S)/) {
|
| + unless ($expect eq START_CHANGES or $expect eq CHANGES_OR_TRAILER) {
|
| + $self->parse_error($file, $., sprintf(_g('found change data' .
|
| + ' where expected %s'), $expect), "$_");
|
| + if ($expect eq NEXT_OR_EOF and not $entry->is_empty) {
|
| + # lets assume we have missed the actual header line
|
| + push @{$self->{data}}, $entry;
|
| + $entry = Dpkg::Changelog::Entry::Debian->new();
|
| + $entry->set_part('header', 'unknown (unknown' . ($unknowncounter++) . ') unknown; urgency=unknown');
|
| + }
|
| + }
|
| + # Keep raw changes
|
| + $entry->extend_part('changes', [ @blanklines, $_ ]);
|
| + @blanklines = ();
|
| + $expect = CHANGES_OR_TRAILER;
|
| + } elsif (!m/\S/) {
|
| + if ($expect eq START_CHANGES) {
|
| + $entry->extend_part('blank_after_header', $_);
|
| + next;
|
| + } elsif ($expect eq NEXT_OR_EOF) {
|
| + $entry->extend_part('blank_after_trailer', $_);
|
| + next;
|
| + } elsif ($expect ne CHANGES_OR_TRAILER) {
|
| + $self->parse_error($file, $.,
|
| + sprintf(_g('found blank line where expected %s'), $expect));
|
| + }
|
| + push @blanklines, $_;
|
| + } else {
|
| + $self->parse_error($file, $., _g('unrecognized line'), "$_");
|
| + unless ($expect eq START_CHANGES or $expect eq CHANGES_OR_TRAILER) {
|
| + # lets assume change data if we expected it
|
| + $entry->extend_part('changes', [ @blanklines, $_]);
|
| + @blanklines = ();
|
| + $expect = CHANGES_OR_TRAILER;
|
| + }
|
| + }
|
| + }
|
| +
|
| + unless ($expect eq NEXT_OR_EOF) {
|
| + $self->parse_error($file, $., sprintf(_g('found eof where expected %s'),
|
| + $expect));
|
| + }
|
| + unless ($entry->is_empty) {
|
| + push @{$self->{data}}, $entry;
|
| + }
|
| +
|
| + return scalar @{$self->{data}};
|
| +}
|
| +
|
| +1;
|
| +__END__
|
| +
|
| +=back
|
| +
|
| +=head1 SEE ALSO
|
| +
|
| +Dpkg::Changelog
|
| +
|
| +Description of the Debian changelog format in the Debian policy:
|
| +L<http://www.debian.org/doc/debian-policy/ch-source.html#s-dpkgchangelog>.
|
| +
|
| +=head1 AUTHORS
|
| +
|
| +Frank Lichtenheld, E<lt>frank@lichtenheld.deE<gt>
|
| +Raphaël Hertzog, E<lt>hertzog@debian.orgE<gt>
|
| +
|
| +=cut
|
|
|