--- /dev/null
+This file documents the revision history for Perl extension CookBook.
+
+0.01 2007-08-07 15:57:22
+ - initial revision, generated by Catalyst
--- /dev/null
+use inc::Module::Install;
+
+name 'CookBook';
+all_from 'lib/CookBook.pm';
+
+requires 'Catalyst' => '5.7007';
+requires 'Catalyst::Plugin::ConfigLoader';
+requires 'Catalyst::Plugin::Static::Simple';
+requires 'Catalyst::Action::RenderView';
+requires 'YAML'; # This should reflect the config file format you've chosen
+ # See Catalyst::Plugin::ConfigLoader for supported formats
+catalyst;
+
+install_script glob('script/*.pl');
+auto_install;
+WriteAll;
--- /dev/null
+Run script/cookbook_server.pl to test the application.
--- /dev/null
+---
+name: CookBook
--- /dev/null
+package CookBook;
+
+# $Id: CIT.pm 69 2007-06-27 12:55:47Z fbrehm $
+# $URL: http://maria.technik.berlin.strato.de:8080/svn-cit/trunk/CIT/lib/CIT.pm $
+
+use strict;
+use warnings;
+
+use Catalyst::Runtime '5.70';
+
+# Set flags and add plugins for the application
+#
+# ConfigLoader: will load the configuration from a YAML file in the
+# application's home directory
+# Static::Simple: will serve static files from the application's root
+# directory
+
+use Catalyst qw/
+
+ ConfigLoader
+
+ Static::Simple
+
+/;
+
+our $VERSION = '0.01';
+
+# Configure the application.
+#
+# Note that settings in CookBook.yml (or other external
+# configuration file that you set up manually) take precedence
+# over this when using ConfigLoader. Thus configuration
+# details given here can function as a default configuration,
+# with a external configuration file acting as an override for
+# local deployment.
+
+__PACKAGE__->config( name => 'CookBook' );
+
+# Start the application
+__PACKAGE__->setup;
+
+
+=head1 NAME
+
+CookBook - Catalyst based application
+
+=head1 SYNOPSIS
+
+ script/cookbook_server.pl
+
+=head1 DESCRIPTION
+
+[enter your description here]
+
+=head1 SEE ALSO
+
+L<CookBook::Controller::Root>, L<Catalyst>
+
+=head1 AUTHOR
+
+Frank Brehm
+
+=head1 LICENSE
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
+
+1;
--- /dev/null
+package CookBook::Common;
+
+# $Id: Common.pm 69 2007-06-27 12:55:47Z fbrehm $
+# $URL: http://maria.technik.berlin.strato.de:8080/svn-cit/trunk/CIT/lib/CIT/Common.pm $
+
+=head1 NAME
+
+CookBook::Common
+
+=head1 DESCRIPTION
+
+Modul fuer allgemeine Aufgaben, zum Beispiel Verbose-Level usw.
+
+Dieses Modul sollte von allen Scripten und Modulen verwendet werden.
+
+=cut
+
+#---------------------------------------------------------------------------
+
+use strict;
+use warnings;
+use Exporter;
+use Data::Dumper;
+use Cwd;
+use File::Spec;
+
+use Carp qw(:DEFAULT cluck);
+
+our @ISA = qw(Exporter);
+our @EXPORT = qw(
+ &verbose
+ &canon_filename
+ &common_debug
+ &common_error
+ &common_notice
+ &get_output_string
+ &escape_html
+ &home_dir
+ &to_bool
+ &to_float
+ &to_int
+);
+
+$Data::Dumper::Indent = 1;
+$Data::Dumper::Sortkeys = 1;
+
+our $COOKBOOK_VERSION = "1.1";
+our $AUTHOR = 'Frank Brehm <frank@brehm-online.com>';
+
+our $env_home_name = 'COOKBOOK_HOME';
+
+my $Revis = <<'ENDE';
+ $Revision: 69 $
+ENDE
+$Revis =~ s/^.*:\s*(\S+)\s*\$.*/$1/s;
+our $VERSION = $COOKBOOK_VERSION . "." . $Revis;
+
+my $verbose = 0;
+my $mark = 'CookBook';
+
+#------------------------------------------------------------------------------------------
+
+=head1 Funktionen
+
+Alle hier definierten Funktionen werden exportiert.
+
+#------------------------------------------------------------------------------------------
+
+=head2 verbose( $new_verbose_level )
+
+Setzt bzw. gibt den Verbose-Level des aktuellen Scripts zurueck.
+
+Typische Werte:
+
+=over 4
+
+=item I<0>:
+
+Keinerlei Ausgaben.
+
+=item I<1>:
+
+Ausgabe der wichtigsten Aktionen des aktuellen Scripts (sollte eigentlich Standard sein).
+
+.
+.
+.
+
+=item I<6>:
+
+Ausfuehrlichstes Geplapper bis zum Gehtnichtmehr.
+
+=back
+
+=cut
+
+sub verbose {
+
+ my $new_verbose_level = shift;
+
+ if ( defined $new_verbose_level and $new_verbose_level =~ /^\d+$/ ) {
+ $verbose = $new_verbose_level;
+ }
+
+ return $verbose;
+
+} ## end sub verbose
+
+##------------------------------------------------------------------------------------------
+
+=head2 mark( [$new_mark] )
+
+Gibt den aktuellen Log-Marker zurueck bzw. setzt einen neuen, wenn er übergeben wurde.
+
+=cut
+
+sub mark {
+
+ my $new_mark = shift;
+
+ if ( $new_mark and $new_mark !~ /^\s*$/ ) {
+ $new_mark =~ s/^\s+//;
+ $new_mark =~ s/\s+$//s;
+ $mark = $new_mark;
+ }
+
+ return $mark;
+
+} ## end sub mark
+
+#------------------------------------------------------------------------------------------
+
+=head2 home_dir()
+
+Gibt den Namen des Verzeichnisses der Software-Installation zurueck,
+die aus der Umgebungsvariablen C<COOKBOOK_HOME> entnommen wird.
+
+Wenn die Umgebungsvariable nicht gesetzt ist bzw. auf ein nicht vorhandenes Verzeichnis
+zeigt, wird undef zurueckgegeben.
+
+=cut
+
+sub home_dir {
+
+ my $K = __PACKAGE__ . "::home_dir(): ";
+
+ unless ( $ENV{$env_home_name} ) {
+ common_notice( $K . "Umgebungsvariable '" . $env_home_name . "' nicht gesetzt." );
+ return undef;
+ }
+
+ unless ( File::Spec->file_name_is_absolute( $ENV{$env_home_name} ) ) {
+ common_notice( $K . "Umgebungsvariable '" . $env_home_name . "' (" . $ENV{$env_home_name} . ") ist keine absolute Pfadangabe." );
+ return undef;
+ }
+
+ unless ( -d $ENV{$env_home_name} ) {
+ common_notice(
+ $K . "Umgebungsvariable '" . $env_home_name . "' zeigt auf nicht vorhandenes Verzeichnis '" . $ENV{$env_home_name} . "'." );
+ return undef;
+ }
+
+ return File::Spec->canonpath( $ENV{$env_home_name} );
+
+} ## end sub home_dir
+
+#------------------------------------------------------------------------------------------
+
+=head2 canon_filename( @directories, $filename )
+
+Kettet die uebergebenen Verzeichnisnamen und Dateinamen aneinander.
+Wenn der resultierende Pfad nicht absolut ist, wird home_dir() davorgehaengt.
+
+=cut
+
+sub canon_filename {
+
+ my @path = @_;
+ my $K = __PACKAGE__ . "::canon_filename(): ";
+
+ unless ( scalar(@path) ) {
+ common_notice( $K . "Keine Argumente uebergeben." );
+ return undef;
+ }
+
+ my $file = File::Spec->catfile(@path);
+ unless ( File::Spec->file_name_is_absolute($file) ) {
+ my $home = home_dir();
+ return undef unless $home;
+ $file = File::Spec->catfile( $home, @path );
+ }
+
+ return $file;
+
+} ## end sub canon_filename
+
+#---------------------------------------------------------------------------
+
+=head2 common_debug( $debug_level, @messages )
+
+Allgemeine Debug-Funktion (wenn das Log-Objekt noch nicht existieren sollte)
+
+=cut
+
+sub common_debug {
+
+ my $debug_level = shift;
+
+ $debug_level = to_int($debug_level);
+ $debug_level = 1 unless defined $debug_level;
+
+ return if $debug_level > $verbose;
+
+ my $text = get_output_string(@_);
+ return if $text eq '';
+
+ print $mark . " (debug" . $debug_level . "): " . $text . "\n";
+
+ return;
+
+} ## end sub common_debug
+
+#---------------------------------------------------------------------------
+
+sub get_output_string {
+
+ my $text = '';
+ for (@_) {
+ next unless defined $_;
+ my $t = ref($_) ? Dumper($_) : $_;
+ next if $t eq '';
+ $text .= $t;
+ }
+
+ $text =~ s/^\s+//;
+ $text =~ s/\s+$//s;
+ return $text;
+
+} ## end sub get_output_string
+
+#---------------------------------------------------------------------------
+
+=head2 common_error( $error_level, @messages )
+
+Allgemeine Error-Warn-Funktion (wenn das Log-Objekt noch nicht existieren sollte)
+
+=cut
+
+sub common_error {
+
+ my $error_level = shift;
+
+ $error_level ||= 'error';
+
+ my $text = get_output_string(@_);
+
+ $text = "unbekannter Fehler" if $text eq '';
+
+ warn $mark . "(" . $error_level . "): " . $text . "\n";
+
+ return;
+
+} ## end sub common_error
+
+#---------------------------------------------------------------------------
+
+=head2 common_notice( @messages )
+
+Allgemeine Warnmeldung.
+
+=cut
+
+sub common_notice {
+
+ my $text = get_output_string(@_);
+ $text = "unbekannter Fehler" if $text eq '';
+
+ warn $mark . ": " . $text . "\n";
+
+ return;
+
+} ## end sub common_notice
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_bool( $wert )
+
+Wandelt den uebergebenen Scalar sicher in einen Wahrheitswert (0 oder 1) um.
+
+=cut
+
+sub to_bool {
+
+ my $val = shift;
+
+ return 0 unless defined $val;
+ return 0 if $val =~ /^\s*$/;
+
+ if ( $val =~ /^\s*y(?:es?)?/i
+ or $val =~ /^\s*ja?/i
+ or $val =~ /^\s*[wt]\s*$/i
+ or $val =~ /^\s*on\s*$/i
+ or $val =~ /^\s*wahr|true/i )
+ {
+ return 1;
+ }
+
+ if ( $val =~ /^\s*no?/i
+ or $val =~ /^\s*ne(?:in?)?/i
+ or $val =~ /^\s*f\s*$/i
+ or $val =~ /^\s*off\s*$/i
+ or $val =~ /^\s*falsch|false/i )
+ {
+ return 0;
+ }
+
+ my $intval = to_int($val);
+ if ( defined $intval ) {
+ return $intval ? 1 : 0;
+ }
+
+ return $val ? 1 : 0;
+
+} ## end sub to_bool
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_float( $wert )
+
+Wandelt den uebergebenen Scalar sicher in eine Float-Zahl um.
+
+Falls der uebergebene Wert keine gueltige Zahl ist, wird undef zurueckgegeben.
+
+=cut
+
+sub to_float {
+
+ my $val = shift;
+
+ return undef unless defined($val) and $val =~ /\d/;
+
+ my $ts = ",";
+ my $ds = ".";
+
+ if ( ( $val =~ /\d,/ and $val !~ /\d\./ )
+ or ( $val =~ /\d\.\d\d\d\./ )
+ or ( $val =~ /\d\.\d\d\d,/ ) )
+ {
+ $ds = ",";
+ $ts = ".";
+ }
+
+ $val =~ s/\Q$ts\E//g;
+ $val =~ s/\Q$ds\E/\./g;
+
+ return ( $val + 0 );
+
+} ## end sub to_float
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_int( $wert, $signed )
+
+Wandelt den uebergebenen Wert sicher in eine Integer-Zahl um.
+
+Dabei legt der optionale logische Parameter $signed fest, ob auch
+vorzeichenbehaftete Werte zulaessig sind.
+
+Wenn keine gueltige Zahl uebergeben wird, wird undef zurueckgegeben.
+
+=cut
+
+sub to_int {
+
+ my $val = shift;
+ my $signed = shift;
+
+ return undef unless defined $val;
+ unless ( $val =~ /\d/ ) {
+ return undef;
+ }
+
+ if ($signed) {
+ $val =~ /^[^\d-]*(?:(-)\s*)?(\d+)/;
+ $val = ( defined $1 ? $1 : '' ) . $2;
+ }
+ else {
+ $val =~ /^\D*(\d+)/;
+ $val = $1;
+ }
+
+ return $val + 0;
+
+} ## end sub to_int
+
+#------------------------------------------------------------------------------------------
+
+=head2 escape_html( $text )
+
+Maskiert alle '&', '<', '>' und '"' im uebergebenen Text durch entsprechende
+HTML-Entities.
+
+Entnommen dem Modul L<CGI::Util>.
+
+=cut
+
+sub escape_html {
+
+ return unless defined( my $toencode = shift );
+
+ $toencode =~ s{&}{&}gso;
+ $toencode =~ s{<}{<}gso;
+ $toencode =~ s{>}{>}gso;
+ $toencode =~ s{\"}{"}gso;
+
+ # Doesn't work. Can't work. forget it.
+ # $toencode =~ s{\x8b}{‹}gso;
+ # $toencode =~ s{\x9b}{›}gso;
+
+ $toencode;
+
+} ## end sub escape_html
+
+#------------------------------------------------------------------------------------------
+
+1;
+
+#------------------------------------------------------------------------------------------
+
+__END__
--- /dev/null
+package CookBook::Common;
+
+# $Id: Common.pm 69 2007-06-27 12:55:47Z fbrehm $
+# $URL: http://maria.technik.berlin.strato.de:8080/svn-cit/trunk/CIT/lib/CIT/Common.pm $
+
+=head1 NAME
+
+CookBook::Common
+
+=head1 DESCRIPTION
+
+Modul fuer allgemeine Aufgaben, zum Beispiel Verbose-Level usw.
+
+Dieses Modul sollte von allen Scripten und Modulen verwendet werden.
+
+=cut
+
+#---------------------------------------------------------------------------
+
+use strict;
+use warnings;
+use Exporter;
+use Data::Dumper;
+use Cwd;
+use File::Spec;
+
+use Carp qw(:DEFAULT cluck);
+
+our @ISA = qw(Exporter);
+our @EXPORT = qw(
+ &verbose
+ &canon_filename
+ &common_debug
+ &common_error
+ &common_notice
+ &get_output_string
+ &escape_html
+ &home_dir
+ &to_bool
+ &to_float
+ &to_int
+);
+
+$Data::Dumper::Indent = 1;
+$Data::Dumper::Sortkeys = 1;
+
+our $COOKBOOK_VERSION = "1.1";
+our $AUTHOR = 'Frank Brehm <frank@brehm-online.com>';
+
+our $env_home_name = 'COOKBOOK_HOME';
+
+my $Revis = <<'ENDE';
+ $Revision: 69 $
+ENDE
+$Revis =~ s/^.*:\s*(\S+)\s*\$.*/$1/s;
+our $VERSION = $COOKBOOK_VERSION . "." . $Revis;
+
+my $verbose = 0;
+my $mark = 'CookBook';
+
+#------------------------------------------------------------------------------------------
+
+=head1 Funktionen
+
+Alle hier definierten Funktionen werden exportiert.
+
+#------------------------------------------------------------------------------------------
+
+=head2 verbose( $new_verbose_level )
+
+Setzt bzw. gibt den Verbose-Level des aktuellen Scripts zurueck.
+
+Typische Werte:
+
+=over 4
+
+=item I<0>:
+
+Keinerlei Ausgaben.
+
+=item I<1>:
+
+Ausgabe der wichtigsten Aktionen des aktuellen Scripts (sollte eigentlich Standard sein).
+
+.
+.
+.
+
+=item I<6>:
+
+Ausfuehrlichstes Geplapper bis zum Gehtnichtmehr.
+
+=back
+
+=cut
+
+sub verbose {
+
+ my $new_verbose_level = shift;
+
+ if ( defined $new_verbose_level and $new_verbose_level =~ /^\d+$/ ) {
+ $verbose = $new_verbose_level;
+ }
+
+ return $verbose;
+
+} ## end sub verbose
+
+##------------------------------------------------------------------------------------------
+
+=head2 mark( [$new_mark] )
+
+Gibt den aktuellen Log-Marker zurueck bzw. setzt einen neuen, wenn er übergeben wurde.
+
+=cut
+
+sub mark {
+
+ my $new_mark = shift;
+
+ if ( $new_mark and $new_mark !~ /^\s*$/ ) {
+ $new_mark =~ s/^\s+//;
+ $new_mark =~ s/\s+$//s;
+ $mark = $new_mark;
+ }
+
+ return $mark;
+
+}
+
+#------------------------------------------------------------------------------------------
+
+=head2 home_dir()
+
+Gibt den Namen des Verzeichnisses der Software-Installation zurueck,
+die aus der Umgebungsvariablen C<COOKBOOK_HOME> entnommen wird.
+
+Wenn die Umgebungsvariable nicht gesetzt ist bzw. auf ein nicht vorhandenes Verzeichnis
+zeigt, wird undef zurueckgegeben.
+
+=cut
+
+sub home_dir {
+
+ my $K = __PACKAGE__ . "::home_dir(): ";
+
+ unless ( $ENV{$env_home_name} ) {
+ common_notice( $K . "Umgebungsvariable '" . $env_home_name . "' nicht gesetzt." );
+ return undef;
+ }
+
+ unless ( File::Spec->file_name_is_absolute( $ENV{$env_home_name} ) ) {
+ common_notice( $K . "Umgebungsvariable '" . $env_home_name . "' (" . $ENV{$env_home_name} . ") ist keine absolute Pfadangabe." );
+ return undef;
+ }
+
+ unless ( -d $ENV{$env_home_name} ) {
+ common_notice( $K . "Umgebungsvariable '" . $env_home_name . "' zeigt auf nicht vorhandenes Verzeichnis '" . $ENV{$env_home_name} . "'." );
+ return undef;
+ }
+
+ return File::Spec->canonpath( $ENV{$env_home_name} );
+
+} ## end sub home_dir
+
+#------------------------------------------------------------------------------------------
+
+=head2 canon_filename( @directories, $filename )
+
+Kettet die uebergebenen Verzeichnisnamen und Dateinamen aneinander.
+Wenn der resultierende Pfad nicht absolut ist, wird home_dir() davorgehaengt.
+
+=cut
+
+sub canon_filename {
+
+ my @path = @_;
+ my $K = __PACKAGE__ . "::canon_filename(): ";
+
+ unless ( scalar(@path) ) {
+ common_notice( $K . "Keine Argumente uebergeben." );
+ return undef;
+ }
+
+ my $file = File::Spec->catfile(@path);
+ unless ( File::Spec->file_name_is_absolute($file) ) {
+ my $home = home_dir();
+ return undef unless $home;
+ $file = File::Spec->catfile( $home, @path );
+ }
+
+ return $file;
+
+} ## end sub canon_filename
+
+#---------------------------------------------------------------------------
+
+=head2 common_debug( $debug_level, @messages )
+
+Allgemeine Debug-Funktion (wenn das Log-Objekt noch nicht existieren sollte)
+
+=cut
+
+sub common_debug {
+
+ my $debug_level = shift;
+
+ $debug_level = to_int($debug_level);
+ $debug_level = 1 unless defined $debug_level;
+
+ return if $debug_level > $verbose;
+
+ my $text = get_output_string(@_);
+ return if $text eq '';
+
+ print $mark . " (debug" . $debug_level . "): " . $text . "\n";
+
+ return;
+
+} ## end sub common_debug
+
+#---------------------------------------------------------------------------
+
+sub get_output_string {
+
+ my $text = '';
+ for (@_) {
+ next unless defined $_;
+ my $t = ref($_) ? Dumper($_) : $_;
+ next if $t eq '';
+ $text .= $t;
+ }
+
+ $text =~ s/^\s+//;
+ $text =~ s/\s+$//s;
+ return $text;
+
+}
+
+#---------------------------------------------------------------------------
+
+=head2 common_error( $error_level, @messages )
+
+Allgemeine Error-Warn-Funktion (wenn das Log-Objekt noch nicht existieren sollte)
+
+=cut
+
+sub common_error {
+
+ my $error_level = shift;
+
+ $error_level ||= 'error';
+
+ my $text = get_output_string(@_);
+
+ $text = "unbekannter Fehler" if $text eq '';
+
+ warn $mark . "(" . $error_level . "): " . $text . "\n";
+
+ return;
+
+} ## end sub common_error
+
+#---------------------------------------------------------------------------
+
+=head2 common_notice( @messages )
+
+Allgemeine Warnmeldung.
+
+=cut
+
+sub common_notice {
+
+ my $text = get_output_string(@_);
+ $text = "unbekannter Fehler" if $text eq '';
+
+ warn $mark . ": " . $text . "\n";
+
+ return;
+
+} ## end sub common_notice
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_bool( $wert )
+
+Wandelt den uebergebenen Scalar sicher in einen Wahrheitswert (0 oder 1) um.
+
+=cut
+
+sub to_bool {
+
+ my $val = shift;
+
+ return 0 unless defined $val;
+ return 0 if $val =~ /^\s*$/;
+
+ if ( $val =~ /^\s*y(?:es?)?/i
+ or $val =~ /^\s*ja?/i
+ or $val =~ /^\s*[wt]\s*$/i
+ or $val =~ /^\s*on\s*$/i
+ or $val =~ /^\s*wahr|true/i )
+ {
+ return 1;
+ }
+
+ if ( $val =~ /^\s*no?/i
+ or $val =~ /^\s*ne(?:in?)?/i
+ or $val =~ /^\s*f\s*$/i
+ or $val =~ /^\s*off\s*$/i
+ or $val =~ /^\s*falsch|false/i )
+ {
+ return 0;
+ }
+
+ my $intval = to_int($val);
+ if ( defined $intval ) {
+ return $intval ? 1 : 0;
+ }
+
+ return $val ? 1 : 0;
+
+} ## end sub to_bool
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_float( $wert )
+
+Wandelt den uebergebenen Scalar sicher in eine Float-Zahl um.
+
+Falls der uebergebene Wert keine gueltige Zahl ist, wird undef zurueckgegeben.
+
+=cut
+
+sub to_float {
+
+ my $val = shift;
+
+ return undef unless defined($val) and $val =~ /\d/;
+
+ my $ts = ",";
+ my $ds = ".";
+
+ if ( ( $val =~ /\d,/ and $val !~ /\d\./ )
+ or ( $val =~ /\d\.\d\d\d\./ )
+ or ( $val =~ /\d\.\d\d\d,/ ) )
+ {
+ $ds = ",";
+ $ts = ".";
+ }
+
+ $val =~ s/\Q$ts\E//g;
+ $val =~ s/\Q$ds\E/\./g;
+
+ return ( $val + 0 );
+
+} ## end sub to_float
+
+#------------------------------------------------------------------------------------------
+
+=head2 to_int( $wert, $signed )
+
+Wandelt den uebergebenen Wert sicher in eine Integer-Zahl um.
+
+Dabei legt der optionale logische Parameter $signed fest, ob auch
+vorzeichenbehaftete Werte zulaessig sind.
+
+Wenn keine gueltige Zahl uebergeben wird, wird undef zurueckgegeben.
+
+=cut
+
+sub to_int {
+
+ my $val = shift;
+ my $signed = shift;
+
+ return undef unless defined $val;
+ unless ( $val =~ /\d/ ) {
+ return undef;
+ }
+
+ if ($signed) {
+ $val =~ /^[^\d-]*(?:(-)\s*)?(\d+)/;
+ $val = ( defined $1 ? $1 : '' ) . $2;
+ }
+ else {
+ $val =~ /^\D*(\d+)/;
+ $val = $1;
+ }
+
+ return $val + 0;
+
+} ## end sub to_int
+
+#------------------------------------------------------------------------------------------
+
+=head2 escape_html( $text )
+
+Maskiert alle '&', '<', '>' und '"' im uebergebenen Text durch entsprechende
+HTML-Entities.
+
+Entnommen dem Modul L<CGI::Util>.
+
+=cut
+
+sub escape_html {
+
+ return unless defined( my $toencode = shift );
+
+ $toencode =~ s{&}{&}gso;
+ $toencode =~ s{<}{<}gso;
+ $toencode =~ s{>}{>}gso;
+ $toencode =~ s{\"}{"}gso;
+
+# Doesn't work. Can't work. forget it.
+# $toencode =~ s{\x8b}{‹}gso;
+# $toencode =~ s{\x9b}{›}gso;
+
+ $toencode;
+
+}
+
+#------------------------------------------------------------------------------------------
+
+1;
+
+#------------------------------------------------------------------------------------------
+
+__END__
--- /dev/null
+package CookBook::Controller::Root;
+
+use strict;
+use warnings;
+use base 'Catalyst::Controller';
+
+#
+# Sets the actions in this controller to be registered with no prefix
+# so they function identically to actions created in MyApp.pm
+#
+__PACKAGE__->config->{namespace} = '';
+
+=head1 NAME
+
+CookBook::Controller::Root - Root Controller for CookBook
+
+=head1 DESCRIPTION
+
+[enter your description here]
+
+=head1 METHODS
+
+=cut
+
+=head2 default
+
+=cut
+
+sub default : Private {
+ my ( $self, $c ) = @_;
+
+ # Hello World
+ $c->response->body( $c->welcome_message );
+}
+
+=head2 end
+
+Attempt to render a view, if needed.
+
+=cut
+
+sub end : ActionClass('RenderView') {}
+
+=head1 AUTHOR
+
+Frank Brehm
+
+=head1 LICENSE
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
+
+1;
--- /dev/null
+#!/usr/bin/perl -w
+
+BEGIN { $ENV{CATALYST_ENGINE} ||= 'CGI' }
+
+use strict;
+use warnings;
+use FindBin;
+use lib "$FindBin::Bin/../lib";
+use CookBook;
+
+CookBook->run;
+
+1;
+
+=head1 NAME
+
+cookbook_cgi.pl - Catalyst CGI
+
+=head1 SYNOPSIS
+
+See L<Catalyst::Manual>
+
+=head1 DESCRIPTION
+
+Run a Catalyst application as a cgi script.
+
+=head1 AUTHOR
+
+Sebastian Riedel, C<sri@oook.de>
+
+=head1 COPYRIGHT
+
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
--- /dev/null
+#!/usr/bin/perl -w
+
+use strict;
+use warnings;
+use Getopt::Long;
+use Pod::Usage;
+use Catalyst::Helper;
+
+my $force = 0;
+my $mech = 0;
+my $help = 0;
+
+GetOptions(
+ 'nonew|force' => \$force,
+ 'mech|mechanize' => \$mech,
+ 'help|?' => \$help
+ );
+
+pod2usage(1) if ( $help || !$ARGV[0] );
+
+my $helper = Catalyst::Helper->new( { '.newfiles' => !$force, mech => $mech } );
+
+pod2usage(1) unless $helper->mk_component( 'CookBook', @ARGV );
+
+1;
+
+=head1 NAME
+
+cookbook_create.pl - Create a new Catalyst Component
+
+=head1 SYNOPSIS
+
+cookbook_create.pl [options] model|view|controller name [helper] [options]
+
+ Options:
+ -force don't create a .new file where a file to be created exists
+ -mechanize use Test::WWW::Mechanize::Catalyst for tests if available
+ -help display this help and exits
+
+ Examples:
+ cookbook_create.pl controller My::Controller
+ cookbook_create.pl -mechanize controller My::Controller
+ cookbook_create.pl view My::View
+ cookbook_create.pl view MyView TT
+ cookbook_create.pl view TT TT
+ cookbook_create.pl model My::Model
+ cookbook_create.pl model SomeDB DBIC::Schema MyApp::Schema create=dynamic\
+ dbi:SQLite:/tmp/my.db
+ cookbook_create.pl model AnotherDB DBIC::Schema MyApp::Schema create=static\
+ dbi:Pg:dbname=foo root 4321
+
+ See also:
+ perldoc Catalyst::Manual
+ perldoc Catalyst::Manual::Intro
+
+=head1 DESCRIPTION
+
+Create a new Catalyst Component.
+
+Existing component files are not overwritten. If any of the component files
+to be created already exist the file will be written with a '.new' suffix.
+This behavior can be suppressed with the C<-force> option.
+
+=head1 AUTHOR
+
+Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
+
+=head1 COPYRIGHT
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
--- /dev/null
+#!/usr/bin/perl -w
+
+BEGIN { $ENV{CATALYST_ENGINE} ||= 'FastCGI' }
+
+use strict;
+use warnings;
+use Getopt::Long;
+use Pod::Usage;
+use FindBin;
+use lib "$FindBin::Bin/../lib";
+use CookBook;
+
+my $help = 0;
+my ( $listen, $nproc, $pidfile, $manager, $detach, $keep_stderr );
+
+GetOptions(
+ 'help|?' => \$help,
+ 'listen|l=s' => \$listen,
+ 'nproc|n=i' => \$nproc,
+ 'pidfile|p=s' => \$pidfile,
+ 'manager|M=s' => \$manager,
+ 'daemon|d' => \$detach,
+ 'keeperr|e' => \$keep_stderr,
+);
+
+pod2usage(1) if $help;
+
+CookBook->run(
+ $listen,
+ { nproc => $nproc,
+ pidfile => $pidfile,
+ manager => $manager,
+ detach => $detach,
+ keep_stderr => $keep_stderr,
+ }
+);
+
+1;
+
+=head1 NAME
+
+cookbook_fastcgi.pl - Catalyst FastCGI
+
+=head1 SYNOPSIS
+
+cookbook_fastcgi.pl [options]
+
+ Options:
+ -? -help display this help and exits
+ -l -listen Socket path to listen on
+ (defaults to standard input)
+ can be HOST:PORT, :PORT or a
+ filesystem path
+ -n -nproc specify number of processes to keep
+ to serve requests (defaults to 1,
+ requires -listen)
+ -p -pidfile specify filename for pid file
+ (requires -listen)
+ -d -daemon daemonize (requires -listen)
+ -M -manager specify alternate process manager
+ (FCGI::ProcManager sub-class)
+ or empty string to disable
+ -e -keeperr send error messages to STDOUT, not
+ to the webserver
+
+=head1 DESCRIPTION
+
+Run a Catalyst application as fastcgi.
+
+=head1 AUTHOR
+
+Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
+
+=head1 COPYRIGHT
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
--- /dev/null
+#!/usr/bin/perl -w
+
+BEGIN {
+ $ENV{CATALYST_ENGINE} ||= 'HTTP';
+ $ENV{CATALYST_SCRIPT_GEN} = 30;
+ require Catalyst::Engine::HTTP;
+}
+
+use strict;
+use warnings;
+use Getopt::Long;
+use Pod::Usage;
+use FindBin;
+use lib "$FindBin::Bin/../lib";
+
+my $debug = 0;
+my $fork = 0;
+my $help = 0;
+my $host = undef;
+my $port = 3000;
+my $keepalive = 0;
+my $restart = 0;
+my $restart_delay = 1;
+my $restart_regex = '\.yml$|\.yaml$|\.pm$';
+my $restart_directory = undef;
+
+my @argv = @ARGV;
+
+GetOptions(
+ 'debug|d' => \$debug,
+ 'fork' => \$fork,
+ 'help|?' => \$help,
+ 'host=s' => \$host,
+ 'port=s' => \$port,
+ 'keepalive|k' => \$keepalive,
+ 'restart|r' => \$restart,
+ 'restartdelay|rd=s' => \$restart_delay,
+ 'restartregex|rr=s' => \$restart_regex,
+ 'restartdirectory=s' => \$restart_directory,
+);
+
+pod2usage(1) if $help;
+
+if ( $restart ) {
+ $ENV{CATALYST_ENGINE} = 'HTTP::Restarter';
+}
+if ( $debug ) {
+ $ENV{CATALYST_DEBUG} = 1;
+}
+
+# This is require instead of use so that the above environment
+# variables can be set at runtime.
+require CookBook;
+
+CookBook->run( $port, $host, {
+ argv => \@argv,
+ 'fork' => $fork,
+ keepalive => $keepalive,
+ restart => $restart,
+ restart_delay => $restart_delay,
+ restart_regex => qr/$restart_regex/,
+ restart_directory => $restart_directory,
+} );
+
+1;
+
+=head1 NAME
+
+cookbook_server.pl - Catalyst Testserver
+
+=head1 SYNOPSIS
+
+cookbook_server.pl [options]
+
+ Options:
+ -d -debug force debug mode
+ -f -fork handle each request in a new process
+ (defaults to false)
+ -? -help display this help and exits
+ -host host (defaults to all)
+ -p -port port (defaults to 3000)
+ -k -keepalive enable keep-alive connections
+ -r -restart restart when files get modified
+ (defaults to false)
+ -rd -restartdelay delay between file checks
+ -rr -restartregex regex match files that trigger
+ a restart when modified
+ (defaults to '\.yml$|\.yaml$|\.pm$')
+ -restartdirectory the directory to search for
+ modified files
+ (defaults to '../')
+
+ See also:
+ perldoc Catalyst::Manual
+ perldoc Catalyst::Manual::Intro
+
+=head1 DESCRIPTION
+
+Run a Catalyst Testserver for this application.
+
+=head1 AUTHOR
+
+Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
+
+=head1 COPYRIGHT
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
--- /dev/null
+#!/usr/bin/perl -w
+
+use strict;
+use warnings;
+use Getopt::Long;
+use Pod::Usage;
+use FindBin;
+use lib "$FindBin::Bin/../lib";
+use Catalyst::Test 'CookBook';
+
+my $help = 0;
+
+GetOptions( 'help|?' => \$help );
+
+pod2usage(1) if ( $help || !$ARGV[0] );
+
+print request($ARGV[0])->content . "\n";
+
+1;
+
+=head1 NAME
+
+cookbook_test.pl - Catalyst Test
+
+=head1 SYNOPSIS
+
+cookbook_test.pl [options] uri
+
+ Options:
+ -help display this help and exits
+
+ Examples:
+ cookbook_test.pl http://localhost/some_action
+ cookbook_test.pl /some_action
+
+ See also:
+ perldoc Catalyst::Manual
+ perldoc Catalyst::Manual::Intro
+
+=head1 DESCRIPTION
+
+Run a Catalyst action from the command line.
+
+=head1 AUTHOR
+
+Sebastian Riedel, C<sri@oook.de>
+Maintained by the Catalyst Core Team.
+
+=head1 COPYRIGHT
+
+This library is free software, you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+=cut
--- /dev/null
+use strict;
+use warnings;
+use Test::More tests => 2;
+
+BEGIN { use_ok 'Catalyst::Test', 'CookBook' }
+
+ok( request('/')->is_success, 'Request should succeed' );
--- /dev/null
+use strict;
+use warnings;
+use Test::More;
+
+eval "use Test::Pod 1.14";
+plan skip_all => 'Test::Pod 1.14 required' if $@;
+plan skip_all => 'set TEST_POD to enable this test' unless $ENV{TEST_POD};
+
+all_pod_files_ok();
--- /dev/null
+use strict;
+use warnings;
+use Test::More;
+
+eval "use Test::Pod::Coverage 1.04";
+plan skip_all => 'Test::Pod::Coverage 1.04 required' if $@;
+plan skip_all => 'set TEST_POD to enable this test' unless $ENV{TEST_POD};
+
+all_pod_coverage_ok();