SourceCode::LineCounter::Perl - Count lines in Perl source code
use SourceCode::LineCounter::Perl; my $counter = SourceCode::LineCounter::Perl->new; $counter->count( $file ); my $total_lines = $counter->total; my $pod_lines = $counter->documentation; my $code_lines = $counter->code; my $comment_lines = $counter->comment; my $comment_lines = $counter->blank;
This module counts the lines in Perl source code and tries to classify them as code lines, documentation lines, and blank lines.
Read a line
If it's a blank line, record it and move on to the next line
If it is the start of pod, mark that we are in pod, and count it as a pod line and move on
If we are in pod and the line is blank, record it as a blank line and a pod line, and move on.
If we are ending pod (with
=cut, record it as a pod line and move on.
If we are in pod and it is not blank, record it as a pod line and move on.
If we are not in pod, guess if the line has a comment. If the line has a comment, record it.
Removing comments, see if there is anything left. If there is, record it as a code line.
Move on to the next line.
Reset everything the object counted so you can use the same object with another file.
- accumulate( [ BOOLEAN ] )
With no argument, returns the current setting as true or false.
With one argument, sets the value for accumulation. If that's true, the counter will add to the count from previous calls to
counter. If false,
counterstarts fresh each time.
- count( FILE )
Counts the lines in FILE. The optional second argument, if true, adds those counts to the counts from the last run. By default, previous results are cleared.
Returns the total number of lines in the file
Returns the total number of Pod lines in the file, including and blank lines in Pod.
Add to the documentation line counter if the line is documentation.
Returns the number of non-blank lines, whether documentation or code.
- add_to_code( LINE )
Add to the code line counter if the line is a code line.
The number of lines with comments. These are the things that start with #. That might be lines that are all comments or code lines that have comments.
Add to the comment line counter if the line has a comment. A line might be counted as both code and comments.
The number of blank lines. By default, these are lines that match the regex qr/^\s*$/. You can change this in
new()by specifying the
Add to the blank line counter if the line is blank.
Generalized LineCounter that can dispatch to language delegates.
This source is in Github
brian d foy,
COPYRIGHT AND LICENSE
Copyright (c) 2008-2013, brian d foy, All Rights Reserved.
You may redistribute this under the same terms as Perl itself.