#!/usr/bin/env perl
# pmfunc -- show a function 

# ------ pragmas
use strict;
use warnings;

our $VERSION = '2.0';

# ------ define variables
my $errors   = 0;        # error count
my $file     = undef;        # module file path
my $function = undef;        # function name
my $module   = undef;        # module name
my $ok       = undef;        # OK count

BEGIN { $^W = 1 }
BEGIN { die "usage: $0 module ...\n" unless @ARGV }

use FindBin qw($Bin);

$errors = 0;

for my $arg (@ARGV) { 
    ($module, $function) = $arg =~ /(\w.*)::(\w+)$/;
    if (!defined($module)) {
        print STDERR "Sorry, '$arg' is not the name of a function in a module.\n";

    $file = `$^X -S $Bin/pmpath $module`;
    if ($?) {
    chomp $file;

    my $found = 0;
    my $ifh;
    my $in_function = 0;
    open $ifh, '<', $file or die "cannot open '$file': $!\n";
    while (my $line = <$ifh>) {
        $in_function = 1 if ($line =~ m/^sub\s+$function\W/msx);
        next if !$in_function;

        $found = 1;
        print $line;

        $in_function = 0 if $line =~ m/^}\s*$/msx;
    close $ifh;
    print STDERR "cannot find '$module::$function'\n" if !$found;

    $errors++ if $? || !$found;

exit ($errors != 0);


=head1 NAME

pmfunc - cat out a function from a module


Given a fully-qualified function, this program opens
up the file and attempts to display the source for 
that function.


    $ pmfunc Cwd::_perl_getcwd
    sub _perl_getcwd


Only subroutines that are defined in the normal fashion are seen, since
a simple pattern-match is what does the extraction.  Those loaded other
ways, such as via AUTOLOAD, typeglob aliasing, or in an C<eval>, will
all necessarily be missed.

This is mostly here for people who are too lazy to type

    sed '/^sub getcwd/,/}/p' `pmpath Cwd`
    perl -ne 'print if /^sub\s+getcwd\b/ .. /}/' `pmpath Cwd`


=head1 SEE ALSO


Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2014, 2018 Mark Leighton Fisher.

=head1 LICENSE

This is free software; you can redistribute it and/or modify it
under the terms of either:
(a) the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any
later version, or
(b) the Perl "Artistic License".
(This is the Perl 5 licensing scheme.)

Please note this is a change from the
original pmtools-1.00 (still available on CPAN),
as pmtools-1.00 were licensed only under the
Perl "Artistic License".