# ankane/the-ultimate-guide-to-ruby-timeouts

Timeouts for popular Ruby gems

Repository: https://github.com/ankane/the-ultimate-guide-to-ruby-timeouts
Canonical: https://ross.abutalabs.com/products/the-ultimate-guide-to-ruby-timeouts
Language: Ruby
License: MIT
License Family: permissive
Last push: 2026-06-29T20:06:51+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 90, release rhythm 35, longevity 100
- inputs: {"age_days": 4056, "days_push": 65, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2498, forks 100 (observed 2026-08-28T04:06:56.831994+00:00)

## What it is
A tested reference guide showing how to configure timeouts for popular Ruby gems, standard library modules, and databases. It explains timeout types (connect, read, write, statement, etc.) and warns against Ruby's Timeout module.

## Use cases
- add timeouts to ruby http clients
- set statement timeout for postgresql in activerecord
- configure redis timeout in ruby
- avoid ruby Timeout module dangers
- find default timeout settings for ruby gems
- set connection pool checkout timeout
- timeout kafka or elasticsearch clients in ruby

## When to choose
- you're writing or reviewing Ruby code that makes network requests or database calls and need correct timeout configuration
- you want tested, copy-pasteable timeout snippets for specific Ruby gems
- you're hardening a Ruby service against unresponsive downstream services

## When to avoid
- you need timeouts for languages other than Ruby (use the companion Python/Node/Go/PHP/Rust guides)
- you need a library that enforces timeouts automatically rather than documentation
- your stack doesn't involve Ruby networking or data stores

## Facets
- artifact type: learning-resource
- maturity: active
- function: developer-tools, documentation, security
- domain: developer-tools, documentation, performance
- platform: ruby
- tags: timeouts, ruby-gems, networking, reliability, guide

## Member repositories
- ankane/the-ultimate-guide-to-ruby-timeouts (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:56.831994+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:27:02.607748+00:00, confidence not recorded.
  - readme: https://github.com/ankane/the-ultimate-guide-to-ruby-timeouts (fetched 2026-08-28T04:06:56.831994+00:00, sha 592fd230b6cb)
- Data as of 2026-08-30T08:39:29.467469+00:00.