demo.todomvc

Demo project to implement TodoMVC using Bract/Gossamer.

Usage

Setup the database

You must setup the database as a one-time task before running the application:

$ lein do clean, run -m liquibase update

The project.clj file has a shorter alias defined for this task, so you may run the following command instead:

$ lein liquibase update

Starting the server

Once you start the server you should visit http://localhost:3000 in your web browser.

You can build the app locally and start the server as follows:

$ lein do clean, uberjar         # implicitly calls `lein cljsbuild once`
$ java -jar target/uberjar/demo.todomvc-0.6.2-0.3.0-standalone.jar -vf config/config.edn

Alternatively, you may want to run it as follows in development (but logging configuration may be out of control):

$ lein do clean, cljsbuild auto  # in a separate terminal
$ lein ring server-headless      # ensure not to include clean task

Should you need a browser REPL during development, run the following commands instead (with logging config caveat):

$ lein do clean, figwheel        # in a separate terminal, preferably with rlwrap
$ lein ring server-headless      # ensure not to include clean task

Triggering batch job

The TODO items are only soft-deleted in the database by the application. The CLI command purge hard-deletes such deleted entries, which can be triggered as follows:

$ java -jar target/uberjar/demo.todomvc-0.6.2-0.3.0-standalone.jar -c purge -vf config/config.edn

REPL based development

Be sure to start the ClojureScript code compilation using lein do clean, cljsbuild auto or lein do clean, figwheel ahead of starting the REPL with lein repl.

Run lein do clean, repl to launch the REPL (run (start) to start the server):

bract.dev.repl=> (help)  ; shows the help screen

Inspect and toggle logs

Running the application should by default emit logs in the logs folder. To enable/disable certain kinds of logs you may override the default configuration by specifying as such in the config file:

"logback.appender.console.enabled"  "true"
"logback.appender.jsonfile.enabled" "true"
"logback.appender.textfile.enabled" "false"

Note: Jetty server logs (lein-ring) are configured in test/clj/jetty-logging.properties to appear in console only.

License

Copyright © 2017-2021 Shantanu Kumar

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.