1 package Module::Build::PPMMaker;
5 # This code is mostly borrowed from ExtUtils::MM_Unix 6.10_03, with a
6 # few tweaks based on the PPD spec at
7 # http://www.xav.com/perl/site/lib/XML/PPD.html
9 # The PPD spec is based on <http://www.w3.org/TR/NOTE-OSD>
13 return bless {@_}, $package;
17 my ($self, %args) = @_;
18 my $build = delete $args{build};
21 if (exists $args{codebase}) {
22 @codebase = ref $args{codebase} ? @{$args{codebase}} : ($args{codebase});
24 my $distfile = $build->ppm_name . '.tar.gz';
25 print "Using default codebase '$distfile'\n";
26 @codebase = ($distfile);
30 foreach my $info (qw(name author abstract version)) {
31 my $method = "dist_$info";
32 $dist{$info} = $build->$method() or die "Can't determine distribution's $info\n";
34 $dist{version} = $self->_ppd_version($dist{version});
36 $self->_simple_xml_escape($_) foreach $dist{abstract}, @{$dist{author}};
38 # TODO: could add <LICENSE HREF=...> tag if we knew what the URLs were for
41 <SOFTPKG NAME=\"$dist{name}\" VERSION=\"$dist{version}\">
42 <TITLE>$dist{name}</TITLE>
43 <ABSTRACT>$dist{abstract}</ABSTRACT>
44 @{[ join "\n", map " <AUTHOR>$_</AUTHOR>", @{$dist{author}} ]}
48 # TODO: We could set <IMPLTYPE VALUE="PERL" /> or maybe
49 # <IMPLTYPE VALUE="PERL/XS" /> ???
51 # We don't include recommended dependencies because PPD has no way
52 # to distinguish them from normal dependencies. We don't include
53 # build_requires dependencies because the PPM installer doesn't
54 # build or test before installing. And obviously we don't include
57 foreach my $type (qw(requires)) {
58 my $prereq = $build->$type();
59 while (my ($modname, $spec) = each %$prereq) {
60 next if $modname eq 'perl';
62 my $min_version = '0.0';
63 foreach my $c ($build->_parse_conditions($spec)) {
64 my ($op, $version) = $c =~ /^\s* (<=?|>=?|==|!=) \s* ([\w.]+) \s*$/x;
66 # This is a nasty hack because it fails if there is no >= op
68 $min_version = $version;
73 # Another hack - dependencies are on modules, but PPD expects
74 # them to be on distributions (I think).
77 $ppd .= sprintf(<<'EOF', $modname, $self->_ppd_version($min_version));
78 <DEPENDENCY NAME="%s" VERSION="%s" />
84 # We only include these tags if this module involves XS, on the
85 # assumption that pure Perl modules will work on any OS. PERLCORE,
86 # unfortunately, seems to indicate that a module works with _only_
87 # that version of Perl, and so is only appropriate when a module
89 if (keys %{$build->find_xs_files}) {
90 my $perl_version = $self->_ppd_version($build->perl_version);
91 $ppd .= sprintf(<<'EOF', $perl_version, $^O, $self->_varchname($build->config) );
92 <PERLCORE VERSION="%s" />
94 <ARCHITECTURE NAME="%s" />
98 foreach my $codebase (@codebase) {
99 $self->_simple_xml_escape($codebase);
100 $ppd .= sprintf(<<'EOF', $codebase);
101 <CODEBASE HREF="%s" />
110 my $ppd_file = "$dist{name}.ppd";
111 my $fh = IO::File->new(">$ppd_file")
112 or die "Cannot write to $ppd_file: $!";
120 my ($self, $version) = @_;
122 # generates something like "0,18,0,0"
123 return join ',', (split(/\./, $version), (0)x4)[0..3];
126 sub _varchname { # Copied from PPM.pm
127 my ($self, $config) = @_;
128 my $varchname = $config->{archname};
129 # Append "-5.8" to architecture name for Perl 5.8 and later
130 if (defined($^V) && ord(substr($^V,1)) >= 8) {
131 $varchname .= sprintf("-%d.%d", ord($^V), ord(substr($^V,1)));
144 my $rx = join '|', keys %escapes;
146 sub _simple_xml_escape {
147 $_[1] =~ s/($rx)/$escapes{$1}/go;
157 Module::Build::PPMMaker - Perl Package Manager file creation
162 On the command line, builds a .ppd file:
168 This package contains the code that builds F<.ppd> "Perl Package
169 Description" files, in support of ActiveState's "Perl Package
170 Manager". Details are here:
171 L<http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/>
176 Dave Rolsky <autarch@urth.org>, Ken Williams <kwilliams@cpan.org>
181 Copyright (c) 2001-2006 Ken Williams. All rights reserved.
183 This library is free software; you can redistribute it and/or
184 modify it under the same terms as Perl itself.
189 perl(1), Module::Build(3)