Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Asset	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Content	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Cookie	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
DOM	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
IOLoop	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
JSON	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Message	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Reactor	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Server	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Transaction	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
UserAgent	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
resources	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Asset.pm	3.12 KB	-rw-rw-rw-	2021-01-17 16:57
Base.pm	11.48 KB	-rw-rw-rw-	2021-01-17 16:57
ByteStream.pm	8.23 KB	-rw-rw-rw-	2021-01-17 16:57
Cache.pm	1.3 KB	-rw-rw-rw-	2021-01-17 16:57
Collection.pm	10.13 KB	-rw-rw-rw-	2021-01-17 16:57
Content.pm	14.51 KB	-rw-rw-rw-	2021-01-17 16:57
Cookie.pm	1.56 KB	-rw-rw-rw-	2021-01-17 16:57
DOM.pm	30.11 KB	-rw-rw-rw-	2021-01-17 16:57
Date.pm	4.46 KB	-rw-rw-rw-	2021-01-17 16:57
DynamicMethods.pm	2.92 KB	-rw-rw-rw-	2021-01-17 16:57
EventEmitter.pm	3.38 KB	-rw-rw-rw-	2021-01-17 16:57
Exception.pm	10.03 KB	-rw-rw-rw-	2021-01-17 16:57
File.pm	12.88 KB	-rw-rw-rw-	2021-01-17 16:57
Headers.pm	19.2 KB	-rw-rw-rw-	2021-01-17 16:57
HelloWorld.pm	883 B	-rw-rw-rw-	2021-01-17 16:57
Home.pm	1.64 KB	-rw-rw-rw-	2021-01-17 16:57
IOLoop.pm	17.77 KB	-rw-rw-rw-	2021-01-17 16:57
JSON.pm	8.95 KB	-rw-rw-rw-	2021-01-17 16:57
Loader.pm	5.09 KB	-rw-rw-rw-	2021-01-17 16:57
Log.pm	6.72 KB	-rw-rw-rw-	2021-01-17 16:57
Message.pm	17.13 KB	-rw-rw-rw-	2021-01-17 16:57
Parameters.pm	8.75 KB	-rw-rw-rw-	2021-01-17 16:57
Path.pm	7.92 KB	-rw-rw-rw-	2021-01-17 16:57
Promise.pm	14.81 KB	-rw-rw-rw-	2021-01-17 16:57
Reactor.pm	5.6 KB	-rw-rw-rw-	2021-01-17 16:57
Server.pm	4.37 KB	-rw-rw-rw-	2021-01-17 16:57
Template.pm	17.8 KB	-rw-rw-rw-	2021-01-17 16:57
Transaction.pm	6.85 KB	-rw-rw-rw-	2021-01-17 16:57
URL.pm	12.53 KB	-rw-rw-rw-	2021-01-17 16:57
Upload.pm	1.57 KB	-rw-rw-rw-	2021-01-17 16:57
UserAgent.pm	34.04 KB	-rw-rw-rw-	2021-01-17 16:57
Util.pm	22.59 KB	-rw-rw-rw-	2021-01-17 16:57
WebSocket.pm	7.1 KB	-rw-rw-rw-	2021-01-17 16:57

Rename

package Mojo::DynamicMethods;
use Mojo::Base -strict;

use Hash::Util::FieldHash qw(fieldhash);
use Mojo::Util qw(monkey_patch);

sub import {
  my ($flag, $caller) = ($_[1] // '', caller);
  return unless $flag eq '-dispatch';

my $dyn_pkg    = "${caller}::_Dynamic";
  my $caller_can = $caller->can('SUPER::can');
  monkey_patch $dyn_pkg, 'can', sub {
    my ($self, $method, @rest) = @_;

# Delegate to our parent's "can" if there is one, without breaking if not
    my $can = $self->$caller_can($method, @rest);
    return undef unless $can;
    no warnings 'once';
    my $h = do { no strict 'refs'; *{"${dyn_pkg}::${method}"}{CODE} };
    return $h && $h eq $can ? undef : $can;
  };

{
    no strict 'refs';
    unshift @{"${caller}::ISA"}, $dyn_pkg;
  }
}

sub register {
  my ($target, $object, $name, $code) = @_;

state %dyn_methods;
  state $setup = do { fieldhash %dyn_methods; 1 };

my $dyn_pkg = "${target}::_Dynamic";
  monkey_patch($dyn_pkg, $name, $target->BUILD_DYNAMIC($name, \%dyn_methods))
    unless do { no strict 'refs'; *{"${dyn_pkg}::${name}"}{CODE} };
  $dyn_methods{$object}{$name} = $code;
}

=encoding utf8

=head1 NAME

Mojo::DynamicMethods - Fast dynamic method dispatch

=head1 SYNOPSIS

package MyClass;
  use Mojo::Base -base, -signatures;

use Mojo::DynamicMethods -dispatch;

sub BUILD_DYNAMIC ($class, $method, $dyn_methods) {
    return sub {...};
  }

sub add_helper ($self, $name, $cb) {
    Mojo::DynamicMethods::register 'MyClass', $self, $name, $cb;
  }

package main;

# Generate methods dynamically (and hide them from "$obj->can(...)")
  my $obj = MyClass->new;
  $obj->add_helper(foo => sub { warn 'Hello Helper!' });
  $obj->foo;

=head1 DESCRIPTION

L<Mojo::DynamicMethods> provides dynamic method dispatch for per-object helper methods without requiring use of
C<AUTOLOAD>.

To opt your class into dynamic dispatch simply pass the C<-dispatch> flag.

use Mojo::DynamicMethods -dispatch;

And then implement a C<BUILD_DYNAMIC> method in your class, making sure that the key you use to lookup methods in
C<$dyn_methods> is the same thing you pass as C<$ref> to L</"register">.

sub BUILD_DYNAMIC ($class, $method, $dyn_methods) {
    return sub ($self, @args) {
      my $dynamic = $dyn_methods->{$self}{$method};
      return $self->$dynamic(@args) if $dynamic;
      my $package = ref $self;
      croak qq{Can't locate object method "$method" via package "$package"};
    };
  }

Note that this module is B<EXPERIMENTAL> and might change without warning!

=head1 FUNCTIONS

L<Mojo::DynamicMethods> implements the following functions.

=head2 register

Mojo::DynamicMethods::register $class, $ref, $name, $cb;

Registers the method C<$name> as eligible for dynamic dispatch for C<$class>, and sets C<$cb> to be looked up for
C<$name> by reference C<$ref> in a dynamic method constructed by C<BUILD_DYNAMIC>.

=head1 SEE ALSO

L<Mojolicious>, L<Mojolicious::Guides>, L<https://mojolicious.org>.

=cut