rython 0.0.1

Calling methods with RubyProxy arguments

Let’s say you have a Ruby method that takes a complex Ruby object. This object will be proxied in the Python context as a RubyProxy. To pass this object to a method, simply use the repr string substitution. The following example passes a RubyProxied Browser object to a method:

my_browser = ctx("Watir::Browser.new")
my_foobar = ctx("Foobar.new")

my_foobar("method_that_takes_browser(%(browser)r)", browser=my_browser)

Rython will automatically convert a RubyProxy argument to the appropriate Ruby expression that refers to the object in the Ruby context.

Apply monkeypatches to the context

When instantiating a RubyContext, you can specify a ‘setup’ parameter that contains raw Ruby code to execute after doing the require statements. This is perfect for adding monkeypatches to Ruby objects, or just performing additional setup.

This example monkeypatches the String object with a ‘to_safe_string’ method. This makes it easy to convert all strings into printable characters:

import rython

monkeypatches = '''
    class String
        GOOD_NONUNICODE_CHARS = (("A".."Z").to_a + ("a".."z").to_a + ("0".."9").to_a).to_a
        def to_safe_string
            final = ""
            each_char do |ch|
                final += "#{ch}" if GOOD_NONUNICODE_CHARS.include? ch
            end
            final
        end
    end
    '''

ctx = rython.RubyContext(setup=monkeypatches)

Running the context in debug mode

This is helpful when Rython appears to be failing due to problems in the Ruby context. By default, all logging messages are suppressed from the Ruby context. You can reenable them by setting the debug flag:

import rython

ctx = rython.RubyContext(debug=True)