Ring is a Clojure web applications library inspired by Python's WSGI and Ruby's Rack. By abstracting the details of HTTP into a simple, unified API, Ring allows web applications to be constructed of modular components that can be shared among a variety of applications, web servers, and web frameworks.
The SPEC file at the root of this distribution provides a complete description of the Ring interface.
From version 1.2.1 onward, the ring/ring-core package no longer comes with the
javax.servlet/servlet-api package as a dependency (see issue #89).
If you are using the
ring/ring-core namespace on its own, you may run into errors when executing tests or running alternative adapters. To resolve this, include the following dependency in your dev profile:
- ring-core - essential functions for handling parameters, cookies and more
- ring-devel - functions for developing and debugging Ring applications
- ring-servlet - construct Java servlets from Ring handlers
- ring-jetty-adapter - a Ring adapter that uses the Jetty webserver
To include one of the above libraries, for example
ring-core, add the following to your
To include all of them:
Please see CONTRIBUTING.md.
This project borrows heavily from Ruby's Rack and Python's WSGI; thanks to those communities for their work.
Copyright © 2009-2021 Mark McGranaghan, James Reeves & contributors.
Released under the MIT license.