ri > Puma::ThreadPool

man perldoc info pydoc3 ri search

📦 NAME

Puma::ThreadPool < Object

🚀 Quick Reference

Use Case	Command	Description
Create a new thread pool	Puma::ThreadPool.new(min, max, &block)	Initialize a pool with minimum and maximum thread counts, and a block to process requests
Add work to the pool	pool << client	Push a client request into the @todo array for processing by an available thread
Check pending work	pool.backlog	Returns the number of requests waiting in the @todo array
Check available capacity	pool.pool_capacity	Returns the number of threads available to take new work
Trigger graceful shutdown	pool.shutdown	Signals all threads to stop after finishing current work (not shown in snippet, but typical)
Force shutdown with grace	ForceShutdown exception + SHUTDOWN_GRACE_TIME	After raising ForceShutdown, wait SHUTDOWN_GRACE_TIME for threads to finish before leaving them

📝 Description

Internal Docs for A simple thread pool management object.

Each Puma "worker" has a thread pool to process requests.

First a connection to a client is made in Puma::Server. It is wrapped in a Puma::Client instance and then passed to the Puma::Reactor to ensure the whole request is buffered into memory. Once the request is ready, it is passed into a thread pool via the Puma::ThreadPool#<< operator where it is stored in a @todo array.

Each thread in the pool has an internal loop where it pulls a request from the @todo array and processes it.

📋 Constants

• SHUTDOWN_GRACE_TIME: How long, after raising the ForceShutdown of a thread during forced shutdown mode, to wait for the thread to try and finish up its work before leaving the thread to die on the vine.

🔧 Class methods

• clean_thread_locals
• new

🔧 Instance methods

• backlog
• busy_threads
• clean_thread_locals
• out_of_band_hook
• pool_capacity
• spawned
• trim_requested
• waiting

🏷️ Attributes

• attr_accessor clean_thread_locals
• attr_accessor out_of_band_hook
• attr_reader spawned
• attr_reader trim_requested
• attr_reader waiting

📦 NAME 🚀 Quick Reference 📝 Description 📋 Constants 🔧 Class methods 🔧 Instance methods 🏷️ Attributes