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.

• 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

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")

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");

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")

• 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

• 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

Contributions are welcome! See CONTRIBUTING.md for guidelines.