lib/Frey/ClassLoader.pm

package Frey::ClassLoader;
use Moose;

=head1 DESCRIPTION

Load L<Frey> classes

=cut

extends 'Frey';

use Data::Dump qw/dump/;
use File::Find;

our $class_path;
our @classes;

=head2 classes

Return all local classes by reading from disk

  my @classes = $o->classes;

=cut

sub classes {
        my $self = shift;
        return @classes if @classes;

        # FIXME there must be better way to do this in Moose style
        finddepth({ no_chdir => 1, wanted => sub {
                return unless m{\.pm$};
                my $class = $_;
                $class =~ s{^lib/}{};
                $class =~ s{\.pm$}{};
                $class =~ s{/}{::}g;
                $class_path->{ $class } = $_;
        } }, 'lib');
        warn "## class_path = ",dump( $class_path ) if $self->debug;

        @classes = sort keys %$class_path;
}

=head2 class_path

Return any local or loaded class

  $path = $o->class_path( $class );

=cut

sub class_path {
        my ( $self, $class ) = @_;
        $self->classes unless $class_path;
        if ( ! defined $class_path->{$class} ) {
                my $path = $class;
                $path =~ s{::}{/}g;
                $path .= '.pm';
                $path = $INC{$path};
                warn "# $class from INC $path";
                $class_path->{$class} = $path || confess "can't find path for $class";
        }
        return $class_path->{$class};
}

=head2 loaded_classes

  my $available = $o->loaded_classes;
  $available->{'Frey'} # true

=cut

our $loaded_class;
sub loaded_classes { $loaded_class };

=head2 class_meta

  my ( $meta, $is_role, $instance ) = $o->class_meta( 'Some::Class' );

=cut

sub class_meta {
        my ( $self, $class ) = @_;

        $class ||= $self->class if $self->can('class');
        warn "# class_meta $class";

        $self->load_class($class);

        my $meta;
        my $is_role = 0;
        my $instance;

        if ( ! $class->can('meta') ) {
                $instance = Moose::Meta::Class->create_anon_class;
                warn "# class $class isn't Moose, faking anon class" if $self->debug;
                $meta = $instance->meta;
        } elsif( $class->meta->isa('Moose::Meta::Role') ) {
                $is_role = 1;
                $instance = Frey->new;
                warn "# apply $class on $instance";
                $class->meta->apply( $instance );
                $meta = $instance->meta;
        } else {
                $meta = $class->meta;
        }
        return ( $meta, $is_role, $instance );
}

sub load_class {
        my ( $self, $class ) = @_;
        return if $loaded_class->{$class}++;
        eval {
                Class::MOP::load_class($class)
        };
        warn $@ if $@; # && $@ !~ m/role/;
        warn "# load_class $class" if $self->debug && $loaded_class->{$class} == 1;
}

sub load_all_classes {
        my $self = shift;
        warn "# loaded_class = ",dump( $loaded_class ) if $self->debug;
        $self->load_class( $_ ) foreach ( $self->classes );
        $loaded_class;
}

=head2 class_methods

  my @all_methods = $o->class_methods( $class );

  my $class_method = $o->class_methods( $class );
  if ( $class_method->{ $method } ) {
        # $class has $method
  }

=cut

sub class_methods {
        my ( $self, $class ) = @_;

        confess "need class" unless $class;
        if ( ! $class->can('meta') ) {
                warn "# $class doesn't have meta (isn't Moose class)" if $self->debug;
                return;
        }
        my $meta = $class->meta;

        my $attr;
        my $methods;
        $attr->{$_}++ foreach $meta->get_attribute_list;
        my @methods = map { $methods->{$_}++; $_ } grep { ! defined($attr->{$_}) && $_ ne 'meta' } $meta->get_method_list;
        warn "# methods = ",dump( @methods ) if $self->debug;

        return @methods if wantarray;
        return $methods;
}

=head2 class_runnable

  my @runnable_methods = $o->class_runnable( $class );

=cut

sub class_runnable {
        my ( $self, $class ) = @_;
        my @methods = grep { m{^as_} } $self->class_methods( $class );
        return @methods if wantarray;
        return \@methods;
}

sub class_inputs {
        my ( $self, $class ) = @_;
        my @inputs = grep { m{^(markup/as_data/as_sponge)$} } $self->class_methods( $class );
        return @inputs if wantarray;
        return \@inputs;
}

=head2 new_frey_class

  my $instance = $o->new_frey_class( $class, $params );

This will apply L<Moose::Role> on the fly to provide accessors for
C<data> and C<sponge> in form of C<as_*>

See L<http://www.perlmonks.org/?node_id=602389>

It is used by L<Frey::Run> and L<Frey::Pipe> to create objects

=cut

{
        package Frey::Role::as_data;
        use Moose::Role;

        sub as_data {
                my ($self) = @_;
                $self->data;
        }

        package Frey::Role::as_sponge;
        use Moose::Role;
        sub as_sponge {
                my ($self) = @_;
                $self->sponge;
        }
}

sub new_frey_class {
        my ( $self, $class, $params ) = @_;
        my $instance = $class->new( %$params );
        if ( $instance->can('data') && ! $instance->can('as_data') ) {
                Frey::Role::as_data->meta->apply( $instance );
                warn "# apply as_data role to $class";
        }
        if ( $instance->can('sponge') && ! $instance->can('as_sponge') ) {
                Frey::Role::as_sponge->meta->apply( $instance );
                warn "# apply as_sponge role to $class";
        }
        return $instance;
}

1;
1	package Frey::ClassLoader;
2	use Moose;
3
4	=head1 DESCRIPTION
5
6	Load L<Frey> classes
7
8	=cut
9
10	extends 'Frey';
11
12	use Data::Dump qw/dump/;
13	use File::Find;
14
15	our $class_path;
16	our @classes;
17
18	=head2 classes
19
20	Return all local classes by reading from disk
21
22	my @classes = $o->classes;
23
24	=cut
25
26	sub classes {
27	my $self = shift;
28	return @classes if @classes;
29
30	# FIXME there must be better way to do this in Moose style
31	finddepth({ no_chdir => 1, wanted => sub {
32	return unless m{\.pm$};
33	my $class = $_;
34	$class =~ s{^lib/}{};
35	$class =~ s{\.pm$}{};
36	$class =~ s{/}{::}g;
37	$class_path->{ $class } = $_;
38	} }, 'lib');
39	warn "## class_path = ",dump( $class_path ) if $self->debug;
40
41	@classes = sort keys %$class_path;
42	}
43
44	=head2 class_path
45
46	Return any local or loaded class
47
48	$path = $o->class_path( $class );
49
50	=cut
51
52	sub class_path {
53	my ( $self, $class ) = @_;
54	$self->classes unless $class_path;
55	if ( ! defined $class_path->{$class} ) {
56	my $path = $class;
57	$path =~ s{::}{/}g;
58	$path .= '.pm';
59	$path = $INC{$path};
60	warn "# $class from INC $path";
61	$class_path->{$class} = $path \|\| confess "can't find path for $class";
62	}
63	return $class_path->{$class};
64	}
65
66	=head2 loaded_classes
67
68	my $available = $o->loaded_classes;
69	$available->{'Frey'} # true
70
71	=cut
72
73	our $loaded_class;
74	sub loaded_classes { $loaded_class };
75
76	=head2 class_meta
77
78	my ( $meta, $is_role, $instance ) = $o->class_meta( 'Some::Class' );
79
80	=cut
81
82	sub class_meta {
83	my ( $self, $class ) = @_;
84
85	$class \|\|= $self->class if $self->can('class');
86	warn "# class_meta $class";
87
88	$self->load_class($class);
89
90	my $meta;
91	my $is_role = 0;
92	my $instance;
93
94	if ( ! $class->can('meta') ) {
95	$instance = Moose::Meta::Class->create_anon_class;
96	warn "# class $class isn't Moose, faking anon class" if $self->debug;
97	$meta = $instance->meta;
98	} elsif( $class->meta->isa('Moose::Meta::Role') ) {
99	$is_role = 1;
100	$instance = Frey->new;
101	warn "# apply $class on $instance";
102	$class->meta->apply( $instance );
103	$meta = $instance->meta;
104	} else {
105	$meta = $class->meta;
106	}
107	return ( $meta, $is_role, $instance );
108	}
109
110	sub load_class {
111	my ( $self, $class ) = @_;
112	return if $loaded_class->{$class}++;
113	eval {
114	Class::MOP::load_class($class)
115	};
116	warn $@ if $@; # && $@ !~ m/role/;
117	warn "# load_class $class" if $self->debug && $loaded_class->{$class} == 1;
118	}
119
120	sub load_all_classes {
121	my $self = shift;
122	warn "# loaded_class = ",dump( $loaded_class ) if $self->debug;
123	$self->load_class( $_ ) foreach ( $self->classes );
124	$loaded_class;
125	}
126
127	=head2 class_methods
128
129	my @all_methods = $o->class_methods( $class );
130
131	my $class_method = $o->class_methods( $class );
132	if ( $class_method->{ $method } ) {
133	# $class has $method
134	}
135
136	=cut
137
138	sub class_methods {
139	my ( $self, $class ) = @_;
140
141	confess "need class" unless $class;
142	if ( ! $class->can('meta') ) {
143	warn "# $class doesn't have meta (isn't Moose class)" if $self->debug;
144	return;
145	}
146	my $meta = $class->meta;
147
148	my $attr;
149	my $methods;
150	$attr->{$_}++ foreach $meta->get_attribute_list;
151	my @methods = map { $methods->{$_}++; $_ } grep { ! defined($attr->{$_}) && $_ ne 'meta' } $meta->get_method_list;
152	warn "# methods = ",dump( @methods ) if $self->debug;
153
154	return @methods if wantarray;
155	return $methods;
156	}
157
158	=head2 class_runnable
159
160	my @runnable_methods = $o->class_runnable( $class );
161
162	=cut
163
164	sub class_runnable {
165	my ( $self, $class ) = @_;
166	my @methods = grep { m{^as_} } $self->class_methods( $class );
167	return @methods if wantarray;
168	return \@methods;
169	}
170
171	sub class_inputs {
172	my ( $self, $class ) = @_;
173	my @inputs = grep { m{^(markup/as_data/as_sponge)$} } $self->class_methods( $class );
174	return @inputs if wantarray;
175	return \@inputs;
176	}
177
178	=head2 new_frey_class
179
180	my $instance = $o->new_frey_class( $class, $params );
181
182	This will apply L<Moose::Role> on the fly to provide accessors for
183	C<data> and C<sponge> in form of C<as_*>
184
185	See L<http://www.perlmonks.org/?node_id=602389>
186
187	It is used by L<Frey::Run> and L<Frey::Pipe> to create objects
188
189	=cut
190
191	{
192	package Frey::Role::as_data;
193	use Moose::Role;
194
195	sub as_data {
196	my ($self) = @_;
197	$self->data;
198	}
199
200	package Frey::Role::as_sponge;
201	use Moose::Role;
202	sub as_sponge {
203	my ($self) = @_;
204	$self->sponge;
205	}
206	}
207
208	sub new_frey_class {
209	my ( $self, $class, $params ) = @_;
210	my $instance = $class->new( %$params );
211	if ( $instance->can('data') && ! $instance->can('as_data') ) {
212	Frey::Role::as_data->meta->apply( $instance );
213	warn "# apply as_data role to $class";
214	}
215	if ( $instance->can('sponge') && ! $instance->can('as_sponge') ) {
216	Frey::Role::as_sponge->meta->apply( $instance );
217	warn "# apply as_sponge role to $class";
218	}
219	return $instance;
220	}
221
222	1;