How haiz/threadingq works
Core Components
• ThreadingQueue (Main Controller)
• WorkerThread Manager
• Queue System
• Worker Function Handler
• Async/Sync Support Layer
Flow Architecture
a. Producer Flow
b. Queue Management Flow
c. Worker Thread Flow
d. Resource Management Flow
Component Details
ThreadingQueue Controller:
• Sync Interface (put)
• Async Interface (async put)
• num_of_threads
• worker_params
• log_dir
• worker_params_builder
• on_thread_close
Queue System:
• Connection to both producer and consumer sides
• Queue state management
Worker Thread Pool:
• Multiple worker threads
• Thread lifecycle management
• Resource handling (e.g., DB connections)
Special Features to Highlight
• Context manager support (with/async with)
• Worker parameter building
• Thread cleanup mechanisms
• Logging system integration
Interactions
Key interactions:
• Producer → Queue
• Queue → Worker Threads
• Worker Threads → Resources
• Error Handling → Retry Logic
A separate section showing:
• Supported Python versions
• Threading model details
• Async/sync compatibility
• Resource management patterns
Specific Implementation Guidelines:
Retry mechanisms and error handling
• ThreadingQueue Controller: 20% of space
• Queue System: 30% of space
• Worker Thread Pool: 30% of space
• Resource Management: 20% of space
Remember to:
• Use consistent styling
• Version compatibility notes
• Clear boundaries between components
• Scalability aspects