1Perl::Tidy::Sweetened(3Upsme)r Contributed Perl DocumentaPteiroln::Tidy::Sweetened(3pm)
2
3
4
6 Perl::Tidy::Sweetened - Tweaks to Perl::Tidy to support some syntactic
7 sugar
8
10 version 1.18
11
14 There are a number of modules on CPAN that allow users to write their
15 classes with a more "modern" syntax. These tools eliminate the need to
16 shift off $self, can support type checking and offer other
17 improvements. Unfortunately, they can break the support tools that the
18 Perl community has come to rely on. This module attempts to work around
19 those issues.
20
21 The module uses Perl::Tidy's "prefilter" and "postfilter" hooks to
22 support "method" and "func" keywords, including the (possibly multi-
23 line) parameter lists. This is quite an ugly hack, but it is the
24 recommended method of supporting these new keywords (see the 2010-12-17
25 entry in the Perl::Tidy CHANGES
26 <https://metacpan.org/source/SHANCOCK/Perl-Tidy-20120714/CHANGES>
27 file). The resulting formatted code will leave the parameter lists
28 untouched.
29
30 "Perl::Tidy::Sweetened" attempts to support the syntax outlined in the
31 following modules, but most of the new syntax styles should work:
32
33 • p5-mop
34
35 • Method::Signatures::Simple
36
37 • MooseX::Method::Signatures
38
39 • MooseX::Declare
40
41 • Moops
42
43 • perl 5.20 signatures
44
45 • Kavorka
46
48 The idea and much of original code taken from Jonathan Swartz' blog
49 <http://www.openswartz.com/2010/12/19/perltidy-and-method-happy-
50 together/>.
51
53 Perl::Tidy
54
56 Mark Grimes <mgrimes@cpan.org>
57
59 Source repository is at
60 <https://github.com/mvgrimes/Perl-Tidy-Sweetened>.
61
63 Please report any bugs or feature requests on the bugtracker website
64 <http://github.com/mvgrimes/Perl-Tidy-Sweetened/issues>
65
66 When submitting a bug or request, please include a test-file or a patch
67 to an existing test-file that illustrates the bug or desired feature.
68
70 This software is copyright (c) 2021 by Mark Grimes <mgrimes@cpan.org>.
71
72 This is free software; you can redistribute it and/or modify it under
73 the same terms as the Perl 5 programming language system itself.
74
75
76
77perl v5.32.1 2021-01-31 Perl::Tidy::Sweetened(3pm)