Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The easiest way to write web applications with Perl (Perl web micro-framework)
Perl Other
Tag: v0.9905

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
example
lib
script
t
.gitignore
AUTHORS
CHANGES
Makefile.PL
README
ROADMAP
TODO

README

                                    Dancer

                  The easiest way to write a webapp with Perl                                    

=== ABOUT ===

That project intends to become a port of Ruby's Sinatra framework: a framework
for building web application with minimal-effort in mind.

The user should be able to define a webapp with very few lines of codes.


=== EXAMPLE ===

To create a new Dancer application, use the helper script "dancer" provided
with this distribution:

    $ dancer -a mywebapp
    + [D] mywebapp 
    + [F] mywebapp/config.yml
    + [D] mywebapp/views
    + [D] mywebapp/views/layouts
    [...]

You have then a new Dancer application in 'mywebapp'.

Here is an example of a webapp built with Dancer:

    # webapp.pl
    #!/usr/bin/perl

    use Dancer;

    get '/' => sub {
        "Hello There!"
    };

    get '/hello/:name' => sub {
        "Hey ".params->{name}.", how are you?";
    };

    post '/new' => sub {
        "creating new entry: ".params->{name};
    };

    Dancer->dance;

When running this script, a webserver is running and ready to serve:    

    $ perl ./webapp.pl
    >> Listening on 127.0.0.1:1915
    == Entering the dance floor ...

Then it's possible to access any route defined in the script:

    $ curl http://localhost:1915/
    Hello There!


Feel free to fork that project if you like the idea and want to add some
features.


=== DEPENDENCIES ===

Dancer depends on the following modules

    - HTTP::Server::Simple
    - File::MimeInfo
    - Template

=== PRODUCTION MATTERS ===

This is a work in progress.

Dancer supports PSGI/Plack, to run a Dancer app with PSGI/Plack
just create a file 'app.psgi' in your appdir (like the one in example)


=== WEBSITE ===

For more details about the project, checkout the official website:
http://dancer.sukria.net
Something went wrong with that request. Please try again.