Skip to content
This repository
Newer
Older
100644 57 lines (41 sloc) 2.666 kb
7626a152 »
2010-04-07 modif README
1 = BrB - Easy and Fast distributed ruby
0e0a36c1 »
2010-04-06 First release on Github :) Need cleanup
2
3adaa34f »
2010-04-22 modif readme (thanks bwalton)
3 BrB is a simple, fully transparent and extremely fast interface for doing simple distributed Ruby.
4 The core of the architecture is provided by EventMachine (a fast and reliable IO event library).
5
6 BrB was built in order to achieve these 4 main goals :
7 * Simple and fast message passing between distant Ruby processes.
8 * Message passing with of return values when needed.
9 * Being extremely fast in order to handle more than a few thousand messages per second.
922ecc1b »
2010-04-16 Add examples
10 * Being completely transparent for developer.
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
11
3adaa34f »
2010-04-22 modif readme (thanks bwalton)
12 The principle is simple and inspired from Drb (standard distributed ruby library) :
13 A process exposes an object over the network and any ruby process (after having established a connection tunnel) can directly call a method on the exposed object. BrB handles that part, so it’s fully transparent in the Ruby code.
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
14
15 BrB only support message passing with Marshable dumpable object : String, symbol, Array, hash, Number, Object etc...
16 That mean you can not send file descriptor, Thread or another funky things like that :)
17
6b3c414a » guillaume
2010-10-13 Added the Google Group url
18 For any question, use the Ruby BrB google group: http://groups.google.com/group/ruby-brb
19
7626a152 »
2010-04-07 modif README
20 == Main Functionalities
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
21
7626a152 »
2010-04-07 modif README
22 * Unlimited objects exposed
23 * Processes can expose object and be client to exposed object too at the same time
24 * Do not wait for return by default : just do simple message passing
9c83196b »
2010-05-21 Added non blocking callback functionality, little specs refactoring. …
25 * Handle return values without blocking with the usage of a simple block
d642d839 »
2010-05-21 Modif readme
26 * Blocking wait for a return value if needed by simply adding <em>_block</em> at the end of the method name
7626a152 »
2010-04-07 modif README
27 * Transmission of Exception when blocking call
28 * Thread safe if used correctly with Event Machine
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
29
7626a152 »
2010-04-07 modif README
30 == How it works
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
31
32 First of all, a process declare himself as a sever and expose any object on a given address and port.
33 Then, any number of distant processes can create a <em>Tunnel</em> with that server and can expose an object in exchange too.
34 After connection are ready, just call method on the tunnel. It will just act like normal method calling on the exposed object !
35
3adaa34f »
2010-04-22 modif readme (thanks bwalton)
36 == What BrB is designed for ?
b485f942 »
2010-04-07 More spec, little clean up, More in Readme
37
922ecc1b »
2010-04-16 Add examples
38 * Doing Simple message passing between ruby process.
39 * Connecting hundred of ruby process transparently.
40 * Building a real-time scalable (game) server
41 * Taking important load on a server easily just by distributing the load on multiple BrB instance.
42 * Taking advantage of multi-core and multi-threaded systems.
0e0a36c1 »
2010-04-06 First release on Github :) Need cleanup
43
7626a152 »
2010-04-07 modif README
44 == TODO
922ecc1b »
2010-04-16 Add examples
45 * Writing more examples
7626a152 »
2010-04-07 modif README
46 * Publish Benchmarks VS drb
47 * Improve logging mechanism
922ecc1b »
2010-04-16 Add examples
48 * Clean up
0e0a36c1 »
2010-04-06 First release on Github :) Need cleanup
49
bda47d28 »
2010-05-21 Ad contributors to README
50 == Contributors
51
52 * kwi (Guillaume Luccisano)
53 * bwalton (Brian Walton)
1ae0c82f »
2011-05-18 Merge dpree custom logger branch (awesome) and bump to version 0.3.1
54 * dpree (Jens Bissinger)
bda47d28 »
2010-05-21 Ad contributors to README
55
74703dc4 »
2010-05-21 Add contributors to README
56
922ecc1b »
2010-04-16 Add examples
57 Copyright (c) 2009-2010 Guillaume Luccisano - g-mai|: guillaume.luccisano, released under the MIT license
Something went wrong with that request. Please try again.