Snaplet-Tasks / README

h2. Snaplet-Tasks

Snap Framework ( ) support for command line
tasks akin to _Rake_ tasks from _Ruby On Rails_

Depends on Snap 0.7.* and <others>

h3. Installation

cabal install snaplet-tasks

h3. Integration


import           Snap.Snaplet.Tasks

-- ( ... some code ... )

data App = App
    { _heist :: Snaplet (Heist App)
    -- ( ... other state ... )
    , _tasks :: Snaplet TasksSnaplet

app = do
  h  <- nestSnaplet "heist" heist $ do
            heistInit "resources/templates"
  -- ( ... some init ... )
  t <- nestSnaplet  "tasks" tasks $
  return $ App h .. .. .. t

Because we need full app state at disposal in our tasks
the easiest way was to create them from normal handlers.

Thus, in order to run task - app has to be started.
It is comparable with Ruby On Rails Rake tasks where
whole app environment _can_ be loaded for task as well.
The only difference is that here in Snap - app also listens
on TCP for connections - and that *we utilize*.

There are two constriants to running tasks:
1. You can't run them remotely ( meaning that you can't fire
   app task handler remotely )
2. Task route is being _hashified_ and the only way to specify
   task is by using command line app arg switch _T_ 
   ( ex. T mysupertask or T namespace:second:supertask )
   The supplied name of task is being hashified again and thus
   matched with route that responds to exaclty that hash.

This implies that you have to have some tool/function to create
tasks so that they respond to hashified names. And indeed you have:

task :: String -> (Handler b v ()) -> (B.ByteString, Handler b v ())

This function takes name of the task ( ex. "db:migrate" ) and a handler
and returns a tuple that you can use defining your app routes.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.