1DBIx::Class::Carp(3)  User Contributed Perl Documentation DBIx::Class::Carp(3)
2
3
4

NAME

6       DBIx::Class::Carp - Provides advanced Carp::Clan-like warning functions
7       for DBIx::Class internals
8

DESCRIPTION

10       Documentation is lacking on purpose - this an experiment not yet fit
11       for mass consumption. If you use this do not count on any kind of
12       stability, in fact don't even count on this module's continuing
13       existence (it has been noindexed for a reason).
14
15       In addition to the classic interface:
16
17         use DBIx::Class::Carp '^DBIx::Class'
18
19       this module also supports a class-data based way to specify the
20       exclusion regex. A message is only carped from a callsite that matches
21       neither the closed over string, nor the value of
22       "_skip_namespace_frames" as declared on any callframe already skipped
23       due to the same mechanism. This is to ensure that intermediate
24       callsites can declare their own additional skip-namespaces.
25

CLASS ATTRIBUTES

27   _skip_namespace_frames
28       A classdata attribute holding the stringified regex matching callsites
29       that should be skipped by the carp methods below. An empty string "q{}"
30       is treated like no setting/"undef" (the distinction is necessary due to
31       semantics of the class data accessors provided by
32       Class::Accessor::Grouped)
33

EXPORTED FUNCTIONS

35       This module export the following 3 functions. Only warning related
36       "carp*" is being handled here, for "croak"-ing you must use
37       "throw_exception" in DBIx::Class::Schema or DBIx::Class::Exception.
38
39   carp
40       Carps message with the file/line of the first callsite not matching
41       "_skip_namespace_frames" nor the closed-over arguments to "use
42       DBIx::Class::Carp".
43
44   carp_unique
45       Like "carp" but warns once for every distinct callsite (subject to the
46       same ruleset as "carp").
47
48   carp_once
49       Like "carp" but warns only once for the life of the perl interpreter
50       (regardless of callsite).
51

FURTHER QUESTIONS?

53       Check the list of additional DBIC resources.
54

56       This module is free software copyright by the DBIx::Class (DBIC)
57       authors. You can redistribute it and/or modify it under the same terms
58       as the DBIx::Class library.
59
60
61
62perl v5.28.1                      2018-01-29              DBIx::Class::Carp(3)
Impressum