--- trunk/lib/Frey/Introspect.pm 2008/11/18 16:54:10 418
+++ trunk/lib/Frey/Introspect.pm 2008/12/05 17:34:42 727
@@ -11,10 +11,13 @@
use PPI;
use PPI::HTML;
+use Frey::Pod;
+
use lib 'lib';
-extends 'Frey::ClassLoader';
+extends 'Frey::PPI';
with 'Frey::Web';
+with 'Frey::Storage';
has 'class' => (
is => 'rw',
@@ -22,10 +25,6 @@
required => 1,
);
-has 'path' => (
- is => 'rw',
-);
-
=head2 joose
my $js = $o->joose;
@@ -98,20 +97,11 @@
my $path = "static/blib/$filename";
write_file( $path, $out );
warn "# created $path\n";
- $self->path( $path );
return $out;
}
-=head1 OUTPUT GENERATION
-
-=head2 markup
-
- $o->markup;
-
-=cut
-
-sub markup {
+sub as_markup {
my ( $self ) = @_;
$self->add_head( 'static/introspect.css' );
@@ -120,6 +110,10 @@
my $class = $self->class;
+ my $introspect_path = "var/introspect/$class.yaml";
+ $self->mkbasepath( $introspect_path );
+ my $introspect = $self->load( $introspect_path );
+
my ( $superclasses, $roles ) = ( 'Role', '' );
if ( ! $is_role ) {
if ( $meta->superclasses ) {
@@ -127,7 +121,8 @@
join(', ',
map {
my $name = $_->meta->name;
- qq|$name| . $_->meta->dump(2) . qq|
|;
+ $introspect->{superclass}->{$name}++;
+ $self->dropdown( $name, $_->meta )
}
#grep { $_ ne 'Moose::Object' }
$meta->superclasses
@@ -144,9 +139,10 @@
grep { ! m/\Q$class\E/ } # skip me
map {
my $name = $_->name;
+ $introspect->{role}->{$name}++;
$role_method->{ $_ }->{$name} = $role_nr foreach $_->get_method_list;
$role_attribute->{ $_ }->{$name} = $role_nr foreach $_->get_attribute_list;
- qq|$name| . $name->meta->dump(2) . qq|
| . $role_nr++ . qq||;
+ $self->dropdown( $name, $name->meta ) . qq|| . $role_nr++ . qq||;
}
$meta->calculate_all_roles
);
@@ -157,23 +153,29 @@
my @methods;
@methods = map {
my $name = $_;
+ $introspect->{method}->{$name}++;
if ( $role_method->{$name} ) {
my ( $role_name, $nr ) = each %{ $role_method->{$name} };
$name .= qq|$nr|;
}
qq|
$name | |
- } $self->class_methods( $class );
+ } sort $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 ( $before, $title, $after ) = ( '', '', '' );
- ( $before, $title, $after ) = ( '', ' title="required"', '' ) if $attr->can('is_required') && $attr->is_required;
- 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_documentation has_applied_traits/ ) {
+
+ my ( $title, $properties ) = ( '', '' );
+ ( $html_name, $title ) = ( "$name", ' title="required"' )
+ if $attr->can('is_required') && $attr->is_required;
+
+ 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;
@@ -181,15 +183,13 @@
if ( $attr->can($check) && $attr->$check ) {
if ( $getter eq $check ) {
- $after .= "$check";
+ $properties .= "$check";
} else {
- $after .= qq{$check};
- # we need dump here instead of $attr->$getter->dump because default can return scalar
- $after .= '' . dump( $attr->$getter ) . '
' if $getter ne $check;
- $after .= '';
+ # we need our dump here instead of $attr->$getter->dump because default can return scalar
+ $properties .= $self->dropdown( $check, $attr->$getter );
}
}
- $after .= ' ';
+ $properties .= ' ';
}
my $type = $attr->can('has_type_constraint') && $attr->has_type_constraint ? $attr->type_constraint->name : '';
@@ -198,8 +198,10 @@
$name .= qq|$nr|;
}
- qq|$before $name | $type | $after | |
- } $meta->get_attribute_list
+ eval { $properties = $attr->documentation . ' ' . $properties };
+
+ qq|$html_name | $type | $properties | |
+ } sort $meta->get_attribute_list
}
my $table = qq|Methods | Attributes | Type | Properties |
|;
@@ -211,10 +213,11 @@
}
$table .= qq|
|;
- my $pod = Frey::Pod->new( class => $class )->markup;
- $pod = $pod->{body} if ref($pod);
-
my $path = $self->class_path( $class );
+
+ my $pod = Frey::Pod->new( class => $class, request_url => $self->request_url )->as_markup;
+ return $pod if $path =~ m{\.pod};
+
my $Document = PPI::Document->new( $path );
# Create a reusable syntax highlighter
@@ -236,19 +239,34 @@
# $source =~ s{^.*]+>}{}s;
# $source =~ s{class_methods( $class );
my $runnable = join("\n",
- map { $class_method->{$_} ? qq|$_| : '' } grep { $class->can($_) } Frey::Run->runnable
+ map {
+ $introspect->{runnable}->{$_}++;
+ my $short = $_;
+ $short =~ s{_as_(?:markup|data|sponge)$}{};
+ qq|$short|
+ } $self->class_runnable( $class )
);
- $runnable = " runnable: $runnable" if $runnable;
+ $runnable = "
run: $runnable" if $runnable;
+
+ $self->store( $introspect_path, $introspect );
$self->title( $class );
+ my $has_tests = '';
+ my @tests = grep { defined $_ } $self->has_tests;
+ if ( @tests ) {
+ $has_tests =
+ '
test' . ( $#tests > 0 ? 's' : '' ) . ': ' .
+ join("\n", map {
+ qq|$_|
+ } @tests );
+ }
+
return join("\n",
qq|$class
|,
qq|$superclasses\n$roles\n$runnable\n|,
+ $has_tests,
$pod ? qq|
pod| : '',
$source ? qq|
source| : '',
qq|$table\n$pod\n
\n|,