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 PPI;
use PPI::HTML;

use lib 'lib';
use Frey::Pod;

extends 'Frey::PPI';
with 'Frey::Web';
with 'Frey::Storage';

=head1 DESCRIPTION

Provide introspection on any perl class installed on system

=cut

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

=head2 joose

  my $js = $o->joose;

=cut

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

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

        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->class, 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 = eval { $attr->_is_metadata; };
                return if $@;

                $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->class . "\")
                        },\n";

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

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

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

        $out .= "\nconsole.log( 'loaded " . $self->class . " 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";

        return $out;
}

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

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

        my $class = $self->class;
        $self->title( $class );

        my $introspect_path = "var/introspect/$class.yaml";
        $self->mkbasepath( $introspect_path );
        my $introspect; # FIXME update with = $self->load( $introspect_path );

        my ( $superclasses, $roles ) = ( '<b>Role</b>', '' );
        if ( ! $is_role ) {
                if ( $meta->superclasses ) {
                        $superclasses = 'Superclasses: ' .
                                join(', ',
                                        map {
                                                my $name = $_->meta->name;
                                                $introspect->{superclass}->{$name} = {};

                                                qq|<a target="$name" href="/$name" title="introspect $name">$name</a>| .
                                                $self->dropdown( qq|<sup>?</sup>|, $_->meta )
                                        }
                                        #grep { $_ ne 'Moose::Object' }
                                        $meta->superclasses
                                );
                }
        }

        my $method_from_role;
        my $attribute_from_role;

        if ( $meta->can('roles') ) {
                my $role_nr = 1;
                $roles = join(' ',
                        grep { ! m/\Q$class\E/ }        # skip me
                        map {
                                my $name = $_->name;
                                $introspect->{roles}->{$name} = {};
                                $method_from_role->{    $_ }->{$name} = $role_nr foreach $_->get_method_list;
                                $attribute_from_role->{ $_ }->{$name} = $role_nr foreach $_->get_attribute_list;

                                  qq|<a target="$name" href="/$name" title="introspect $name">$name</a>|
#                               . qq|<sup>| . $self->dropdown( $role_nr++, $name->meta ) . qq|</sup>|
                                . $self->dropdown(
                                        qq|<sup>| . $role_nr++ . qq|</sup>|,
                                        $name->meta
                                )
                                ;
                        }
                        $meta->calculate_all_roles
                );
                $roles = qq|with roles: $roles| if $roles;
        }
        warn "# method_from_role ",dump( $method_from_role );

        my @methods;
        @methods = map {
                my $name = $_;
                if ( $method_from_role->{$name} ) {
                        my ( $role_name, $nr ) = each %{ $method_from_role->{$name} };
                        $introspect->{methods}->{$name}->{role} = $role_name;
                        $name .= qq|<sup title="$role_name">$nr</sup>|;
                } else {
                        $introspect->{methods}->{$name} = {};
                }
                qq|<td class="m">$name</td>|
        } sort {
                lc($a) cmp lc($b)       
        } $self->class_methods( $class );

        my @attributes;
        if ( $meta->get_attribute_list ) {
                @attributes = map {
                        my $name = $_;
                        $introspect->{attribute}->{$name} = {}; 
                        my $html_name = $name;
                        my $attr = $meta->get_attribute($name);
                        confess "$class attribute $name isn't blessed ",dump( $attr ) unless blessed $attr;
                        warn "## attr $name ref ",ref( $attr ) if $self->debug;

                        my ( $title, $properties ) = ( '', '' );
                        if ( $attr->can('is_required') && $attr->is_required ) {
                                ( $html_name, $title ) = ( "<b>$name</b>", ' title="required"' );
                                $introspect->{attribute}->{$name}->{required} = 1;
                        }

                        foreach my $check ( qw/has_type_constraint has_handles is_weak_ref is_required is_lazy should_coerce should_auto_deref has_default has_trigger has_applied_traits/ ) {
                                my $getter;
                                
                                $getter = $check;
                                $getter =~ s/^has_//;
                                
                                if ( $attr->can($check) && $attr->$check ) {
                                        $properties .= $check;
                                        # we need our dump here instead of $attr->$getter->dump because default can return scalar
                                        my $v = $attr->$getter;
                                        $properties .= ref($v)
                                                ? $self->dropdown( qq|<sup>?</sup>|, $attr->$getter )
                                                : qq| <code>$v</code>|
                                                ;
                                }
                                $properties .= ' ';
                        }
                        my $type = $attr->can('has_type_constraint') && $attr->has_type_constraint ? $attr->type_constraint->name : '';

                        if ( $attribute_from_role->{$name} ) {
                                my ( $role_name, $nr ) = each %{ $attribute_from_role->{$name} };
                                $name .= qq|<sup title="$role_name">$nr</sup>|;
                        }

                        if ( my $doc = eval { $attr->documentation } ) {
                                $properties = qq|
                                        $properties
                                        <span class="documentation">$doc</span>
                                |;
                                $self->add_css(qq|
                                        span.documentation {
                                                background: #eee;
                                                padding: 0.25em;
                                                float: left;
                                                clear: left;
                                        }
                                |);
                                $introspect->{action}->{$name}->{documentation} = $doc;
                        }

                        qq|<td class="a">$html_name</td><td class="t">$type</td><td class="p">$properties</td>|
                } sort $meta->get_attribute_list
        }

        my $table = qq|<table class="frey-introspect"><tr><th class="m">Methods</th><th class="a">Attributes</th><th>Type</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 $path = $self->class_path( $class );

        my ( $pod_toc, $pod ) = Frey::Pod->new( class => $class, request_url => $self->request_url )->as_markup;
        return $pod_toc . $pod if $path =~ m{\.pod};

        warn "# ", $pod_toc ? 'toc' : '', ' ', $pod ? 'pod' : '';

        my $Document = PPI::Document->new( $path );

        # Create a reusable syntax highlighter
        my $Highlight = PPI::HTML->new(
                line_numbers => 1,
#               page => 1,
#               colors => {
#                       line_number => '#CCCCCC',
#                       number      => '#990000',
#               },
        );

        # Spit out the HTML
        my $source = $Highlight->html( $Document );

        $source =~ s{(<span.*?line_number.*>\s*)(\d+)(:\s*</span>)}{$1<a target="editor" href="/editor+$path+$2">$2</a>$3}g;

        # strip page html
#       $source =~ s{^.*<body[^>]+>}{}s;
#       $source =~ s{</body.*$}{}s;

        my $runnable = join("</dd><dd>",
                map {
                        $introspect->{runnable}->{$_} = {};
                        my $short = $_;
                        $short =~ s{_as_(?:markup|data|sponge)$}{};
                        qq|<a target="$class" href="/$class/$_" title="/$class/$_">$short</a>|
                } $self->class_runnable( $class )
        );
        $runnable = "<dt>runnable</dt><dd>$runnable</dd>" if $runnable;

        my $has_tests = '';
        my @tests = sort { lc($a) cmp lc($b) } grep { defined $_ } $self->has_tests;
        if ( @tests ) {
                $has_tests
                        = qq|<dt>test|
                        . ( $#tests > 0 ? 's' : '' )
                        . qq|<dt><dd>|
                        . join("</dd><dd>", map {
                                qq|<a target="$class" href="/Frey::Test::Runner/as_markup?test=$_">$_</a>|
                        } @tests )
                        . qq|</dd>|
                        ;
                $introspect->{tests} = [ @tests ],
        }

        my $includes = '';
        if ( my $inc = $self->includes ) {
                $introspect->{includes} = $inc;
                foreach my $type ( keys %$inc ) {
                        $includes
                                .= ucfirst($type)
                                . qq|: |
                                . join("\n",
                                        map {
                                                qq|<a target="$_" href="/$_">$_</a>|
                                        } @{
                                                $inc->{$type}
                                        }
                                )
                                ;
                }
        }

        $self->store( $introspect_path, $introspect );

        $self->add_css(qq|
                .frey-introspect-right {
                        position: fixed;
                        top: 1em;
                        right: 1em;
                        z-index: 10;
                        background: #ffc;
                        padding: 0.5em;
                        width: 20%;
                        font-size: 80%;
                }
                .frey-introspect-right dl dd {
                        margin-left: 1em;
                }

                /* fix pod */
                .frey-introspect-right dd ul {
                        padding-left: 0;
                }
                .frey-introspect-right dl ul > li {
                        list-style: none;
                }
        |);

        my $has_pod = qq|
                <dt><a href="#___top" title="Skip to POD">pod</a></dt>
                <dd>$pod_toc</dd>
        | if $pod_toc;

        my $has_source = qq|
                <dt><a href="#source" title="Skip to source">source</a></dt>
        | if $source;

        my $right = qq|
                <dl>
                $runnable
                $has_tests
                $has_pod
                $has_source
                </dl>
        |;


        return
                qq|
                        <h1>$class</h1>
                        <div class="frey-introspect">
                                $superclasses $roles
                                <br>$includes
                        </div>
                        <div class="frey-introspect-right">
                                $right
                        </div>
                        $table
                        $pod
                        </div>

                        <h1>Source</h1><a name="source"></a>
                        <div class="frey-source">$source</div>
                |
                ;
}

=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	380	use PPI;
12			use PPI::HTML;
13
14	dpavlin	733	use lib 'lib';
15	dpavlin	631	use Frey::Pod;
16
17	dpavlin	496	extends 'Frey::PPI';
18	dpavlin	100	with 'Frey::Web';
19	dpavlin	602	with 'Frey::Storage';
20	dpavlin	49
21	dpavlin	943	=head1 DESCRIPTION
22
23			Provide introspection on any perl class installed on system
24
25			=cut
26
27	dpavlin	270	has 'class' => (
28	dpavlin	49	is => 'rw',
29			isa => 'Str',
30			required => 1,
31			);
32
33	dpavlin	53	=head2 joose
34
35	dpavlin	137	my $js = $o->joose;
36	dpavlin	53
37			=cut
38
39			sub joose {
40			my ($self) = @_;
41
42	dpavlin	308	my ( $meta, $is_role ) = $self->class_meta;
43	dpavlin	53
44			if ( ! $is_role ) {
45	dpavlin	50	my @superclasses = map{ $_->meta->name }
46			grep { $_ ne 'Moose::Object' } $meta->superclasses;
47	dpavlin	100	warn "superclasses ",dump( @superclasses ) if $self->debug;
48	dpavlin	50	}
49	dpavlin	49
50			my $out;
51
52	dpavlin	270	my ( $m, $c ) = split(/::/, $self->class, 2);
53	dpavlin	51	my $filename = $m . '.' . ( $c ? "$c." : '' ) . 'js';
54	dpavlin	49
55	dpavlin	137	$c \|\|= '';
56
57	dpavlin	49	$out .= "Module(\"$m\", function (m) {\n\tClass(\"$c\", {\n\t\thas: {\n";
58
59	dpavlin	137	foreach ( $meta->get_attribute_list ) {
60	dpavlin	49	$out .= "\t\t\t$_: {\n";
61
62	dpavlin	137	my $attr = $meta->get_attribute($_);
63	dpavlin	972	my $is = eval { $attr->_is_metadata; };
64			return if $@;
65
66	dpavlin	50	$out .= "\t\t\t\tis: \"$is\",\n" if defined $is;
67			$out .= "\t\t\t\tlazy: true,\n" if $attr->is_lazy;
68			$out .= "\t\t\t\trequired: true,\n" if $attr->is_required;
69			$out .= "\t\t\t\tinit: \"" . $attr->init_arg . "\",\n" if $attr->init_arg; # FIXME
70
71			if( defined(my $isa = $attr->_isa_metadata) ){
72			if( blessed $isa ){
73			while( blessed $isa ){
74			$isa = $isa->name;
75			}
76			}
77			$isa =~ s/\s+\\|\s+undef//gi;
78			$out .= "\t\t\t\tisa: Moose.$isa,\n";
79			}
80
81
82	dpavlin	49	$out .= "\t\t\t},\n";
83
84			}
85
86	dpavlin	51	$out .= "\t\t},\n\t\tmeta: Frey.HTML,
87			classMethods: {
88			renderHTML: function () {
89	dpavlin	292	return new Joose.SimpleRequest().getText(\"/" . $self->class . "\")
90	dpavlin	51	},\n";
91
92	dpavlin	49	$out .= "\t\t},\n";
93
94			$out .= "\t}),\n";
95	dpavlin	50
96			$out =~ s/,\n$/\n/;
97	dpavlin	49	$out .= "});\n";
98
99	dpavlin	270	$out .= "\nconsole.log( 'loaded " . $self->class . " from $filename' );\n";
100	dpavlin	49
101	dpavlin	137	warn "method_list = ",dump( $meta->get_method_list ) if $self->debug;
102	dpavlin	49
103	dpavlin	51	# print $out;
104	dpavlin	49	my $path = "static/blib/$filename";
105			write_file( $path, $out );
106			warn "# created $path\n";
107	dpavlin	51
108			return $out;
109	dpavlin	49	}
110
111	dpavlin	455	sub as_markup {
112	dpavlin	269	my ( $self ) = @_;
113	dpavlin	53
114	dpavlin	308	my ( $meta, $is_role ) = $self->class_meta;
115	dpavlin	53
116	dpavlin	270	my $class = $self->class;
117	dpavlin	802	$self->title( $class );
118	dpavlin	54
119	dpavlin	602	my $introspect_path = "var/introspect/$class.yaml";
120			$self->mkbasepath( $introspect_path );
121	dpavlin	735	my $introspect; # FIXME update with = $self->load( $introspect_path );
122	dpavlin	602
123	dpavlin	310	my ( $superclasses, $roles ) = ( '<b>Role</b>', '' );
124			if ( ! $is_role ) {
125			if ( $meta->superclasses ) {
126			$superclasses = 'Superclasses: ' .
127			join(', ',
128			map {
129			my $name = $_->meta->name;
130	dpavlin	733	$introspect->{superclass}->{$name} = {};
131	dpavlin	943
132			qq\|<a target="$name" href="/$name" title="introspect $name">$name</a>\| .
133			$self->dropdown( qq\|<sup>?</sup>\|, $_->meta )
134	dpavlin	310	}
135			#grep { $_ ne 'Moose::Object' }
136			$meta->superclasses
137			);
138			}
139			}
140
141	dpavlin	733	my $method_from_role;
142			my $attribute_from_role;
143	dpavlin	310
144			if ( $meta->can('roles') ) {
145			my $role_nr = 1;
146			$roles = join(' ',
147			grep { ! m/\Q$class\E/ } # skip me
148			map {
149			my $name = $_->name;
150	dpavlin	733	$introspect->{roles}->{$name} = {};
151			$method_from_role->{ $_ }->{$name} = $role_nr foreach $_->get_method_list;
152			$attribute_from_role->{ $_ }->{$name} = $role_nr foreach $_->get_attribute_list;
153	dpavlin	943
154			qq\|<a target="$name" href="/$name" title="introspect $name">$name</a>\|
155			# . qq\|<sup>\| . $self->dropdown( $role_nr++, $name->meta ) . qq\|</sup>\|
156			. $self->dropdown(
157			qq\|<sup>\| . $role_nr++ . qq\|</sup>\|,
158			$name->meta
159			)
160			;
161	dpavlin	310	}
162			$meta->calculate_all_roles
163			);
164	dpavlin	943	$roles = qq\|with roles: $roles\| if $roles;
165	dpavlin	310	}
166	dpavlin	733	warn "# method_from_role ",dump( $method_from_role );
167	dpavlin	310
168	dpavlin	269	my @methods;
169	dpavlin	310	@methods = map {
170	dpavlin	313	my $name = $_;
171	dpavlin	733	if ( $method_from_role->{$name} ) {
172			my ( $role_name, $nr ) = each %{ $method_from_role->{$name} };
173			$introspect->{methods}->{$name}->{role} = $role_name;
174	dpavlin	313	$name .= qq\|<sup title="$role_name">$nr</sup>\|;
175	dpavlin	733	} else {
176			$introspect->{methods}->{$name} = {};
177	dpavlin	310	}
178	dpavlin	313	qq\|<td class="m">$name</td>\|
179	dpavlin	884	} sort {
180			lc($a) cmp lc($b)
181			} $self->class_methods( $class );
182	dpavlin	53
183	dpavlin	269	my @attributes;
184			if ( $meta->get_attribute_list ) {
185	dpavlin	409	@attributes = map {
186	dpavlin	313	my $name = $_;
187	dpavlin	733	$introspect->{attribute}->{$name} = {};
188	dpavlin	582	my $html_name = $name;
189	dpavlin	313	my $attr = $meta->get_attribute($name);
190	dpavlin	416	confess "$class attribute $name isn't blessed ",dump( $attr ) unless blessed $attr;
191	dpavlin	393	warn "## attr $name ref ",ref( $attr ) if $self->debug;
192	dpavlin	582
193			my ( $title, $properties ) = ( '', '' );
194	dpavlin	733	if ( $attr->can('is_required') && $attr->is_required ) {
195			( $html_name, $title ) = ( "<b>$name</b>", ' title="required"' );
196			$introspect->{attribute}->{$name}->{required} = 1;
197			}
198	dpavlin	582
199			foreach my $check ( qw/has_type_constraint has_handles is_weak_ref is_required is_lazy should_coerce should_auto_deref has_default has_trigger has_applied_traits/ ) {
200	dpavlin	269	my $getter;
201
202			$getter = $check;
203			$getter =~ s/^has_//;
204
205	dpavlin	416	if ( $attr->can($check) && $attr->$check ) {
206	dpavlin	943	$properties .= $check;
207			# we need our dump here instead of $attr->$getter->dump because default can return scalar
208			my $v = $attr->$getter;
209			$properties .= ref($v)
210			? $self->dropdown( qq\|<sup>?</sup>\|, $attr->$getter )
211			: qq\| <code>$v</code>\|
212			;
213	dpavlin	197	}
214	dpavlin	582	$properties .= ' ';
215	dpavlin	269	}
216	dpavlin	416	my $type = $attr->can('has_type_constraint') && $attr->has_type_constraint ? $attr->type_constraint->name : '';
217	dpavlin	313
218	dpavlin	733	if ( $attribute_from_role->{$name} ) {
219			my ( $role_name, $nr ) = each %{ $attribute_from_role->{$name} };
220	dpavlin	313	$name .= qq\|<sup title="$role_name">$nr</sup>\|;
221			}
222
223	dpavlin	735	if ( my $doc = eval { $attr->documentation } ) {
224			$properties = qq\|
225			$properties
226			<span class="documentation">$doc</span>
227			\|;
228			$self->add_css(qq\|
229			span.documentation {
230			background: #eee;
231			padding: 0.25em;
232	dpavlin	736	float: left;
233			clear: left;
234	dpavlin	735	}
235			\|);
236			$introspect->{action}->{$name}->{documentation} = $doc;
237			}
238	dpavlin	582
239	dpavlin	943	qq\|<td class="a">$html_name</td><td class="t">$type</td><td class="p">$properties</td>\|
240	dpavlin	727	} sort $meta->get_attribute_list
241	dpavlin	269	}
242	dpavlin	54
243	dpavlin	312	my $table = qq\|<table class="frey-introspect"><tr><th class="m">Methods</th><th class="a">Attributes</th><th>Type</th><th class="p">Properties</th></tr>\|;
244	dpavlin	269	while ( @methods \|\| @attributes ) {
245			my ($m,$a) = ( shift @methods, shift @attributes );
246			$m \|\|= '<td></td>';
247			$a \|\|= '<td></td>';
248			$table .= qq\|<tr>$m$a</tr>\|;
249			}
250			$table .= qq\|</table>\|;
251
252	dpavlin	688	my $path = $self->class_path( $class );
253
254	dpavlin	1034	my ( $pod_toc, $pod ) = Frey::Pod->new( class => $class, request_url => $self->request_url )->as_markup;
255			return $pod_toc . $pod if $path =~ m{\.pod};
256	dpavlin	134
257	dpavlin	1034	warn "# ", $pod_toc ? 'toc' : '', ' ', $pod ? 'pod' : '';
258
259	dpavlin	406	my $Document = PPI::Document->new( $path );
260	dpavlin	380
261			# Create a reusable syntax highlighter
262			my $Highlight = PPI::HTML->new(
263	dpavlin	406	line_numbers => 1,
264	dpavlin	380	# page => 1,
265			# colors => {
266			# line_number => '#CCCCCC',
267			# number => '#990000',
268			# },
269			);
270
271			# Spit out the HTML
272			my $source = $Highlight->html( $Document );
273
274	dpavlin	407	$source =~ s{(<span.?line_number.>\s)(\d+)(:\s</span>)}{$1<a target="editor" href="/editor+$path+$2">$2</a>$3}g;
275	dpavlin	406
276			# strip page html
277	dpavlin	380	# $source =~ s{^.*<body[^>]+>}{}s;
278			# $source =~ s{</body.*$}{}s;
279
280	dpavlin	1022	my $runnable = join("</dd><dd>",
281	dpavlin	458	map {
282	dpavlin	733	$introspect->{runnable}->{$_} = {};
283	dpavlin	662	my $short = $_;
284			$short =~ s{_as_(?:markup\|data\|sponge)$}{};
285			qq\|<a target="$class" href="/$class/$_" title="/$class/$_">$short</a>\|
286	dpavlin	458	} $self->class_runnable( $class )
287	dpavlin	409	);
288	dpavlin	1022	$runnable = "<dt>runnable</dt><dd>$runnable</dd>" if $runnable;
289	dpavlin	128
290	dpavlin	496	my $has_tests = '';
291	dpavlin	1034	my @tests = sort { lc($a) cmp lc($b) } grep { defined $_ } $self->has_tests;
292	dpavlin	635	if ( @tests ) {
293	dpavlin	1022	$has_tests
294			= qq\|<dt>test\|
295			. ( $#tests > 0 ? 's' : '' )
296			. qq\|<dt><dd>\|
297			. join("</dd><dd>", map {
298			qq\|<a target="$class" href="/Frey::Test::Runner/as_markup?test=$_">$_</a>\|
299			} @tests )
300			. qq\|</dd>\|
301			;
302	dpavlin	943	$introspect->{tests} = [ @tests ],
303	dpavlin	496	}
304
305	dpavlin	943	my $includes = '';
306			if ( my $inc = $self->includes ) {
307			$introspect->{includes} = $inc;
308			foreach my $type ( keys %$inc ) {
309			$includes
310			.= ucfirst($type)
311			. qq\|: \|
312			. join("\n",
313			map {
314			qq\|<a target="$_" href="/$_">$_</a>\|
315			} @{
316			$inc->{$type}
317			}
318			)
319			;
320			}
321			}
322
323			$self->store( $introspect_path, $introspect );
324
325	dpavlin	993	$self->add_css(qq\|
326	dpavlin	1034	.frey-introspect-right {
327	dpavlin	993	position: fixed;
328			top: 1em;
329			right: 1em;
330			z-index: 10;
331	dpavlin	1022	background: #ffc;
332			padding: 0.5em;
333			width: 20%;
334			font-size: 80%;
335	dpavlin	993	}
336	dpavlin	1034	.frey-introspect-right dl dd {
337	dpavlin	1022	margin-left: 1em;
338			}
339	dpavlin	1034
340			/* fix pod */
341			.frey-introspect-right dd ul {
342			padding-left: 0;
343			}
344			.frey-introspect-right dl ul > li {
345			list-style: none;
346			}
347	dpavlin	993	\|);
348
349	dpavlin	1034	my $has_pod = qq\|
350			<dt><a href="#___top" title="Skip to POD">pod</a></dt>
351			<dd>$pod_toc</dd>
352			\| if $pod_toc;
353	dpavlin	1018
354	dpavlin	1034	my $has_source = qq\|
355			<dt><a href="#source" title="Skip to source">source</a></dt>
356			\| if $source;
357
358			my $right = qq\|
359			<dl>
360			$runnable
361			$has_tests
362			$has_pod
363			$has_source
364			</dl>
365			\|;
366
367
368	dpavlin	1018	return
369	dpavlin	993	qq\|
370			<h1>$class</h1>
371			<div class="frey-introspect">
372			$superclasses $roles
373			<br>$includes
374			</div>
375	dpavlin	1034	<div class="frey-introspect-right">
376	dpavlin	1017	$right
377	dpavlin	993	</div>
378			$table
379			$pod
380			</div>
381
382			<h1>Source</h1><a name="source"></a>
383			<div class="frey-source">$source</div>
384	dpavlin	1018	\|
385			;
386	dpavlin	53	}
387
388	dpavlin	49	=head1 SEE ALSO
389
390			L<MooseX::AutoDoc> on which this code is based
391
392			=cut
393
394			1;