NAME

       Code::TidyAll::Plugin - Create plugins for tidying or validating code

VERSION

       version 0.32

SYNOPSIS

           package Code::TidyAll::Plugin::SomeTidier;
           use Moo;
           extends 'Code::TidyAll::Plugin';

           sub transform_source {
               my ( $self, $source ) = @_;
               ...
               return $source;
           }

           package Code::TidyAll::Plugin::SomeValidator;
           use Moo;
           extends 'Code::TidyAll::Plugin';

           sub validate_file {
               my ( $self, $file ) = @_;
               die "not valid" if ...;
           }

DESCRIPTION

       To use a tidier or validator with "tidyall" it must have a corresponding plugin class that inherits from
       this class. This document describes how to implement a new plugin.

       The easiest way to start is to look at existing plugins, such as Code::TidyAll::Plugin::PerlTidy and
       Code::TidyAll::Plugin::PerlCritic.

NAMING

       If you are going to publicly release your plugin, call it 'Code::TidyAll::Plugin::something' so that
       users can find it easily and refer to it by its short name in configuration.

       If it's an internal plugin, you can call it whatever you like and refer to it with a plus sign prefix in
       the config file, e.g.

           [+My::Tidier::Class]
           select = **/*.{pl,pm,t}

CONSTRUCTOR AND ATTRIBUTES

       Your plugin constructor will be called with the configuration key/value pairs as parameters. e.g. given

           [PerlCritic]
           select = lib/**/*.pm
           ignore = lib/UtterHack.pm
           argv = -severity 3

       then Code::TidyAll::Plugin::PerlCritic would be constructed with parameters

           select => 'lib/**/*.pm',
           ignore = 'lib/UtterHack.pm',
           argv = '-severity 3'

       The following attributes are part of this base class. Your subclass can declare others, of course.

       argv
           A standard attribute for passing command line arguments.

       cmd A    standard    attribute    for    specifying    the   name   of   the   command   to   run,   e.g.
           "/usr/local/bin/perlcritic".

       is_validator
           An attribute that indicates if this is a validator or not; By default this  returns  true  if  either
           "validate_source" or "validate_file" methods have been implemented.

       name
           Name of the plugin to be used in error messages etc.

       tidyall
           A weak reference back to the Code::TidyAll object.

       select, ignore
           Select and ignore patterns - you can ignore these.

       weight
           A  number  indicating the relative weight of the plugin, used to calculate the order the plugins will
           execute in. The lower the number the sooner the plugin will be executed.

           By default the weight will be 50 for non validators (anything where "is_validator" returns false) and
           60 for validators (anything where "is_validator" returns true.)

           The order of plugin execution is determined first by the value of the "weight"  attribute,  and  then
           (if multiple plugins have the same weight>) by sorting by the name of module.

METHODS

       Your plugin may define one or more of these methods. They are all no-ops by default.

       preprocess_source ($source)
           Receives  source code as a string; returns the processed string, or dies with error. This runs on all
           plugins before any of the other methods.

       transform_source ($source)
           Receives source code as a string; returns the  transformed  string,  or  dies  with  error.  This  is
           repeated multiple times if --iterations was passed or specified in the configuration file.

       transform_file ($file)
           Receives  filename;  transforms  the  file in place, or dies with error. Note that the file will be a
           temporary copy of the user's file with the same basename; your changes will only  propagate  back  if
           there  was  no  error  reported  from any plugin. This is repeated multiple times if --iterations was
           passed or specified in the configuration file.

       validate_source ($source)
           Receives source code as a string; dies with error if invalid. Return value will be ignored.

       validate_file ($file)
           Receives filename; validates file and dies with error if invalid.  Should  not  modify  file!  Return
           value will be ignored.

       postprocess_source ($source)
           Receives  source code as a string; returns the processed string, or dies with error. This runs on all
           plugins after any of the other methods.

SEE ALSO

       Code::TidyAll

AUTHORS

       •   Jonathan Swartz <swartz@pobox.com>

       •   Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 - 2015 by Jonathan Swartz.

       This is free software; you can redistribute it and/or modify it under  the  same  terms  as  the  Perl  5
       programming language system itself.

perl v5.20.2                                       2015-11-19                         Code::TidyAll::Plugin(3pm)