The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


Thread::Isolate::Pool - A pool of threads to execute multiple tasks.


This module creates a pool of threads that can be used to execute simultaneously many tasks. The interface to the pool is similar to a normal Thread::Isolate object, so we can think that the pool is like a thread that can receive multiple calls at the same time.


  use Thread::Isolate::Pool ;

  my $pool = Thread::Isolate::Pool->new() ;
  $pool->use('LWP::Simple') ; ## Loads LWP::Simple in the main thread of the pool.
  print $pool->main_thread->err ; ## $@ of the main thread of the pool.
  my $url = '' ;
  my $job1 = $pool->call_detached('get' , $url) ;
  my $job2 = $pool->call_detached('get' , $url) ;
  my $job3 = $pool->call_detached('get' , $url) ;
  ## Print what jobs are running in the pool:
  while( $job1->is_running || $job2->is_running || $job3->is_running ) {
    print "[1]" if $job1->is_running  ;
    print "[2]" if $job2->is_running  ;
    print "[3]" if $job3->is_running  ;
  print "\n<<1>> Size: " . length( $job1->returned ) . "\n" ;
  print "\n<<2>> Size: " . length( $job2->returned ) . "\n" ;
  print "\n<<3>> Size: " . length( $job3->returned ) . "\n" ;
  ## Shutdown all the thread of the pool:
  $pool->shutdown ;

The code above creates a Pool of threads and make simultaneously 3 LWP::Simple::get()s. Internally the pool has a main thread that is used to create the execution threads.

The main thread should have all the resources/modules loaded before make any call()/eval() to the pool.

When a call()/eval() is made, if the pool doesn't have any thread free (without be executing any job), a new thread is created from the main thread, and is used to do the task. Note that no threads will be removed after be created since this won't free memory, so is better to let them there until shutdown().


new ( LIMIT )

Creates a new pool. If LIMIT is defined will set the maximal number of threads inside the pool. So, this defines the maximal number of simultaneous calls that the pool can have.


Returns the main thread.


Returns the LIMIT of threads of the pool.


Return a free thread. If is not possible to get a free thread and create a new due LIMIT, any thread in the pool will be returned.

If called in a ARRAY contest will return ( FREE_THREAD , ON_LIMIT ), where when ON_LIMIT is true indicates that was not possible to get a free thread or create a new free thread.


Add a new thread if is not in the LIMIT.

use ( MODULE , ARGS )

Make an "use MODULE qw(ARGS)" call in the main thread of the pool.


Get a free thread and make a $thi-call()> on it.


Get a free thread and make a $thi-call_detached()> on it.


Get a free thread and make a $thi-eval()> on it.


Get a free thread and make a $thi-eval_detached()> on it.


Shutdown all the threads of the pool.


Thread::Isolate, Thread::Isolate::Map.



Graciliano M. P. <>

I will appreciate any type of feedback (include your opinions and/or suggestions). ;-P


This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.