A framework for writing modular web applications in node.js
Apps contain a set of (regex) URL mappings that map HTTP requests to functions called handlers. URL mappings and handlers can be stored in separate files, which are imported when the app is executed. Apps can be organised into a set of modules, each with their own URL and handler definitions. You can build quite complex apps by hooking a module's URL mappings into one of another module's URL mappings.
To install through npm, run the following command in your terminal of choice:
npm install jimi
Have a run through the Tutorial to get a flavour of how jimi works. It'll take you 5 minutes to get your first site up and running. If it takes more than 5, I'll give you your money back.
Examples are be stored in the apps directory, and will give you a starting point for building your applications. Navigate to an example app directory and run:
Then visit http://127.0.0.1:8009/ in your web browser.
Example App Structure
<app_directory> | |- app.js |- handlers.js |- urls.js | |- <module_directory> | | | |- handlers.js | |- urls.js | |- <public_directory> | | | |- <public_file>.css | |- <templates_directory> | |- <base_template>.html | |- <module_directory> | |- <template>.html |- <template>.html
Templates don't have to be laid out this way, but the templating example uses this layout. Public content such as static files should also be placed in a folder inside your app directory. Look at some of the examples to see how they fit in.
I'm considering replacing the templating system with something more lightweight as a one-to-one copy of the django templating system may not be the best way forward. This may not happen straight away though.
I'm also considering various node.js data modelling libraries for building the 'model' layer of jimi, so please forward any suggestions to firstname.lastname@example.org.
jimi was originally based on djangode, a node.js micro-framework written by Simon Willison. The framework still uses the djangode templating system, so he deserves heaps of credit.