view release on metacpan or  search on metacpan

Examples.pm  view on Meta::CPAN

	};
	if (! getopts('dh', $self->{'_opts'})
		|| $self->{'_opts'}->{'h'}
		|| @ARGV > 1) {

		print STDERR "Usage: $0 [-d] [-h] [--version] [working_dir]\n";
		print STDERR "\t-d\t\tDebug mode.\n";
		print STDERR "\t-h\t\tPrint help.\n";
		print STDERR "\t--version\tPrint version.\n";
		print STDERR "\t[working_dir]\tWorking directory (default is actual).\n";
		return 1;
	}
	my $working_dir = $ARGV[0] || '.';

	# Find all perl module files in working directory.
	my $rule = File::Find::Rule->new;
	my @pm = $rule->or(
		$rule->new->directory->name('t')->prune->discard,
		$rule->new->directory->name('inc')->prune->discard,
		$rule->new->directory->name('blib')->prune->discard,
		$rule->new,
	)->name('*.pm')->in($working_dir);

	# Print Perl modules in debug mode.
	if ($self->{'_opts'}->{'d'}) {
		print "Found Perl modules:\n";
		foreach my $pm (@pm) {
			print '- '.abs2rel($pm, $working_dir)."\n";
		}
	}

	# For each example save example.
	my $num = 1;
	foreach my $perl_module_file (@pm) {

		# Get all example sections.
		my @examples = sections($perl_module_file);

		# For each section.
		foreach my $example_sec (@examples) {
			my ($section, $number_of_example) = _section_and_number($example_sec);

			# Create example content.
			my ($example_data, $example_file) = get($perl_module_file, $section,
				$number_of_example);
			if (! defined $example_file) {
				$example_file = sprintf 'ex%d.pl', $num;
			}
			$example_data = "#!/usr/bin/env perl\n\n".
				$example_data;
			my $examples_dir = catdir($working_dir, 'examples');
			my $example_path = catfile($examples_dir, $example_file);

			# Examples directory.
			if (! -r $examples_dir) {
				mkdir $examples_dir;
			}

			# Save example.
			barf($example_path, $example_data);
			chmod 0755, $example_path; 

			$num++;
		}
	}
	
	return 0;
}

# Get section name and number of example.
sub _section_and_number {
	my $example_sec = shift;

	if ($example_sec =~ m/^(.+?)(\d+)$/ms) {
		return ($1, $2);
	}

	return ($example_sec, undef);
}

1;

__END__

=pod

=encoding utf8

=head1 NAME

App::Perl::Module::Examples - Base class for perl-module-examples script.

=head1 SYNOPSIS

 use App::Perl::Module::Examples;

 my $app = App::Perl::Module::Examples->new;
 my $exit_code = $app->run;

=head1 METHODS

=head2 C<new>

 my $app = App::Perl::Module::Examples->new;

Constructor.

Returns instance of object.

=head2 C<run>

 my $exit_code = $app->run;

Run.

Returns 1 for error, 0 for success.

=head1 ERRORS

 new():
         From Class::Utils::set_params():