rubyx-py 0.2.0-arm64-darwin → 0.2.1-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86d5cf5c52d52664994c76fa7cae53a0403e5f34bc2d772ebe702832b2e3acd7
-  data.tar.gz: d7e7993819adc02bee503790f210746917c6db81b4304d65f12ad84fa1d98140
+  metadata.gz: a3ae1306c44028e00fc740e97698a652a04f9f632ee60f11fe7e342869686d3d
+  data.tar.gz: b5b878d20cc076841a5adf1b20fb0ab9202243c466cf0a29a361d7e23ed452c4
 SHA512:
-  metadata.gz: ddf9c0e08e80cff34c621b72c9c25e3135d4d1e3324457aec776a23b1cc5722068ac5a52abd417e9636fdbcb0dc30a91b2824906bcb5c03ebc2b536b6e0d3032
-  data.tar.gz: 39380e4aad86765816954a47e89af7aba8387dc4d94269901e3edb68c93e69a8c6280e7b15b15ea02452d14415bc165335c2a85a24e01aee20618ae7862930e0
+  metadata.gz: a7149f3120299ddaf8242ef0f1b1ff07f8657c3274b750513a7fc9661ab940fd5c5a545d1bdf1c43acb475d0f56b1a63b1cc9bf2650d8503d4916197e449d752
+  data.tar.gz: 766c75dd79bcea478746ea6b9b982c9d7e5f245b7b768381e38dfb6c09c7058c03a0e05a0013fe218321b107fddf86bbf21f6eee5809597cc14e8bc10fb6460c

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/lib/rubyx/railtie.rb

@@ -14,7 +14,8 @@ module Rubyx
 
     # Register rake tasks
     rake_tasks do
-      load 'rubyx/tasks/rubyx.rake'
+      task_file = File.expand_path('tasks/rubyx.rake', __dir__)
+      load task_file if File.exist?(task_file)
     end
   end
 end

data/lib/rubyx/tasks/rubyx.rake

@@ -0,0 +1,127 @@
+namespace :rubyx do
+  desc 'Initialize Python environment (downloads uv and Python if needed)'
+  task init: :environment do
+    Rubyx::Rails.init!
+    puts '[Rubyx] Python environment initialized successfully.'
+  end
+
+  desc 'Check Python environment health'
+  task check: :environment do
+    puts 'Checking Python environment...'
+    puts
+
+    # Check uv
+    system_uv = `which uv 2>/dev/null`.strip
+    uv_available = !system_uv.empty? && File.exist?(system_uv)
+    puts "uv available: #{uv_available ? "Yes (#{system_uv})" : 'No (will auto-download)'}"
+
+    begin
+      Rubyx::Rails.ensure_initialized!
+      puts 'Python initialized: Yes'
+    rescue => e
+      puts "Python initialized: No (#{e.message})"
+      puts
+      puts 'Run `rake rubyx:init` to initialize.'
+      exit 1
+    end
+
+    begin
+      Rubyx.eval('1 + 1')
+      puts 'Basic eval: OK'
+    rescue => e
+      puts "Basic eval: FAILED (#{e.message})"
+      exit 1
+    end
+
+    begin
+      gen = Rubyx.eval("import sys\niter([sys.version.split()[0]])")
+      version = Rubyx.stream(gen).first
+      puts "Import sys: OK (Python #{version})"
+    rescue => e
+      puts "Import sys: FAILED (#{e.message})"
+      exit 1
+    end
+
+    puts
+    puts 'All checks passed!'
+  end
+
+  desc 'Show Rubyx configuration and status'
+  task status: :environment do
+    config = Rubyx::Rails.configuration
+
+    puts 'Rubyx Status'
+    puts '=' * 40
+
+    puts "Initialized: #{Rubyx::Rails.initialized?}"
+    puts
+
+    puts 'Configuration:'
+    puts "  pyproject_path:    #{config.pyproject_path || '(not set)'}"
+    puts "  pyproject_content: #{config.pyproject_content ? '(inline, %d bytes)' % config.pyproject_content.length : '(not set)'}"
+    puts "  auto_init:         #{config.auto_init}"
+    puts "  force_reinit:      #{config.force_reinit}"
+    puts "  uv_version:        #{config.uv_version}"
+    puts "  debug:             #{config.debug}"
+    puts "  python_paths:      #{config.python_paths.inspect}"
+    puts "  uv_path:           #{config.uv_path || '(auto-download)'}"
+    puts "  uv_args:           #{config.uv_args.inspect}"
+    puts
+
+    if config.pyproject_path
+      exists = File.exist?(config.pyproject_path.to_s)
+      puts "pyproject.toml exists: #{exists}"
+    end
+
+    if config.pyproject_path
+      venv_dir = File.join(File.dirname(config.pyproject_path.to_s), '.venv')
+      puts ".venv exists: #{Dir.exist?(venv_dir)}"
+    end
+
+    system_uv = `which uv 2>/dev/null`.strip
+    puts "System uv: #{!system_uv.empty? ? system_uv : '(not found)'}"
+  end
+
+  desc 'List installed Python packages'
+  task packages: :environment do
+    Rubyx::Rails.ensure_initialized!
+
+    gen = Rubyx.eval(<<~PY)
+      import pkg_resources
+      packages = sorted([f"{d.project_name}=={d.version}" for d in pkg_resources.working_set])
+      iter(packages)
+    PY
+
+    puts 'Installed Python packages:'
+    Rubyx.stream(gen).each { |pkg| puts "  #{pkg}" }
+  rescue => e
+    begin
+      gen = Rubyx.eval(<<~PY)
+        from importlib.metadata import distributions
+        packages = sorted([f"{d.metadata['Name']}=={d.metadata['Version']}" for d in distributions()])
+        iter(packages)
+      PY
+
+      puts 'Installed Python packages:'
+      Rubyx.stream(gen).each { |pkg| puts "  #{pkg}" }
+    rescue => e2
+      puts "Could not list packages: #{e2.message}"
+    end
+  end
+
+  desc 'Clear the Rubyx cache (re-download uv + Python on next init)'
+  task clear_cache: :environment do
+    cache_dir = File.join(
+      ENV.fetch('XDG_CACHE_HOME', File.join(Dir.home, '.cache')),
+      'rubyx'
+    )
+
+    if Dir.exist?(cache_dir)
+      require 'fileutils'
+      FileUtils.rm_rf(cache_dir)
+      puts "[Rubyx] Cache cleared: #{cache_dir}"
+    else
+      puts '[Rubyx] No cache directory found.'
+    end
+  end
+end

data/lib/rubyx/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Rubyx
-  VERSION = "0.2.0".freeze
-end
+  VERSION = "0.2.1".freeze
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubyx-py
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: arm64-darwin
 authors:
 - Naiker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake-compiler
@@ -63,6 +63,7 @@ files:
 - lib/rubyx/error.rb
 - lib/rubyx/rails.rb
 - lib/rubyx/railtie.rb
+- lib/rubyx/tasks/rubyx.rake
 - lib/rubyx/uv.rb
 - lib/rubyx/version.rb
 homepage: https://github.com/yinho999/rubyx