Example blog application with Lotus
Ruby HTML CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
apps/web
bin
config
db
lib
spec
.gitignore
.lotusrc
.travis.yml
Gemfile
Gemfile.lock
LICENSE.txt
Procfile
README.md
Rakefile
config.ru

README.md

Example Lotus blog application Build Status

Introduction

This is a very simple Lotus example application to demonstrate the basics of the Lotus web framework. It contains the following concepts:

  1. Routing
  2. Repositories, entities and mapping
  3. Flash
  4. Parameter whitelisting and validation
  5. Reading and writing data to a repository
  6. Testing with Minitest
  7. Database migrations

For a guide walking you through this application, see http://arjanvandergaag.nl/blog/up-and-running-with-lotus.html.

Setup

Running this application locally is simple. First, make sure you have a working installtion of Ruby (version 2 or later) and Rubygems on your system. Then, clone the repository:

% git clone git@github.com:avdgaag/lotus-blog-demo.git

Use Bundler to install required aubygems dependencies:

% bundle install

Make sure you have a database to work with. The application comes configured to look for a PostgreSQL database called demo_development. You can change this configuration in config/.env.development. To create the database, assuming you have postgres running:

% createdb demo_development

Run the database migrations to set up the database schema:

% bin/sequel -m db/migrations postgres://localhost/demo_development

You might also want to create some records using whatever database tools you like.

To see the results, launch a web server:

% bin/lotus server

And see the results at http://localhost:2300.

Running the tests

Assuming you have the development server set up, all you need now is a test database. The project comes preconfigured to look for a PostgreSQL database called demo_test, but this can be changed in config/.env.test.

Set up the test database:

% createdb demo_test
% bin/sequel -m db/mgirations postgres://localhost/demo_test

You can now run the test suite with Rake:

% rake spec

You should see the test results now.