rucy 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ca0dce824c22dfee0f0bcc9e8a593d29a55d793d2e71cda65b5aa0438a1f42a
-  data.tar.gz: 5600a73ce3d2c837f2fec6d3052ece836ce2f11d8035c5192c4193ffced10208
+  metadata.gz: bad5f79df70e83f98dcc1571f7a43a25855b1bde8387063728ac2b9b4beeacde
+  data.tar.gz: 233f871a156d7391412515bb7f40c0f813489cf9c920a0a7d594bcd0a7ee0e79
 SHA512:
-  metadata.gz: 38794541c07f9ea75e4616a572c225427eca8ff86ea70bcd19e53114040bd270cf441e0d984fa876461de189ffb0baaa25f7e17e9a66530cadeef919c991acdd
-  data.tar.gz: d41b2ec54cbb56fbd6ba86294bba9e20a63ccf3bc94078662489d4e42137a8f5f8ceda6688477a809583e14e9fe17db181e07f65be8a31e85b876ea32689cc73
+  metadata.gz: 378c52e7c4e79fac2e80f0b7a0c3d60fd9ee908dd4338343e64ba82cd1b7127faf98eede21d355b0067f01325b2e38028eee012c3c41ca3d55cc09171db71a70
+  data.tar.gz: a204c450f186c05448ae3ffc1c15415d28fa4458ea6378d1b1f00fc93d50642ae80d202348ef27ab4dccdb40da48dfed2798abcc6c238d7e63bc67f750e673ec

data/.doc/ext/rucy/class.cpp

@@ -49,7 +49,7 @@ class RubyBase : public ClassWrapper<T>
 
 #define THIS(type)     to<type*>(self)
 
-#define CHECK(type)    RUCY_CHECK_OBJ(type, self)
+#define CHECK(type)    RUCY_CHECK_PTR(type, self)
 
 #define CALL(obj, fun) RUCY_CALL_SUPER(obj, fun)
 
@@ -97,6 +97,38 @@ VALUE base_new_raw(VALUE self)
 	return value(new Base);
 }
 
+static Base* base_raw_ref = NULL;
+
+static
+VALUE base_set_raw_ref(VALUE self, VALUE obj)
+{
+	if (base_raw_ref)
+		invalid_state_error(__FILE__, __LINE__);
+
+	// holds the c++ object without holding the ruby one, like a native handle
+	// that retains before the wrapper is set up
+	base_raw_ref = to<Base*>(obj);
+	base_raw_ref->Xot::RefCountable<>::retain();
+	return obj;
+}
+
+static
+VALUE base_clear_raw_ref(VALUE self)
+{
+	if (base_raw_ref)
+		base_raw_ref->Xot::RefCountable<>::release();
+	base_raw_ref = NULL;
+}
+
+static
+VALUE base_call_raw_ref_name_overridable(VALUE self)
+{
+	if (!base_raw_ref)
+		invalid_state_error(__FILE__, __LINE__);
+
+	return value(base_raw_ref->name_overridable());
+}
+
 
 /*
 	alloc function.
@@ -168,6 +200,9 @@ Init_class ()
 	rb_define_method(cBase, "call_name", RUBY_METHOD_FUNC(call_name), 0);
 	rb_define_method(cBase, "call_name_overridable", RUBY_METHOD_FUNC(call_name_overridable), 0);
 	rb_define_singleton_method(cBase, "new_raw", RUBY_METHOD_FUNC(base_new_raw), 0);
+	rb_define_singleton_method(cBase, "set_raw_ref", RUBY_METHOD_FUNC(base_set_raw_ref), 1);
+	rb_define_singleton_method(cBase, "clear_raw_ref", RUBY_METHOD_FUNC(base_clear_raw_ref), 0);
+	rb_define_singleton_method(cBase, "call_raw_ref_name_overridable", RUBY_METHOD_FUNC(base_call_raw_ref_name_overridable), 0);
 
 	cSub = rb_define_class_under(mTester, "Sub", cBase);
 	rb_define_alloc_func(cSub, sub_alloc);

data/.doc/ext/rucy/exception.cpp

@@ -1,6 +1,15 @@
 #include "defs.h"
 
 
+#ifdef OSX
+	#include <objc/runtime.h>
+	#include <objc/message.h>
+	#include <objc/objc-exception.h>
+	#include <CoreFoundation/CoreFoundation.h>
+	#undef nil// hides Rucy::nil()
+#endif
+
+
 using namespace Rucy;
 
 
@@ -81,6 +90,25 @@ VALUE throw_cstring(VALUE self)
 	throw "cstring";
 }
 
+#ifdef OSX
+/*
+	throw NSException. this file is c++, so go through the objc runtime.
+*/
+static
+VALUE throw_objc_exception(VALUE self)
+{
+	typedef id (*Fun) (id, SEL, id, id, id);
+
+	CFStringRef name   = CFSTR("TesterException");
+	CFStringRef reason = CFSTR("throw_objc_exception");
+	id exception       = ((Fun) objc_msgSend)(
+		(id) objc_getClass("NSException"),
+		sel_registerName("exceptionWithName:reason:userInfo:"),
+		(id) name, (id) reason, NULL);
+	objc_exception_throw(exception);
+}
+#endif
+
 
 void
 Init_exception ()
@@ -96,4 +124,7 @@ Init_exception ()
 	rb_define_method(mTester, "throw_custom_exception", RUBY_METHOD_FUNC(throw_custom_exception), 0);
 	rb_define_method(mTester, "throw_std_string", RUBY_METHOD_FUNC(throw_std_string), 0);
 	rb_define_method(mTester, "throw_cstring", RUBY_METHOD_FUNC(throw_cstring), 0);
+#ifdef OSX
+	rb_define_method(mTester, "throw_objc_exception", RUBY_METHOD_FUNC(throw_objc_exception), 0);
+#endif
 }

data/.doc/ext/rucy/tester.cpp

@@ -23,9 +23,9 @@ log (const char* str)
 */
 VALUE all_logs(VALUE self)
 {
-	std::vector<Value> a;
-	for (size_t i = 0; i < logs.size(); ++i) a.push_back(logs[i].c_str());
-	return array(&a[0], a.size());
+	Value a = array(NULL, logs.size());
+	for (size_t i = 0; i < logs.size(); ++i) a.push(logs[i].c_str());
+	return a;
 }
 
 /*

data/.doc/ext/rucy/value.cpp

@@ -5,9 +5,9 @@ using namespace Rucy;
 
 
 static
-VALUE value_to_char(VALUE self, VALUE num)
+VALUE value_to_schar(VALUE self, VALUE num)
 {
-	return value(to<char>(num));
+	return value(to<signed char>(num));
 }
 
 static
@@ -97,6 +97,19 @@ VALUE array_value(VALUE self)
 	}
 }
 
+static
+VALUE value_is_frozen(VALUE self, VALUE obj)
+{
+	return value(obj.is_frozen());
+}
+
+static
+VALUE value_check_frozen(VALUE self, VALUE obj)
+{
+	obj.check_frozen();
+	return obj;
+}
+
 
 void
 Init_value ()
@@ -104,7 +117,7 @@ Init_value ()
 	Module mRucy = rb_define_module("Rucy");
 	Module mTester = rb_define_module_under(mRucy, "Tester");
 
-	rb_define_method(mTester, "value_to_char", RUBY_METHOD_FUNC(value_to_char), 1);
+	rb_define_method(mTester, "value_to_schar", RUBY_METHOD_FUNC(value_to_schar), 1);
 	rb_define_method(mTester, "value_to_uchar", RUBY_METHOD_FUNC(value_to_uchar), 1);
 	rb_define_method(mTester, "value_to_short", RUBY_METHOD_FUNC(value_to_short), 1);
 	rb_define_method(mTester, "value_to_ushort", RUBY_METHOD_FUNC(value_to_ushort), 1);
@@ -119,4 +132,7 @@ Init_value ()
 
 	rb_define_method(mTester, "nil_value", RUBY_METHOD_FUNC(nil_value), -1);
 	rb_define_method(mTester, "array_value", RUBY_METHOD_FUNC(array_value), -1);
+
+	rb_define_method(mTester, "value_is_frozen", RUBY_METHOD_FUNC(value_is_frozen), 1);
+	rb_define_method(mTester, "value_check_frozen", RUBY_METHOD_FUNC(value_check_frozen), 1);
 }

data/.github/workflows/release-gem.yml

@@ -9,52 +9,5 @@ permissions:
 
 jobs:
   release:
-    runs-on: macos-latest
-
-    steps:
-      - name: ruby 3.2
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.2
-
-      - name: checkout
-        uses: actions/checkout@v4
-
-      - name: setup gems
-        run: bundle install
-
-      - name: setup dependencies
-        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
-
-      - name: packages
-        run: bundle exec rake packages
-
-      - name: setup zig
-        if: github.event.repository.name == 'reflex-terminal'
-        uses: mlugg/setup-zig@v2
-        with:
-          version: 0.16.0
-
-      - name: test
-        run: bundle exec rake test
-
-      - name: create gem
-        id: gem
-        run: |
-          bundle exec rake gem
-          echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
-
-      - name: create github release
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
-
-      - name: upload to rubygems
-        env:
-          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_AUTH_TOKEN }}
-        run: |
-          mkdir -p $HOME/.gem
-          touch $HOME/.gem/credentials
-          chmod 0600 $HOME/.gem/credentials
-          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
-          bundle exec rake upload
+    uses: xord/xot/.github/workflows/release-gem.yml@master
+    secrets: inherit

data/.github/workflows/tag.yml

@@ -1,35 +1,12 @@
 name: Tag
 
 on:
-  push:
+  workflow_run:
+    workflows: [Test]
+    types: [completed]
     branches: [master]
 
 jobs:
   tag:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: ruby 3.2
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.2
-
-      - name: checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.PAT }}
-
-      - name: setup dependencies
-        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies only: :xot'"
-
-      - name: setup user name and email
-        run: |
-          git config --global user.email "xordog@gmail.com"
-          git config --global user.name "xord"
-
-      - name: tag versions
-        run: "ruby -I.github/workflows -rutils -e 'tag_versions'"
-
-      - name: push tags
-        run: git push origin --tags
+    uses: xord/xot/.github/workflows/tag.yml@master
+    secrets: inherit

data/.github/workflows/test.yml

@@ -7,40 +7,4 @@ on:
 
 jobs:
   test:
-    runs-on: macos-latest
-
-    steps:
-      - name: ruby 3.2
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.2
-
-      - name: checkout
-        uses: actions/checkout@v4
-
-      - name: setup gems
-        run: bundle install
-
-      - name: setup dependencies
-        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
-
-      - name: packages
-        run: bundle exec rake verbose packages
-
-      - name: setup zig
-        if: github.event.repository.name == 'reflex-terminal'
-        uses: mlugg/setup-zig@v2
-        with:
-          version: 0.16.0
-
-      - name: vendor
-        run: bundle exec rake vendor
-
-      - name: lib
-        run: bundle exec rake verbose lib
-
-      - name: ext
-        run: bundle exec rake verbose ext
-
-      - name: test
-        run: bundle exec rake verbose test
+    uses: xord/xot/.github/workflows/test.yml@master

data/ChangeLog.md

@@ -1,6 +1,20 @@
 # rucy ChangeLog
 
 
+## [v0.5.0] - 2026-11-04
+
+- [BREAKING] Rename RUCY_CHECK_OBJ to RUCY_CHECK_PTR and RUCY_CHECK_OBJECT to RUCY_CHECK_OBJ
+- [BREAKING] Take signed char instead of char in value_to
+- [BREAKING] Remove the hint_memory_usage callback
+- Tag the strings handed over from C++ as UTF-8, not as ASCII-8BIT
+- Add Value::freeze, Value::is_frozen and Value::check_frozen
+- Keep a Ruby exception alive while it is thrown and caught in C++
+- Put the name and reason of an Objective-C exception into NativeError
+
+- Fix a crash when a C++ object outlives its Ruby object
+- Fix a crash when the GC runs while an array is made from C++ values
+
+
 ## [v0.4.0] - 2026-08-04
 
 - Add Rucy::yield and route extension block yields through it

data/Gemfile.lock

@@ -1,21 +1,26 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    power_assert (3.0.1)
-    rake (13.3.1)
-    test-unit (3.7.7)
+    power_assert (3.1.0)
+    rake (13.4.2)
+    test-unit (3.7.8)
       power_assert
-    yard (0.9.39)
+    yard (0.9.45)
 
 PLATFORMS
-  arm64-darwin-21
-  arm64-darwin-23
-  arm64-darwin-24
+  ruby
 
 DEPENDENCIES
   rake
   test-unit
   yard
 
+CHECKSUMS
+  bundler (4.0.20) sha256=7978a8ac648767f5e635bc522445b79e80a52b907a39a36c2d8085ed6bc762ae
+  power_assert (3.1.0) sha256=fefe98ed5d3140628138f3f9f9194d6ece01f1320e69700d3c928adca7518251
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  test-unit (3.7.8) sha256=689d1ca53f4d46f678b4e5d68d8e4294f87fc5e8b9238cc4de7c5727e8d65943
+  yard (0.9.45) sha256=52e211493f7cb8a3ebf7e104a25a1e73937a3103092545d34cb88fafebb3dc51
+
 BUNDLED WITH
-   2.4.19
+  4.0.20

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/ext/rucy/class.cpp

@@ -49,7 +49,7 @@ class RubyBase : public ClassWrapper<T>
 
 #define THIS(type)     to<type*>(self)
 
-#define CHECK(type)    RUCY_CHECK_OBJ(type, self)
+#define CHECK(type)    RUCY_CHECK_PTR(type, self)
 
 #define CALL(obj, fun) RUCY_CALL_SUPER(obj, fun)
 
@@ -103,6 +103,41 @@ RUCY_DEF0(base_new_raw)
 }
 RUCY_END
 
+static Base* base_raw_ref = NULL;
+
+static
+RUCY_DEF1(base_set_raw_ref, obj)
+{
+	if (base_raw_ref)
+		invalid_state_error(__FILE__, __LINE__);
+
+	// holds the c++ object without holding the ruby one, like a native handle
+	// that retains before the wrapper is set up
+	base_raw_ref = to<Base*>(obj);
+	base_raw_ref->Xot::RefCountable<>::retain();
+	return obj;
+}
+RUCY_END
+
+static
+RUCY_DEF0(base_clear_raw_ref)
+{
+	if (base_raw_ref)
+		base_raw_ref->Xot::RefCountable<>::release();
+	base_raw_ref = NULL;
+}
+RUCY_END
+
+static
+RUCY_DEF0(base_call_raw_ref_name_overridable)
+{
+	if (!base_raw_ref)
+		invalid_state_error(__FILE__, __LINE__);
+
+	return value(base_raw_ref->name_overridable());
+}
+RUCY_END
+
 
 /*
 	alloc function.
@@ -181,6 +216,10 @@ Init_class ()
 	cBase.define_method("call_name",             call_name);
 	cBase.define_method("call_name_overridable", call_name_overridable);
 	cBase.define_singleton_method("new_raw", base_new_raw);
+	cBase.define_singleton_method("set_raw_ref",   base_set_raw_ref);
+	cBase.define_singleton_method("clear_raw_ref", base_clear_raw_ref);
+	cBase.define_singleton_method(
+		"call_raw_ref_name_overridable", base_call_raw_ref_name_overridable);
 
 	cSub = mTester.define_class("Sub", cBase);
 	cSub.define_alloc_func(sub_alloc);

data/ext/rucy/exception.cpp

@@ -1,6 +1,15 @@
 #include "defs.h"
 
 
+#ifdef OSX
+	#include <objc/runtime.h>
+	#include <objc/message.h>
+	#include <objc/objc-exception.h>
+	#include <CoreFoundation/CoreFoundation.h>
+	#undef nil// hides Rucy::nil()
+#endif
+
+
 using namespace Rucy;
 
 
@@ -89,6 +98,26 @@ RUCY_DEF0(throw_cstring)
 }
 RUCY_END
 
+#ifdef OSX
+/*
+	throw NSException. this file is c++, so go through the objc runtime.
+*/
+static
+RUCY_DEF0(throw_objc_exception)
+{
+	typedef id (*Fun) (id, SEL, id, id, id);
+
+	CFStringRef name   = CFSTR("TesterException");
+	CFStringRef reason = CFSTR("throw_objc_exception");
+	id exception       = ((Fun) objc_msgSend)(
+		(id) objc_getClass("NSException"),
+		sel_registerName("exceptionWithName:reason:userInfo:"),
+		(id) name, (id) reason, NULL);
+	objc_exception_throw(exception);
+}
+RUCY_END
+#endif
+
 
 void
 Init_exception ()
@@ -104,4 +133,7 @@ Init_exception ()
 	mTester.define_method("throw_custom_exception", throw_custom_exception);
 	mTester.define_method("throw_std_string", throw_std_string);
 	mTester.define_method("throw_cstring", throw_cstring);
+#ifdef OSX
+	mTester.define_method("throw_objc_exception", throw_objc_exception);
+#endif
 }

data/ext/rucy/extconf.rb

@@ -10,7 +10,8 @@ require 'rucy/extension'
 
 Xot::ExtConf.new Xot, Rucy do
   setup do
-    headers << 'ruby.h'
+    headers    << 'ruby.h'
+    frameworks << 'Foundation' if osx?
   end
 
   create_makefile 'rucy/tester'

data/ext/rucy/tester.cpp

@@ -23,9 +23,9 @@ log (const char* str)
 */
 RUCY_DEF0(all_logs)
 {
-	std::vector<Value> a;
-	for (size_t i = 0; i < logs.size(); ++i) a.push_back(logs[i].c_str());
-	return array(&a[0], a.size());
+	Value a = array(NULL, logs.size());
+	for (size_t i = 0; i < logs.size(); ++i) a.push(logs[i].c_str());
+	return a;
 }
 RUCY_END
 

data/ext/rucy/value.cpp

@@ -5,9 +5,9 @@ using namespace Rucy;
 
 
 static
-RUCY_DEF1(value_to_char, num)
+RUCY_DEF1(value_to_schar, num)
 {
-	return value(to<char>(num));
+	return value(to<signed char>(num));
 }
 RUCY_END
 
@@ -110,6 +110,21 @@ RUCY_DEFN(array_value)
 }
 RUCY_END
 
+static
+RUCY_DEF1(value_is_frozen, obj)
+{
+	return value(obj.is_frozen());
+}
+RUCY_END
+
+static
+RUCY_DEF1(value_check_frozen, obj)
+{
+	obj.check_frozen();
+	return obj;
+}
+RUCY_END
+
 
 void
 Init_value ()
@@ -117,7 +132,7 @@ Init_value ()
 	Module mRucy   =       define_module("Rucy");
 	Module mTester = mRucy.define_module("Tester");
 
-	mTester.define_method("value_to_char",   value_to_char);
+	mTester.define_method("value_to_schar",  value_to_schar);
 	mTester.define_method("value_to_uchar",  value_to_uchar);
 	mTester.define_method("value_to_short",  value_to_short);
 	mTester.define_method("value_to_ushort", value_to_ushort);
@@ -126,10 +141,13 @@ Init_value ()
 	mTester.define_method("value_to_long",   value_to_long);
 	mTester.define_method("value_to_ulong",  value_to_ulong);
 
-	mTester.define_method("true_to_value", true_to_value);
+	mTester.define_method( "true_to_value",  true_to_value);
 	mTester.define_method("false_to_value", false_to_value);
-	mTester.define_method("null_to_value", NULL_to_value);
+	mTester.define_method( "null_to_value",  NULL_to_value);
 
-	mTester.define_method("nil_value", nil_value);
+	mTester.define_method(  "nil_value",   nil_value);
 	mTester.define_method("array_value", array_value);
+
+	mTester.define_method("value_is_frozen",    value_is_frozen);
+	mTester.define_method("value_check_frozen", value_check_frozen);
 }

data/include/rucy/exception.h

@@ -5,6 +5,7 @@
 
 
 #include <stdexcept>
+#include <exception>
 #include <xot/exception.h>
 #include <rucy/value.h>
 
@@ -30,7 +31,7 @@ namespace Rucy
 
 		private:
 
-			/*Global*/Value val;
+			GlobalValue val;
 
 	};// RubyException
 
@@ -98,6 +99,9 @@ namespace Rucy
 		const char* file, int line, const char* format = NULL, ...);
 
 
+	Xot::String get_unknown_exception_message (std::exception_ptr exception);
+
+
 }// Rucy
 
 

data/include/rucy/extension.h.erb

@@ -256,7 +256,8 @@
 	catch (...) \
 	{ \
 		RUCY_GOTO_RAISE(rb_exc_new2( \
-			Rucy::native_error_class(), "Unknown C++ exception was thrown.")); \
+			Rucy::native_error_class(), \
+			Rucy::get_unknown_exception_message(std::current_exception()).c_str())); \
 	}
 
 #define RUCY_GOTO_RAISE(exception) \
@@ -290,7 +291,7 @@
 	}
 
 
-#define RUCY_CHECK_OBJ(native_class, obj) \
+#define RUCY_CHECK_PTR(native_class, obj) \
 	do \
 	{ \
 		native_class* p = \
@@ -299,7 +300,7 @@
 	} \
 	while(0)
 
-#define RUCY_CHECK_OBJECT(native_class, obj) \
+#define RUCY_CHECK_OBJ(native_class, obj) \
 	do \
 	{ \
 		native_class* p = \
@@ -338,7 +339,7 @@ namespace Rucy
 
 		public:
 
-			GlobalValue value;
+			mutable GlobalValue value;
 
 			ClassWrapper ()
 			:	value(nil(), true), overridable(true)
@@ -353,7 +354,10 @@ namespace Rucy
 
 			void release (intptr_t by_ruby) const override
 			{
-				if (!by_ruby) value.enable_gc();
+				if (by_ruby)
+					value = nil();
+				else
+					value.enable_gc();
 				RucyWrapped::release();
 			}
 
@@ -496,7 +500,7 @@ namespace Rucy
 	static
 	RUCY_DEF1(wrapper_equal, other)
 	{
-		RUCY_CHECK_OBJ(T, self);
+		RUCY_CHECK_PTR(T, self);
 		if (!other.is_a(get_ruby_class<T>()))
 			return value(false);
 		return value(get_type_ptr<T>(self) == get_type_ptr<T>(other));
@@ -507,7 +511,7 @@ namespace Rucy
 	static
 	RUCY_DEF0(wrapper_hash)
 	{
-		RUCY_CHECK_OBJ(T, self);
+		RUCY_CHECK_PTR(T, self);
 		return value((unsigned long long) get_type_ptr<T>(self));
 	}
 	RUCY_DEF_END

data/include/rucy/value.h.erb

@@ -4,7 +4,8 @@
 #define __RUCY_VALUE_H__
 
 
-#include <vector>
+#include <iterator>
+#include <type_traits>
 #include <rucy/ruby.h>
 #include <rucy/symbol.h>
 
@@ -111,6 +112,12 @@ namespace Rucy
 
 			bool respond_to (Symbol name) const;
 
+			Value      freeze ();
+
+			bool    is_frozen () const;
+
+			void check_frozen () const;
+
 			Value inspect () const;
 
 			// String
@@ -199,6 +206,8 @@ namespace Rucy
 
 			GlobalValue (const This& obj, bool gc = false);
 
+			GlobalValue& operator = (const RubyValue& v);
+
 			GlobalValue& operator = (const Value& v);
 
 			GlobalValue& operator = (const This& obj);
@@ -224,6 +233,8 @@ namespace Rucy
 
 	Value value (         char n);
 
+	Value value (  signed char n);
+
 	Value value (unsigned char n);
 
 	Value value (         short n);
@@ -264,8 +275,13 @@ namespace Rucy
 			std::input_iterator_tag
 		>::value>::type* = nullptr)
 	{
-		std::vector<Value> v(begin, end);
-		return array(&v[0], v.size());
+		size_t size = 0;
+		if constexpr (std::sized_sentinel_for<T, T>)
+			size = end - begin;
+
+		Value ary = array(NULL, size);
+		for (T it = begin; it != end; ++it) ary.push(*it);
+		return ary;
 	}
 
 
@@ -293,6 +309,10 @@ namespace Rucy
 	}
 
 
+	// the range of char changes with the platform, so use signed or unsigned char
+	template <> char value_to<char> (Value obj, bool convert) = delete;
+
+
 }// Rucy
 
 

data/rucy.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
 
   ext   = Rucy::Extension
   name  = ext.name true
-  rdocs = glob.call *%w[README .doc/ext/**/*.cpp]
+  rdocs = glob.call(*%w[README .doc/ext/**/*.cpp])
 
   s.name        = name
   s.version     = ext.version
@@ -25,7 +25,7 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot', '~> 0.4.0'
+  s.add_dependency 'xot', '~> 0.5.0'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}

data/src/exception.cpp

@@ -144,4 +144,18 @@ namespace Rucy
 	}
 
 
+	Xot::String
+	get_unknown_exception_message (std::exception_ptr exception)
+	{
+#if defined(OSX) || defined(IOS)
+		Xot::String get_native_unknown_exception_message (std::exception_ptr);
+		Xot::String message = get_native_unknown_exception_message(exception);
+		if (!message.empty())
+			return message;
+#endif
+
+		return "Unknown C++ exception was thrown.";
+	}
+
+
 }// Rucy

data/src/ios/exception.mm

@@ -0,0 +1,2 @@
+// -*- objc -*-
+#include "../osx/exception.mm"

data/src/osx/exception.mm

@@ -0,0 +1,31 @@
+// -*- objc -*-
+#include "rucy/exception.h"
+
+
+#import <Foundation/Foundation.h>
+
+
+namespace Rucy
+{
+
+
+	Xot::String
+	get_native_unknown_exception_message (std::exception_ptr exception)
+	{
+		try
+		{
+			std::rethrow_exception(exception);
+		}
+		catch (NSException* e)
+		{
+			return Xot::stringf(
+				"%s: %s", e.name.UTF8String, e.reason ? e.reason.UTF8String : "");
+		}
+		catch (...)
+		{
+			return "";
+		}
+	}
+
+
+}// Rucy

data/src/rucy.cpp

@@ -2,7 +2,6 @@
 #include "rucy/rucy.h"
 
 
-#include <xot/util.h>
 #include "rucy/exception.h"
 
 
@@ -10,18 +9,6 @@ namespace Rucy
 {
 
 
-	static void
-	hint_memory_usage (ssize_t size)
-	{
-		rb_gc_adjust_memory_usage(size);
-
-		// rb_gc_adjust_memory_usage() uses MEMOP_TYPE_REALLOC internally,
-		// which increases malloc_increase but does not check the GC trigger.
-		// A tiny ruby_xmalloc() goes through MEMOP_TYPE_MALLOC and triggers
-		// GC when malloc_increase exceeds malloc_limit.
-		if (size > 0) ruby_xfree(ruby_xmalloc(1));
-	}
-
 	void
 	init ()
 	{
@@ -29,8 +16,6 @@ namespace Rucy
 		if (done) return;
 		done = true;
 
-		Xot::set_hint_memory_usage_fun(hint_memory_usage);
-
 		rucy_module();
 		native_error_class();
 		invalid_state_error_class();

data/src/value.cpp.erb

@@ -58,15 +58,13 @@ namespace Rucy
 	static VALUE
 	str_new (const char* s, rb_encoding* encoding)
 	{
-		rb_encoding* e = encoding ? encoding : rb_default_internal_encoding();
-		return e ? rb_enc_str_new_cstr(s, e) : rb_str_new_cstr(s);
+		return rb_enc_str_new_cstr(s, encoding ? encoding : rb_utf8_encoding());
 	}
 
 	static VALUE
 	str_new (const char* s, size_t len, rb_encoding* encoding)
 	{
-		rb_encoding* e = encoding ? encoding : rb_default_internal_encoding();
-		return e ? rb_enc_str_new(s, len, e) : rb_str_new(s, len);
+		return rb_enc_str_new(s, len, encoding ? encoding : rb_utf8_encoding());
 	}
 
 	Value::Value (const char* s, rb_encoding* encoding)
@@ -314,6 +312,24 @@ namespace Rucy
 		return rb_respond_to(val, name.symbol());
 	}
 
+	Value
+	Value::freeze ()
+	{
+		return rb_obj_freeze(val);
+	}
+
+	bool
+	Value::is_frozen () const
+	{
+		return RB_OBJ_FROZEN(val);
+	}
+
+	void
+	Value::check_frozen () const
+	{
+		rb_check_frozen(val);
+	}
+
 	Value
 	Value::inspect () const
 	{
@@ -492,6 +508,13 @@ namespace Rucy
 		init(gc_);
 	}
 
+	GlobalValue&
+	GlobalValue::operator = (const RubyValue& v)
+	{
+		Super::operator=(v);
+		return *this;
+	}
+
 	GlobalValue&
 	GlobalValue::operator = (const Value& v)
 	{
@@ -552,6 +575,12 @@ namespace Rucy
 		return (int) n;
 	}
 
+	Value
+	value (signed char n)
+	{
+		return (int) n;
+	}
+
 	Value
 	value (unsigned char n)
 	{
@@ -652,18 +681,18 @@ namespace Rucy
 		return (bool) obj;
 	}
 
-	template <> char
-	value_to<char> (Value obj, bool convert)
+	template <> signed char
+	value_to<signed char> (Value obj, bool convert)
 	{
 		if (convert) obj = obj.to_i();
 		int n = NUM2INT(obj.value());
 		if (
-			n < std::numeric_limits<char>::min() ||
-			n > std::numeric_limits<char>::max())
+			n < std::numeric_limits<signed char>::min() ||
+			n > std::numeric_limits<signed char>::max())
 		{
-			range_error(__FILE__, __LINE__, "cannot cast '%d' to char", n);
+			range_error(__FILE__, __LINE__, "cannot cast '%d' to signed char", n);
 		}
-		return (char) n;
+		return (signed char) n;
 	}
 
 	template <> unsigned char

data/test/test_class.rb

@@ -1,3 +1,4 @@
+require 'weakref'
 require_relative 'helper'
 
 
@@ -130,4 +131,16 @@ class TestClass < Test::Unit::TestCase
     assert_equal '~SimpleObj(2)', last_log(/2/)
   end
 
+  def test_freed_ruby_object_is_not_called()
+    # made on another thread, whose stack is gone with no stale value left
+    ref = Thread.new {WeakRef.new Base.set_raw_ref(Temp.new)}.value
+    3.times {GC.start; break unless ref.weakref_alive?}
+    # the gc scans the stack conservatively, so a stale value can keep it alive
+    omit 'the ruby object was not freed by the gc' if ref.weakref_alive?
+
+    assert_equal "Sub::name_overridable", Base.call_raw_ref_name_overridable
+  ensure
+    Base.clear_raw_ref
+  end
+
 end# TestClass

data/test/test_exception.rb

@@ -33,4 +33,10 @@ class TestException < Test::Unit::TestCase
     assert_raise(Rucy::NativeError) {throw_cstring}
   end
 
+  def test_throw_objc_exception()
+    return unless osx?
+    e = assert_raise(Rucy::NativeError) {throw_objc_exception}
+    assert_match(/TesterException: throw_objc_exception/, e.message)
+  end
+
 end# TestException

data/test/test_value.rb

@@ -5,12 +5,12 @@ class TestFunction < Test::Unit::TestCase
 
   include Rucy::Tester
 
-  def test_value_to_char()
-    assert_equal    0,        value_to_char(   0)
-    assert_equal  127,        value_to_char( 127)
-    assert_raise(RangeError) {value_to_char  128}
-    assert_equal(-128,        value_to_char(-128))
-    assert_raise(RangeError) {value_to_char(-129)}
+  def test_value_to_schar()
+    assert_equal    0,        value_to_schar(   0)
+    assert_equal  127,        value_to_schar( 127)
+    assert_raise(RangeError) {value_to_schar  128}
+    assert_equal(-128,        value_to_schar(-128))
+    assert_raise(RangeError) {value_to_schar(-129)}
   end
 
   def test_value_to_uchar()
@@ -61,4 +61,13 @@ class TestFunction < Test::Unit::TestCase
     assert_raise(ArgumentError) {array_value 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11}
   end
 
+  def test_frozen()
+    assert_false value_is_frozen(+'')
+    assert_true  value_is_frozen( ''.freeze)
+
+    o = Object.new
+    assert_equal o,            value_check_frozen(o)
+    assert_raise(FrozenError) {value_check_frozen o.freeze}
+  end
+
 end# TestFunction

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rucy
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-04 00:00:00.000000000 Z
+date: 2026-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xot
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
 description: This library helps you to develop Ruby Extension by C++.
 email: xordog@gmail.com
 executables:
@@ -48,7 +48,6 @@ files:
 - ".github/workflows/release-gem.yml"
 - ".github/workflows/tag.yml"
 - ".github/workflows/test.yml"
-- ".github/workflows/utils.rb"
 - CLAUDE.md
 - CONTRIBUTING.md
 - ChangeLog.md
@@ -89,7 +88,9 @@ files:
 - src/exception.cpp
 - src/extension.cpp
 - src/function.cpp.erb
+- src/ios/exception.mm
 - src/module.cpp.erb
+- src/osx/exception.mm
 - src/rucy.cpp
 - src/symbol.cpp
 - src/value.cpp.erb
@@ -119,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A Ruby C++ Extension Helper Library.

data/.github/workflows/utils.rb

@@ -1,127 +0,0 @@
-require 'shellwords'
-
-ALL_REPO        = 'xord/all'
-ALL_DIR         = '../all'
-ALL_FETCH_DEPTH = 100
-
-RENAMES = {reflex: 'reflexion'}
-
-def sh(cmd)
-  puts cmd
-  system cmd
-end
-
-def setup_dependencies(only: nil)
-  gemspec_path = `git ls-files`.lines(chomp: true).find {|l| l =~ /\.gemspec$/}
-  return unless gemspec_path
-
-  gemspec = File.read gemspec_path
-  name    = File.basename gemspec_path, '.gemspec'
-
-  exts = File.readlines('Rakefile')
-    .map {|l| l[%r|^\s*require\W+([\w\-\_]+)/extension\W+$|, 1]}
-    .compact
-    .reject {|ext| ext == name}
-  exts = exts & [only].flatten.map(&:to_s) if only
-  return if exts.empty?
-
-  unless setup_dependencies_via_monorepo(exts)
-    setup_dependencies_via_each_repo_by_version(gemspec, exts)
-  end
-
-  exts.each {|ext| sh %( cd ../#{ext} && rake ext )}
-end
-
-def setup_dependencies_via_monorepo(exts)
-  return false unless checkout_monorepo
-  exts.each {|ext| sh %( ln -snf all/#{ext} ../#{ext} )}
-  true
-end
-
-def checkout_monorepo()
-  uuid = `git log -1 --format=%B`[/^\[\[([0-9a-fA-F-]+)\]\]$/, 1]
-  return false unless uuid
-
-  commit = setup_monorepo uuid
-  return false unless commit
-
-  Dir.chdir(ALL_DIR) {sh %( git checkout -q #{commit} )}
-  true
-end
-
-def setup_monorepo(uuid)
-  unless File.directory? ALL_DIR
-    url = "https://github.com/#{ALL_REPO}.git"
-    sh %( git clone --no-tags --depth #{ALL_FETCH_DEPTH} #{url} #{ALL_DIR} )
-  end
-  loop do
-    commit = find_monorepo_commit uuid
-    return commit if commit
-
-    deepened = Dir.chdir ALL_DIR do
-      before = `git rev-list --count HEAD`.to_i
-      sh %( git fetch --deepen #{ALL_FETCH_DEPTH} )
-      `git rev-list --count HEAD`.to_i > before
-    end
-    return nil unless deepened
-  end
-end
-
-def find_monorepo_commit(uuid)
-  Dir.chdir ALL_DIR do
-    out = `git log origin/HEAD -F --grep="[[#{uuid}]]" --format=%H -1`.strip
-    out.empty? ? nil : out
-  end
-end
-
-def setup_dependencies_via_each_repo_by_version(gemspec, exts)
-  exts.each do |ext|
-    gem   = RENAMES[ext.to_sym].then {|s| s || ext}
-    ver   = gemspec[/add_dependency.*['"]#{gem}['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/, 1]
-    opts  = '-c advice.detachedHead=false --depth 1'
-    clone = "git clone #{opts} https://github.com/xord/#{ext}.git ../#{ext}"
-
-    # 'rake subtree:push' pushes all subrepos, so cloning by new tag
-    # often fails before tagging each new tag
-    sh %( #{clone} --branch v#{ver} || #{clone} )
-  end
-end
-
-def tag_versions()
-  changes = changelogs
-  tags    = `git tag`.lines chomp: true
-  vers    = `git log --oneline ./VERSION`
-    .lines(chomp: true)
-    .map {|line| line.split.first[/^\w+$/]}
-    .map {|sha| [`git cat-file -p #{sha}:./VERSION 2>/dev/null`[/[\d\.]+/], sha]}
-    .select {|ver, sha| ver && sha}
-    .reverse
-    .to_h
-
-  vers.to_a.reverse.each do |ver, sha|
-    tag = "v#{ver}"
-    break if tags.include?(tag)
-    sh %( git tag -a -m \"#{changes[tag]&.gsub '"', '\\"'}\" #{tag} #{sha} )
-  end
-end
-
-def release(*paths)
-  tag   = ENV['GITHUB_REF']&.sub(%r|^refs/tags/|, '') || raise('GITHUB_REF tag not set')
-  notes = (changelogs[tag] || '').shellescape
-  paths = paths.flatten.join ' '
-
-  sh(%( gh release create #{tag} #{paths} --notes #{notes} )) ||
-    sh(%( gh release upload #{tag} #{paths} --clobber )) ||
-    raise('failed to upload to releases')
-end
-
-def changelogs()
-  File.read('ChangeLog.md')
-    .split(/^\s*##\s*\[\s*(v[\d\.]+)\s*\].*$/)
-    .slice(1..)
-    .each_slice(2)
-    .to_h
-    .transform_values(&:strip!)
-rescue Errno::ENOENT
-  raise 'failed to get changelogs'
-end