lib/Frey/Introspect.pm

package Frey::Introspect;

use Moose;
use Carp;
#use Moose::Meta::Role;
#use Moose::Meta::Class;
use Data::Dump qw/dump/;
use File::Slurp;
use List::Util;

use lib 'lib';

extends 'Frey';
with 'Frey::Web';

has 'package' => (
        is => 'rw',
        isa => 'Str',
        required => 1,
);

has 'path' => (
        is => 'rw',
);

=head2 joose

  my $js = $o->joose;

=cut

sub joose {
        my ($self) = @_;

        my ( $meta, $is_role ) = $self->load_package;

        if ( ! $is_role ) {
                my @superclasses = map{ $_->meta->name }
                        grep { $_ ne 'Moose::Object' } $meta->superclasses;
                warn "superclasses ",dump( @superclasses ) if $self->debug;
        }

        my $out;

        my ( $m, $c ) = split(/::/, $self->package, 2);
        my $filename = $m . '.' . ( $c ? "$c." : '' ) . 'js';

        $c ||= '';

        $out .= "Module(\"$m\", function (m) {\n\tClass(\"$c\", {\n\t\thas: {\n";

        foreach ( $meta->get_attribute_list ) {
                $out .= "\t\t\t$_: {\n";

                my $attr = $meta->get_attribute($_);
                my $is = $attr->_is_metadata;
                $out .= "\t\t\t\tis: \"$is\",\n" if defined $is;
                $out .= "\t\t\t\tlazy: true,\n" if $attr->is_lazy;
                $out .= "\t\t\t\trequired: true,\n" if $attr->is_required;
                $out .= "\t\t\t\tinit: \"" . $attr->init_arg . "\",\n" if $attr->init_arg;      # FIXME

                if( defined(my $isa = $attr->_isa_metadata) ){
                        if( blessed $isa ){
                                while( blessed $isa ){
                                        $isa = $isa->name;
                                }
                        }
                        $isa =~ s/\s+\|\s+undef//gi;
                        $out .= "\t\t\t\tisa: Moose.$isa,\n";
                }


                $out .= "\t\t\t},\n";

        }

        $out .= "\t\t},\n\t\tmeta: Frey.HTML,
                classMethods: {
                        renderHTML: function () {
                                return new Joose.SimpleRequest().getText(\"/~/" . $self->package . "\")
                        },\n";

        $out .= "\t\t},\n";

        $out .= "\t}),\n";

        $out =~ s/,\n$/\n/;
        $out .= "});\n";

        $out .= "\nconsole.log( 'loaded " . $self->package . " from $filename' );\n";

        warn "method_list = ",dump( $meta->get_method_list ) if $self->debug;

#       print $out;
        my $path = "static/blib/$filename";
        write_file( $path, $out );
        warn "# created $path\n";
        $self->path( $path );

        return $out;
}

=head2 methods

  my @methods = $o->methods;

=cut

sub methods {
        my $self = shift;

        my ( $meta, $is_role ) = $self->load_package;

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

        return sort @methods;
}

use Frey::ClassLoader;

sub load_package {
        my $self = shift;
        return Frey::ClassLoader->load_package( $self->package );
}


=head1 OUTPUT GENERATION

=head2 markup

  $o->markup;

=cut

sub markup {
        my ( $self ) = @_;

        $self->add_head( 'static/introspect.css' );

        my ( $meta, $is_role ) = $self->load_package;

        my $package = $self->package;

        my @methods;
        @methods = map { qq|<td class="m">$_</td>| } $self->methods;

        my @attributes;
        if ( $meta->get_attribute_list ) {
        @attributes = map {
                        my $attr = $meta->get_attribute($_);
                        my ( $before, $title, $after ) = ( '', '', '' );
                        ( $before, $title, $after ) = ( '<b>', ' title="required"', '</b>' ) if $attr->is_required;
warn $attr->dump(3);
                        foreach my $check ( qw/has_type_constraint has_handles is_weak_ref is_required is_lazy should_coerce should_auto_deref has_trigger has_documentation has_applied_traits/ ) {
                                my $getter;
                                
                                $getter = $check;
                                $getter =~ s/^has_//;
                                
                                if ( $attr->$check ) {
                                        if ( $getter eq $check ) {
                                                $after .= "$check";
                                        } else {
                                                $after .= qq{<span class="frey-popdown">$check};
                                                $after .= '<code>' . $attr->$getter->dump . '</code>' if $getter ne $check;
                                                $after .= '</span>';
                                        }
                                }
                                $after .= ' ';
                        }
                        qq|<td class="a">$before $_</td><td>$after</td>|
                } sort $meta->get_attribute_list
        }

        my $table = qq|<table class="frey-object-browser"><tr><th class="m">Methods</th><th class="a">Attributes</th><th class="p">Properties</th></tr>|;
        while ( @methods || @attributes ) {
                my ($m,$a) = ( shift @methods, shift @attributes );
                $m ||= '<td></td>';
                $a ||= '<td></td>';
                $table .= qq|<tr>$m$a</tr>|;
        }
        $table .= qq|</table>|;

        my ( $superclasses, $roles ) = ( '<b>Role</b>', '' );
        if ( ! $is_role ) {
                if ( $meta->superclasses ) {
                        $superclasses = 'Superclasses: ' .
                                join(', ',
                                        map {
                                                my $name = $_->meta->name;
                                                qq|<a class="frey-popdown" href="/~/$name">$name<code>| . $_->meta->dump(2) . qq|</code></a>|;
                                        }
                                        #grep { $_ ne 'Moose::Object' }
                                        $meta->superclasses
                                );
                }
        }

        if ( $meta->can('roles') ) {
                $roles = join(', ',
                        grep { ! m/\Q$package\E/ }      # skip me
                        map {
                                my $name = $_->name;
                                qq|<a class="frey-popdown" href="/~/$name">$name<code>| . $name->meta->dump(2) . qq|</code></a>|;
                        }
                        $meta->calculate_all_roles
                );
                $roles = " with roles: $roles" if $roles;
        }

        my $pod = Frey::Pod->new( class => $package )->markup;

        use Frey::Run;
        my $execute = join("\n", map { qq|<a href="/$_/$package">$_</a>| } grep { $package->can($_) } Frey::Run->execute );
        $execute = " execute: $execute" if $execute;

        my $html = $self->page(
                title => "Introspect $package",
                body => qq|<h1>$package</h1>|
                        . qq|$superclasses\n$roles\n$execute\n|
                        . ( $pod ? qq|<a href="#___top" title="Skip to POD" style="font-size: 80%; color: #aaa;">&darr;pod&darr</a>| : '' )
                        . qq|$table\n$pod|

        );

        return $html;
}

=head1 SEE ALSO

L<MooseX::AutoDoc> on which this code is based

=cut

1;
1	dpavlin	49	package Frey::Introspect;
2
3			use Moose;
4			use Carp;
5	dpavlin	100	#use Moose::Meta::Role;
6			#use Moose::Meta::Class;
7	dpavlin	49	use Data::Dump qw/dump/;
8			use File::Slurp;
9	dpavlin	51	use List::Util;
10	dpavlin	49
11	dpavlin	55	use lib 'lib';
12	dpavlin	53
13	dpavlin	49	extends 'Frey';
14	dpavlin	100	with 'Frey::Web';
15	dpavlin	49
16			has 'package' => (
17			is => 'rw',
18			isa => 'Str',
19			required => 1,
20			);
21
22	dpavlin	51	has 'path' => (
23			is => 'rw',
24			);
25
26	dpavlin	53	=head2 joose
27
28	dpavlin	137	my $js = $o->joose;
29	dpavlin	53
30			=cut
31
32			sub joose {
33			my ($self) = @_;
34
35	dpavlin	137	my ( $meta, $is_role ) = $self->load_package;
36	dpavlin	53
37			if ( ! $is_role ) {
38	dpavlin	50	my @superclasses = map{ $_->meta->name }
39			grep { $_ ne 'Moose::Object' } $meta->superclasses;
40	dpavlin	100	warn "superclasses ",dump( @superclasses ) if $self->debug;
41	dpavlin	50	}
42	dpavlin	49
43			my $out;
44
45	dpavlin	137	my ( $m, $c ) = split(/::/, $self->package, 2);
46	dpavlin	51	my $filename = $m . '.' . ( $c ? "$c." : '' ) . 'js';
47	dpavlin	49
48	dpavlin	137	$c \|\|= '';
49
50	dpavlin	49	$out .= "Module(\"$m\", function (m) {\n\tClass(\"$c\", {\n\t\thas: {\n";
51
52	dpavlin	137	foreach ( $meta->get_attribute_list ) {
53	dpavlin	49	$out .= "\t\t\t$_: {\n";
54
55	dpavlin	137	my $attr = $meta->get_attribute($_);
56	dpavlin	50	my $is = $attr->_is_metadata;
57			$out .= "\t\t\t\tis: \"$is\",\n" if defined $is;
58			$out .= "\t\t\t\tlazy: true,\n" if $attr->is_lazy;
59			$out .= "\t\t\t\trequired: true,\n" if $attr->is_required;
60			$out .= "\t\t\t\tinit: \"" . $attr->init_arg . "\",\n" if $attr->init_arg; # FIXME
61
62			if( defined(my $isa = $attr->_isa_metadata) ){
63			if( blessed $isa ){
64			while( blessed $isa ){
65			$isa = $isa->name;
66			}
67			}
68			$isa =~ s/\s+\\|\s+undef//gi;
69			$out .= "\t\t\t\tisa: Moose.$isa,\n";
70			}
71
72
73	dpavlin	49	$out .= "\t\t\t},\n";
74
75			}
76
77	dpavlin	51	$out .= "\t\t},\n\t\tmeta: Frey.HTML,
78			classMethods: {
79			renderHTML: function () {
80	dpavlin	66	return new Joose.SimpleRequest().getText(\"/~/" . $self->package . "\")
81	dpavlin	51	},\n";
82
83	dpavlin	49	$out .= "\t\t},\n";
84
85			$out .= "\t}),\n";
86	dpavlin	50
87			$out =~ s/,\n$/\n/;
88	dpavlin	49	$out .= "});\n";
89
90	dpavlin	137	$out .= "\nconsole.log( 'loaded " . $self->package . " from $filename' );\n";
91	dpavlin	49
92	dpavlin	137	warn "method_list = ",dump( $meta->get_method_list ) if $self->debug;
93	dpavlin	49
94	dpavlin	51	# print $out;
95	dpavlin	49	my $path = "static/blib/$filename";
96			write_file( $path, $out );
97			warn "# created $path\n";
98	dpavlin	51	$self->path( $path );
99
100			return $out;
101	dpavlin	49	}
102
103	dpavlin	53	=head2 methods
104
105			my @methods = $o->methods;
106
107			=cut
108
109			sub methods {
110			my $self = shift;
111
112	dpavlin	137	my ( $meta, $is_role ) = $self->load_package;
113	dpavlin	53
114			my $attr;
115	dpavlin	137	$attr->{$_}++ foreach $meta->get_attribute_list;
116			my @methods = grep { ! defined($attr->{$_}) } $meta->get_method_list;
117	dpavlin	100	warn "# methods = ",dump( @methods ) if $self->debug;
118	dpavlin	53
119	dpavlin	120	return sort @methods;
120	dpavlin	53	}
121
122	dpavlin	100	use Frey::ClassLoader;
123
124			sub load_package {
125			my $self = shift;
126			return Frey::ClassLoader->load_package( $self->package );
127			}
128
129
130	dpavlin	53	=head1 OUTPUT GENERATION
131
132	dpavlin	269	=head2 markup
133	dpavlin	53
134	dpavlin	269	$o->markup;
135	dpavlin	53
136			=cut
137
138	dpavlin	269	sub markup {
139			my ( $self ) = @_;
140	dpavlin	53
141	dpavlin	160	$self->add_head( 'static/introspect.css' );
142	dpavlin	139
143	dpavlin	269	my ( $meta, $is_role ) = $self->load_package;
144	dpavlin	53
145	dpavlin	269	my $package = $self->package;
146	dpavlin	54
147	dpavlin	269	my @methods;
148			@methods = map { qq\|<td class="m">$_</td>\| } $self->methods;
149	dpavlin	53
150	dpavlin	269	my @attributes;
151			if ( $meta->get_attribute_list ) {
152			@attributes = map {
153			my $attr = $meta->get_attribute($_);
154			my ( $before, $title, $after ) = ( '', '', '' );
155			( $before, $title, $after ) = ( '<b>', ' title="required"', '</b>' ) if $attr->is_required;
156	dpavlin	198	warn $attr->dump(3);
157	dpavlin	269	foreach my $check ( qw/has_type_constraint has_handles is_weak_ref is_required is_lazy should_coerce should_auto_deref has_trigger has_documentation has_applied_traits/ ) {
158			my $getter;
159
160			$getter = $check;
161			$getter =~ s/^has_//;
162
163			if ( $attr->$check ) {
164			if ( $getter eq $check ) {
165			$after .= "$check";
166			} else {
167			$after .= qq{<span class="frey-popdown">$check};
168			$after .= '<code>' . $attr->$getter->dump . '</code>' if $getter ne $check;
169			$after .= '</span>';
170	dpavlin	197	}
171			}
172	dpavlin	269	$after .= ' ';
173			}
174			qq\|<td class="a">$before $_</td><td>$after</td>\|
175			} sort $meta->get_attribute_list
176			}
177	dpavlin	54
178	dpavlin	269	my $table = qq\|<table class="frey-object-browser"><tr><th class="m">Methods</th><th class="a">Attributes</th><th class="p">Properties</th></tr>\|;
179			while ( @methods \|\| @attributes ) {
180			my ($m,$a) = ( shift @methods, shift @attributes );
181			$m \|\|= '<td></td>';
182			$a \|\|= '<td></td>';
183			$table .= qq\|<tr>$m$a</tr>\|;
184			}
185			$table .= qq\|</table>\|;
186
187			my ( $superclasses, $roles ) = ( '<b>Role</b>', '' );
188			if ( ! $is_role ) {
189			if ( $meta->superclasses ) {
190			$superclasses = 'Superclasses: ' .
191			join(', ',
192			map {
193			my $name = $_->meta->name;
194			qq\|<a class="frey-popdown" href="/~/$name">$name<code>\| . $_->meta->dump(2) . qq\|</code></a>\|;
195			}
196			#grep { $_ ne 'Moose::Object' }
197			$meta->superclasses
198			);
199	dpavlin	120	}
200	dpavlin	269	}
201	dpavlin	100
202	dpavlin	269	if ( $meta->can('roles') ) {
203			$roles = join(', ',
204			grep { ! m/\Q$package\E/ } # skip me
205			map {
206			my $name = $_->name;
207			qq\|<a class="frey-popdown" href="/~/$name">$name<code>\| . $name->meta->dump(2) . qq\|</code></a>\|;
208	dpavlin	124	}
209	dpavlin	269	$meta->calculate_all_roles
210			);
211			$roles = " with roles: $roles" if $roles;
212			}
213	dpavlin	128
214	dpavlin	269	my $pod = Frey::Pod->new( class => $package )->markup;
215	dpavlin	134
216	dpavlin	269	use Frey::Run;
217			my $execute = join("\n", map { qq\|<a href="/$_/$package">$_</a>\| } grep { $package->can($_) } Frey::Run->execute );
218			$execute = " execute: $execute" if $execute;
219	dpavlin	128
220	dpavlin	269	my $html = $self->page(
221			title => "Introspect $package",
222			body => qq\|<h1>$package</h1>\|
223			. qq\|$superclasses\n$roles\n$execute\n\|
224			. ( $pod ? qq\|<a href="#___top" title="Skip to POD" style="font-size: 80%; color: #aaa;">↓pod&darr</a>\| : '' )
225			. qq\|$table\n$pod\|
226	dpavlin	227
227	dpavlin	269	);
228	dpavlin	128
229	dpavlin	269	return $html;
230	dpavlin	53	}
231
232	dpavlin	49	=head1 SEE ALSO
233
234			L<MooseX::AutoDoc> on which this code is based
235
236			=cut
237
238			1;