X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse.pm;h=4c4dc39e1e5973897bfe603c9b2f81273ece9d01;hb=fd2b172a4657cb6cc47976d2e66cdba4bdfa579d;hp=8a24c2e2faf3d94c8fb82a836762460d2ddc5e87;hpb=123fd4f8368c8a468d735c9ee43ee871e22dc301;p=gitmo%2FMouse.git diff --git a/lib/Mouse.pm b/lib/Mouse.pm index 8a24c2e..4c4dc39 100644 --- a/lib/Mouse.pm +++ b/lib/Mouse.pm @@ -3,7 +3,7 @@ use 5.006_002; use Mouse::Exporter; # enables strict and warnings -our $VERSION = '0.50_09'; +our $VERSION = '0.87'; use Carp qw(confess); use Scalar::Util qw(blessed); @@ -48,13 +48,8 @@ sub has { $meta->throw_error(q{Usage: has 'name' => ( key => value, ... )}) if @_ % 2; # odd number of arguments - if(ref $name){ # has [qw(foo bar)] => (...) - for (@{$name}){ - $meta->add_attribute($_ => @_); - } - } - else{ # has foo => (...) - $meta->add_attribute($name => @_); + for my $n(ref($name) ? @{$name} : $name){ + $meta->add_attribute($n => @_); } return; } @@ -130,7 +125,7 @@ sub init_meta { my %args = @_; my $class = $args{for_class} - or confess("Cannot call init_meta without specifying a for_class"); + or confess("Cannot call init_meta without specifying a for_class"); my $base_class = $args{base_class} || 'Mouse::Object'; my $metaclass = $args{metaclass} || 'Mouse::Meta::Class'; @@ -160,7 +155,7 @@ Mouse - Moose minus the antlers =head1 VERSION -This document describes Mouse version 0.50_09 +This document describes Mouse version 0.87 =head1 SYNOPSIS @@ -195,30 +190,31 @@ This document describes Mouse version 0.50_09 =head1 DESCRIPTION -L is wonderful. B +L is a postmodern object system for Perl5. Moose is wonderful. Unfortunately, Moose has a compile-time penalty. Though significant progress has been made over the years, the compile time penalty is a non-starter for some very specific applications. If you are writing a command-line application or CGI script where startup time is essential, you may not be able to use -Moose. We recommend that you instead use L and FastCGI for the -latter, if possible. +Moose (we recommend that you instead use persistent Perl executing environments +like C for the latter, if possible). -Mouse aims to alleviate this by providing a subset of Moose's functionality, -faster. +Mouse is a Moose compatible object system, which aims to alleviate this penalty +by providing a subset of Moose's functionality. We're also going as light on dependencies as possible. Mouse currently has -B except for testing modules. +B except for building/testing modules. Mouse also works +without XS, although it has an XS backend to make it much faster. -=head2 MOOSE COMPATIBILITY +=head2 Moose Compatibility Compatibility with Moose has been the utmost concern. The sugary interface is highly compatible with Moose. Even the error messages are taken from Moose. -The Mouse code just runs the test suite 4x faster. +The Mouse code just runs its test suite 4x faster. The idea is that, if you need the extra power, you should be able to run C on your codebase and have nothing break. To that end, -we have written L which will act as Mouse unless Moose is loaded, +we have written L which will act as Mouse unless Moose is loaded, in which case it will act as Moose. Since Mouse is a little sloppier than Moose, if you run into weird errors, it would be worth running: @@ -229,7 +225,7 @@ also better. See also L for compatibility and incompatibility with Moose. -=head2 MouseX +=head2 Mouse Extentions Please don't copy MooseX code to MouseX. If you need extensions, you really should upgrade to Moose. We don't need two parallel sets of extensions! @@ -400,22 +396,6 @@ You may use L to replace the superclass list. Please unimport Mouse (C) so that if someone calls one of the keywords (such as L) it will break loudly instead breaking subtly. -=head1 CAVEATS - -If you use Mouse::XS you might see a fatal error on callbacks -which include C, which typically occurs in such code -as C. This is not -a bug in Mouse. In fact, it is a bug in Perl (RT #69939). - -To work around this problem, surround C with C: - - sub callback { - # eval 'use NotInstalledModule'; # NG - eval{ eval 'use NotInstalledModule' }; # OK - } - -It seems ridiculous, but it works as you expected. - =head1 SOURCE CODE ACCESS We have a public git repository: