PlayConsole

Using the Play 2.0 console

Launching the console

The Play 2.0 console is a development console based on sbt that allow to manage the complete development cycle of a Play application.

To launche the console, enter any existing application directory and launch the play script:

$ cd /path/to/any/application
$ play 

console.png

Getting help

Use the help command to get basic help about the available commands:

[My first application] $ help

Running the server in development mode

To run the current application in development mode, use the run command:

[My first application] $ run

consoleRun.png

In this mode, the server will be launched with the auto-reload feature enabled, meaning that for each request Play will check your project and recompile required sources. If needed the application will restart automatically.

If there is any compilation error you will see the result of the compilation directly in your browser:

errorPage.png

To stop the server, you can press the Crtl+D key, and you will come back to the Play console prompt.

Compiling

In Play 2.0 you can also compile your application without running the server. Just use the compile command:

[My first application] $ compile

consoleCompile.png

Launch the interactive console

Typing console you can enter the interactive Scala console, allowing to test your code interactively:

[My first application] $ console

consoleEval.png

Using the sbt features

The Play console is just a normal sbt console, so you can use any sbt features like triggered execution.

For example, using ~ compile

[My first application] $ ~ compile

The compilation will be triggered each time you change a source file.

You can also do the same for ~ test, testing continously your project each time you modify a source file:

[My first application] $ ~ test