--- trunk/lib/Frey/Introspect.pm 2008/07/13 19:46:10 120 +++ trunk/lib/Frey/Introspect.pm 2009/01/11 12:09:58 993 @@ -8,31 +8,38 @@ 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'; + +=head1 DESCRIPTION + +Provide introspection on any perl class installed on system + +=cut -has 'package' => ( +has 'class' => ( is => 'rw', isa => 'Str', required => 1, ); -has 'path' => ( - is => 'rw', -); - =head2 joose - my $js = $o->joose( 'Some::Package' ); + my $js = $o->joose; =cut sub joose { my ($self) = @_; - my ( $class, $meta, $is_role ) = $self->load_package; + my ( $meta, $is_role ) = $self->class_meta; if ( ! $is_role ) { my @superclasses = map{ $_->meta->name } @@ -42,16 +49,20 @@ my $out; - my ( $m, $c ) = split(/::/, $class->name, 2); + 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 ( $class->get_attribute_list ) { + foreach ( $meta->get_attribute_list ) { $out .= "\t\t\t$_: {\n"; - my $attr = $class->get_attribute($_); - my $is = $attr->_is_metadata; + 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; @@ -75,7 +86,7 @@ $out .= "\t\t},\n\t\tmeta: Frey.HTML, classMethods: { renderHTML: function () { - return new Joose.SimpleRequest().getText(\"/~/" . $self->package . "\") + return new Joose.SimpleRequest().getText(\"/" . $self->class . "\") },\n"; $out .= "\t\t},\n"; @@ -85,123 +96,263 @@ $out =~ s/,\n$/\n/; $out .= "});\n"; - $out .= "\nconsole.log( 'loaded " . $class->name . " from $filename' );\n"; + $out .= "\nconsole.log( 'loaded " . $self->class . " from $filename' );\n"; - warn "method_list = ",dump( $class->get_method_list ) if $self->debug; + 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 +sub as_markup { + my ( $self ) = @_; - my @methods = $o->methods; + $self->add_head( 'static/introspect.css' ); -=cut - -sub methods { - my $self = shift; - - my ( $class, $meta, $is_role ) = $self->load_package; + my ( $meta, $is_role ) = $self->class_meta; - my $attr; - $attr->{$_}++ foreach $class->get_attribute_list; - my @methods = grep { ! defined($attr->{$_}) } $class->get_method_list; - warn "# methods = ",dump( @methods ) if $self->debug; - - return sort @methods; -} + my $class = $self->class; + $self->title( $class ); -use Frey::ClassLoader; + my $introspect_path = "var/introspect/$class.yaml"; + $self->mkbasepath( $introspect_path ); + my $introspect; # FIXME update with = $self->load( $introspect_path ); -sub load_package { - my $self = shift; - return Frey::ClassLoader->load_package( $self->package ); -} + my ( $superclasses, $roles ) = ( 'Role', '' ); + if ( ! $is_role ) { + if ( $meta->superclasses ) { + $superclasses = 'Superclasses: ' . + join(', ', + map { + my $name = $_->meta->name; + $introspect->{superclass}->{$name} = {}; + + qq|$name| . + $self->dropdown( qq|?|, $_->meta ) + } + #grep { $_ ne 'Moose::Object' } + $meta->superclasses + ); + } + } + my $method_from_role; + my $attribute_from_role; -=head1 OUTPUT GENERATION + 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|$name| +# . qq|| . $self->dropdown( $role_nr++, $name->meta ) . qq|| + . $self->dropdown( + qq|| . $role_nr++ . qq||, + $name->meta + ) + ; + } + $meta->calculate_all_roles + ); + $roles = qq|with roles: $roles| if $roles; + } + warn "# method_from_role ",dump( $method_from_role ); -=head2 html + 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|$nr|; + } else { + $introspect->{methods}->{$name} = {}; + } + qq|
$v
|
+ ;
+ }
+ $properties .= ' ';
+ }
+ my $type = $attr->can('has_type_constraint') && $attr->has_type_constraint ? $attr->type_constraint->name : '';
-sub html {
- my ( $self, $request ) = @_;
+ if ( $attribute_from_role->{$name} ) {
+ my ( $role_name, $nr ) = each %{ $attribute_from_role->{$name} };
+ $name .= qq|$nr|;
+ }
- while (1) {
+ 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;
+ }
- my $js = $self->head_javascript;
- $js .= << '__END_OF_JS__';
-
-__END_OF_JS__
+ my $path = $self->class_path( $class );
- my ( $class, $meta, $is_role ) = $self->load_package;
+ my $pod = Frey::Pod->new( class => $class, request_url => $self->request_url )->as_markup;
+ return $pod if $path =~ m{\.pod};
- my $package = $self->package;
+ my $Document = PPI::Document->new( $path );
- my @methods;
- @methods = map { qq|Methods | Attributes | '; - $a ||= ' | '; - $table .= qq| |
---|---|