package DBIx::Class::Storage::Statistics;
+
use strict;
use warnings;
-use base qw/DBIx::Class/;
-use IO::File;
+# DO NOT edit away without talking to riba first, he will just put it back
+# BEGIN pre-Moo2 import block
+BEGIN {
+ my $initial_fatal_bits = (${^WARNING_BITS}||'') & $warnings::DeadBits{all};
+ local $ENV{PERL_STRICTURES_EXTRA} = 0;
+ require Moo; Moo->import;
+ ${^WARNING_BITS} &= ( $initial_fatal_bits | ~ $warnings::DeadBits{all} );
+}
+# END pre-Moo2 import block
-__PACKAGE__->mk_group_accessors(simple => qw/callback debugfh silence/);
+extends 'DBIx::Class';
+use DBIx::Class::_Util qw(sigwarn_silencer qsub);
+use IO::Handle ();
+use namespace::clean;
=head1 NAME
=head1 METHODS
-=cut
-
=head2 new
Returns a new L<DBIx::Class::Storage::Statistics> object.
+=head2 debugfh
+
+Sets or retrieves the filehandle used for trace/debug output. This should
+be an L<IO::Handle> compatible object (only the
+L<< printflush|IO::Handle/$io->printflush_(_ARGS_) >> method is used). By
+default it is initially set to STDERR - although see discussion of the
+L<DBIC_TRACE|DBIx::Class::Storage/DBIC_TRACE> environment variable.
+
+Invoked as a getter it will lazily open a filehandle for you if one is not
+already set.
+
=cut
-sub new {
- my $self = {};
- bless $self, (ref($_[0]) || $_[0]);
- return $self;
+# FIXME - there ought to be a way to fold this into _debugfh itself
+# having the undef re-trigger the builder (or better yet a default
+# which can be folded in as a qsub)
+sub debugfh {
+ my $self = shift;
+
+ return $self->_debugfh(@_) if @_;
+ $self->_debugfh || $self->_build_debugfh;
}
-=head2 debugfh
+has _debugfh => (
+ is => 'rw',
+ lazy => 1,
+ trigger => qsub '$_[0]->_defaulted_to_stderr(undef)',
+ builder => '_build_debugfh',
+);
-Sets or retrieves the filehandle used for trace/debug output. This should
-be an IO::Handle compatible object (only the C<print> method is used). Initially
-should be set to STDERR - although see information on the
-L<DBIC_TRACE> environment variable.
+sub _build_debugfh {
+ my $fh;
+
+ my $debug_env = $ENV{DBIX_CLASS_STORAGE_DBI_DEBUG} || $ENV{DBIC_TRACE};
+
+ if (defined($debug_env) and ($debug_env =~ /=(.+)$/)) {
+ open ($fh, '>>', $1)
+ or die("Cannot open trace file $1: $!\n");
+ }
+ else {
+ open ($fh, '>&STDERR')
+ or die("Duplication of STDERR for debug output failed (perhaps your STDERR is closed?): $!\n");
+ $_[0]->_defaulted_to_stderr(1);
+ }
+
+ $fh;
+}
+
+has [qw(_defaulted_to_stderr silence callback)] => (
+ is => 'rw',
+);
=head2 print
-Prints the specified string to our debugging filehandle, which we will attempt
-to open if we haven't yet. Provided to save our methods the worry of how
-to display the message.
+Prints the specified string to our debugging filehandle. Provided to save our
+methods the worry of how to display the message.
=cut
sub print {
return if $self->silence;
- if(!defined($self->debugfh())) {
- my $fh;
- my $debug_env = $ENV{DBIX_CLASS_STORAGE_DBI_DEBUG}
- || $ENV{DBIC_TRACE};
- if (defined($debug_env) && ($debug_env =~ /=(.+)$/)) {
- $fh = IO::File->new($1, 'w')
- or die("Cannot open trace file $1");
- } else {
- $fh = IO::File->new('>&STDERR')
- or die('Duplication of STDERR for debug output failed (perhaps your STDERR is closed?)');
- }
-
- $fh->autoflush();
- $self->debugfh($fh);
- }
+ my $fh = $self->debugfh;
+
+ # not using 'no warnings' here because all of this can change at runtime
+ local $SIG{__WARN__} = sigwarn_silencer(qr/^Wide character in print/)
+ if $self->_defaulted_to_stderr;
- $self->debugfh->print($msg);
+ $fh->printflush($msg);
}
=head2 silence
1;
-=head1 AUTHORS
+=head1 AUTHOR AND CONTRIBUTORS
-Cory G. Watson <gphat@cpan.org>
+See L<AUTHOR|DBIx::Class/AUTHOR> and L<CONTRIBUTORS|DBIx::Class/CONTRIBUTORS> in DBIx::Class
=head1 LICENSE
-You may distribute this code under the same license as Perl itself.
+You may distribute this code under the same terms as Perl itself.
=cut