ffi-clang 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f3fba953ec692d348f92786e6892450d93011103
-  data.tar.gz: 4e1b34caa60d2d0a577471d419170f998e1d5451
+SHA256:
+  metadata.gz: 371454aeb7550fde909b4e944d5371e8c56a3b07551fb4321b9761db71c65290
+  data.tar.gz: 95d22ce375a63f2ab4a2881c39b048393297246684af30751ba70e1886957473
 SHA512:
-  metadata.gz: b90f7d9d97dca48869b045e76c3f1c57e6efc390a67c0a07cb95527a85c735f70f22cbf76e9a0745a3233fa9cc388c42efdb1ec0c042583c413335801f376132
-  data.tar.gz: ea69e1a70cb738ae85cbfd86a5de317724054926cdbc2e2bab50aa154497d53104ead7af30d7afb8e84c750f5e40952b2cde388b19f63621c48e2b975adb8239
+  metadata.gz: a89207faa58c1c78a44147d7405f88bce71734c33850f1b171b8f93ddaaaf3610521ad18ccd82ccbc327789bd674ef5aaa912d8bfb855729753eb0a640dc63b7
+  data.tar.gz: 3b8cf9d510d9abc186c4d695db6c6d4d2268f9b0fcfa8b7fd6261d19bf2fed8d052edbde8c5565ea13bd0e05bf61781f1f46a256add91e6e4feb34c8a9298699

data/.editorconfig

@@ -0,0 +1,23 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = false
+indent_style = tab
+
+[{*.{rb,gemspec},Gemfile,Rakefile}]
+indent_size = 2
+
+[*.{c,cc,cpp,cxx,h,hpp,hxx}]
+indent_size = 4
+
+[*.json]
+indent_size = 2
+
+[*.yml]
+indent_size = 2
+
+[*.md]
+indent_size = 4

data/.gitignore

@@ -15,3 +15,5 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+
+.rspec_status

data/Gemfile

@@ -2,12 +2,11 @@ source 'https://rubygems.org'
 
 gemspec
 
-group :development do
-	gem 'transpec'
-	gem 'pry'
+group :maintenance, optional: true do
+	gem "bake-gem"
+	gem "bake-modernize"
 end
 
 group :test do
 	gem 'simplecov'
-	gem 'coveralls', require: false
 end

data/ffi-clang.gemspec

@@ -7,7 +7,6 @@ Gem::Specification.new do |spec|
 	spec.name          = "ffi-clang"
 	spec.version       = FFI::Clang::VERSION
 	spec.authors       = ["Jari Bakken", "Samuel Williams"]
-	spec.email         = ["Jari Bakken", "samuel.williams@oriontransfer.co.nz"]
 	spec.description   = %q{Ruby FFI bindings for libclang C interface.}
 	spec.summary       = %q{Ruby FFI bindings for libclang C interface.}
 	spec.homepage      = ""
@@ -20,7 +19,7 @@ Gem::Specification.new do |spec|
 
 	spec.add_dependency "ffi"
 
-	spec.add_development_dependency "bundler", "~> 1.3"
-	spec.add_development_dependency "rspec", "~> 3.4.0"
+	spec.add_development_dependency "bundler", ">= 1.3"
+	spec.add_development_dependency "rspec", ">= 3.4.0"
 	spec.add_development_dependency "rake"
 end

data/lib/ffi/clang/cursor.rb

@@ -24,6 +24,7 @@ require_relative 'lib/cursor'
 require_relative 'lib/code_completion'
 
 require_relative 'source_location'
+require_relative 'source_range'
 require_relative 'comment'
 require_relative 'type'
 
@@ -251,6 +252,18 @@ module FFI
 				Lib.visit_children(@cursor, adapter, nil)
 			end
 
+			def find_references_in_file(file = nil, &block)
+				file ||= Lib.extract_string Lib.get_translation_unit_spelling(@translation_unit)
+
+				visit_adapter = Proc.new do |unused, cxcursor, cxsource_range|
+					block.call Cursor.new(cxcursor, @translation_unit), SourceRange.new(cxsource_range)
+				end
+				visitor = FFI::Clang::Lib::CXCursorAndRangeVisitor.new
+				visitor[:visit] = visit_adapter
+
+				Lib.find_references_in_file(@cursor, Lib.get_file(@translation_unit, file), visitor)
+			end
+
 			def linkage
 				Lib.get_cursor_linkage(@cursor)
 			end
@@ -381,6 +394,15 @@ module FFI
 				filter.collect{|child, parent| child}
 			end
 
+			def references(file = nil)
+				refs = []
+				self.find_references_in_file(file) do |cursor, unused|
+					refs << cursor
+					:continue
+				end
+				refs
+			end
+
 			class PlatformAvailability < AutoPointer
 				def initialize(memory_pointer)
 					pointer = FFI::Pointer.new(memory_pointer)

data/lib/ffi/clang/lib/cursor.rb

@@ -32,19 +32,24 @@ module FFI
 			enum :cursor_kind, [
 				:cursor_unexposed_decl, 1,
 				:cursor_struct, 2,
+				# :cusor_struct_decl, :cursor_struct
 				:cursor_union, 3,
+				# :cusor_union_decl, :cursor_union
 				:cursor_class_decl, 4,
 				:cursor_enum_decl, 5,
 				:cursor_field_decl, 6,
 				:cursor_enum_constant_decl, 7,
 				:cursor_function, 8,
+				# :cursor_function_decl, :cursor_function,
 				:cursor_variable, 9,
+				# :cursor_var_decl, :cursor_variable,
 				:cursor_parm_decl, 10,
 				:cursor_obj_c_interface_decl, 11,
 				:cursor_obj_c_category_decl, 12,
 				:cursor_obj_c_protocol_decl, 13,
 				:cursor_obj_c_property_decl, 14,
 				:cursor_obj_c_instance_var_decl, 15,
+				# :cursor_obj_c_ivar_decl, :cursor_obj_c_instance_var_decl,
 				:cursor_obj_c_instance_method_decl, 16,
 				:cursor_obj_c_class_method_decl, 17,
 				:cursor_obj_c_implementation_decl, 18,
@@ -69,6 +74,9 @@ module FFI
 				:cursor_obj_c_synthesize_decl, 37,
 				:cursor_obj_c_dynamic_decl, 38,
 				:cursor_cxx_access_specifier, 39,
+				# :cursor_first_decl, :cursor_unexposed_decl,
+				# :cursor_last_decl, :cursor_cxx_access_specifier,
+				:cursor_first_ref, 40,
 				:cursor_obj_c_super_class_ref, 40,
 				:cursor_obj_c_protocol_ref, 41,
 				:cursor_obj_c_class_ref, 42,
@@ -80,10 +88,14 @@ module FFI
 				:cursor_label_ref, 48,
 				:cursor_overloaded_decl_ref, 49,
 				:cursor_variable_ref, 50,
+				# :cursor_last_ref, :cursor_variable_ref,
+				:cursor_first_invalid, 70,
 				:cursor_invalid_file, 70,
 				:cursor_no_decl_found, 71,
 				:cursor_not_implemented, 72,
 				:cursor_invalid_code, 73,
+				# :cursor_last_invalid, :cursor_invalid_code,
+				:cursor_first_expr, 100,
 				:cursor_unexposed_expr, 100,
 				:cursor_decl_ref_expr, 101,
 				:cursor_member_ref_expr, 102,
@@ -113,25 +125,33 @@ module FFI
 				:cursor_cxx_reinterpret_cast_expr, 126,
 				:cursor_cxx_const_cast_expr, 127,
 				:cursor_cxx_functional_cast_expr, 128,
-				:cursor_cxx_typeid_expr, 129,
-				:cursor_cxx_bool_literal_expr, 130,
-				:cursor_cxx_null_ptr_literal_expr, 131,
-				:cursor_cxx_this_expr, 132,
-				:cursor_cxx_throw_expr, 133,
-				:cursor_cxx_new_expr, 134,
-				:cursor_cxx_delete_expr, 135,
-				:cursor_unary_expr, 136,
-				:cursor_obj_c_string_literal, 137,
-				:cursor_obj_c_encode_expr, 138,
-				:cursor_obj_c_selector_expr, 139,
-				:cursor_obj_c_protocol_expr, 140,
-				:cursor_obj_c_bridged_cast_expr, 141,
-				:cursor_pack_expansion_expr, 142,
-				:cursor_size_of_pack_expr, 143,
-				:cursor_lambda_expr, 144,
-				:cursor_obj_c_bool_literal_expr, 145,
-				:cursor_obj_c_self_expr, 146,
+				:cursor_cxx_addrspace_cast_expr, 129,
+				:cursor_cxx_typeid_expr, 130,
+				:cursor_cxx_bool_literal_expr, 131,
+				:cursor_cxx_null_ptr_literal_expr, 132,
+				:cursor_cxx_this_expr, 133,
+				:cursor_cxx_throw_expr, 134,
+				:cursor_cxx_new_expr, 135,
+				:cursor_cxx_delete_expr, 136,
+				:cursor_unary_expr, 137,
+				:cursor_obj_c_string_literal, 138,
+				:cursor_obj_c_encode_expr, 139,
+				:cursor_obj_c_selector_expr, 140,
+				:cursor_obj_c_protocol_expr, 141,
+				:cursor_obj_c_bridged_cast_expr, 142,
+				:cursor_pack_expansion_expr, 143,
+				:cursor_size_of_pack_expr, 144,
+				:cursor_lambda_expr, 145,
+				:cursor_obj_c_bool_literal_expr, 146,
+				:cursor_obj_c_self_expr, 147,
+				:cursor_omp_array_section_expr, 148,
+				:cursor_obj_c_availability_check_expr, 149,
+				:cursor_fixed_point_literal, 150,
+				:cursor_omp_array_shaping_expr, 151,
+				:cursor_omp_iterator_expr, 152,
+				# :cursor_last_expr, :cursor_omp_iterator_expr,
 				:cursor_unexposed_stmt, 200,
+				# :cursor_first_stmt, :cursor_unexposed_stmt,
 				:cursor_label_stmt, 201,
 				:cursor_compound_stmt, 202,
 				:cursor_case_stmt, 203,
@@ -147,6 +167,7 @@ module FFI
 				:cursor_break_stmt, 213,
 				:cursor_return_stmt, 214,
 				:cursor_gcc_asm_stmt, 215,
+				# :cursor_asm_stmt, :cursor_gcc_asm_stmt,
 				:cursor_obj_c_at_try_stmt, 216,
 				:cursor_obj_c_at_catch_stmt, 217,
 				:cursor_obj_c_at_finally_stmt, 218,
@@ -164,7 +185,64 @@ module FFI
 				:cursor_null_stmt, 230,
 				:cursor_decl_stmt, 231,
 				:cursor_omp_parallel_directive, 232,
+				:cursor_omp_simd_directive, 233,
+				:cursor_omp_for_directive, 234,
+				:cursor_omp_sections_directive, 235,
+				:cursor_omp_section_directive, 236,
+				:cursor_omp_single_directive, 237,
+				:cursor_omp_parallel_for_directive, 238,
+				:cursor_omp_parallel_sections_directive, 239,
+				:cursor_omp_task_directive, 240,
+				:cursor_omp_master_directive, 241,
+				:cursor_omp_critical_directive, 242,
+				:cursor_omp_taskyield_directive, 243,
+				:cursor_omp_barrier_directive, 244,
+				:cursor_omp_taskwait_directive, 245,
+				:cursor_omp_flush_directive, 246,
+				:cursor_seh_leave_stmt, 247,
+				:cursor_omp_ordered_directive, 248,
+				:cursor_omp_atomic_directive, 249,
+				:cursor_omp_for_simd_directive, 250,
+				:cursor_omp_parallel_for_simd_directive, 251,
+				:cursor_omp_target_directive, 252,
+				:cursor_omp_teams_directive, 253,
+				:cursor_omp_taskgroup_directive, 254,
+				:cursor_omp_cancellation_point_directive, 255,
+				:cursor_omp_cancel_directive, 256,
+				:cursor_omp_target_data_directive, 257,
+				:cursor_omp_task_loop_directive, 258,
+				:cursor_omp_task_loop_simd_directive, 259,
+				:cursor_omp_distribute_directive, 260,
+				:cursor_omp_target_enter_data_directive, 261,
+				:cursor_omp_target_exit_data_directive, 262,
+				:cursor_omp_target_parallel_directive, 263,
+				:cursor_omp_target_parallel_for_directive, 264,
+				:cursor_omp_target_update_directive, 265,
+				:cursor_omp_distribute_parallel_for_directive, 266,
+				:cursor_omp_distribute_parallel_for_simd_directive, 267,
+				:cursor_omp_distribute_simd_directive, 268,
+				:cursor_omp_target_parallel_for_simd_directive, 269,
+				:cursor_omp_target_simd_directive, 270,
+				:cursor_omp_teams_distribute_directive, 271,
+				:cursor_omp_teams_distribute_simd_directive, 272,
+				:cursor_omp_teams_distribute_parallel_for_simd_directive, 273,
+				:cursor_omp_teams_distribute_parallel_for_directive, 274,
+				:cursor_omp_target_teams_directive, 275,
+				:cursor_omp_target_teams_distribute_directive, 276,
+				:cursor_omp_target_teams_distribute_parallel_for_directive, 277,
+				:cursor_omp_target_teams_distribute_parallel_for_simd_directive, 278,
+				:cursor_omp_target_teams_distribute_simd_directive, 279,
+				:cursor_builtin_bit_cast_expr, 280,
+				:cursor_omp_master_task_loop_directive, 281,
+				:cursor_omp_parallel_master_task_loop_directive, 282,
+				:cursor_omp_master_task_loop_simd_directive, 283,
+				:cursor_omp_parallel_master_task_loop_simd_directive, 284,
+				:cursor_omp_parallel_master_directive, 285,
+				:cursor_omp_depobj_directive, 286,
+				:cursor_omp_scan_directive, 287,
+				# :cursor_last_stmt, :cursor_omp_scan_directive,
 				:cursor_translation_unit, 300,
+				:cursor_first_attr, 400,
 				:cursor_unexposed_attr, 400,
 				:cursor_ibaction_attr, 401,
 				:cursor_iboutlet_attr, 402,
@@ -174,11 +252,54 @@ module FFI
 				:cursor_annotate_attr, 406,
 				:cursor_asm_label_attr, 407,
 				:cursor_packed_attr, 408,
+				:cursor_pure_attr, 409,
+				:cursor_const_attr, 410,
+				:cursor_no_duplicate_attr, 411,
+				:cursor_cuda_constant_attr, 412,
+				:cursor_cuda_device_attr, 413,
+				:cursor_cuda_global_attr, 414,
+				:cursor_cuda_host_attr, 415,
+				:cursor_cuda_shared_attr, 416,
+				:cursor_visibility_attr, 417,
+				:cursor_dll_export, 418,
+				:cursor_dll_import, 419,
+				:cursor_ns_returns_retained, 420,
+				:cursor_ns_returns_not_retained, 421,
+				:cursor_ns_returns_autoreleased, 422,
+				:cursor_ns_consumes_self, 423,
+				:cursor_ns_consumed, 424,
+				:cursor_obj_c_exception, 425,
+				:cursor_obj_c_ns_object, 426,
+				:cursor_obj_c_independent_class, 427,
+				:cursor_obj_c_precise_lifetime, 428,
+				:cursor_obj_c_returns_inner_pointer, 429,
+				:cursor_obj_c_requires_super, 430,
+				:cursor_obj_c_root_class, 431,
+				:cursor_obj_c_subclassing_restricted, 432,
+				:cursor_obj_c_explicit_protocol_impl, 433,
+				:cursor_obj_c_designated_initializer, 434,
+				:cursor_obj_c_runtime_visible, 435,
+				:cursor_obj_c_boxable, 436,
+				:cursor_flag_enum, 437,
+				:cursor_convergent_attr, 438,
+				:cursor_warn_unused_attr, 439,
+				:cursor_warn_unused_result_attr, 440,
+				:cursor_aligned_attr, 441,
+				# :cursor_last_attr, :cursor_aligned_attr,
 				:cursor_preprocessing_directive, 500,
 				:cursor_macro_definition, 501,
 				:cursor_macro_expansion, 502,
+				# :cursor_macro_instantiation, :cursor_macro_expansion,
 				:cursor_inclusion_directive, 503,
+				# :cursor_first_preprocessing, :cursor_preprocessing_directive,
+				# :cursor_last_preprocessing, :cursor_inclusion_directive,
 				:cursor_module_import_decl, 600,
+				:cursor_type_alias_template_decl, 601,
+				:cursor_static_assert, 602,
+				:cursor_friend_decl, 603,
+				# :cursor_first_extra_decl, :cursor_module_import_decl,
+				# :cursor_last_extra_decl, :cursor_friend_decl,
+				:cursor_overload_candidate, 700
 			]
 
 			enum :access_specifier, [
@@ -250,6 +371,15 @@ module FFI
 				)
 			end
 
+			enum :visitor_result, [:break, :continue]
+
+			class CXCursorAndRangeVisitor < FFI::Struct
+				layout(
+					:context, :pointer,
+					:visit, callback([:pointer, CXCursor.by_value, CXSourceRange.by_value], :visitor_result),
+				)
+			end
+
 			enum :cxx_access_specifier, [:invalid, :public, :protected, :private]
 			attach_function :get_cxx_access_specifier, :clang_getCXXAccessSpecifier, [CXCursor.by_value], :cxx_access_specifier
 
@@ -312,6 +442,9 @@ module FFI
 			callback :visit_children_function, [CXCursor.by_value, CXCursor.by_value, :pointer], :child_visit_result
 			attach_function :visit_children, :clang_visitChildren, [CXCursor.by_value, :visit_children_function, :pointer], :uint
 
+			enum :result, [:success, :invalid, :visit_break]
+			attach_function :find_references_in_file, :clang_findReferencesInFile, [CXCursor.by_value, :CXFile, CXCursorAndRangeVisitor.by_value], :result
+
 			attach_function :get_cursor_type, :clang_getCursorType, [CXCursor.by_value], CXType.by_value
 			attach_function :get_cursor_result_type, :clang_getCursorResultType, [CXCursor.by_value], CXType.by_value
 			attach_function :get_typedef_decl_underlying_type, :clang_getTypedefDeclUnderlyingType, [CXCursor.by_value], CXType.by_value

data/lib/ffi/clang/lib/diagnostic.rb

@@ -22,18 +22,11 @@
 require_relative 'translation_unit'
 require_relative 'source_location'
 require_relative 'string'
+require_relative 'source_range'
 
 module FFI
 	module Clang
 		module Lib
-			class CXSourceRange < FFI::Struct
-				layout(
-					:ptr_data, [:pointer, 2],
-					:begin_int_data, :uint,
-					:end_int_data, :uint
-				)
-			end
-
 			typedef :pointer, :CXDiagnostic
 			typedef :pointer, :CXDiagnosticSet
 

data/lib/ffi/clang/lib/translation_unit.rb

@@ -37,6 +37,12 @@ module FFI
 				:cxx_chained_pch, 0x20,
 				:skip_function_bodies, 0x40,
 				:include_brief_comments_in_code_completion, 0x80,
+				:create_preamble_on_first_parse, 0x100,
+				:keep_going, 0x200,
+				:single_file_parse, 0x400,
+				:limit_skip_function_bodies_to_preamble, 0x800,
+				:include_attributed_type, 0x1000,
+				:visit_implicit_attributes, 0x2000
 			]
 
 			SaveTranslationUnitFlags = enum [
@@ -90,7 +96,7 @@ module FFI
 			attach_function :parse_translation_unit, :clang_parseTranslationUnit, [:CXIndex, :string, :pointer, :int, :pointer, :uint, :uint], :CXTranslationUnit
 			attach_function :create_translation_unit, :clang_createTranslationUnit, [:CXIndex, :string], :CXTranslationUnit
 			attach_function :dispose_translation_unit, :clang_disposeTranslationUnit, [:CXTranslationUnit], :void
-			attach_function :get_translation_unit_spelling, :clang_getTranslationUnitSpelling, [:CXTranslationUnit], :string
+			attach_function :get_translation_unit_spelling, :clang_getTranslationUnitSpelling, [:CXTranslationUnit], CXString.by_value
 
 			attach_function :default_editing_translation_unit_options, :clang_defaultEditingTranslationUnitOptions, [], :uint
 			attach_function :default_save_options, :clang_defaultSaveOptions, [:CXTranslationUnit], :uint

data/lib/ffi/clang/lib.rb

@@ -37,7 +37,15 @@ module FFI
 			libs = []
 			begin
 				xcode_dir = `xcode-select -p`.chomp
-				libs << "#{xcode_dir}/Toolchains/XcodeDefault.xctoolchain/usr/lib/libclang.dylib"
+				%W[
+					#{xcode_dir}/Toolchains/XcodeDefault.xctoolchain/usr/lib/libclang.dylib
+					#{xcode_dir}/usr/lib/libclang.dylib
+				].each do |f|
+					if File.exist? f
+						libs << f
+						break
+					end
+				end
 			rescue Errno::ENOENT
 				# Ignore
 			end
@@ -48,9 +56,14 @@ module FFI
 				libs << ENV['LIBCLANG']
 			elsif llvm_config
 				llvm_library_dir = `#{llvm_config} --libdir`.chomp
-
-				if FFI::Clang.platform == :darwin
+				platform = FFI::Clang.platform
+				
+				case platform
+				when :darwin
 					libs << llvm_library_dir + '/libclang.dylib'
+				when :windows
+					llvm_bin_dir = `#{llvm_config} --bindir`.chomp
+					libs << llvm_bin_dir + '/libclang.dll'
 				else
 					libs << llvm_library_dir + '/libclang.so'
 				end
@@ -61,9 +74,7 @@ module FFI
 			def self.bitmask_from(enum, opts)
 				bitmask = 0
 
-				opts.each do |key, val|
-					next unless val
-
+				opts.each do |key, value|
 					if int = enum[key]
 						bitmask |= int
 					else

data/lib/ffi/clang/translation_unit.rb

@@ -91,12 +91,16 @@ module FFI
 				ExpansionLocation.new Lib.get_location_offset(self, file, offset)
 			end
 
-			def file(file_name)
-				File.new(Lib.get_file(self, file_name), self)
+			def file(file_name = nil)
+				if file_name.nil?
+					File.new(Lib.get_file(self, spelling), self)
+				else
+					File.new(Lib.get_file(self, file_name), self)
+				end
 			end
 
 			def spelling
-				Lib.get_translation_unit_spelling(self)
+				Lib.extract_string Lib.get_translation_unit_spelling(self)
 			end
 
 			def resource_usage

data/lib/ffi/clang/version.rb

@@ -21,6 +21,6 @@
 
 module FFI
 	module Clang
-		VERSION = "0.5.0"
+		VERSION = "0.7.0"
 	end
 end

data/spec/ffi/clang/compilation_database_spec.rb

@@ -47,7 +47,11 @@ describe CompilationDatabase do
 
 		it "returns compile commands if the specified file is not found" do
 			expect(cdb.compile_commands(not_found_file)).to be_kind_of(CompilationDatabase::CompileCommands)
-			expect(cdb.compile_commands(not_found_file).size).to eq(0)
+			if FFI::Clang.clang_version_string[/\d+/].to_i >= 10
+				expect(cdb.compile_commands(not_found_file).size).to eq(1)
+			else
+				expect(cdb.compile_commands(not_found_file).size).to eq(0)
+			end
 		end
 	end
 
@@ -114,7 +118,7 @@ describe CompilationDatabase do
 		describe '#num_args' do
 			it "returns the number of CompileCommand" do
 				expect(cmd.num_args).to be_kind_of(Integer)
-				expect(cmd.num_args).to eq(31)
+				expect(cmd.num_args).to be >= 31 # clang may insert additional args
 			end
 		end
 

data/spec/ffi/clang/cursor_spec.rb

@@ -31,7 +31,7 @@ describe "Function Call Cursors" do
 	end
 
 	it "should find a method call" do
-		call.should_not be_nil
+		expect(call).to_not be_nil
 	end
 end
 
@@ -392,6 +392,28 @@ describe Cursor do
 		end
 	end
 
+	describe '#find_references_in_file' do
+		let (:struct_cursor) {find_first(cursor_canon, :cursor_struct) }
+
+		it "visits references to the cursor in the main file" do
+			counter = 0
+			struct_cursor.find_references_in_file do |ref_cursor, ref_src_loc|
+				counter += 1
+				:continue
+			end
+			expect(counter).not_to equal(0)
+		end
+
+		it "visits references to the cursor in the indicated file" do
+			counter = 0
+			struct_cursor.find_references_in_file(fixture_path("canonical.c")) do |ref_cursor, ref_src_loc|
+				counter += 1
+				:continue
+			end
+			expect(counter).not_to equal(0)
+		end
+	end
+
 	describe '#linkage' do
 		let (:ref) { find_first(cursor, :cursor_type_ref) }
 		let (:func) { find_first(cursor, :cursor_function) }
@@ -650,6 +672,24 @@ describe Cursor do
 		end
 	end
 
+	describe '#references' do
+		let (:struct_cursor) { find_first(cursor_canon, :cursor_struct) }
+		let (:unspecified_references) { struct_cursor.references }
+		let (:specified_references) { struct_cursor.references(fixture_path("canonical.c")) }
+
+		it "returns an Array of reference Cursors in the main file" do
+			expect(unspecified_references).to be_kind_of(Array)
+			expect(unspecified_references.length).not_to equal(0)
+			expect(unspecified_references).to all(be_a (FFI::Clang::Cursor))
+		end
+
+		it "returns an Array of reference Cursors in the specified file" do
+			expect(specified_references).to be_kind_of(Array)
+			expect(specified_references.length).not_to equal(0)
+			expect(specified_references).to all(be_a (FFI::Clang::Cursor))
+		end
+	end
+
 	describe Cursor::PlatformAvailability do
 		let(:func) { find_matching(cursor_cxx) { |child, parent|
 				child.kind == :cursor_function and child.spelling == 'availability_func'} }

data/spec/ffi/clang/index_spec.rb

@@ -49,6 +49,22 @@ describe Index do
 		it "can handle command line options" do
 			expect{index.parse_translation_unit(fixture_path("a.c"), ["-std=c++11"])}.not_to raise_error
 		end
+
+		it 'can handle translation unit options' do 
+			expect{index.parse_translation_unit(fixture_path("a.c"), [], [], [:incomplete, :single_file_parse, :cache_completion_results])}.not_to raise_error
+		end
+
+		it 'can handle missing translation options' do 
+			expect{index.parse_translation_unit(fixture_path("a.c"), [], [], [])}.not_to raise_error
+		end
+
+		it 'can handle translation options with random values' do 
+			expect{index.parse_translation_unit(fixture_path("a.c"), [], [], {:incomplete => 654, :single_file_parse => 8, :cache_completion_results => 93})}.not_to raise_error
+		end
+
+		it "raises error when one of the translation options is invalid" do
+			expect{index.parse_translation_unit(fixture_path("a.c"), [], [], [:incomplete, :random_option, :cache_completion_results])}.to raise_error(FFI::Clang::Error)
+		end
 	end
 
 	describe '#create_translation_unit' do

data/spec/ffi/clang/token_spec.rb

@@ -26,7 +26,7 @@ describe Tokens do
 
 	it "can be obtained from a translation unit" do
 		expect(tokens).to be_kind_of(Tokens)
-		expect(tokens.size).to eq(13)
+		expect(tokens.size).to be >= 12
 		expect(tokens.tokens).to be_kind_of(Array)
 		expect(tokens.tokens.first).to be_kind_of(Token)
 	end

data/spec/ffi/clang/translation_unit_spec.rb

@@ -59,10 +59,16 @@ describe TranslationUnit do
 	end
 
 	describe "#file" do
-		let (:file) { translation_unit.file(fixture_path("a.c")) }
+		let (:specified_file) { translation_unit.file(fixture_path("a.c")) }
+		let (:unspecified_file) { translation_unit.file }
 
 		it "returns File instance" do
-			expect(file).to be_kind_of(FFI::Clang::File)
+			expect(specified_file).to be_kind_of(FFI::Clang::File)
+		end
+
+		it "returns main file when file name is not specified" do
+			expect(unspecified_file).to be_kind_of(FFI::Clang::File)
+			expect(unspecified_file.name).to include("a.c")
 		end
 	end
 

data/spec/spec_helper.rb

@@ -29,19 +29,23 @@ module ClangSpecHelper
 	end
 end
 
-RSpec.configure do |c|
-	c.include ClangSpecHelper
+RSpec.configure do |config|
+	# Enable flags like --only-failures and --next-failure
+	config.example_status_persistence_file_path = ".rspec_status"
+	
+	config.include ClangSpecHelper
+	
 	supported_versions = ['3.4', '3.5', '3.6', '3.7', '3.8', '3.9', '4.0']
 	current_version = ENV['LLVM_VERSION'] || supported_versions.last
 	supported_versions.reverse_each { |version|
 		break if version == current_version
 		sym = ('from_' + version.tr('.', '_')).to_sym
-		c.filter_run_excluding sym => true
+		config.filter_run_excluding sym => true
 	}
 
 	supported_versions.each { |version|
 		break if version == current_version
 		sym = ('upto_' + version.tr('.', '_')).to_sym
-		c.filter_run_excluding sym => true
+		config.filter_run_excluding sym => true
 	}
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: ffi-clang
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Jari Bakken
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-03-14 00:00:00.000000000 Z
+date: 2022-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -29,28 +29,28 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.4.0
 - !ruby/object:Gem::Dependency
@@ -69,12 +69,11 @@ dependencies:
         version: '0'
 description: Ruby FFI bindings for libclang C interface.
 email:
-- Jari Bakken
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".editorconfig"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
@@ -149,7 +148,7 @@ homepage: ''
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -164,9 +163,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.10
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Ruby FFI bindings for libclang C interface.
 test_files: