https://github.com/clojure-liberator/liberator

Liberator is a Clojure library for building RESTful applications.
https://github.com/clojure-liberator/liberator

clojure http rest server-side

Last synced: 7 days ago
JSON representation

Liberator is a Clojure library for building RESTful applications.

• Host: GitHub
• URL: https://github.com/clojure-liberator/liberator
• Owner: clojure-liberator
• License: other
• Created: 2012-09-02T09:05:07.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2021-09-28T13:08:50.000Z (about 3 years ago)
• Last Synced: 2024-10-29T15:35:18.256Z (about 2 months ago)
• Topics: clojure, http, rest, server-side
• Language: Clojure
• Homepage: http://clojure-liberator.github.io/liberator
• Size: 1.34 MB
• Stars: 1,261
• Watchers: 50
• Forks: 130
• Open Issues: 65
• Metadata Files:
  • Readme: README.markdown
  • Changelog: CHANGES.markdown
  • License: LICENSE

Awesome Lists containing this project

README

        
# Liberator [![Build Status](https://travis-ci.org/clojure-liberator/liberator.svg?branch=master)](https://travis-ci.org/clojure-liberator/liberator) [![Clojars Project](http://clojars.org/liberator/latest-version.svg)](http://clojars.org/liberator)

Liberator is a Clojure library for building RESTful applications.

## Quick Links

You can find documentation at http://clojure-liberator.github.io/liberator

If you have any questions, visit our fine google group at https://groups.google.com/forum/#!forum/clojure-liberator

### Similar projects

Liberator used to be known as compojure-rest. It got renamed in July 2012.

Liberator is loosely modeled after webmachine and shares the same aims as Bishop.

## Warming up

### Dependencies

The examples in this document rely on you installing [leiningen 2](http://leiningen.org).

We'll also use ```curl``` for testing. If you don't have curl installed (ie. you're using Windows), there's some Clojure tests you can use instead.

### Running the examples

A set of examples is included.

If you want to see the examples in a browser, run

    lein examples

This will start a web server on port 8000 (but you can specify a alternative port with an argument, eg. ```lein examples 8001```). Alternatively you can run the web server with ```lein ring server```).

### Ensuring the tests pass

Liberator uses [Midje](https://github.com/marick/Midje/) for testing. You can run all the tests like this :-

    lein midje

# Documentation

Documentation and a tutorial can be found on [http://clojure-liberator.github.io](http://clojure-liberator.github.io).

# License

Liberator is licensed under EPL 1.0 (see file epl-v10.html).