libextutils-xspp-perl 0.1800-2 / usr / share / perl5 / ExtUtils / XSpp / Parser.pm

package ExtUtils::XSpp::Parser;

use strict;
use warnings;

use IO::Handle;
use ExtUtils::XSpp::Grammar;

=head1 NAME

ExtUtils::XSpp::Parser - an XS++ parser

=cut

sub _my_open {
  my $file = shift;

  open my $in, "<", $file
    or die "Failed to open '$file' for reading: $!";

  return $in;
}

=head2 ExtUtils::XSpp::Parser::new( file => path )

Create a new XS++ parser.

=cut

sub new {
  my $class = shift;
  my $this = bless {}, $class;
  my %args = @_;

  $this->{FILE} = $args{file};
  $this->{STRING} = $args{string};
  $this->{PARSER} = ExtUtils::XSpp::Grammar->new;
  $this->{PLUGINS} = {};

  return $this;
}

=head2 ExtUtils::XSpp::Parser::parse

Parse the file data; returns true on success, false otherwise,
on failure C<get_errors> will return the list of errors.

=cut

sub parse {
  my $this = shift;
  my $fh;
  if( $this->{FILE} ) {
      $fh = _my_open( $this->{FILE} );
  } else {
      open $fh, '<', \$this->{STRING}
        or die "Failed to create file handle from in-memory string";
  }
  my $buf = '';

  my $parser = $this->{PARSER};
  $parser->YYData->{LEX}{FH} = $fh;
  $parser->YYData->{LEX}{BUFFER} = \$buf;
  $parser->YYData->{LEX}{FILE} = $this->{FILE};
  local $parser->YYData->{PARSER} = $this;

  $this->{DATA} = $parser->YYParse( yylex   => \&ExtUtils::XSpp::Grammar::yylex,
                                    yyerror => \&ExtUtils::XSpp::Grammar::yyerror,
                                    yydebug => 0x00,
                                   );
}

sub parse_type {
    my( $class, $type ) = @_;
    my $this = $class->new( string => "%_type{$type}" );

    $this->parse;

    return $this->{DATA};
}

sub include_file {
  my $this = shift;
  my( $file ) = @_;
  my $buf = '';
  my $new_lex = { FH     => _my_open( $file ),
                  FILE   => $file,
                  BUFFER => \$buf,
                  NEXT   => $this->{PARSER}->YYData->{LEX},
                  };

  $this->{PARSER}->YYData->{LEX} = $new_lex;
}

=head2 ExtUtils::XSpp::Parser::get_data

Returns a list containing the parsed data. Each item of the list is
a subclass of C<ExtUtils::XSpp::Node>

=cut

sub get_data {
  my $this = shift;
  die "'parse' must be called before calling 'get_data'"
    unless exists $this->{DATA};

  return $this->{DATA};
}

=head2 ExtUtils::XSpp::Parser::get_errors

Returns the parsing errors as an array.

=cut

sub get_errors {
  my $this = shift;

  return @{$this->{ERRORS}};
}

=head2 ExtUtils::XSpp::Parser::load_plugin

Loads the specified plugin and calls its C<register_plugin> method.

=cut

sub load_plugin {
  my( $this, $package ) = @_;

  if (eval "require ExtUtils::XSpp::Plugin::$package;") {
    $package = "ExtUtils::XSpp::Plugin::$package";
  }
  elsif (!eval "require $package;") {
    die "Could not load XS++ plugin '$package' (neither via the namespace "
       ."'ExtUtils::XSpp::Plugin::$package' nor via '$package'). Reason: $@";
  }

  # only call register_plugin once
  if (!$this->{PLUGINS}{$package}) {
    $package->register_plugin( $this );
    $this->{PLUGINS}{$package} = 1;
  }

  # TODO handle %load_plugin parameters

  return 1;
}

=head2 ExtUtils::XSpp::Parser::add_post_process_plugin

Adds the specified plugin to be called after parsing is complete to
modify the parse tree before it is emitted.

=cut

sub add_post_process_plugin {
  my( $this, %args ) = @_;

  _add_plugin( $this, 'POST_PROCESS', \%args, 'post_process' );
}

sub post_process_plugins { $_[0]->{PLUGINS}{POST_PROCESS} || [] }

=head2 ExtUtils::XSpp::Parser::add_class_tag_plugin

Adds the specified plugin to the list of plugins that can handle custom
%foo annotations for a class.

=cut

sub add_class_tag_plugin {
  my( $this, %args ) = @_;
  my $tag = $args{tag} || '_any_';

  _add_plugin( $this, 'CLASS_TAG', \%args, 'handle_class_tag' );
}

sub handle_class_tag_plugins {
  my( $this, $class, @args ) = @_;

  _handle_plugin( $this, $this->{PLUGINS}{CLASS_TAG}, 'class',
                  [ $class, @args ] );
}

=head2 ExtUtils::XSpp::Parser::add_function_tag_plugin

Adds the specified plugin to the list of plugins that can handle custom
%foo annotations for a function.

=cut

sub add_function_tag_plugin {
  my( $this, %args ) = @_;
  my $tag = $args{tag} || '_any_';

  _add_plugin( $this, 'FUNCTION_TAG', \%args, 'handle_function_tag' );
}

sub handle_function_tags_plugins {
  my( $this, $function, $tags ) = @_;

  _handle_plugins( $this, $this->{PLUGINS}{FUNCTION_TAG}, 'function',
                   $tags, $function )
}

=head2 ExtUtils::XSpp::Parser::add_method_tag_plugin

Adds the specified plugin to the list of plugins that can handle custom
%foo annotations for a function.

=cut

sub add_method_tag_plugin {
  my( $this, %args ) = @_;
  my $tag = $args{tag} || '_any_';

  _add_plugin( $this, 'METHOD_TAG', \%args, 'handle_method_tag' );
}

sub handle_method_tags_plugins {
  my( $this, $method, $tags ) = @_;

  _handle_plugins( $this, $this->{PLUGINS}{METHOD_TAG}, 'method',
                   $tags, $method );
}

=head2 ExtUtils::XSpp::Parser::add_argument_tag_plugin

Adds the specified plugin to the list of plugins that can handle custom
%foo annotations for an arguments.

=cut

sub add_argument_tag_plugin {
  my( $this, %args ) = @_;
  my $tag = $args{tag} || '_any_';

  _add_plugin( $this, 'ARGUMENT_TAG', \%args, 'handle_argument_tag' );
}

sub handle_argument_tags_plugins {
  my( $this, $argument, $tags ) = @_;

  _handle_plugins( $this, $this->{PLUGINS}{ARGUMENT_TAG}, 'argument',
                   $tags, $argument );
}

=head2 ExtUtils::XSpp::Parser::add_toplevel_tag_plugin

Adds the specified plugin to the list of plugins that can handle custom
%foo top level directives.

=cut

sub add_toplevel_tag_plugin {
  my( $this, %args ) = @_;
  my $tag = $args{tag} || '_any_';

  _add_plugin( $this, 'TOPLEVEL_TAG', \%args, 'handle_toplevel_tag' );
}

sub handle_toplevel_tag_plugins {
  my( $this, @args ) = @_;

  _handle_plugin( $this, $this->{PLUGINS}{TOPLEVEL_TAG}, 'top-level',
                  [ undef, @args ] );
}

sub _add_plugin {
  my( $this, $kind, $args, $default_method ) = @_;
  my $entry = { plugin => $args->{plugin},
                method => $args->{method} || $default_method,
                };

  if( $kind eq 'POST_PROCESS' ) {
    push @{$this->{PLUGINS}{$kind}}, $entry;
  } else {
    push @{$this->{PLUGINS}{$kind}{$args->{tag} || '_any_'}}, $entry;
  }
}

sub _handle_plugins {
  my( $this, $plugins, $plugin_type, $tags, $arg ) = @_;
  my @nodes;

  foreach my $tag ( @{$tags || []} ) {
    my $nodes = _handle_plugin( $this, $plugins, $plugin_type,
                  [ $arg, $tag->{any},
                    named                    => $tag->{named},
                    positional               => $tag->{positional},
                    any_named_arguments      => $tag->{named},
                    any_positional_arguments => $tag->{positional},
                    ] );

    push @nodes, @$nodes;
  }

  return \@nodes;
}

sub _handle_plugin {
  my( $this, $plugins, $plugin_type, $plugin_args ) = @_;
  my $tag = $plugin_args->[1];

  foreach my $plugin ( @{$plugins->{$tag} || []}, @{$plugins->{_any_} || []} ) {
    my $method = $plugin->{method};

    my( $handled, @nodes ) = $plugin->{plugin}->$method( @$plugin_args );
    return \@nodes if $handled;
  }

  die "Unhandled $plugin_type annotation '$tag'";
}

sub current_file { $_[0]->{PARSER}->YYData->{LEX}{FILE} }

1;