view release on metacpan or  search on metacpan

README  view on Meta::CPAN

  Via perl Makefile.PL:

    perl Makefile.PL
    make
    make test
    make install

  Via pmake.bat (Windows, no make required):

    pmake.bat test
    pmake.bat install

  PSGI::Handy has no required dependencies beyond the Perl core. To
  serve an app you supply a PSGI server such as HTTP::Handy; HP::Handy
  and DB::Handy are optional and only needed when you use template
  rendering or DB::Handy as the injected database handle.

COMPATIBILITY

  This module works with Perl 5.005_03 and later.

  WHY PERL 5.005_03 SPECIFICATION?

  This module adheres to the Perl 5.005_03 specification--not because we
  use the old interpreter, but because this specification represents the
  simple, original Perl programming model that makes programming enjoyable.

  THE STRENGTH OF MODERN TIMES

  Some people think the strength of modern times is the ability to use
  modern technology. That thinking is insufficient. The strength of modern
  times is the ability to use ALL technology up to the present day.

  By adhering to the Perl 5.005_03 specification, we gain access to the
  entire history of Perl--from 5.005_03 to 5.42 and beyond--rather than
  limiting ourselves to only the latest versions.

  Key reasons:

  - Simplicity: Original Perl approach keeps programming "raku" (easy/fun)
  - JPerl: Final version of JPerl (Japanese Perl)
  - Universal: Runs on ALL Perl versions (5.005_03 through 5.42+)
  - Philosophy: Programming should be enjoyable (Camel Book readers know!)

  Perl 5.6+ introduced character encoding complexity that made programming
  harder. By following the 5.005_03 specification, we maintain the joy of
  Perl programming.

TARGET USE CASES

  - Isolated networks where CPAN cannot be installed
  - Legacy in-house servers running old Perl
  - Local development and rapid prototyping
  - Small data-entry and reporting web tools
  - Educational use

LIMITATIONS

  - The app always returns the buffered PSGI form [ $status, \@headers,
    \@body ]; the PSGI delayed-response (streaming responder callback)
    form is not produced ("PSGI-subset")
  - Concurrency and the HTTP version depend on the PSGI server you choose
  - Some servers deliver only GET and POST; PUT/PATCH/DELETE routes are
    reachable through to_app under a PSGI server that sends them
  - No multipart uploads and no WebSocket in this version
  - HEAD requests are served by the matching GET route with the body removed
  - No built-in session management (cookies are provided; sessions are not)
  - No HTTPS (use a reverse proxy for TLS)

AUTHOR

  INABA Hitoshi <ina.cpan@gmail.com>

COPYRIGHT AND LICENSE

  This software is free software; you can redistribute it and/or modify
  it under the same terms as Perl itself.

  See http://www.perl.com/perl/misc/Artistic.html