Commit | Line | Data |
0ba6e8aa |
1 | package Catalyst::Script::Server; |
a3ca4468 |
2 | use Moose; |
883c37ef |
3 | use MooseX::Types::Common::Numeric qw/PositiveInt/; |
880d1f8b |
4 | use MooseX::Types::Moose qw/ArrayRef Str Bool Int RegexpRef/; |
b89d8b98 |
5 | use Catalyst::Utils; |
59804176 |
6 | use namespace::autoclean; |
a3ca4468 |
7 | |
c821df21 |
8 | sub _plack_engine_name { 'Standalone' } |
9 | |
d3082fac |
10 | with 'Catalyst::ScriptRole'; |
a3ca4468 |
11 | |
f59a9d1b |
12 | has debug => ( |
4387c692 |
13 | traits => [qw(Getopt)], |
14 | cmd_aliases => 'd', |
15 | isa => Bool, |
16 | is => 'ro', |
d3082fac |
17 | documentation => q{Force debug mode}, |
e46bf32c |
18 | ); |
19 | |
57dc50b0 |
20 | has host => ( |
4387c692 |
21 | traits => [qw(Getopt)], |
22 | cmd_aliases => 'h', |
23 | isa => Str, |
24 | is => 'ro', |
b1bfeea6 |
25 | # N.B. undef (the default) means we bind on all interfaces on the host. |
3bd410a9 |
26 | documentation => 'Specify a hostname or IP on this host for the server to bind to', |
41b55019 |
27 | ); |
90b481b1 |
28 | |
57dc50b0 |
29 | has fork => ( |
4387c692 |
30 | traits => [qw(Getopt)], |
31 | cmd_aliases => 'f', |
32 | isa => Bool, |
33 | is => 'ro', |
34 | default => 0, |
53c6ec79 |
35 | documentation => 'Fork the server to be able to serve multiple requests at once', |
90b481b1 |
36 | ); |
37 | |
bc6fa9fc |
38 | has port => ( |
4387c692 |
39 | traits => [qw(Getopt)], |
40 | cmd_aliases => 'p', |
883c37ef |
41 | isa => PositiveInt, |
4387c692 |
42 | is => 'ro', |
b89d8b98 |
43 | default => sub { |
56eb9db4 |
44 | Catalyst::Utils::env_value(shift->application_name, 'port') || 3000 |
b89d8b98 |
45 | }, |
53c6ec79 |
46 | documentation => 'Specify a different listening port (to the default port 3000)', |
204c6935 |
47 | ); |
48 | |
57dc50b0 |
49 | has pidfile => ( |
4387c692 |
50 | traits => [qw(Getopt)], |
51 | cmd_aliases => 'pid', |
52 | isa => Str, |
53 | is => 'ro', |
d3082fac |
54 | documentation => 'Specify a pidfile', |
41b55019 |
55 | ); |
56 | |
57dc50b0 |
57 | has keepalive => ( |
4387c692 |
58 | traits => [qw(Getopt)], |
59 | cmd_aliases => 'k', |
60 | isa => Bool, |
61 | is => 'ro', |
62 | default => 0, |
53c6ec79 |
63 | documentation => 'Support keepalive', |
bd31e11f |
64 | ); |
65 | |
57dc50b0 |
66 | has background => ( |
4387c692 |
67 | traits => [qw(Getopt)], |
68 | cmd_aliases => 'bg', |
69 | isa => Bool, |
70 | is => 'ro', |
71 | default => 0, |
d3082fac |
72 | documentation => 'Run in the background', |
57dc50b0 |
73 | ); |
4b3881d4 |
74 | |
8f01ed5f |
75 | has restart => ( |
4387c692 |
76 | traits => [qw(Getopt)], |
77 | cmd_aliases => 'r', |
78 | isa => Bool, |
79 | is => 'ro', |
56eb9db4 |
80 | default => sub { |
81 | Catalyst::Utils::env_value(shift->application_name, 'reload') || 0; |
82 | }, |
53c6ec79 |
83 | documentation => 'use Catalyst::Restarter to detect code changes and restart the application', |
57dc50b0 |
84 | ); |
a7dea640 |
85 | |
86 | has restart_directory => ( |
4387c692 |
87 | traits => [qw(Getopt)], |
1c517146 |
88 | cmd_aliases => [ 'rdir', 'restartdirectory' ], |
4387c692 |
89 | isa => ArrayRef[Str], |
90 | is => 'ro', |
d3082fac |
91 | documentation => 'Restarter directory to watch', |
4387c692 |
92 | predicate => '_has_restart_directory', |
8f01ed5f |
93 | ); |
94 | |
57dc50b0 |
95 | has restart_delay => ( |
4387c692 |
96 | traits => [qw(Getopt)], |
97 | cmd_aliases => 'rd', |
98 | isa => Int, |
99 | is => 'ro', |
d3082fac |
100 | documentation => 'Set a restart delay', |
4387c692 |
101 | predicate => '_has_restart_delay', |
70871584 |
102 | ); |
103 | |
880d1f8b |
104 | { |
105 | use Moose::Util::TypeConstraints; |
106 | |
107 | my $tc = subtype as RegexpRef; |
108 | coerce $tc, from Str, via { qr/$_/ }; |
109 | |
110 | MooseX::Getopt::OptionTypeMap->add_option_type_to_map($tc => '=s'); |
111 | |
112 | has restart_regex => ( |
4387c692 |
113 | traits => [qw(Getopt)], |
114 | cmd_aliases => 'rr', |
115 | isa => $tc, |
116 | coerce => 1, |
117 | is => 'ro', |
880d1f8b |
118 | documentation => 'Restart regex', |
4387c692 |
119 | predicate => '_has_restart_regex', |
880d1f8b |
120 | ); |
121 | } |
ee7aabd6 |
122 | |
57dc50b0 |
123 | has follow_symlinks => ( |
4387c692 |
124 | traits => [qw(Getopt)], |
125 | cmd_aliases => 'sym', |
126 | isa => Bool, |
127 | is => 'ro', |
128 | default => 0, |
d3082fac |
129 | documentation => 'Follow symbolic links', |
4387c692 |
130 | predicate => '_has_follow_symlinks', |
bbd42ac8 |
131 | ); |
a3ca4468 |
132 | |
3453b929 |
133 | sub _restarter_args { |
134 | my $self = shift; |
34be7d45 |
135 | |
10255473 |
136 | return ( |
34be7d45 |
137 | argv => $self->ARGV, |
138 | start_sub => sub { $self->_run_application }, |
139 | ($self->_has_follow_symlinks ? (follow_symlinks => $self->follow_symlinks) : ()), |
140 | ($self->_has_restart_delay ? (sleep_interval => $self->restart_delay) : ()), |
141 | ($self->_has_restart_directory ? (directories => $self->restart_directory) : ()), |
880d1f8b |
142 | ($self->_has_restart_regex ? (filter => $self->restart_regex) : ()), |
34be7d45 |
143 | ); |
3453b929 |
144 | } |
145 | |
a3ca4468 |
146 | sub run { |
3453b929 |
147 | my $self = shift; |
57dc50b0 |
148 | |
53c6ec79 |
149 | local $ENV{CATALYST_DEBUG} = 1 |
150 | if $self->debug; |
abee32cb |
151 | |
a7dea640 |
152 | if ( $self->restart ) { |
153 | die "Cannot run in the background and also watch for changed files.\n" |
154 | if $self->background; |
155 | |
53c6ec79 |
156 | # If we load this here, then in the case of a restarter, it does not |
157 | # need to be reloaded for each restart. |
158 | require Catalyst; |
159 | |
160 | # If this isn't done, then the Catalyst::Devel tests for the restarter |
161 | # fail. |
162 | $| = 1 if $ENV{HARNESS_ACTIVE}; |
163 | |
a7dea640 |
164 | require Catalyst::Restarter; |
165 | |
166 | my $subclass = Catalyst::Restarter->pick_subclass; |
167 | |
a7dea640 |
168 | my $restarter = $subclass->new( |
3453b929 |
169 | $self->_restarter_args() |
a7dea640 |
170 | ); |
171 | |
172 | $restarter->run_and_watch; |
173 | } |
174 | else { |
d3082fac |
175 | $self->_run_application; |
a7dea640 |
176 | } |
177 | |
178 | |
57dc50b0 |
179 | } |
180 | |
36a53c3a |
181 | sub _plack_loader_args { |
182 | my ($self) = shift; |
183 | return ( |
184 | port => $self->port, |
185 | host => $self->host, |
186 | keepalive => $self->keepalive ? 100 : 1, |
54ab9446 |
187 | server_ready => sub { |
188 | my ($args) = @_; |
189 | |
190 | my $name = $args->{server_software} || ref($args); # $args is $server |
191 | my $host = $args->{host} || 0; |
192 | my $proto = $args->{proto} || 'http'; |
193 | |
194 | print STDERR "$name: Accepting connections at $proto://$host:$args->{port}/\n"; |
195 | }, |
36a53c3a |
196 | ); |
197 | } |
198 | |
d3082fac |
199 | sub _application_args { |
a7dea640 |
200 | my ($self) = shift; |
d3082fac |
201 | return ( |
bc6fa9fc |
202 | $self->port, |
d3082fac |
203 | $self->host, |
57dc50b0 |
204 | { |
30b70903 |
205 | argv => $self->ARGV, |
d3082fac |
206 | map { $_ => $self->$_ } qw/ |
207 | fork |
208 | keepalive |
209 | background |
210 | pidfile |
211 | keepalive |
212 | follow_symlinks |
213 | /, |
214 | }, |
a3ca4468 |
215 | ); |
a3ca4468 |
216 | } |
5b923b0b |
217 | |
2e81e132 |
218 | __PACKAGE__->meta->make_immutable; |
5b923b0b |
219 | |
0ba6e8aa |
220 | 1; |
e46bf32c |
221 | |
222 | =head1 NAME |
223 | |
cbaaecc0 |
224 | Catalyst::Script::Server - Catalyst test server |
e46bf32c |
225 | |
226 | =head1 SYNOPSIS |
227 | |
cbaaecc0 |
228 | myapp_server.pl [options] |
e46bf32c |
229 | |
230 | Options: |
4b3881d4 |
231 | -d --debug force debug mode |
232 | -f --fork handle each request in a new process |
e46bf32c |
233 | (defaults to false) |
3dcfb4c8 |
234 | --help display this help and exits |
235 | -h --host host (defaults to all) |
4b3881d4 |
236 | -p --port port (defaults to 3000) |
237 | -k --keepalive enable keep-alive connections |
238 | -r --restart restart when files get modified |
239 | (defaults to false) |
87f5a448 |
240 | --rd --restart_delay delay between file checks |
e46bf32c |
241 | (ignored if you have Linux::Inotify2 installed) |
87f5a448 |
242 | --rr --restart_regex regex match files that trigger |
e46bf32c |
243 | a restart when modified |
244 | (defaults to '\.yml$|\.yaml$|\.conf|\.pm$') |
87f5a448 |
245 | --rdir --restart_directory the directory to search for |
6ab9f4af |
246 | modified files, can be set multiple times |
e46bf32c |
247 | (defaults to '[SCRIPT_DIR]/..') |
4b3881d4 |
248 | --sym --follow_symlinks follow symlinks in search directories |
e46bf32c |
249 | (defaults to false. this is a no-op on Win32) |
4b3881d4 |
250 | --bg --background run the process in the background |
251 | --pid --pidfile specify filename for pid file |
e46bf32c |
252 | |
253 | See also: |
254 | perldoc Catalyst::Manual |
255 | perldoc Catalyst::Manual::Intro |
256 | |
257 | =head1 DESCRIPTION |
258 | |
cbaaecc0 |
259 | Run a Catalyst test server for this application. |
e46bf32c |
260 | |
261 | =head1 AUTHORS |
262 | |
263 | Catalyst Contributors, see Catalyst.pm |
264 | |
265 | =head1 COPYRIGHT |
266 | |
267 | This library is free software. You can redistribute it and/or modify |
268 | it under the same terms as Perl itself. |
269 | |
270 | =cut |