# README ## What's Floop? Floop used to be an experiment with [p5-mop-redux](https://github.com/stevan/p5-mop-redux), the new MOP for Perl 5 inspired by the syntax proposed for Perl 6. After that project floundered, Floop was ported to Moo, losing a couple features in the process but gaining in production viability. Floop is a small PSGI-aware Web route framework that currently includes: + Dancer-style simple route matching with named path parts, e.g. `/foo/:bar` + Catalyst-style route chaining (basic) + a pluggable logging subsystem + generally high modularity, allowing you to mix and match existing Floop components in your app (not that anybody has written any) ## How do I use Floop? Unlike Dancer/Dancer 2, which use singletons/package variables heavily, and Catalyst, which defines app components as classes, Floop apps (and components, which behave much the same in almost all ways) are object instances. To define a Floop app, instantiate the Floop class and start calling methods on it. The method you're probably looking for is `add_route`. `add_route` takes a route object as a parameter and installs it in the application's dispatcher, which will then take care of calling the route handler whenever the route's pattern is matched. Like this: ```perl my $app = Floop->new(...); my $route = Floop::Route->new( pattern => '/foo/:bar', handler => sub { 'I am called whenever a request is made to /foo/*' }); $app->add_route($route); ``` Future versions of Floop will include more comfortable/reusable ways to define components.