garde-fou

garde-fou is a multi-language toolkit for building protective wrappers around paid API clients. The goal is to make it easy to enforce usage quotas, rate limits, and duplicate detection across different programming languages.

Features

• Call counting - Set maximum number of calls and get warnings or exceptions when exceeded
• Duplicate detection - Detect and handle repeated identical API calls
• Flexible violation handling - Choose to warn, raise exceptions, or use custom handlers
• Configuration support - Load settings from JSON/YAML files or set programmatically
• Async support - Works with both synchronous and asynchronous functions
• Multi-language support - Consistent API across Python, JavaScript/TypeScript, and Ruby

Quick Start

Python

pip install garde-fou

from gardefou import GardeFou

guard = GardeFou(max_calls=5, on_violation_max_calls="warn")
result = guard(your_api_function, "your", "arguments")

JavaScript/TypeScript

npm install garde-fou

import { GardeFou } from 'garde-fou';

const guard = GardeFou({ max_calls: 5, on_violation_max_calls: 'warn' });

// Two equivalent calling patterns:
// 1. Direct call (Python-like syntax)
const result = guard(yourApiFunction, "your", "arguments");

// 2. Explicit method call
const result2 = guard.call(yourApiFunction, "your", "arguments");

// For async functions
const asyncResult = await guard.callAsync(yourAsyncApiFunction, "args");

Ruby

gem install garde_fou

require 'gardefou'

guard = Gardefou::GardeFou.new(max_calls: 5, on_violation_max_calls: 'warn')

# Three equivalent calling patterns:
# 1. Method call
result = guard.call(your_api_method, "your", "arguments")

# 2. Bracket syntax (Ruby callable style)
result = guard[your_api_method, "your", "arguments"]

# 3. Protect method (semantic)
result = guard.protect(your_api_method, "your", "arguments")

Repository Layout

• python/ – ✅ Ready! Full Python package published to PyPI
• js/ – ✅ Ready! TypeScript/JavaScript package with full type support
• ruby/ – ✅ Ready! Ruby gem with multiple calling patterns and mixin support

Status

• Python: ✅ Complete and published to PyPI
• JavaScript/TypeScript: ✅ Complete with TypeScript support and comprehensive test suite
• Ruby: ✅ Complete with Ruby-idiomatic API and comprehensive RSpec test suite

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.