https://github.com/ruby-concurrency/thread_safe

Thread-safe collections for Ruby (merged with concurrent-ruby)
https://github.com/ruby-concurrency/thread_safe

Last synced: 12 days ago
JSON representation

Thread-safe collections for Ruby (merged with concurrent-ruby)

• Host: GitHub
• URL: https://github.com/ruby-concurrency/thread_safe
• Owner: ruby-concurrency
• License: apache-2.0
• Archived: true
• Created: 2014-06-06T22:13:43.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-08-28T15:06:39.000Z (about 4 years ago)
• Last Synced: 2024-08-31T17:32:31.868Z (2 months ago)
• Language: Java
• Homepage: http://concurrent-ruby.com
• Size: 514 KB
• Stars: 194
• Watchers: 14
• Forks: 20
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Threadsafe (Inactive, code moved to concurrent-ruby gem and repo.)

[![Gem Version](https://badge.fury.io/rb/thread_safe.svg)](http://badge.fury.io/rb/thread_safe) [![Build Status](https://travis-ci.org/ruby-concurrency/thread_safe.svg?branch=master)](https://travis-ci.org/ruby-concurrency/thread_safe) [![Coverage Status](https://img.shields.io/coveralls/ruby-concurrency/thread_safe/master.svg)](https://coveralls.io/r/ruby-concurrency/thread_safe) [![Code Climate](https://codeclimate.com/github/ruby-concurrency/thread_safe.svg)](https://codeclimate.com/github/ruby-concurrency/thread_safe) [![Dependency Status](https://gemnasium.com/ruby-concurrency/thread_safe.svg)](https://gemnasium.com/ruby-concurrency/thread_safe) [![License](https://img.shields.io/badge/license-apache-green.svg)](http://opensource.org/licenses/MIT) [![Gitter chat](http://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg)](https://gitter.im/ruby-concurrency/concurrent-ruby)

A collection of thread-safe versions of common core Ruby classes.

__This code base is now part of the concurrent-ruby gem

at https://github.com/ruby-concurrency/concurrent-ruby.

The code in this repository is no longer maintained.__

## Installation

Add this line to your application's Gemfile:

    gem 'thread_safe'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install thread_safe

## Usage

```ruby

require 'thread_safe'

sa = ThreadSafe::Array.new # supports standard Array.new forms

sh = ThreadSafe::Hash.new # supports standard Hash.new forms

```

`ThreadSafe::Cache` also exists, as a hash-like object, and should have

much better performance characteristics esp. under high concurrency than

`ThreadSafe::Hash`. However, `ThreadSafe::Cache` is not strictly semantically

equivalent to a ruby `Hash` -- for instance, it does not necessarily retain

ordering by insertion time as `Hash` does. For most uses it should do fine

though, and we recommend you consider `ThreadSafe::Cache` instead of

`ThreadSafe::Hash` for your concurrency-safe hash needs. It understands some

options when created (depending on your ruby platform) that control some of the

internals - when unsure just leave them out:

```ruby

require 'thread_safe'

cache = ThreadSafe::Cache.new

```

## Contributing

1. Fork it

2. Clone it (`git clone [email protected]:you/thread_safe.git`)

3. Create your feature branch (`git checkout -b my-new-feature`)

4. Build the jar (`rake jar`) NOTE: Requires JRuby

5. Install dependencies (`bundle install`)

6. Commit your changes (`git commit -am 'Added some feature'`)

7. Push to the branch (`git push origin my-new-feature`)

8. Create new Pull Request