Ji2p - JRuby library

Installation

Note: This is a JRuby only gem, it depends on java.

Gemfile:

gem 'ji2p', '~> 0.0.2'

CLI:

jgem install ji2p

Examples

Generate / Load destination and private key

require 'ji2p'
# Generate new
kp = Ji2p::Control::Keypair.generate!
# Read private key(s) to serializable string
pkey_string = kp.private_key_format
# Load destination from private key stream
stream = StringIO.new pkey_string
kp = Ji2p::Control::Keypair.load_from_stream! stream

Rack HTTP Server

require 'ji2p'

app = Proc.new { |env| ['200', {'Content-Type' => 'text/html'}, ['get rack\'d']] }

kp = Ji2p::Control::Keypair.generate!
ssmgr = Ji2p::Control::SocketManager.defineManager! "testing", kp
ssmgr.connectTunnel
socket = ssmgr.getServerSocket
server = Ji2p::Server::HttpServer.new(app, socket)

puts "Your destination: #{kp.dest.base32}"

server.run

Supported servers/technologies:

• WEBrick
• FCGI
• CGI
• SCGI
• LiteSpeed
• Thin
• Agoo
• Ebb
• Fuzed
• Glassfish v3
• Phusion Passenger (which is mod_rack for Apache and for nginx)
• Puma
• vReel
• unixrack
• uWSGI

However, any valid Rack app will run the same on all these handlers, without changing anything.

Frameworks that support rack:

• Camping
• Coset
• Espresso
• Halcyon
• Hanami
• Mack
• Maveric
• Merb
• Padrino
• Racktools::SimpleApplication
• Ramaze
• Ruby on Rails
• vRum
• Sinatra
• Sin
• Vintage
• WABuR
• Waves
• Wee
• ... and many others.

TODOs?

• Consider splitting up database code to a sub-gem
• Complete clustering support