How do I set up OAuth 2.0 authentication in Friboo?

Friboo supports pluggable authentication via the HTTP component. Configure OAuth 2.0 in your Swagger YAML file and set up the appropriate handler functions, as detailed in the authentication section of the README.

Friboo vs Luminus for Clojure microservices?

Friboo is better for API-first design with Swagger and Component lifecycle management, while Luminus offers a more full-stack, traditional approach. Choose Friboo if you need strict microservice conventions and built-in monitoring components.

How to handle database migrations with Flyway in Friboo?

Use the DB component which integrates Flyway. Place SQL migration files in resources/db/migration, and the component automatically applies them on startup, as shown in the example projects from friboo-ext-zalando.

Can I deploy Friboo apps to Kubernetes?

Yes, Friboo applications are standard JAR files that can be containerized. The configuration via environment variables aligns well with Kubernetes secrets and config maps, making deployment straightforward.

What's the performance impact of the metrics component?

The metrics component uses Dropwizard Metrics, which has minimal overhead but provides detailed API performance insights. It's optional and configurable, so you can tune it based on your monitoring needs.

How to test Friboo microservices effectively?

Generated projects include examples with clojure.test and Midje. Leverage the reloaded workflow for integration testing, and mock dependencies in unit tests for handlers, as demonstrated in the template.

Open-Awesome

Friboo

Apache-2.0Clojure1.5.0

A lightweight utility library for building microservices in Clojure with Swagger-based API-first design and built-in components.

GitHub

118 stars16 forks0 contributors

What is Friboo?

Friboo is a utility library for building microservices in Clojure that follows an API-first approach using Swagger specifications. It provides pre-built components for HTTP serving, database access, metrics, and authentication, reducing the boilerplate code needed to create production-ready services. The library integrates with the Component lifecycle framework to manage dependencies and configuration systematically.

Target Audience

Clojure developers building RESTful microservices, especially teams adopting API-first design and needing standardized components for configuration, database access, and monitoring.

Value Proposition

Developers choose Friboo for its opinionated yet flexible structure, built-in support for Swagger-based API design, and comprehensive components that handle common microservice concerns like authentication, metrics, and database migrations out of the box.

Overview

Utility library for writing microservices in Clojure, with support for Swagger and OAuth

Use Cases

Best For

Building Swagger-defined REST APIs in Clojure
Creating microservices with integrated OAuth 2.0 authentication
Managing database schemas and migrations with Flyway in Clojure apps
Implementing monitoring and metrics with Dropwizard Metrics
Developing services following the 12-factor app configuration principles
Structuring microservices using the Component lifecycle framework

Not Ideal For

Projects that prefer code-first API development over Swagger specifications
Teams needing built-in support for non-HTTP protocols like gRPC or WebSockets
Applications requiring a large ecosystem of community plugins beyond Zalando's stack
Simple, single-endpoint services where Component framework overhead is unnecessary

Pros & Cons

Pros

API-First Design Enforcement

Encourages defining REST APIs in Swagger YAML before implementation, using swagger1st for routing, which ensures consistency and portability across services.

Comprehensive Component Library

Provides ready-to-use components for HTTP serving, database access with Flyway migrations, and Dropwizard metrics, reducing boilerplate and integrating best practices.

Robust Configuration Management

Aggregates configuration from environment variables, JVM properties, and files with namespacing, adhering to 12-factor app principles for microservices.

REPL-Driven Development Support

Facilitates reloaded workflow with hot-reload capabilities for configuration and components, enabling iterative development in the REPL.

Cons

Limited Protocol Support

Focused solely on REST APIs via Swagger, with no built-in components for real-time communication, GraphQL, or other modern protocols.

Ecosystem Dependency

Heavily tied to Zalando's extensions like friboo-ext-zalando for production use, which may limit community-driven growth and flexibility.

Configuration Complexity

The namespaced configuration system, while powerful, adds overhead and a learning curve that can be excessive for simpler microservices.

Frequently Asked Questions

Related Projects

Reitit

A fast data-driven routing library for Clojure/Script

Stars1,583

Forks262

Last commit7 days ago

Compojure-api

Sweet web apis with Compojure & Swagger

Stars1,125

Forks146

Last commit1 year ago

yada

A powerful Clojure web library, full HTTP, full async - see https://juxt.pro/yada/index.html

Stars733

Forks96

Last commit3 years ago

Router

Bidirectional Ring router. REST oriented. Rails inspired.

Stars80

Forks4

Last commit9 years 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