rubyx-py 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2815c45d6a58b835cfc97484894c6aff43abf13316f18006f46a38c059988ec9
-  data.tar.gz: 2eb4aa61608a7553046b01143d7a704dd204a9eb0a13aa1c1a933350f092b660
+  metadata.gz: cf3d6decfdb8c4bf6dd12f891389511ce96deeaf3efffb1664bb35d6b9b6066f
+  data.tar.gz: 7dcbdcceac38a4a8dc0908e0f11fc19237080025fbb36e8d7cb8d38d0c8ec58f
 SHA512:
-  metadata.gz: 4bd4ce8b2bf2e169a8b32adc9f3fefaf8445fdcc72b1eb1ac821d6c8b8ae192979b0f00260585844e22f0aa3b76a70648801c11130e82df8cb6b6da66bdfec4d
-  data.tar.gz: 0ef30d48d7cbeb5b85e33cb51fa5abebc67808495ff2bcb840b78c1b7c962fa62cb484b7f88a3ee84cc0506e13c6a06c0d173aa0fb03f9f0074443e0aa3e2397
+  metadata.gz: 63cd8eba2c550fd0f4728d6a836ae3e2c80c0b81421830e07938a4d6acba4823e9cc11fb73e767384e33993c01fe4e4138097d9b26e53b361d87d46281ac8de4
+  data.tar.gz: 27c3168265e2e40186c2e0cb554192b03fd484400e34b788d125f9d4347abfecd9d3be260bf093deec48fc38f350c4655ce1e8632b3e7729f41cf967fce6d7ca

data/README.md

@@ -6,14 +6,16 @@
 
 **Call Python from Ruby. No microservices, no REST APIs, no serialization overhead.**
 
-Powered by Rust for safety and performance. Built for Rails.
+Powered by Rust for safety and performance. Built for Rails. Inspired by [Pythonx](https://github.com/livebook-dev/pythonx)
 
 [![Gem Version](https://badge.fury.io/rb/rubyx-py.svg)](https://badge.fury.io/rb/rubyx-py)
 [![CI](https://github.com/yinho999/rubyx/actions/workflows/ci.yml/badge.svg)](https://github.com/yinho999/rubyx/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%203.0-red.svg)](https://www.ruby-lang.org)
 [![Rust](https://img.shields.io/badge/Rust-powered-orange.svg)](https://www.rust-lang.org)
-
+> *"Rubyx showed that the proxy-object pattern works beautifully for cross-language bridges in Rust, and its magnus + rb-sys architecture is exactly what [Boax](https://intertwingly.net/blog/2026/03/25/Calling-JavaScript-from-Ruby.html) uses."*
+> 
+> — [Sam Ruby](https://en.wikipedia.org/wiki/Sam_Ruby), author of *Agile Web Development with Rails*
 </div>
 
 ---
@@ -93,7 +95,7 @@ dependencies = []
 
 ```python
 # app/python/example.py
-def hello(name="World"):
+def hello(name):
     return f"Hello, {name}! From Python."
 ```
 
@@ -102,7 +104,7 @@ def hello(name="World"):
 class GreetingsController < ApplicationController
   def index
     example = Rubyx.import('example')
-    render json: { message: example.hello(params[:name]).to_ruby }
+    render json: { message: example.hello(params[:name] || 'World').to_ruby }
   end
 end
 ```
@@ -159,7 +161,7 @@ class TasksController < ApplicationController
     tasks = Rubyx.import('tasks')
 
     # Non-blocking — returns a Future immediately
-    future = Rubyx.async_await(tasks.delayed_greet(params[:name], seconds: 2))
+    future = Rubyx.async_await(tasks.delayed_greet(params[:name] || 'World', seconds: 2))
     do_other_work()
     render json: { message: future.await.to_ruby }
   end
@@ -331,7 +333,29 @@ Rubyx.eval("f'Hello, {name}!'", name: "World").to_ruby # => "Hello, World!"
 Rubyx.eval("max(items)", items: [3, 1, 4, 1, 5]).to_ruby # => 5
 ```
 
-Supports: Integer, Float, String, Symbol, Bool, nil, Array, Hash, and RubyxObject.
+Supports: Integer, Float, String, Symbol, Bool, nil, Array, Hash, binary String (ASCII-8BIT), and RubyxObject.
+
+## Bytes / Binary Data
+
+Python `bytes` and `bytearray` convert to Ruby `String` with `ASCII-8BIT` encoding. Ruby binary strings (`.b`) convert to Python `bytes`:
+
+```ruby
+# Python bytes → Ruby
+Rubyx.eval("b'hello'").to_ruby # => "hello" (ASCII-8BIT)
+Rubyx.eval("bytearray(b'hello')").to_ruby # => "hello" (ASCII-8BIT)
+
+# Ruby → Python
+ctx = Rubyx.context
+ctx.eval("type(data).__name__", data: "hello".b) # => "bytes"
+ctx.eval("type(data).__name__", data: "hello")   # => "str"
+
+# Roundtrip binary data
+ctx.eval("data", data: "\xff\x00\xfe".b).to_ruby # => "\xFF\x00\xFE" (ASCII-8BIT)
+
+# Works with Python stdlib
+ctx.eval("import base64")
+ctx.eval("base64.b64encode(raw)", raw: "Hello".b).to_ruby # => "SGVsbG8=" (ASCII-8BIT)
+```
 
 ## Python Objects
 
@@ -470,6 +494,37 @@ svc.Analyzer([1, 2, 3]).summary.to_ruby # => {"count" => 3, "sum" => 6}
 | `.callable?`             | Check if callable             |
 | `.py_type`               | Python type name              |
 
+## Type Conversion
+
+| Python                | Ruby                         | Notes                  |
+|-----------------------|------------------------------|------------------------|
+| `int`                 | `Integer`                    |                        |
+| `float`               | `Float`                      |                        |
+| `str`                 | `String` (UTF-8)             |                        |
+| `bytes`               | `String` (ASCII-8BIT)        | binary data            |
+| `bytearray`           | `String` (ASCII-8BIT)        | binary data            |
+| `bool`                | `true` / `false`             |                        |
+| `None`                | `nil`                        |                        |
+| `list` / `tuple`      | `Array`                      |                        |
+| `dict`                | `Hash`                       |                        |
+| `set` / `frozenset`   | `Array`                      |                        |
+| everything else       | `RubyxObject`                | proxy to Python object |
+
+**Ruby → Python** (via globals/kwargs):
+
+| Ruby                           | Python      |
+|--------------------------------|-------------|
+| `Integer`                      | `int`       |
+| `Float`                        | `float`     |
+| `String` (UTF-8)               | `str`       |
+| `String` (ASCII-8BIT / `.b`)   | `bytes`     |
+| `true` / `false`               | `bool`      |
+| `nil`                          | `None`      |
+| `Array`                        | `list`      |
+| `Hash`                         | `dict`      |
+| `Symbol`                       | `str`       |
+| `RubyxObject`                  | original    |
+
 ## Requirements
 
 - Ruby >= 3.0

data/ext/rubyx/src/lib.rs

@@ -95,6 +95,7 @@ fn init(ruby: &magnus::Ruby) -> Result<(), magnus::Error> {
     py_object.define_method("truthy?", method!(RubyxObject::is_truthy, 0))?;
     py_object.define_method("falsy?", method!(RubyxObject::is_falsy, 0))?;
     py_object.define_method("callable?", method!(RubyxObject::is_callable, 0))?;
+    py_object.define_method("call", method!(RubyxObject::call, -1))?;
     py_object.define_method("py_type", method!(RubyxObject::py_type, 0))?;
     py_object.define_method("each", method!(RubyxObject::each, 0))?;
     py_object.include_module(ruby.module_enumerable())?;