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 |