Question 1

How to use bidi with Ring middleware?

Accepted Answer

Create a handler using make-handler from bidi.ring, then wrap it with Ring middleware functions like wrap-session, as demonstrated in the README's example for chaining middleware with your routes.

Question 2

bidi vs Compojure: which should I use?

Accepted Answer

Choose bidi if you need bidirectional URI generation and data-driven routes for HATEOAS or dynamic routing; Compojure is better for simpler, macro-based syntax and faster setup in unidirectional applications.

Question 3

How to generate URIs for routes with parameters in bidi?

Accepted Answer

Use the path-for function with the route structure and handler identifier, passing route parameters as keyword arguments, such as :id, as shown in the examples with segmented patterns like [:id "/article.html"].

Question 4

Can bidi handle multiple virtual hosts?

Accepted Answer

Yes, bidi supports virtual host routing through the vhosts-model function, allowing you to define routes across different domains or schemes in a single structure, detailed in the virtual hosts section of the README.

Question 5

How to serve static files with bidi?

Accepted Answer

Use the built-in Resources or Files records on the right-hand side of routes, specifying a prefix or directory, but note that ResourcesMaybe may return nil for missing files, allowing subsequent routes to match.

Question 6

Is bidi compatible with Liberator for REST APIs?

Accepted Answer

Yes, bidi is fully compatible with Liberator; you can use bidi for routing and Liberator for resource handling, with integration tips and examples referenced in the README's issue links.

Bidi

What is Bidi?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions