How to handle POST requests with JSON data in Compojure?

Use the POST macro with a handler that parses the request body. Integrate Ring middleware like ring-json to automatically parse JSON, then access the data in your handler function for processing.

Compojure vs Reitit: which is better for Clojure web apps?

Compojure is simpler and more established, ideal for basic routing with Ring. Reitit offers more features like data-driven routes and better performance, but has a steeper learning curve. Choose based on your need for simplicity versus advanced capabilities.

How to add authentication to a Compojure app?

Compojure doesn't provide authentication out of the box. Use Ring middleware, such as friend or buddy, to handle authentication and integrate it with your Compojure routes by wrapping handlers or using middleware stacks.

What's the best way to organize large Compojure applications?

Break routes into separate namespaces and use defroutes to combine them. This modular approach keeps code clean and allows for reuse, following functional composition patterns highlighted in the philosophy.

How does Compojure handle async requests?

Compojure supports asynchronous handlers by returning a promise or future from route handlers. This integrates with Ring's async capabilities, enabling non-blocking operations for improved performance.

Can I use Compojure with ClojureScript for frontend routing?

No, Compojure is designed for server-side Clojure with Ring. For client-side routing in ClojureScript, consider libraries like re-frame or secretary, as Compojure won't work in that context.

Open-Awesome

Compojure

EPL-1.0Clojure

A concise routing library for Ring/Clojure that composes web applications from small, independent parts.

GitHub

4.1k stars259 forks0 contributors

What is Compojure?

Compojure is a concise routing library for Ring/Clojure that allows developers to build web applications by composing small, independent route handlers. It provides a clean DSL for defining HTTP endpoints and integrates seamlessly with the Ring ecosystem. The library solves the problem of creating modular, maintainable web applications in Clojure without unnecessary complexity.

Target Audience

Clojure developers building web applications who want a lightweight, functional approach to routing. It's ideal for those already using Ring who need a simple way to define and organize HTTP endpoints.

Value Proposition

Developers choose Compojure for its minimalism, excellent Ring integration, and functional composition model. Its concise syntax and focus on small, reusable handlers make it particularly appealing for Clojure developers who value simplicity and modularity over feature-heavy frameworks.

Overview

A concise routing library for Ring/Clojure

Use Cases

Best For

Building RESTful APIs in Clojure with clean route definitions
Creating modular web applications composed of independent handlers
Developing lightweight microservices with Ring/Clojure
Prototyping web applications quickly with minimal boilerplate
Learning web development in Clojure with established ecosystem tools
Maintaining large codebases through functional composition patterns

Not Ideal For

Projects requiring built-in authentication, session management, or other full-stack framework features
Teams that prefer convention-over-configuration frameworks with automatic code generation and scaffolding
Applications needing complex, nested routing patterns or advanced URL matching beyond simple HTTP method-based routes
Developers not already using the Ring ecosystem or new to Clojure's functional web development paradigm

Pros & Cons

Pros

Concise Routing DSL

Uses macros like GET and POST for clean, readable route definitions, as shown in the example application with minimal boilerplate.

Seamless Ring Integration

Built specifically for Ring, allowing effortless use of Ring middleware and handlers, which is the standard in Clojure web development.

Modular Handler Composition

Encourages building applications from small, reusable functions via defroutes, making codebases easier to maintain and test.

Built-in Error Utilities

Includes helpers like route/not-found for custom 404 pages, simplifying error handling without extra dependencies.

Cons

Minimal Feature Set

Focuses solely on routing, so developers must integrate additional libraries for common needs like validation, database access, or API documentation.

Documentation Fragmentation

Documentation is split between a wiki and separate API docs, which can be less accessible and up-to-date than centralized guides.

Ring Ecosystem Lock-in

Tight coupling to Ring limits flexibility for alternative HTTP abstractions in Clojure, potentially creating vendor lock-in.

Frequently Asked Questions

Related Projects

Pedestal

The Pedestal Server-side Libraries

Stars2,782

Forks315

Last commit3 days ago

fulcro

A library for development of single-page full-stack web applications in clj/cljs

Stars1,614

Forks149

Last commit25 days ago

Reitit

A fast data-driven routing library for Clojure/Script

Stars1,587

Forks265

Last commit16 days ago

Duct

Server-side application framework for Clojure

Stars1,156

Forks52

Last commit1 year ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub