NAME¶
DBIx::Class::Carp - Provides advanced Carp::Clan-like warning functions for
DBIx::Class internals
DESCRIPTION¶
Documentation is lacking on purpose - this an experiment not yet fit for mass
consumption. If you use this do not count on any kind of stability, in fact
don't even count on this module's continuing existence (it has been noindexed
for a reason).
In addition to the classic interface:
use DBIx::Class::Carp '^DBIx::Class'
this module also supports a class-data based way to specify the exclusion regex.
A message is only carped from a callsite that matches neither the closed over
string, nor the value of "_skip_namespace_frames" as declared on any
callframe already skipped due to the same mechanism. This is to ensure that
intermediate callsites can declare their own additional skip-namespaces.
CLASS ATTRIBUTES¶
_skip_namespace_frames¶
A classdata attribute holding the stringified regex matching callsites that
should be skipped by the carp methods below. An empty string "q{}"
is treated like no setting/"undef" (the distinction is necessary due
to semantics of the class data accessors provided by Class::Accessor::Grouped)
EXPORTED FUNCTIONS¶
This module export the following 3 functions. Only warning related
"carp*" is being handled here, for "croak"-ing you must
use "throw_exception" in DBIx::Class::Schema or
DBIx::Class::Exception.
carp¶
Carps message with the file/line of the first callsite not matching
"_skip_namespace_frames" nor the closed-over arguments to "use
DBIx::Class::Carp".
carp_unique¶
Like "carp" but warns once for every distinct callsite (subject to the
same ruleset as "carp").
carp_once¶
Like "carp" but warns only once for the life of the perl interpreter
(regardless of callsite).