ruby-llvm 20.1.2 → 21.1.0

data/lib/llvm/core_ffi.rb

@@ -4,7 +4,8 @@ require 'ffi'
 
 module LLVM::C
   extend FFI::Library
-  ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+  ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
 
   # (Not documented)
   #
@@ -2893,33 +2894,6 @@ module LLVM::C
   # @scope class
   attach_function :const_nuw_sub, :LLVMConstNUWSub, [:pointer, :pointer], :pointer
 
-  # (Not documented)
-  #
-  # @method const_mul(lhs_constant, rhs_constant)
-  # @param [FFI::Pointer(ValueRef)] lhs_constant
-  # @param [FFI::Pointer(ValueRef)] rhs_constant
-  # @return [FFI::Pointer(ValueRef)]
-  # @scope class
-  attach_function :const_mul, :LLVMConstMul, [:pointer, :pointer], :pointer
-
-  # (Not documented)
-  #
-  # @method const_nsw_mul(lhs_constant, rhs_constant)
-  # @param [FFI::Pointer(ValueRef)] lhs_constant
-  # @param [FFI::Pointer(ValueRef)] rhs_constant
-  # @return [FFI::Pointer(ValueRef)]
-  # @scope class
-  attach_function :const_nsw_mul, :LLVMConstNSWMul, [:pointer, :pointer], :pointer
-
-  # (Not documented)
-  #
-  # @method const_nuw_mul(lhs_constant, rhs_constant)
-  # @param [FFI::Pointer(ValueRef)] lhs_constant
-  # @param [FFI::Pointer(ValueRef)] rhs_constant
-  # @return [FFI::Pointer(ValueRef)]
-  # @scope class
-  attach_function :const_nuw_mul, :LLVMConstNUWMul, [:pointer, :pointer], :pointer
-
   # (Not documented)
   #
   # @method const_xor(lhs_constant, rhs_constant)

data/lib/llvm/execution_engine.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'
@@ -62,7 +63,9 @@ module LLVM
     # GenericValues).
     # Important: Call #dispose on the returned GenericValue to
     # free backend memory after use.
+    #: (LLVM::Function, *untyped) -> GenericValue?
     def run_function(fun, *args)
+      result = nil #: GenericValue?
       FFI::MemoryPointer.new(FFI.type_size(:pointer) * args.size) do |args_ptr|
         new_values = []
         args_ptr.write_array_of_pointer(fun.params.zip(args).map do |p, a|
@@ -74,11 +77,14 @@ module LLVM
             value
           end
         end)
-        result = LLVM::GenericValue.from_ptr(
-          C.run_function(self, fun, args.size, args_ptr))
+        result = begin
+          LLVM::GenericValue.from_ptr(C.send(:run_function, self, fun, args.size, args_ptr))
+        rescue ArgumentError
+          nil
+        end
         new_values.each(&:dispose)
-        return result
       end
+      result
     end
 
     # Obtain an FFI::Pointer to a global within the current module.
@@ -211,16 +217,20 @@ module LLVM
       end
     end
 
+    #: (Function, *untyped) -> GenericValue?
     def run_function(fun, *args)
       args2 = fun.params.map {|e| convert_type(e.type)}
       ptr = FFI::Pointer.new(function_address(fun.name))
       raise "Couldn't find function" if ptr.null?
 
       return_type = convert_type(fun.function_type.return_type)
-      f = FFI::Function.new(return_type, args2, ptr)
+      f = FFI::Function.new(return_type, args2, ptr) #: as untyped
       ret1 = f.call(*args)
-      ret2 = LLVM.make_generic_value(fun.function_type.return_type, ret1)
-      ret2
+      begin
+        LLVM.make_generic_value(fun.function_type.return_type, ret1)
+      rescue ArgumentError
+        nil
+      end
     end
 
     protected
@@ -248,13 +258,15 @@ module LLVM
     end
 
     # Casts an FFI::Pointer pointing to a GenericValue to an instance.
+    #: (FFI::Pointer?) -> GenericValue?
     def self.from_ptr(ptr)
-      return if ptr.null?
+      return if ptr.nil? || ptr.null?
       val = allocate
       val.instance_variable_set(:@ptr, ptr)
       val
     end
 
+    #: -> void
     def dispose
       return if @ptr.nil?
       C.dispose_generic_value(@ptr)
@@ -263,22 +275,26 @@ module LLVM
 
     # Creates a Generic Value from an integer. Type is the size of integer to
     # create (ex. Int32, Int8, etc.)
+    #: (Numeric, ?Hash[untyped, untyped]) -> GenericValue
     def self.from_i(i, options = {})
       type   = options.fetch(:type, LLVM::Int)
       signed = options.fetch(:signed, true)
-      from_ptr(C.create_generic_value_of_int(type, i, signed ? 1 : 0))
+      from_ptr(C.create_generic_value_of_int(type, i.to_i, signed ? 1 : 0)) #: as !nil
     end
 
     # Creates a Generic Value from a Float.
+    #: (Numeric) -> GenericValue
     def self.from_f(f)
-      from_ptr(C.create_generic_value_of_float(LLVM::Float, f))
+      from_ptr(C.create_generic_value_of_float(LLVM::Float, f.to_f)) #: as !nil
     end
 
+    #: (Numeric) -> GenericValue
     def self.from_d(val)
-      from_ptr(C.create_generic_value_of_float(LLVM::Double, val))
+      from_ptr(C.create_generic_value_of_float(LLVM::Double, val.to_f)) #: as !nil
     end
 
     # Creates a GenericValue from a Ruby boolean.
+    #: (bool) -> GenericValue
     def self.from_b(b)
       from_i(b ? 1 : 0, type: LLVM::Int1, signed: false)
     end
@@ -289,6 +305,7 @@ module LLVM
     end
 
     # Converts a GenericValue to a Ruby Integer.
+    #: (?bool) -> Integer
     def to_i(signed = true)
       v = C.generic_value_to_int(self, signed ? 1 : 0)
       v -= 2**64 if signed and v >= 2**63
@@ -296,11 +313,19 @@ module LLVM
     end
 
     # Converts a GenericValue to a Ruby Float.
+    #: (?LLVM::Type) -> ::Float
     def to_f(type = LLVM::Float.type)
       C.generic_value_to_float(type, self)
     end
 
+    # Converts a GenericValue to a Ruby Float.
+    #: -> ::Float
+    def to_d
+      C.generic_value_to_float(LLVM.double, self)
+    end
+
     # Converts a GenericValue to a Ruby boolean.
+    #: -> bool
     def to_b
       to_i(false) != 0
     end
@@ -311,6 +336,7 @@ module LLVM
   end
 
   # @private
+  #: (LLVM::Type, untyped) -> GenericValue
   def make_generic_value(ty, val)
     case ty.kind
     when :double  then GenericValue.from_d(val)
@@ -318,7 +344,7 @@ module LLVM
     when :pointer then GenericValue.from_value_ptr(val)
     when :integer then GenericValue.from_i(val, :type => ty)
     else
-      raise "Unsupported type #{ty.kind}."
+      raise ArgumentError, "Unsupported type #{ty.kind}."
     end
   end
   module_function :make_generic_value

data/lib/llvm/execution_engine_ffi.rb

@@ -4,7 +4,8 @@ require 'ffi'
 
 module LLVM::C
   extend FFI::Library
-  ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+  ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
   # @defgroup LLVMCExecutionEngine Execution Engine
   # @ingroup LLVMC
   #

data/lib/llvm/linker.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: strict
 
 require 'llvm'
 require 'llvm/core'
@@ -9,6 +10,7 @@ module LLVM
     # Link the current module into +other+.
     #
     # @return [nil, String] human-readable error if linking has failed
+    #: (LLVM::Module) -> String?
     def link_into(other)
       LLVM.with_message_output do |msg|
         C.link_modules2(other, self)

data/lib/llvm/linker_ffi.rb

@@ -4,7 +4,8 @@ require 'ffi'
 
 module LLVM::C
   extend FFI::Library
-  ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+  ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
   # This enum is provided for backwards-compatibility only. It has no effect.
   #
   # <em>This entry is only for documentation and no real method. The FFI::Enum can be accessed via #enum_type(:linker_mode).</em>

data/lib/llvm/lljit.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm/core'
 
@@ -45,8 +46,9 @@ module LLVM
 
     module C
       extend FFI::Library
+
       ffi_lib_flags(:lazy, :global)
-      ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+      ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
       attach_function :create_lljit_builder, :LLVMOrcCreateLLJITBuilder, [], :pointer
       attach_function :dispose_lljit_builder, :LLVMOrcDisposeLLJITBuilder, [:pointer], :void
 

data/lib/llvm/pass_builder.rb

@@ -1,9 +1,11 @@
 # frozen_string_literal: true
+# typed: true
 
 module LLVM
   class PassBuilder # rubocop:disable Metrics/ClassLength
     extend FFI::Library
-    ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+    ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
     attr_reader :passes
     attr_accessor :inliner_threshold, :merge_functions
 
@@ -60,6 +62,7 @@ module LLVM
     end
 
     # @return self
+    #: (String) -> self
     def add_pass(pass)
       passes << pass
       self
@@ -754,6 +757,14 @@ module LLVM
       add_pass('tysan')
     end
 
+    # This optimization is only applied to integer constants in instructions and
+    # simple (this means not nested) constant cast expressions
+    # https://llvm.org/doxygen/ConstantHoisting_8cpp_source.html
+    #: -> self
+    def consthoist!
+      add_pass('consthoist')
+    end
+
     private
 
     attr_writer :passes

data/lib/llvm/support.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm/core_ffi'
 

data/lib/llvm/target.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'
@@ -7,7 +8,9 @@ require 'llvm/target_ffi'
 module LLVM
   # A shorthand for {LLVM::Target.init_native}
   def self.init_jit(*args)
-    LLVM::Target.init_native(*args)
+    LLVM::Target.init_native(
+      *args #: as untyped
+    )
   end
 
   # @deprecated Use LLVM.init_jit or LLVM::Target.init('X86').
@@ -25,11 +28,15 @@ module LLVM
 
     module TargetModule
       extend FFI::Library
-      ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+      ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
+      #: (*untyped) -> void
       def self.safe_attach_function(*args)
-        attach_function(*args)
+        attach_function(
+          *args #: as untyped
+        )
       rescue FFI::NotFoundError => e
-        warn(e)
+        warn(e.message)
       end
     end
 
@@ -113,6 +120,7 @@ module LLVM
     include PointerIdentity
 
     # @private
+    #: (FFI::Pointer) -> Target
     def self.from_ptr(ptr)
       target = allocate
       target.instance_variable_set :@ptr, ptr
@@ -275,8 +283,9 @@ module LLVM
     # Returns the integer type that is the same size as a pointer on a target.
     #
     # @param [Integer] addr_space address space number
-    def int_ptr_type(addr_space = 0)
-      Type.from_ptr(C.int_ptr_type_for_as(self, addr_space), :integer)
+    # (?address_space: Integer) -> Type
+    def int_ptr_type(address_space: 0)
+      Type.from_ptr(C.int_ptr_type_for_as(self, address_space), kind: :integer)
     end
 
     # Computes the size of a type in bits for a target.

data/lib/llvm/target_ffi.rb

@@ -4,7 +4,8 @@ require 'ffi'
 
 module LLVM::C
   extend FFI::Library
-  ffi_lib ["LLVM-20", "libLLVM-20.so.1", "libLLVM.so.20", "libLLVM.so.20.1"]
+
+  ffi_lib ["LLVM-21", "libLLVM-21.so.1", "libLLVM.so.21", "libLLVM.so.21.1"]
   # (Not documented)
   #
   # <em>This entry is only for documentation and no real method. The FFI::Enum can be accessed via #enum_type(:byte_ordering).</em>

data/lib/llvm/transforms/ipo.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 # Interprocedural optimization (IPO)
 require 'llvm'

data/lib/llvm/transforms/pass_manager_builder.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'

data/lib/llvm/transforms/scalar.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'

data/lib/llvm/transforms/utils.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'

data/lib/llvm/transforms/vectorize.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'llvm'
 require 'llvm/core'

data/lib/llvm/version.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
+# typed: strict
 
 module LLVM
-  LLVM_VERSION = "20"
-  LLVM_REQUIRED_VERSION = "20.1.2"
-  RUBY_LLVM_VERSION = "20.1.2"
+  LLVM_VERSION = "21"
+  LLVM_REQUIRED_VERSION = "21.1.0"
+  RUBY_LLVM_VERSION = "21.1.0"
 end

data/lib/llvm.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: strict
 
 require 'ffi'
 
@@ -9,23 +10,29 @@ module LLVM
   class DeprecationError < StandardError; end
 
   module PointerIdentity
+    attr_reader :ptr #: as FFI::Pointer
+
     # @private
+    #: -> FFI::Pointer
     def to_ptr
-      @ptr
+      ptr #: FFI::Pointer
     end
 
     # Checks if the value is equal to other.
+    #: (untyped) -> bool
     def ==(other)
       other.respond_to?(:to_ptr) &&
-          @ptr == other.to_ptr
+          ptr == other.to_ptr
     end
 
     # Computes hash.
+    #: -> Integer
     def hash
-      @ptr.address.hash
+      ptr.address.hash
     end
 
     # Checks if the value is equivalent to other.
+    #: (untyped) -> bool
     def eql?(other)
       self == other
     end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-llvm
 version: !ruby/object:Gem::Version
-  version: 20.1.2
+  version: 21.1.0
 platform: ruby
 authors:
 - Jesse Johnson
 - Jeremy Voorhis
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -59,20 +58,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: ffi_gen
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -171,6 +156,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: sorbet-static
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tapioca
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.11
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.11
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -194,8 +207,8 @@ executables: []
 extensions:
 - ext/ruby-llvm-support/Rakefile
 extra_rdoc_files:
-- README.md
 - LICENSE
+- README.md
 files:
 - LICENSE
 - README.md
@@ -236,7 +249,6 @@ homepage: http://github.com/ruby-llvm/ruby-llvm
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -244,15 +256,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.9
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: LLVM bindings for Ruby
 test_files: []