#!/usr/bin/perl -w
use strict;
use lib '../lib';
use Getopt::Long;
use LWP::Simple;
use Pod::Usage;
use GraphViz;
use XML::XPath;
sub depends {
my ($xp, $os, $pkg) = @_;
$os = lc $os;
my $nodeset = $xp->find("/REPOSITORYSUMMARY/SOFTPKG[\@NAME='$pkg']/IMPLEMENTATION/DEPENDENCY[../OS/\@NAME='$os']/\@NAME");
return map { $xp->findvalue('.', $_) } $nodeset->get_nodelist;
}
sub process {
my $xp = shift;
my $os = shift;
my $deps = shift;
for my $pkg (@_) {
next if $deps->{$pkg}; # check here since it might have been done in a recursive call
my @deps = depends($xp, $os, $pkg);
$deps->{$pkg} = [ @deps ];
process($xp, $os, $deps, @deps);
}
return $deps;
}
our $VERSION='0.01';
my %opts = (
help => 0,
man => 0,
verbose => 0,
os => '',
pkg => '',
);
GetOptions(\%opts, qw(
help
man
verbose
os=s
pkg=s
)) || pod2usage(2);
pod2usage(1) if $opts{help};
pod2usage(-exitstatus => 0, -verbose => 2) if $opts{man};
pod2usage(1) unless $opts{pkg};
$opts{os} ||= 'linux';
$opts{pkg} =~ s/::/-/g;
mirror("http://www.activestate.com/PPMPackages/5.6plus/package.lst", "package.lst") unless -f "package.lst";
my $xp = XML::XPath->new(filename => 'package.lst');
my $deps = process($xp, $opts{os}, {}, $opts{pkg});
my $g = GraphViz->new();
for my $pkg (keys %$deps) {
$g->add_node($pkg);
for my $dep (@{ $deps->{$pkg} }) {
$g->add_edge($pkg => $dep);
}
}
print $g->as_png;
__END__
=head1 NAME
ppmgraph.pl - graph CPAN tarball dependencies
=head1 SYNOPSIS
ppmgraph.pl -os=linux -pkg=Class-DBI >class-dbi.png
=head1 DESCRIPTION
This program takes Activestate's package list (download it from
http://www.activestate.com/PPMPackages/5.6plus/package.lst), which is in
XML format, and uses it to determine dependencies between packages. It
then hands over those dependencies to GraphViz. The resulting graph is
output in PNG format on STDOUT.
Note that this means that dependencies of modules within the tarballs
can't be determined this way, only dependencies between the tarballs
themselves. For these purposes, there will be programs to graph
dependencies between installed modules and the runtime @ISA hierarchy.
=head1 OPTIONS
This section describes the supported command line options. Minimum
matching is supported.
=over 4
=item B<--pkg>
Mandatory option to specify which package to graph the dependency
for. This can be either the name of the module (e.g. C<Class::DBI>)
or the name of the tarball sans version number (e.g. C<Class-DBI>). In
any case, the graph will display tarball names as the node labels,
since that's what's contained in the XML file.
=item B<--os>
Which Operating System to graph the dependency for. At the moment,
ActiveState defines "linux", "solaris" and "MSWin32". If not given,
this option defaults to "linux".
=item B<--help>
Print a brief help message and exit.
=item B<--man>
Print the manual page and exit.
=item B<--verbose>
Print information messages as we go along.
=back
=head1 BUGS
Some. Possibly. I haven't fully tested it. Also, a performance
problem. The package XML file is over a meg, and performance suffers. At
the moment, this is of no concern, but I might switch over to PerlSAX
later. I'm using XPath at the moment since I'm familiar with it.
=head1 AUTHOR
Marcel GrE<uuml>nauer E<lt>marcel@codewerk.comE<gt>
=head1 COPYRIGHT
Copyright 2000 Marcel GrE<uuml>nauer. All rights reserved.
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
=head1 SEE ALSO
GraphViz(3pm)
=cut