Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Utopian

Quicklisp dist

The caveman in offering the first garland to his maiden thereby transcended the brute. He became a utopian in thus rising above the crude necessities of nature. He entered the realm of art when he perceived the subtle use of the useless. -- Okakura Tenshin, "The Book of Tea"

3 steps to write a better web application:

  1. Choose the right language.
  2. Choose the right web framework.
  3. Write less.

Utopian is a web application framework that encourages rapid web development.

Requirements

  • Roswell
  • Qlot
  • An RDBMS you like one of SQLite3, MySQL or PostgreSQL.

Getting started

Installation

$ ros install fukamachi/utopian
$ ros install fukamachi/lsx
$ ros install fukamachi/qlot

Ensure ~/.roswell/bin is in your shell $PATH.

Creating a new project

To generate the project skeleton, open a terminal and execute this command:

$ utopian new blog

Installing dependencies

$ cd blog/
$ qlot install

Database Settings

This section is needed only when using MySQL or PostgreSQL.

Creating a database user

PostgreSQL
$ createuser -d blog
MySQL
$ mysql -u root
mysql> CREATE USER blog@localhost IDENTIFIED BY '';
mysql> GRANT ALL ON *.* TO blog@localhost;

Creating a database

$ .qlot/bin/utopian db create

Starting a development server

$ .qlot/bin/utopian server
Hunchentoot server is going to start.
Listening on localhost:5000.

DB Migration

Add Mito table classes under models/ directory and run the following commands:

$ .qlot/bin/utopian generate migration
$ .qlot/bin/utopian db migrate

Examples

See examples/ directory.

See Also

  • Clack / Lack
  • MyWay: Sinatra-compatible router.
  • Mito: An O/R Mapper with schema versioning.
  • LSX: Embeddable HTML Templating engine.

Author

Eitaro Fukamachi (e.arrows@gmail.com)

Copyright

Copyright (c) 2016-2018 Eitaro Fukamachi

License

Licensed under the LLGPL License.

You can’t perform that action at this time.