--- trunk/lib/Frey/Introspect.pm 2008/11/05 08:20:59 288 +++ trunk/lib/Frey/Introspect.pm 2008/12/10 20:45:11 802 @@ -8,10 +8,15 @@ use File::Slurp; use List::Util; +use PPI; +use PPI::HTML; + use lib 'lib'; +use Frey::Pod; -extends 'Frey'; +extends 'Frey::PPI'; with 'Frey::Web'; +with 'Frey::Storage'; has 'class' => ( is => 'rw', @@ -19,10 +24,6 @@ required => 1, ); -has 'path' => ( - is => 'rw', -); - =head2 joose my $js = $o->joose; @@ -32,7 +33,7 @@ sub joose { my ($self) = @_; - my ( $meta, $is_role ) = $self->load_class; + my ( $meta, $is_role ) = $self->class_meta; if ( ! $is_role ) { my @superclasses = map{ $_->meta->name } @@ -77,7 +78,7 @@ $out .= "\t\t},\n\t\tmeta: Frey.HTML, classMethods: { renderHTML: function () { - return new Joose.SimpleRequest().getText(\"/Frey-Introspect?class=" . $self->class . "\") + return new Joose.SimpleRequest().getText(\"/" . $self->class . "\") },\n"; $out .= "\t\t},\n"; @@ -95,88 +96,133 @@ 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_class; - - 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_class { - my $self = shift; - return Frey::ClassLoader->load_package( $self->class ); -} - +sub as_markup { + my ( $self ) = @_; -=head1 OUTPUT GENERATION + $self->add_head( 'static/introspect.css' ); -=head2 markup + my ( $meta, $is_role ) = $self->class_meta; - $o->markup; + my $class = $self->class; + $self->title( $class ); -=cut + my $introspect_path = "var/introspect/$class.yaml"; + $self->mkbasepath( $introspect_path ); + my $introspect; # FIXME update with = $self->load( $introspect_path ); -sub markup { - my ( $self ) = @_; - - $self->add_head( 'static/introspect.css' ); + my ( $superclasses, $roles ) = ( 'Role', '' ); + if ( ! $is_role ) { + if ( $meta->superclasses ) { + $superclasses = 'Superclasses: ' . + join(', ', + map { + my $name = $_->meta->name; + $introspect->{superclass}->{$name} = {}; + $self->dropdown( $name, $_->meta ) + } + #grep { $_ ne 'Moose::Object' } + $meta->superclasses + ); + } + } - my ( $meta, $is_role ) = $self->load_class; + my $method_from_role; + my $attribute_from_role; - my $class = $self->class; + 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; + $self->dropdown( $name, $name->meta ) . qq|| . $role_nr++ . qq||; + } + $meta->calculate_all_roles + ); + $roles = qq| with roles: $roles| if $roles; + } + warn "# method_from_role ",dump( $method_from_role ); my @methods; - @methods = map { qq|$_| } $self->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|$nr|; + } else { + $introspect->{methods}->{$name} = {}; + } + qq|$name| + } sort $self->class_methods( $class ); my @attributes; if ( $meta->get_attribute_list ) { - @attributes = map { - my $attr = $meta->get_attribute($_); - my ( $before, $title, $after ) = ( '', '', '' ); - ( $before, $title, $after ) = ( '', ' title="required"', '' ) 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_default has_trigger has_documentation has_applied_traits/ ) { + @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 ) = ( "$name", ' 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->$check ) { + 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 : ''; + + if ( $attribute_from_role->{$name} ) { + my ( $role_name, $nr ) = each %{ $attribute_from_role->{$name} }; + $name .= qq|$nr|; + } + + if ( my $doc = eval { $attr->documentation } ) { + $properties = qq| + $properties + $doc + |; + $self->add_css(qq| + span.documentation { + background: #eee; + padding: 0.25em; + float: left; + clear: left; + } + |); + $introspect->{action}->{$name}->{documentation} = $doc; } - qq|$before $_$after| + + qq|$html_name$type$properties| } sort $meta->get_attribute_list } - my $table = qq||; + my $table = qq|
MethodsAttributesProperties
|; while ( @methods || @attributes ) { my ($m,$a) = ( shift @methods, shift @attributes ); $m ||= ''; @@ -185,49 +231,63 @@ } $table .= qq|
MethodsAttributesTypeProperties
|; - my ( $superclasses, $roles ) = ( 'Role', '' ); - if ( ! $is_role ) { - if ( $meta->superclasses ) { - $superclasses = 'Superclasses: ' . - join(', ', - map { - my $name = $_->meta->name; - qq|$name| . $_->meta->dump(2) . qq||; - } - #grep { $_ ne 'Moose::Object' } - $meta->superclasses - ); - } - } + my $path = $self->class_path( $class ); - if ( $meta->can('roles') ) { - $roles = join(', ', - grep { ! m/\Q$class\E/ } # skip me - map { - my $name = $_->name; - qq|$name| . $name->meta->dump(2) . qq||; - } - $meta->calculate_all_roles - ); - $roles = " with roles: $roles" if $roles; - } + 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 ); - my $pod = Frey::Pod->new( class => $class )->markup; + # Create a reusable syntax highlighter + my $Highlight = PPI::HTML->new( + line_numbers => 1, +# page => 1, +# colors => { +# line_number => '#CCCCCC', +# number => '#990000', +# }, + ); - use Frey::Run; - my $execute = join("\n", map { qq|$_| } grep { $class->can($_) } Frey::Run->execute ); - $execute = " execute: $execute" if $execute; + # Spit out the HTML + my $source = $Highlight->html( $Document ); - my $html = $self->page( - title => "Introspect $class", - body => qq|

$class

| - . qq|$superclasses\n$roles\n$execute\n| - . ( $pod ? qq|↓pod&darr| : '' ) - . qq|$table\n$pod| + $source =~ s{(\s*)(\d+)(:\s*)}{$1$2$3}g; + # strip page html +# $source =~ s{^.*]+>}{}s; +# $source =~ s{{runnable}->{$_} = {}; + my $short = $_; + $short =~ s{_as_(?:markup|data|sponge)$}{}; + qq|$short| + } $self->class_runnable( $class ) ); + $runnable = "
run: $runnable" if $runnable; + + $self->store( $introspect_path, $introspect ); - return $html; + 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|, + qq|

Source

$source
|, + ); } =head1 SEE ALSO