kentaro / p6-crust

PSGI library stack for Perl6

NAME

Crust - Perl6 Superglue for Web frameworks and Web Servers

DESCRIPTION

Crust is a set of tools for using the PSGI stack. It contains middleware components(TBI), and utilities for Web application frameworks. Crust is like Perl5's Plack, Ruby's Rack, Python's Paste for WSGI.

See PSGI for the PSGI specification.

MODULES AND UTILITIES

Crust::Handler

Crust::Handler and its subclasses contains adapters for web servers. We have adapters for the built-in standalone web server HTTP::Easy::PSGI, and HTTP::Server::Tiny included in the core Crust distribution.

See Crust::Handler when writing your own adapters.

Crust::Middleware

P6SGI middleware is a P6SGI application that wraps an existing P6SGI application and plays both side of application and servers. From the servers the wrapped code reference still looks like and behaves exactly the same as P6SGI applications.

Crust::Request, Crust::Response

Crust::Request gives you a nice wrapper API around PSGI $env hash to get headers, cookies and query parameters much like Apache::Request in mod_perl.

Crust::Response does the same to construct the response array reference.

.psgi6 files

A PSGI application is a code reference but it's not easy to pass code reference via the command line or configuration files, so Crust uses a convention that you need a file named "app.psgi6" or similar, which would be loaded (via perl6's core function "EVALFILE") to return the PSGI application code reference.

# Hello.psgi6
my $app = sub ($env) {
    # ...
    return $status, $headers, $body;
};

If you use a web framework, chances are that they provide a helper utility to automatically generate these ".psgi" files for you, such as:

# MyApp.psgi6
use MyApp;
my $app = sub { MyApp->run_psgi(@_) };

It's important that the return value of ".psgi" file is the code reference. See "eg/" directory for more examples of ".psgi" files.

AUTHORS

• Tokuhiro Matsuno

• mattn

• Shoichi Kaji

• Daisuke Maki

COPYRIGHT AND LICENSE

Copyright 2015 Tokuhiro Matsuno [email protected]

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.