ifuture

KO | EN

gitlite — search

#ai #llm #golang #android #deep-learning #nodejs #macos #windows #cli #kubernetes #vue #security #ios #mcp

(★ 12)

Futures over IPC - Deprecated

ifuture Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ifuture
[![Build Status](https://secure.travis-ci.org/havenwood/ifuture.png?branch=master)](http://travis-ci.org/havenwood/ifuture)
[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/havenwood/ifuture)

## Deprecation Notice

### THIS GEM IS DEPRECATED!

ifuture was implemented with the no-longer-supported ichannel gem for interprocess communication over either a Unix Socket or Redis. Futures can be implemented more elegantly and with less overhead by intraprocess communication with a GVL-less Ruby like [JRuby](https://github.com/jruby/jruby#readme), [Rubinius](https://github.com/rubinius/rubinius#readme) or Ruby 3+.

ifuture uses processes forking rather than threads. This allows parallelism with early versions of MRI without the GVL blocking as it might with threads. Run your code in another process and get the result back later!

The Future starts running right away, but isn't blocking because it runs in its own forked process and uses ichannel to communicate with the parent process. If the value is asked for and it is ready, it will be returned right away. If the value is asked for early, the Future blocks until delivery.

## Installation

`gem install ifuture`

The Redis gem is required as well if you opt to use Redis instead of the default Unix socket transporter.

`gem install redis`

## Usage

```ruby
require 'ifuture'
future = IFuture.unix Marshal do
  sleep 2
  'result back from the child process!'
end

future.ready? #=> false
sleep 2
future.ready? #=> true
future.value #=> "result back from the child process!"
```

### Code Serialization Format

The default serialization format is Marshal, but you can use JSON, YAML or other formats that implement the methods #load and #dump.

```ruby
require 'ifuture'
require 'json'
future = IFuture.unix JSON do
  sleep 2
  {ok: true}
end
future.value #=> {"ok"=>true}
```

### IPC Transporter

By default ifuture uses ichannel with unix sockets for transferring serialized code. An alternate choice is to use ichannel with Redis, locally or over the network.

```ruby
require 'ifuture'
future = IFuture.redis Marshal, {host: 'localhost', key: 'readme'} do
  sleep 5
  42
end
future.value #=> 42
```

ifuture

ifuture Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ifuture

ifuture Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README