Run more examples

Reahl comes with a number of examples. These are not self-explanatory – they are referred to all over in the rest of the tutorial to illustrate what is explained there.

Here is a cheat sheet when you come across an example in and you wonder how to run it.

Listing and checking out examples

To list all the examples that come with Reahl:

reahl listexamples

The list of example names this outputs are referred to all over in our documentation.

To get an example, run (e.g.):

reahl example tutorial.hello

This will create a directory “hello” in your current location containing the example.

Running examples

After first checking out an example, do the following before trying to run it:

  • Go to the checked out example:

    cd hello
  • Prepare the example for development:

    reahl setup -- develop -N
  • Create a database:

    reahl createdbuser etc
    reahl createdb etc
    reahl createdbtables etc

Once that is done, run the example:

reahl serve etc

Helpful hints

Each examples creates a sqlite database file in the root the example’s directory with a name derived from its reahlsystem.root_egg configuration setting. The latter defaults to the name of the directory in which the example resides.

To see the current configuration of an example (and which file to set it in) run:

reahl listconfig -f -v

You can drop the database for an example with:

reahl dropdb etc

To remove a previous example from development, run:

reahl setup -- develop -N --uninstall