Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
JSGI middleware composition layer and application framework
branch: master

This branch is 50 commits behind ringo:master

Merge pull request #33 from ringo/master

Merge changes from ringo
latest commit a5eaf5b727
Hannes Wallnöfer authored

README.md

Stick

Stick is a modular JSGI middleware composition layer and application framework based on RingoJS.

Overview

Stick provides an Application object that can be used to compose web applications out of JSGI middleware components. Middleware can in turn define methods or properties on the application object to make itself configurable to the outside world.

Currently Stick comes with the following middleware modules:

  • basicauth - basic HTTP authentication
  • continuation - generator-based async requests
  • error - generating error pages
  • etag - ETag based conditional GET
  • gzip - GZip content encoding
  • method - HTTP method overriding
  • mount - mounting other applications
  • notfound - generating 404 pages
  • params - form data parsing
  • profiler - JavaScript profiling
  • render - mustache.js templates
  • requestlog - collecting per-request log messages
  • route - Sinatra-like request routing
  • session - session support
  • static - serving static files
  • upload - handling file uploads

    Check out the demo applications and documentation to learn more.

Running

Use the ringo-admin command to to install Stick:

$ ringo-admin install hns/stick

Alternatively, you can manually copy or symlink the stick directory into the packages directory of your ringojs installation.

To start the stick demo application run the ringo command with the demo.js script in the stick directory:

$ ringo examples/demo.js

Then point your browser to http://localhost:8080/.

License

Stick is distributed under the MIT license.

Something went wrong with that request. Please try again.