From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

IVANWILLS / App-TemplateCMD-v0.6.12 / lib / App / TemplateCMD / Command.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
—
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155

              
package App::TemplateCMD::Command;
# Created on: 2008-09-04 04:26:46
# Create by:  ivan
# $Id$
# $Revision$, $HeadURL$, $Date$
# $Revision$, $Source$, $Date$
use strict;
use warnings;
use version;
use Carp;
use Data::Dumper qw/Dumper/;
use English qw/ -no_match_vars /;
use base qw/Exporter/;
our $VERSION     = version->new('0.6.12');
our @EXPORT_OK   = qw//;
our %EXPORT_TAGS = ();
#our @EXPORT      = qw//;
sub args {
    return (
        'path|p=s',
    );
}
sub default {
}
sub get_template {
    my ($self, $template, $cmd) = @_;
    # try to get the template directly by name
    for my $provider (@{ $cmd->{providers} }) {
        if ($provider->{INCLUDE_PATH}) {
            for my $path (@{ $provider->{INCLUDE_PATH} }) {
                my ($data, $error) = $provider->_load( "$path/$template" );
                if ($data->{text}) {
                    # return the found template info
                    return ($data, $provider, $error, [$template]);
                }
            }
        }
        else {
            my ($data, $error) = $provider->_load( $template );
            if ($data->{text}) {
                # return the found template info
                return ($data, $provider, $error, [$template]);
            }
        }
        if ($cmd->{verbose}) {
            print "$template was not found with provider " . ( ref $provider ) . "\n";
        }
    }
    # now try to get the template assumin it is missing its suffix
    my @files = map {$_->{file}} $cmd->list_templates();
    # get all templates that start with the template name provided
    my @templates = grep { m{^$template [.] .+ $}xms } @files;
    if (@templates) {
        for my $provider (@{ $cmd->{providers} }) {
            my ($data, $error) = $provider->_load( $templates[0] );
            if ($data->{text}) {
                # return the found template info
                return ($data, $provider, $error, \@templates);
            }
        }
    }
    # no template found
    croak "The template $template was not found!";
}
1;
__END__
=head1 NAME
App::TemplateCMD::Command - The base class for command modules
=head1 VERSION
This documentation refers to App::TemplateCMD::Command version 0.6.12.
=head1 SYNOPSIS
   use App::TemplateCMD::Command;
   # Brief but working code example(s) here showing the most common usage(s)
   # This section will be as far as many users bother reading, so make it as
   # educational and exemplary as possible.
=head1 DESCRIPTION
=head1 SUBROUTINES/METHODS
=head3 C<args ()>
Stub for returning command specific arguments
=head3 C<default ()>
Stub for returning default values for values of command line inputs
=head3 C<get_template ( $template, $cmd )>
Arg: C<$template> - type (detail) - description
Arg: C<$cmd> - type (detail) - description
Return: ($data, $provider, $error, $templates)
Description: Gets the data for a template
=head1 DIAGNOSTICS
=head1 CONFIGURATION AND ENVIRONMENT
=head1 DEPENDENCIES
=head1 INCOMPATIBILITIES
=head1 BUGS AND LIMITATIONS
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gmail.com).
Patches are welcome.
=head1 AUTHOR
Ivan Wills - (ivan.wills@gmail.com)
=head1 LICENSE AND COPYRIGHT
Copyright (c) 2009 Ivan Wills (14 Mullion Close, NSW, Australia 2077).
All rights reserved.
This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself. See L<perlartistic>.  This program is
distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.
=cut