Project

threads

0.01
A long-lived project that still receives updates
Rugy Gem to test a piece of code in concurrent threads
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

EO principles respected here DevOps By Rultor.com We recommend RubyMine

rake Gem Version Maintainability Yard Docs Test Coverage Hits-of-Code

Read this blog post first: Do You Test Ruby Code for Thread Safety?

When you need to test your code for thread safety, what do you do? That's right, you just don't test it. That's wrong! This simple gem helps you test your code with just two additional lines of code.

First, install it:

$ gem install threads

Then, use it like this, to test your code from multiple concurrently running threads:

require 'threads'
Threads.new(5).assert do |i|
  puts "Hello from the thread no.#{i}"
end

You can put whatever you want into the block. The code will be executed from five threads, concurrently. You can also make sure the code block runs only a specific number of times specifying the argument in the assert method (it can't be smaller than the amount of threads):

Threads.new(5).assert(20) do |i, r|
  puts "Hello from the thread no.#{i}, repetition no.#{r}"
end

You can also provide a logger, which will print exception backtraces. It has to implement either method error(msg) or puts(msg):

Threads.new(5, log: STDOUT).assert do
  this_code_fails_for_sure
end

That's it.

How to contribute

Read these guidelines. Make sure you build is green before you contribute your pull request. You will need to have Ruby 2.3+ and Bundler installed. Then:

$ bundle update
$ bundle exec rake

If it's clean and you don't see any error messages, submit your pull request.