feat: expose pool_size and pool_idle_timeout as configurable options

[joalves]

Summary

• Add pool_size config option (default: 20) to control connection pool size
• Add pool_idle_timeout config option (default: 5) to set idle connection timeout in seconds
• Update README with new configuration options
• Add tests for the new options

Test plan

• All 252 existing tests pass
• New tests verify custom and default values for pool settings
• Documentation updated in README.md and CHANGELOG.md

Summary by CodeRabbit

• New Features

  • Added configurable connection pool settings: pool_size and pool_idle_timeout. These settings enable fine-tuning of connection pooling to suit specific application requirements. Default values: pool_size of 20 and pool_idle_timeout of 5 seconds.

• Documentation

  • Updated configuration guide with new pooling options and usage examples.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Warning

Rate limit exceeded

@joalves has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 8 minutes and 1 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

This pull request introduces configurable HTTP connection pool settings to the Ruby SDK. Two new configuration attributes—pool_size (default: 20) and pool_idle_timeout (default: 5)—are added to the DefaultHttpClientConfig class. The implementation replaces hardcoded values in the HTTP client initialisation with these config-driven values. The changes include documentation updates in the README and CHANGELOG, implementation modifications to wire the configuration into the Faraday adapter, and comprehensive test coverage for both the new attributes and their integration with the HTTP client.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• fix: allow http client configuration from configure_client #33: Configures how HTTP client options flow into DefaultHttpClientConfig, complementing the new pool settings additions in this PR.
• Use faraday net-persistent adapter. #35: Modifies lib/default_http_client.rb to initialise the net_http_persistent adapter with pool and idle timeout settings, directly overlapping with this PR's configuration logic.

Suggested reviewers

• calthejuggler
• cwmpinho

Poem

🐰 Pools of wisdom, now we configure!
Pool size and timeouts, set them higher—
No more hardcoded, stiff and rigid,
Flexibility blooms in this pivotal mid-field! ✨🔧

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately and specifically describes the main change: exposing pool_size and pool_idle_timeout as configurable options. It clearly summarises the primary objective of the pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[calthejuggler]

LGTM 🙂