Debian Codegraph @

lib/.perlcriticrc

raw
1 # You may disable specific policies appending the following annotation
2 #
3 # ## no critic (..., ...)
4 #
5 # to the corresponding code line. To direct perlcritic to ignore the
6 # "## no critic" annotations, use the --force option.
7
8 # Policies shipped with Perl::Critic 1.125 were considered for the below
9 # defintion of the new policy theme "knib".
10
11 severity = brutal
12 theme = knib
13 verbose = %f: %m at line %l, column %c. (Policy: %p)\n
14
15 [Perl::Critic::Policy::BuiltinFunctions::ProhibitLvalueSubstr]
16 add_themes = knib
17
18 [Perl::Critic::Policy::BuiltinFunctions::ProhibitStringyEval]
19 add_themes = knib
20 allow_includes = 1
21
22 [Perl::Critic::Policy::BuiltinFunctions::ProhibitStringySplit]
23 add_themes = knib
24
25 [Perl::Critic::Policy::BuiltinFunctions::ProhibitUniversalCan]
26 add_themes = knib
27
28 [Perl::Critic::Policy::BuiltinFunctions::ProhibitUniversalIsa]
29 add_themes = knib
30
31 [Perl::Critic::Policy::BuiltinFunctions::ProhibitUselessTopic]
32 # KNOWN BUGS: This policy flags a false positive on reverse() called in list
33 # context, since reverse() in list context does not assume $_.
34 add_themes = knib
35
36 [Perl::Critic::Policy::BuiltinFunctions::ProhibitVoidGrep]
37 add_themes = knib
38
39 [Perl::Critic::Policy::BuiltinFunctions::ProhibitVoidMap]
40 add_themes = knib
41
42 [Perl::Critic::Policy::BuiltinFunctions::RequireBlockGrep]
43 add_themes = knib
44
45 [Perl::Critic::Policy::BuiltinFunctions::RequireBlockMap]
46 add_themes = knib
47
48 # 14.01.2016 policy disabled after a discussion with the team
49 #[BuiltinFunctions::RequireGlobFunction]
50 #add_themes = knib
51
52 [Perl::Critic::Policy::BuiltinFunctions::RequireSimpleSortBlock]
53 add_themes = knib
54
55 [Perl::Critic::Policy::ClassHierarchies::ProhibitExplicitISA]
56 # Note: Some people prefer parent over base.
57 add_themes = knib
58
59 [Perl::Critic::Policy::CodeLayout::ProhibitHardTabs]
60 add_themes = knib
61 allow_leading_tabs = 0
62
63 # 14.01.2016 policy disabled after a discussion with the team
64 #[Perl::Critic::Policy::CodeLayout::ProhibitQuotedWordLists]
65 #add_themes = knib
66 #min_elements = 1
67 #strict = 1
68
69 [Perl::Critic::Policy::CodeLayout::ProhibitTrailingWhitespace]
70 add_themes = knib
71
72 [Perl::Critic::Policy::CodeLayout::RequireConsistentNewlines]
73 add_themes = knib
74
75 # 14.01.2016 policy disabled after a discussion with the team
76 #[Perl::Critic::Policy::CodeLayout::RequireTrailingCommas]
77 #add_themes = knib
78
79 [Perl::Critic::Policy::ControlStructures::ProhibitCStyleForLoops]
80 add_themes = knib
81
82 [Perl::Critic::Policy::ControlStructures::ProhibitCascadingIfElse]
83 add_themes = knib
84 max_elsif = 1
85
86 [Perl::Critic::Policy::ControlStructures::ProhibitDeepNests]
87 # Martin Fowler's book "Refactoring: Improving The Design of Existing Code".
88 add_themes = knib
89 max_nests = 5
90
91 [Perl::Critic::Policy::ControlStructures::ProhibitLabelsWithSpecialBlockNames]
92 add_themes = knib
93
94 [Perl::Critic::Policy::ControlStructures::ProhibitMutatingListFunctions]
95 # Read the LIMITATIONS that this policy has.
96 add_themes = knib
97
98 [Perl::Critic::Policy::ControlStructures::ProhibitNegativeExpressionsInUnlessAndUntilConditions]
99 add_themes = knib
100
101 [Perl::Critic::Policy::ControlStructures::ProhibitUnreachableCode]
102 add_themes = knib
103
104 # Available With Perl::Critic v1.126
105 #[Perl::Critic::Policy::ControlStructures::ProhibitYadaOperator]
106 #add_themes = knib
107
108 [Perl::Critic::Policy::Documentation::PodSpelling]
109 add_themes =
110 # "spell" is the spell checker avalable on our AIX system. The default spell
111 # checker "aspell" was not available.
112 spell_command = spell
113 #stop_words = ...
114 stop_words_file = PodSpelling_stop_words.txt
115
116 [Perl::Critic::Policy::Documentation::RequirePackageMatchesPodName]
117 add_themes = knib
118
119 #[Perl::Critic::Policy::Documentation::RequirePodSections]
120 #add_themes = knib
121
122 # 14.01.2016 policy disabled after a discussion with the team
123 #[Perl::Critic::Policy::ErrorHandling::RequireCheckingReturnValueOfEval]
124 #add_themes = knib
125
126 [Perl::Critic::Policy::InputOutput::ProhibitBacktickOperators]
127 add_themes = knib
128 # 14.01.2016 policy configuration changed after a discussion with the team
129 only_in_void_context = 1
130
131 [Perl::Critic::Policy::InputOutput::ProhibitBarewordFileHandles]
132 add_themes = knib
133
134 [Perl::Critic::Policy::InputOutput::ProhibitExplicitStdin]
135 add_themes = knib
136
137 [Perl::Critic::Policy::InputOutput::ProhibitInteractiveTest]
138 add_themes = knib
139
140 [Perl::Critic::Policy::InputOutput::ProhibitJoinedReadline]
141 add_themes = knib
142
143 [Perl::Critic::Policy::InputOutput::ProhibitReadlineInForLoop]
144 add_themes = knib
145
146 [Perl::Critic::Policy::InputOutput::ProhibitTwoArgOpen]
147 add_themes = knib
148
149 [Perl::Critic::Policy::InputOutput::RequireBriefOpen]
150 # http://www.perlmonks.org/?node_id=1134785
151 add_themes = knib
152 lines = 9
153
154 [Perl::Critic::Policy::InputOutput::RequireCheckedSyscalls]
155 # Covers the policies
156 # Perl::Critic::Policy::InputOutput::RequireCheckedClose and
157 # Perl::Critic::Policy::InputOutput::RequireCheckedOpen
158 add_themes = knib
159 exclude_functions = print say
160 functions = :builtins
161
162 [Perl::Critic::Policy::InputOutput::RequireEncodingWithUTF8Layer]
163 add_themes = knib
164
165 [Perl::Critic::Policy::Miscellanea::ProhibitUnrestrictedNoCritic]
166 add_themes = knib
167
168 [Perl::Critic::Policy::Miscellanea::ProhibitUselessNoCritic]
169 add_themes = knib
170
171 [Perl::Critic::Policy::Modules::ProhibitAutomaticExportation]
172 add_themes = knib
173
174 [Perl::Critic::Policy::Modules::ProhibitConditionalUseStatements]
175 add_themes = knib
176
177 [Perl::Critic::Policy::Modules::ProhibitEvilModules]
178 add_themes = knib
179 modules = Class::ISA Error Pod::Plainer Shell Switch
180
181 [Perl::Critic::Policy::Modules::ProhibitExcessMainComplexity]
182 # http://en.wikipedia.org/wiki/Cyclomatic_complexity
183 add_themes = knib
184 max_mccabe = 20
185
186 [Perl::Critic::Policy::Modules::ProhibitMultiplePackages]
187 add_themes = knib
188
189 [Perl::Critic::Policy::Modules::RequireBarewordIncludes]
190 add_themes = knib
191
192 [Perl::Critic::Policy::Modules::RequireEndWithOne]
193 add_themes = knib
194
195 [Perl::Critic::Policy::Modules::RequireExplicitPackage]
196 add_themes = knib
197 allow_import_of = utf8
198 exempt_scripts = 0
199
200 [Perl::Critic::Policy::Modules::RequireFilenameMatchesPackage]
201 add_themes = knib
202
203 [Perl::Critic::Policy::Modules::RequireNoMatchVarsWithUseEnglish]
204 add_themes = knib
205
206 [Perl::Critic::Policy::Modules::RequireVersionVar]
207 # Read the TO DO section of this policy and think about its implication.
208 add_themes = knib
209
210 # Perl::Critic::Policy::NamingConventions::Capitalization
211 # It takes some time to configure this policy!
212
213 [Perl::Critic::Policy::Objects::ProhibitIndirectSyntax]
214 add_themes = knib
215 # The new() subroutine is configured by default; any additional forbid values
216 # are in addition to new().
217 forbid = create destroy
218
219 [Perl::Critic::Policy::RegularExpressions::ProhibitFixedStringMatches]
220 add_themes = knib
221
222 [Perl::Critic::Policy::RegularExpressions::ProhibitSingleCharAlternation]
223 add_themes = knib
224
225 [Perl::Critic::Policy::RegularExpressions::ProhibitUnusedCapture]
226 add_themes = knib
227
228 # 14.01.2016 policy still enabled after a discussion with the team
229 [Perl::Critic::Policy::RegularExpressions::ProhibitUnusualDelimiters]
230 add_themes = knib
231 allow_all_brackets = 0
232
233 [Perl::Critic::Policy::RegularExpressions::ProhibitUselessTopic]
234 add_themes = knib
235
236 [Perl::Critic::Policy::RegularExpressions::RequireBracesForMultiline]
237 add_themes = knib
238 allow_all_brackets = 0
239
240 [Perl::Critic::Policy::Subroutines::ProhibitAmpersandSigils]
241 add_themes = knib
242
243 [Perl::Critic::Policy::Subroutines::ProhibitBuiltinHomonyms]
244 # Read the CAVEATS.
245 add_themes = knib
246
247 [Perl::Critic::Policy::Subroutines::ProhibitExcessComplexity]
248 # http://en.wikipedia.org/wiki/Cyclomatic_complexity
249 add_themes = knib
250 max_mccabe = 20
251
252 [Perl::Critic::Policy::Subroutines::ProhibitExplicitReturnUndef]
253 # http://perlmonks.org/index.pl?node_id=741847
254 add_themes = knib
255
256 [Perl::Critic::Policy::Subroutines::ProhibitManyArgs]
257 add_themes = knib
258 max_arguments = 5
259
260 [Perl::Critic::Policy::Subroutines::ProhibitNestedSubs]
261 add_themes = knib
262
263 [Perl::Critic::Policy::Subroutines::ProhibitReturnSort]
264 # KNOWN BUGS: This Policy is not sensitive to the wantarray() function.
265 add_themes = knib
266
267 [Perl::Critic::Policy::Subroutines::ProhibitSubroutinePrototypes]
268 add_themes = knib
269
270 [Perl::Critic::Policy::Subroutines::ProhibitUnusedPrivateSubroutines]
271 add_themes = knib
272
273 [Perl::Critic::Policy::Subroutines::ProtectPrivateSubs]
274 add_themes = knib
275
276 #[Perl::Critic::Policy::Subroutines::RequireArgUnpacking]
277 #add_themes = knib
278 #allow_delegation_to = SUPER:: NEXT::
279 #allow_subscripts = 0
280 #short_subroutine_statements = 0
281
282 [Perl::Critic::Policy::Subroutines::RequireFinalReturn]
283 add_themes = knib
284 terminal_funcs = return carp croak die exec exit goto throw
285
286 [Perl::Critic::Policy::TestingAndDebugging::ProhibitNoStrict]
287 add_themes = knib
288 allow = refs
289
290 [Perl::Critic::Policy::TestingAndDebugging::ProhibitNoWarnings]
291 add_themes = knib
292 allow_with_category_restriction = 1
293
294 [Perl::Critic::Policy::TestingAndDebugging::ProhibitProlongedStrictureOverride]
295 add_themes = knib
296 statements = 3
297
298 # The following policy seems to have a bug for the ok() test.
299 #[Perl::Critic::Policy::TestingAndDebugging::RequireTestLabels]
300 #add_themes = knib
301 #modules = Test::Exception Test::More
302
303 [Perl::Critic::Policy::TestingAndDebugging::RequireUseStrict]
304 add_themes = knib
305
306 [Perl::Critic::Policy::TestingAndDebugging::RequireUseWarnings]
307 add_themes = knib
308
309 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitInterpolationOfLiterals]
310 add_themes = knib
311 allow_if_string_contains_single_quote = 1
312
313 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitLeadingZeros]
314 add_themes = knib
315
316 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitLongChainsOfMethodCalls]
317 add_themes = knib
318 max_chain_length = 3
319
320 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitMagicNumbers]
321 # Not yet configured completely.
322 add_themes = knib
323 # 14.01.2016 2 is considered a magic number as well after a discussion with the team
324 allowed_values = -1 0 1
325
326 # 11.02.2016 policy disabled after a discussion with the team
327 #[Perl::Critic::Policy::ValuesAndExpressions::ProhibitMismatchedOperators]
328 #add_themes = knib
329
330 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitMixedBooleanOperators]
331 add_themes = knib
332
333 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitQuotesAsQuotelikeOperatorDelimiters]
334 add_themes = knib
335 back_quote_allowed_operators =
336 double_quote_allowed_operators =
337 single_quote_allowed_operators =
338
339 [Perl::Critic::Policy::ValuesAndExpressions::ProhibitSpecialLiteralHeredocTerminator]
340 add_themes = knib
341
342 [Perl::Critic::Policy::ValuesAndExpressions::RequireConstantVersion]
343 add_themes =
344 allow_version_without_use_on_same_line = 1
345
346 [Perl::Critic::Policy::ValuesAndExpressions::RequireNumberSeparators]
347 add_themes = knib
348 min_value = 10000
349
350 [Perl::Critic::Policy::ValuesAndExpressions::RequireQuotedHeredocTerminator]
351 add_themes = knib
352
353 [Perl::Critic::Policy::ValuesAndExpressions::RequireUpperCaseHeredocTerminator]
354 add_themes = knib
355
356 [Perl::Critic::Policy::Variables::ProhibitConditionalDeclarations]
357 add_themes = knib
358
359 [Perl::Critic::Policy::Variables::ProhibitLocalVars]
360 add_themes = knib
361
362 [Perl::Critic::Policy::Variables::ProhibitMatchVars]
363 add_themes = knib
364
365 [Perl::Critic::Policy::Variables::ProhibitUnusedVariables]
366 add_themes = knib
367
368 [Perl::Critic::Policy::Variables::RequireInitializationForLocalVars]
369 add_themes = knib
370
371 [Perl::Critic::Policy::Variables::RequireLexicalLoopIterators]
372 add_themes = knib
373
374 [Perl::Critic::Policy::Variables::RequireLocalizedPunctuationVars]
375 add_themes = knib
376 allow =
377
378 [Perl::Critic::Policy::Variables::RequireNegativeIndices]
379 add_themes = knib