transfigure 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ab9e53aade4fcebb812cc2cfdbf32d32d46e743e0e8ab92dab8daf92dd3d1313
+  data.tar.gz: 723c3c3b50ab37ecc6da747bdade04b4369482b149e96599b1c2f3f4a2e6caf7
+SHA512:
+  metadata.gz: 2ea20c2106c5f9808ad23979371002685fb92d001fd0abb5e880d884a54612f8b014e014c4fe774530472078b1360dac0c8c3d6c805e0253657dd280b93a9a74
+  data.tar.gz: 2c667b536b40c4511f9b244655249b991ec9f704518e1995ea1f94a783a5d21e2ea484333c92d18776d934208bd0fb7ae7a23ba3d3f3815a66020df63884d918

data/README.md

@@ -0,0 +1,41 @@
+## transfigure
+
+An experimental Ruby native extension that allows changing an object's class at runtime.
+
+## Installation
+
+`gem install transfigure`
+
+## Usage
+
+```ruby
+require 'transfigure'
+```
+
+The transfigure gem adds the `transfigure_into!` method onto Ruby's `Object` class. Pass it another class to switch out the object's current class to another one:
+
+```ruby
+class Foo
+end
+
+class Bar
+end
+
+obj = Foo.new
+obj.is_a?(Foo) # => true
+obj.transfigure_into!(Bar)
+obj.is_a?(Foo) # => false
+obj.is_a?(Bar) # => true
+```
+
+## Requirements
+
+The code has only been tested on MRI (cruby) 3.1 and will definitely not work on other Ruby engines like JRuby or TruffleRuby.
+
+## Running Tests
+
+`bundle exec rspec`
+
+## Authors
+
+* Cameron C. Dutro: http://github.com/camertron

data/ext/transfigure/extconf.rb

@@ -0,0 +1,6 @@
+require 'mkmf'
+
+$CFLAGS << " -O3 "
+$srcs = ["transfigure.c"]
+
+create_makefile("transfigure/transfigure")

data/ext/transfigure/transfigure.c

@@ -0,0 +1,23 @@
+#include "ruby.h"
+
+/* Copy/pasted from rbasic.h. We have to define our own copy of RBasic in order to
+ * remove the const annotation from the klass field, which is (rightly) marked as
+ * const in the original. We then force-cast the original RBasic into TFRBasic,
+ * which removes klass' const-ness. Now that the field is no longer const, it can
+ * be set easily.
+ *
+ * Forgive me father, for I have sinned.
+*/
+struct RUBY_ALIGNAS(SIZEOF_VALUE) TFRBasic {
+    VALUE flags;
+    VALUE klass;
+};
+
+VALUE tf_transfigure_into_bang(VALUE self, VALUE target_klass) {
+    ((struct TFRBasic*)RBASIC(self))->klass = target_klass;
+    return Qnil;
+}
+
+void Init_transfigure() {
+    rb_define_method(rb_cObject, "transfigure_into!", RUBY_METHOD_FUNC(tf_transfigure_into_bang), 1);
+}

data/lib/transfigure/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Transfigure
+  VERSION = "1.0.0"
+end

data/lib/transfigure.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# load native extension
+require "transfigure/transfigure"

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+$:.push(__dir__)
+
+require 'rspec'
+require 'transfigure'
+
+RSpec.configure do |config|
+end

data/spec/transfigure_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+describe "transfigure_into!" do
+  class Foo
+    def identify
+      "foo"
+    end
+  end
+
+  class Bar
+    def identify
+      "bar"
+    end
+  end
+
+  it "dynamically changes the object's class" do
+    obj = Foo.new
+    expect(obj).to be_a(Foo)
+
+    obj.transfigure_into!(Bar)
+    expect(obj).to be_a(Bar)
+  end
+
+  it "ensures the object responds to the new class's methods" do
+    obj = Foo.new
+    expect(obj.identify).to eq("foo")
+
+    obj.transfigure_into!(Bar)
+    expect(obj.identify).to eq("bar")
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: transfigure
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Cameron C. Dutro
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-06-11 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables: []
+extensions:
+- ext/transfigure/extconf.rb
+extra_rdoc_files: []
+files:
+- README.md
+- ext/transfigure/extconf.rb
+- ext/transfigure/transfigure.c
+- lib/transfigure.rb
+- lib/transfigure/transfigure.bundle
+- lib/transfigure/version.rb
+- spec/spec_helper.rb
+- spec/transfigure_spec.rb
+homepage: https://github.com/camertron/transfigure
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.19
+signing_key:
+specification_version: 4
+summary: An experimental Ruby native extension that allows changing an object's class
+  at runtime.
+test_files: []