Mouse::Util::does_role() respects $thing->does() method
[gitmo/Mouse.git] / lib / Test / Mouse.pm
old mode 100755 (executable)
new mode 100644 (file)
index 6348746..ff1b98d
-package Test::Mouse;\r
-\r
-use strict;\r
-use warnings;\r
-use Mouse ();\r
-\r
-use base qw(Test::Builder::Module);\r
-\r
-our @EXPORT = qw(meta_ok does_ok has_attribute_ok);\r
-\r
-sub find_meta{ Mouse::class_of($class_or_obj) }\r
-\r
-sub meta_ok ($;$) {\r
-    my ($class_or_obj, $message) = @_;\r
-\r
-    $message ||= "The object has a meta";\r
-\r
-    if (find_meta($class_or_obj)) {\r
-        return __PACKAGE__->builder->ok(1, $message)\r
-    }\r
-    else {\r
-        return __PACKAGE__->builder->ok(0, $message);\r
-    }\r
-}\r
-\r
-sub does_ok ($$;$) {\r
-    my ($class_or_obj, $does, $message) = @_;\r
-\r
-    $message ||= "The object does $does";\r
-\r
-    my $meta = find_meta($class_or_obj);\r
-    if ($meta && $meta->does_role($does)) {\r
-        return __PACKAGE__->builder->ok(1, $message)\r
-    }\r
-    else {\r
-        return __PACKAGE__->builder->ok(0, $message);\r
-    }\r
-}\r
-\r
-sub has_attribute_ok ($$;$) {\r
-    my ($class_or_obj, $attr_name, $message) = @_;\r
-\r
-    $message ||= "The object does has an attribute named $attr_name";\r
-\r
-    my $meta = find_meta($class_or_obj);\r
-\r
-    if ($meta->find_attribute_by_name($attr_name)) {\r
-        return __PACKAGE__->builder->ok(1, $message)\r
-    }\r
-    else {\r
-        return __PACKAGE__->builder->ok(0, $message);\r
-    }\r
-}\r
-\r
-1;\r
-\r
-__END__\r
-\r
-=pod\r
-\r
-=head1 NAME\r
-\r
-Test::Mouse - Test functions for Mouse specific features\r
-\r
-=head1 SYNOPSIS\r
-\r
-  use Test::More plan => 1;\r
-  use Test::Mouse;\r
-\r
-  meta_ok($class_or_obj, "... Foo has a ->meta");\r
-  does_ok($class_or_obj, $role, "... Foo does the Baz role");\r
-  has_attribute_ok($class_or_obj, $attr_name, "... Foo has the 'bar' attribute");\r
-\r
-=cut\r
-\r
+package Test::Mouse;
+
+use Mouse::Exporter;
+use Mouse::Util qw(does_role find_meta);
+
+use Test::Builder;
+
+Mouse::Exporter->setup_import_methods(
+    as_is => [qw(
+        meta_ok
+        does_ok
+        has_attribute_ok
+        with_immutable
+    )],
+);
+
+## the test builder instance ...
+
+my $Test = Test::Builder->new;
+
+## exported functions
+
+sub meta_ok ($;$) { ## no critic
+    my ($class_or_obj, $message) = @_;
+
+    $message ||= "The object has a meta";
+
+    if (find_meta($class_or_obj)) {
+        return $Test->ok(1, $message)
+    }
+    else {
+        return $Test->ok(0, $message);
+    }
+}
+
+sub does_ok ($$;$) { ## no critic
+    my ($class_or_obj, $does, $message) = @_;
+
+    $message ||= "The object does $does";
+
+    if (does_role($class_or_obj, $does)) {
+        return $Test->ok(1, $message)
+    }
+    else {
+        return $Test->ok(0, $message);
+    }
+}
+
+sub has_attribute_ok ($$;$) { ## no critic
+    my ($class_or_obj, $attr_name, $message) = @_;
+
+    $message ||= "The object does has an attribute named $attr_name";
+
+    my $meta = find_meta($class_or_obj);
+
+    if ($meta->find_attribute_by_name($attr_name)) {
+        return $Test->ok(1, $message)
+    }
+    else {
+        return $Test->ok(0, $message);
+    }
+}
+
+sub with_immutable (&@) { ## no critic
+    my $block = shift;
+
+    my $before = $Test->current_test;
+
+    $block->();
+    $_->meta->make_immutable for @_;
+    $block->();
+    return if not defined wantarray;
+
+    my $num_tests = $Test->current_test - $before;
+    return !grep{ !$_ } ($Test->summary)[-$num_tests .. -1];
+}
+
+1;
+__END__
+
+=head1 NAME
+
+Test::Mouse - Test functions for Mouse specific features
+
+=head1 SYNOPSIS
+
+  use Test::More plan => 1;
+  use Test::Mouse;
+
+  meta_ok($class_or_obj, "... Foo has a ->meta");
+  does_ok($class_or_obj, $role, "... Foo does the Baz role");
+  has_attribute_ok($class_or_obj, $attr_name, "... Foo has the 'bar' attribute");
+
+=head1 DESCRIPTION
+
+This module provides some useful test functions for Mouse based classes. It
+is an experimental first release, so comments and suggestions are very welcome.
+
+=head1 EXPORTED FUNCTIONS
+
+=over 4
+
+=item B<meta_ok ($class_or_object)>
+
+Tests if a class or object has a metaclass.
+
+=item B<does_ok ($class_or_object, $role, ?$message)>
+
+Tests if a class or object does a certain role, similar to what C<isa_ok>
+does for the C<isa> method.
+
+=item B<has_attribute_ok($class_or_object, $attr_name, ?$message)>
+
+Tests if a class or object has a certain attribute, similar to what C<can_ok>
+does for the methods.
+
+=item B<with_immutable { CODE } @class_names>
+
+Runs I<CODE> *which should contain normal tests) twice, and make each
+class in I<@class_names> immutable between the two runs.
+
+=back
+
+=head1 SEE ALSO
+
+L<Mouse>
+
+L<Test::Moose>
+
+L<Test::More>
+
+=cut
+