From d4dd11da82e39761d11ccd215e5d99467b8da558 Mon Sep 17 00:00:00 2001
From: John SJ Anderson <genehack@genehack.org>
Date: Fri, 13 Mar 2015 15:53:07 -0700
Subject: [PATCH] Add CAVEAT section about type checking [RT#102733]
---
lib/JSON/MaybeXS.pm | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
diff --git a/lib/JSON/MaybeXS.pm b/lib/JSON/MaybeXS.pm
index 2f90001..cd20183 100644
--- a/lib/JSON/MaybeXS.pm
+++ b/lib/JSON/MaybeXS.pm
@@ -223,6 +223,27 @@ To include JSON-aware booleans (C<true>, C<false>) in your data, just do:
my $true = JSON->true;
my $false = JSON->false;
+=head1 CAVEATS
+
+The C<new()> method in this module is technically a factory, not a
+constructor, because the objects it returns will I<NOT> be blessed into the
+C<JSON::MaybeXS> class.
+
+If you are using an object returned by this module as a Moo(se) attribute,
+this type constraint code:
+
+ is 'json' => ( isa => 'JSON::MaybeXS' );
+
+will I<NOT> do what you expect. Instead, either rely on the C<JSON> class
+constant described above, as so:
+
+ is 'json' => ( isa => JSON::MaybeXS::JSON() );
+
+Alternatively, you can use duck typing:
+
+ use Moose::Util::TypeConstraints;
+ is 'json' => ( isa => Object , duck_type([qw/ encode decode /]));
+
=head1 AUTHOR
mst - Matt S. Trout (cpan:MSTROUT) <mst@shadowcat.co.uk>
--
2.3.0
RT for rt.cpan.org