--- trunk/lib/Frey/Introspect.pm 2008/07/02 21:10:57 49 +++ trunk/lib/Frey/Introspect.pm 2008/11/16 16:36:53 358 @@ -2,88 +2,247 @@ use Moose; use Carp; -use Class::MOP; -use Moose::Meta::Role; -use Moose::Meta::Class; -use Scalar::Util qw/blessed/; +#use Moose::Meta::Role; +#use Moose::Meta::Class; use Data::Dump qw/dump/; use File::Slurp; +use List::Util; -extends 'Frey'; +use lib 'lib'; -has 'package' => ( +extends 'Frey::ClassLoader'; +with 'Frey::Web'; + +has 'class' => ( is => 'rw', isa => 'Str', required => 1, ); -sub examine { +has 'path' => ( + is => 'rw', +); + +=head2 joose + + my $js = $o->joose; + +=cut + +sub joose { my ($self) = @_; - my $package = $self->package; + my ( $meta, $is_role ) = $self->class_meta; - #intercept role application so we can accurately generate - #method and attribute information for the parent class. - #this is fragile, but there is not better way that i am aware of - my $rmeta = Moose::Meta::Role->meta; - $rmeta->make_mutable if $rmeta->is_immutable; - my $original_apply = $rmeta->get_method("apply")->body; - $rmeta->remove_method("apply"); - my @roles_to_apply; - $rmeta->add_method("apply", sub{push(@roles_to_apply, [@_])}); - #load the package with the hacked Moose::Meta::Role - eval { Class::MOP::load_class($package); }; - confess "Failed to load package ${package} $@" if $@; - - #get on with analyzing the package - my $meta = $package->meta; - my $spec = {}; - my ($class, $is_role); - if($package->meta->isa('Moose::Meta::Role')){ - $is_role = 1; - # we need to apply the role to a class to be able to properly introspect it - $class = Moose::Meta::Class->create_anon_class; - $original_apply->($meta, $class); - } else { - #roles don't have superclasses ... - $class = $meta; - my @superclasses = map{ $_->meta } - grep { $_ ne 'Moose::Object' } $meta->superclasses; - warn "superclasses ",dump( @superclasses ); - } + 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(/::/, $class->name, 2); - my $filename = "$m.$c.js"; + 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 = $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->class . "\") + },\n"; + $out .= "\t\t},\n"; $out .= "\t}),\n"; - $out .= "});\n"; - - $out .= "\nconsole.log( 'loaded " . $class->name . " from $filename' );\n"; - warn $class->dump(2); + $out =~ s/,\n$/\n/; + $out .= "});\n"; - warn "get_attribute_list = ",dump( $class->get_attribute_list ); -# warn dump( map{ $class->get_attribute($_) } sort $class->get_attribute_list ); + $out .= "\nconsole.log( 'loaded " . $self->class . " from $filename' );\n"; - warn dump( $class->get_method_list ); + warn "method_list = ",dump( $meta->get_method_list ) if $self->debug; - print $out; +# 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->class_meta; + + 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; +} + +=head1 OUTPUT GENERATION + +=head2 markup + + $o->markup; + +=cut + +sub markup { + my ( $self ) = @_; + + $self->add_head( 'static/introspect.css' ); + + my ( $meta, $is_role ) = $self->class_meta; + + my $class = $self->class; + + 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 $role_method; + my $role_attribute; + + if ( $meta->can('roles') ) { + my $role_nr = 1; + $roles = join(' ', + grep { ! m/\Q$class\E/ } # skip me + map { + my $name = $_->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||; + } + $meta->calculate_all_roles + ); + $roles = qq| with roles: $roles| if $roles; + } + warn "# role_method ",dump( $role_method ); + + my @methods; + @methods = map { + my $name = $_; + if ( $role_method->{$name} ) { + my ( $role_name, $nr ) = each %{ $role_method->{$name} }; + $name .= qq|$nr|; + } + qq|$name| + } $self->methods; + + my @attributes; + if ( $meta->get_attribute_list ) { + @attributes = map { + my $name = $_; + my $attr = $meta->get_attribute($name); + warn "## ref attr: ",ref( $attr ); + 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/ ) { + my $getter; + + $getter = $check; + $getter =~ s/^has_//; + + if ( $attr->$check ) { + if ( $getter eq $check ) { + $after .= "$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 .= ''; + } + } + $after .= ' '; + } + my $type = $attr->has_type_constraint ? $attr->type_constraint->name : ''; + + if ( $role_attribute->{$name} ) { + my ( $role_name, $nr ) = each %{ $role_attribute->{$name} }; + $name .= qq|$nr|; + } + + qq|$before $name$type$after| + } sort $meta->get_attribute_list + } + + my $table = qq||; + while ( @methods || @attributes ) { + my ($m,$a) = ( shift @methods, shift @attributes ); + $m ||= ''; + $a ||= ''; + $table .= qq|$m$a|; + } + $table .= qq|
MethodsAttributesTypeProperties
|; + + my $pod = Frey::Pod->new( class => $class )->markup; + + use Frey::Run; + my $runnable = join("\n", map { qq|$_| } grep { $class->can($_) } Frey::Run->runnable ); + $runnable = " runnable: $runnable" if $runnable; + + my $html = { + title => "Introspect $class", + body => qq|

$class

| + . qq|
$superclasses\n$roles\n$runnable\n| + . ( $pod ? qq|↓pod&darr| : '' ) + . qq|$table\n$pod
| + + }; + + return $html; } =head1 SEE ALSO