Permalink
Browse files

rename the module to top-level namespace. See =head1 NAMING for details.

  • Loading branch information...
1 parent 4bccb06 commit f165d4d72b2b1bd5eb2aae3f3580add8fe283e3f @miyagawa committed Feb 11, 2010
View
2 Changes
@@ -1,4 +1,4 @@
-Revision history for Perl extension HTTP::Server::Starman
+Revision history for Perl extension Starman
0.01 Tue Jan 12 01:31:31 2010
- original version
View
5 Makefile.PL
@@ -1,14 +1,15 @@
use inc::Module::Install;
name 'Starman';
-all_from 'lib/HTTP/Server/Starman.pm';
-readme_from 'lib/HTTP/Server/Starman.pm';
+all_from 'lib/Starman.pm';
+readme_from 'lib/Starman.pm';
build_requires 'Test::More';
requires 'Plack', 0.99_05;
requires 'Net::Server';
requires 'Data::Dump';
requires 'HTTP::Parser::XS';
requires 'HTTP::Status';
requires 'HTTP::Date';
+requires 'parent';
install_script 'bin/starman';
recommends 'Server::Starter';
recommends 'Net::Server::SS::PreFork';
View
23 README
@@ -1,5 +1,5 @@
NAME
- HTTP::Server::Starman - High-performance preforking PSGI web server
+ Starman - High-performance preforking PSGI web server
SYNOPSIS
# Run app.psgi with the default settings
@@ -65,10 +65,23 @@ PERFORMANCE
-- server: POE
Requests per second: 503.59 [#/sec] (mean)
-STARMAN?
- The name Starman is taken from the song (*Star na Otoko*) by a Japanese
- rock band Unicorn. It's also a power-up from Super Mario and a character
- from the video game Earthbound.
+NAMING
+ Starman?
+ The name Starman is taken from the song (*Star na Otoko*) by the
+ Japanese rock band Unicorn. It's also a power-up from Super Mario
+ Brothers and a character from the video game Earthbound.
+
+ Why the cute name instead of being more descriptive namespace? Are you on drugs?
+ Maybe I am on drugs with all those Ruby cute names but I'm sick of
+ naming software like
+ HTTP::Server::PSGI::How::Its::Written::With::What::Module and people
+ call it HSSPHIWWWM on IRC, and newbies would ask questinos what they
+ stand for every day. That's crazy.
+
+ This module actually includes the longer alias
+ HTTP::Server::PSGI::Net::Server::PreFork for those who like to type more
+ ::'s. It would actually help you find this software by searching for
+ *PSGI Server Prefork* on CPAN, which i believe is a good thing.
AUTHOR
Tatsuhiko Miyagawa <miyagawa@bulknews.net>
View
4 lib/HTTP/Server/PSGI/Net/Server/PreFork.pm
@@ -0,0 +1,4 @@
+package HTTP::Server::PSGI::Net::Server::PreFork;
+use parent qw(Starman::Server);
+
+1;
View
8 lib/Plack/Handler/Starman.pm
@@ -1,6 +1,6 @@
package Plack::Handler::Starman;
use strict;
-use HTTP::Server::Starman::Server;
+use Starman::Server;
sub new {
my $class = shift;
@@ -12,10 +12,10 @@ sub run {
if ($ENV{SERVER_STARTER_PORT}) {
require Net::Server::SS::PreFork;
- @HTTP::Server::Starman::Server::ISA = qw(Net::Server::SS::PreFork); # Yikes.
+ @Starman::Server::ISA = qw(Net::Server::SS::PreFork); # Yikes.
}
- HTTP::Server::Starman::Server->new->run($app, {%$self});
+ Starman::Server->new->run($app, {%$self});
}
1;
@@ -36,7 +36,7 @@ Tatsuhiko Miyagawa
=head1 SEE ALSO
-L<HTTP::Server::Starman>
+L<Starman>
=cut
View
27 lib/HTTP/Server/Starman.pm → lib/Starman.pm
@@ -1,4 +1,4 @@
-package HTTP::Server::Starman;
+package Starman;
use strict;
use 5.008_001;
@@ -13,7 +13,7 @@ __END__
=head1 NAME
-HTTP::Server::Starman - High-performance preforking PSGI web server
+Starman - High-performance preforking PSGI web server
=head1 SYNOPSIS
@@ -93,11 +93,26 @@ with ApacheBench concurrenty 10 and Keep-alive on.
-- server: POE
Requests per second: 503.59 [#/sec] (mean)
-=head1 STARMAN?
+=head1 NAMING
-The name Starman is taken from the song (I<Star na Otoko>) by a
-Japanese rock band Unicorn. It's also a power-up from Super Mario and
-a character from the video game Earthbound.
+=head2 Starman?
+
+The name Starman is taken from the song (I<Star na Otoko>) by the
+Japanese rock band Unicorn. It's also a power-up from Super Mario
+Brothers and a character from the video game Earthbound.
+
+=head2 Why the cute name instead of being more descriptive namespace? Are you on drugs?
+
+Maybe I am on drugs with all those Ruby cute names but I'm sick of
+naming software like
+HTTP::Server::PSGI::How::Its::Written::With::What::Module and people
+call it HSSPHIWWWM on IRC, and newbies would ask questinos what they
+stand for every day. That's crazy.
+
+This module actually includes the longer alias
+L<HTTP::Server::PSGI::Net::Server::PreFork> for those who like to type
+more ::'s. It would actually help you find this software by searching
+for I<PSGI Server Prefork> on CPAN, which i believe is a good thing.
=head1 AUTHOR
View
2 lib/HTTP/Server/Starman/Server.pm → lib/Starman/Server.pm
@@ -1,4 +1,4 @@
-package HTTP::Server::Starman::Server;
+package Starman::Server;
use strict;
use base 'Net::Server::PreFork';
View
2 t/00_compile.t
@@ -1,4 +1,4 @@
use strict;
use Test::More tests => 1;
-BEGIN { use_ok 'HTTP::Server::Starman' }
+BEGIN { use_ok 'Starman' }

0 comments on commit f165d4d

Please sign in to comment.