]> git.vpit.fr Git - perl/modules/LaTeX-TikZ.git/blobdiff - lib/LaTeX/TikZ/Tools.pm
Just use Mouse instead of Any::Moose
[perl/modules/LaTeX-TikZ.git] / lib / LaTeX / TikZ / Tools.pm
index 6a45fe427545a520c353aab9dd4b9373f2041948..f4e536e7989636f02a52e7854fbdb207054e4d58 100644 (file)
@@ -5,41 +5,50 @@ use warnings;
 
 =head1 NAME
 
-LaTeX::TikZ::Tools - Miscellanous tools for LaTeX::TikZ classes.
+LaTeX::TikZ::Tools - Miscellaneous tools for LaTeX::TikZ classes.
 
 =head1 VERSION
 
-Version 0.01
+Version 0.02
 
 =cut
 
-our $VERSION = '0.01';
+our $VERSION = '0.02';
 
-use Any::Moose 'Util::TypeConstraints' => [ 'find_type_constraint' ];
+use Mouse::Util::TypeConstraints 'find_type_constraint';
 
 =head1 CONSTANTS
 
 =head2 C<EPS>
 
+The numerical accuracy enforced by L</numeq>, L</numcmp> and L</numround>.
+It is currently set to C<1e-10>.
+
 =cut
 
 use constant EPS => 1e-10;
 
 =head1 FUNCTIONS
 
-=head2 C<numeq>
+=head2 C<numeq $x, $y>
+
+Returns true if and only if C<$x> and C<$y> are equal up to L</EPS>.
 
 =cut
 
 sub numeq { abs($_[0] - $_[1]) < EPS }
 
-=head2 C<numcmp>
+=head2 C<numcmp $x, $y>
+
+Returns a negative number, zero, or a positive number when C<$x> is respectively smaller than, equal to, or greater than C<$y> up to L</EPS>.
 
 =cut
 
 sub numcmp { $_[0] < $_[1] - EPS ? -1 : $_[0] > $_[1] + EPS ? 1 : 0 }
 
-=head2 C<numround>
+=head2 C<numround $x>
+
+Returns the closest integer from C<$x> up to L</EPS>.
 
 =cut
 
@@ -51,7 +60,7 @@ sub numround {
 
 =head2 C<type_constraint $class>
 
-Find the type constraint for C<$class> by loading the relevant F<.pm> file beforehand.
+Finds the type constraint for C<$class> by first trying to load the relevant F<.pm> file.
 
 =cut
 
@@ -61,11 +70,21 @@ sub type_constraint {
  my $file = $class;
  $file =~ s{::}{/}g;
  $file .= '.pm';
- require $file;
+ unless ($INC{$file}) {
+  local $@;
+  eval {
+   local $SIG{__DIE__}; # See LaTeX::TikZ::Meta::TypeConstraint::Autocoerce
+   require $file;
+  }
+ }
 
  find_type_constraint($class);
 }
 
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>.
+
 =head1 AUTHOR
 
 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.