This is a very simple Lotus example application to demonstrate the basics of the Lotus web framework. It contains the following concepts:
- Repositories, entities and mapping
- Parameter whitelisting and validation
- Reading and writing data to a repository
- Testing with Minitest
- Database migrations
For a guide walking you through this application, see http://arjanvandergaag.nl/blog/up-and-running-with-lotus.html.
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 email@example.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
% 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
demo_test, but this can be changed in
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.