vijayviji / executor

Executor is similar to Executors in Java lang. A simple thread pool implemented for golang. This gives you fine control over native threads.

executor

Executor is similar to Executors in Java language. A simple thread pool implemented for golang. This gives you fine control over native threads.

An executor is backed by thread pool. runtime.LockOSThread() is internally used to make the thread concept available for go programmers. This is very useful, if you want to contain resources for certain type of tasks.

For example, if you want some CPU hunger tasks not starve other simple tasks, you can create two separate thread pools (or executors) and contain the CPU resource to CPU hunger tasks.

Enjoy!

APIs

• To import

  import "github.com/vijayviji/executor"

• Create an executor backed by a single thread:

  ex := executor.NewSingleThreadExecutor("executorName", 200)
  // 200 = Task Queue Size

• Create an executor backed by a pool of threads:

  ex := executor.NewFixedThreadPool("executorName", 10, 2000)
  // 10 = No. of threads
  // 2000 = Task Queue Size of each thread
  // All the tasks queued to this executor will be pushed to task queues of all the threads backing this executor in
  // a round-robin fashion.

• Queue a task to an executor:

  dataForTask = "Dummy data"
  
  future := ex.Submit(func(taskData interface{}, threadName string, taskID uint64) interface{} {
      dataFromTask := taskData.(string)
      fmt.Println("data for this task: ", dataFromTask)
      return "OKKK"
  }, dataForTask)
  :
  :
  result := future.Get()
  // result will be "OKKK"
  
  // taskStatus can be any of executor.TaskNotStarted, executor.TaskStarted, executor.TaskDone
  taskStatus := future.GetStatus()

• Shutdown an executor (and all its backing threads):

  ex.Shutdown()
  // This function would only return after all the threads are shut down.

• Running test on executor.go

  make test

executor's Issues

Prioritizing Goroutines

Hi,

for my work I need goroutines that I can start with a higher priority than others. @vijayviji On Stackoverflow (https://stackoverflow.com/questions/53890318/prioritizing-goroutine-in-golang) you wrote that with this implementation of thread pools in Go (executor) it is possible to prioritize certain goroutines over others. Could you please give a concrete example of this or explain this statement in more detail? Unfortunately, I can't find any parameter for a priority in your code that I could transfer to the executor.

Thank you very much for an answer!

Best regards from Germany