NAME
    Dancer::Plugin::Res - Syntax sugar for setting the status and returning
    a response

VERSION
    version 0.0003

SYNOPSIS
        use Dancer;
        use Dancer::Plugin::Res;
        post '/widgets' => sub {
            return res 400 => to_json { err => 'name is required' }
                unless param 'name';
            # ...
            return res 201 => to_json { widget => $widget };
        };
        dance;

DESCRIPTION
    This Dancer plugin provides the keyword "res()", which stands for
    response. It allows you to set the response and return a body in one
    shot.

        return res 400, { msg => reason };

    is equivalent to:

        status 400;
        return { msg => reason };

    I made this plugin because I wanted a function like send_error() that
    behaved more consistently. "send_error("reason ...", 500)" will not
    always render the first argument you give it in the response. When your
    app is running in production mode with "show_errors" set to false, it
    will attempt to render a generic 500.html page. This is great for
    front-end only applications, but not for creating an api where you
    always want your application to render the thing that you told it to
    render.

FUNCTIONS
  res
        res($status, [$reason])

    Sets the status to $status and returns $reason. If $reason is not
    provided, returns an empty string.

AUTHOR
    Naveed Massjouni <naveedm9@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Naveed Massjouni.

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