Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A dirt simple library for peer discovery and message passing between Ruby applications on a LAN.

tag: 0.0.3

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 scripts
Octocat-spinner-32 test
Octocat-spinner-32 website
Octocat-spinner-32 History.txt
Octocat-spinner-32 License.txt
Octocat-spinner-32 Manifest.txt
Octocat-spinner-32 README.txt
Octocat-spinner-32 Rakefile
Octocat-spinner-32 setup.rb
README.txt
= Journeta

== About


Journeta is a dirt simple peer discovery and message passing library for processes on the same LAN,
requiring no advanced networking knowledge to use.

Only core Ruby libraries are required, making the library fairly light. As all data is sent accross
the wire in YAML form, any arbitrary Ruby object can be sent to peers, provided they..

 * Are running a compatible Journeta version.
 * Have access to the same class definitions if you are sending your own custom objects.
 * Do not have a firewall preventing network I/O.

Journeta uses Ruby threading to manage the asynchonous nature of peer-to-peer I/O.
For insight into events internal to the library, start ruby with the `--debug` options.


== Use


 examples/instant_messenger.rb
 
    A completely distributed, zero-configuration-required chat room script.
    Fire up several instances in separate terminals. Multiple instances on the same machine is ok.
    Everything you type will automatically be sent to all other instances on the LAN!
    Use `ruby --debug examples/instant_messenger.rb` for detailed internal event details.


== Author

Preston Lee <preston.lee at openrain d0t com>
http://www.prestonlee.com
http://www.openrain.com


== Links

How Journeta discovers peers using UDP multicasting..
http://onestepback.org/index.cgi/Tech/Ruby/MulticastingInRuby.red
Something went wrong with that request. Please try again.