ffi-clang 0.6.0 → 0.8.0

metadata.gz.sig

@@ -0,0 +1,2 @@
+KD ��!��F�p������D��ަޚ�Q��	v�?��^��ڧ��
+����SJ���w��12�Dz�\AfUG��Қ$���/Lc�{�;�D��J3gX)��z١�m��U��`��'�TN���d}��"
�M��MBUj��ལ�

data/.gitignore

@@ -1,19 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-
-.rspec_status

data/.rspec

@@ -1,5 +0,0 @@
---color
---format documentation
---backtrace
---warnings
---require spec_helper

data/.travis.yml

@@ -1,30 +0,0 @@
-language: ruby
-sudo: false
-before_install:
-  - export LD_LIBRARY_PATH=/usr/lib/llvm-${LLVM_VERSION}/lib/
-  - export PATH=/usr/lib/llvm-${LLVM_VERSION}/bin:$PATH
-matrix:
-  include:
-    - addons: {apt: {sources: [ubuntu-toolchain-r-test, llvm-toolchain-precise-3.6], packages: [libclang-3.6-dev, clang-3.6]}}
-      env: LLVM_VERSION=3.6
-      rvm: "2.4.0"
-    - addons: {apt: {sources: [ubuntu-toolchain-r-test, llvm-toolchain-precise-3.7], packages: [libclang-3.7-dev, clang-3.7]}}
-      env: LLVM_VERSION=3.7
-      rvm: "2.4.0"
-    # The default build:
-    - &libclang-38
-      addons: {apt: {sources: [ubuntu-toolchain-r-test, llvm-toolchain-precise-3.8], packages: [libclang-3.8-dev, clang-3.8]}}
-      env: LLVM_VERSION=3.8
-      rvm: "2.4.0"
-    # A second build with the same configuration but using ruby 2.2.4
-    - <<: *libclang-38
-      rvm: "2.3.3"
-    - addons: {apt: {sources: [ubuntu-toolchain-r-test, llvm-toolchain-precise-3.9], packages: [libclang-3.9-dev, clang-3.9]}}
-      env: LLVM_VERSION=3.9
-      rvm: "2.4.0"
-    - addons: {apt: {sources: [ubuntu-toolchain-r-test, llvm-toolchain-precise-4.0], packages: [libclang-4.0-dev, clang-4.0]}}
-      env: LLVM_VERSION=4.0
-      rvm: "2.4.0"
-  allow_failures:
-  - env: LLVM_VERSION=4.0
-    rvm: "2.4.0"

data/Gemfile

@@ -1,13 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec
-
-group :development do
-	gem 'transpec'
-	gem 'pry'
-end
-
-group :test do
-	gem 'simplecov'
-	gem 'coveralls', require: false
-end

data/README.md

@@ -1,74 +0,0 @@
-# FFI::Clang
-
-A light-weight wrapper for Ruby exposing [libclang][1]. Works for libclang v3.4+.
-
-[![Build Status](https://secure.travis-ci.org/ioquatix/ffi-clang.svg)](http://travis-ci.org/ioquatix/ffi-clang)
-[![Code Climate](https://codeclimate.com/github/ioquatix/ffi-clang.svg)](https://codeclimate.com/github/ioquatix/ffi-clang)
-
-[1]: http://llvm.org/devmtg/2010-11/Gregor-libclang.pdf
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-	gem 'ffi-clang'
-
-And then execute:
-
-	$ bundle
-
-Or install it yourself as:
-
-	$ gem install ffi-clang
-
-## Usage
-
-Traverse the AST in the given file:
-
-	index = Index.new
-	translation_unit = index.parse_translation_unit("list.c")
-	cursor = translation_unit.cursor
-	cursor.visit_children do |cursor, parent|
-		puts "#{cursor.kind} #{cursor.spelling.inspect}"
-		
-		next :recurse 
-	end
-
-### Library Version
-
-Due to issues figuring out which library to use, we require you to manually specify it. For example, to run the tests, with MacPorts llvm/clang 3.4, use the following:
-
-	LLVM_CONFIG=llvm-config-mp-3.4 rake
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-## License
-
-Copyright, 2010-2012, by Jari Bakken.  
-Copyright, 2013, by Samuel G. D. Williams. <http://www.codeotaku.com>  
-Copyright, 2013, by Garry C. Marshall. <http://www.meaningfulname.net>  
-Copyright, 2014, by Masahiro Sano.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/Rakefile

@@ -1,12 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec) do |task|
-	begin
-		require('simplecov/version')
-		task.rspec_opts = %w{--require simplecov} if ENV['COVERAGE']
-	rescue LoadError
-	end
-end
-
-task :default => :spec

data/examples/docs.cpp

@@ -1,25 +0,0 @@
-
-/** A test class which does nothing.
-
-	This is used by `main`.
-*/
-template<typename T>
-class Test {};
-
-/// This is a specialization for integers.
-template<>
-class Test<int> {
-public:
-	/// The number of times it has been incremented.
-	int count;
-	
-};
-
-/// This always fails.
-/// @param argc The number of items in `argv`. At least 1.
-/// @param argv The command line arguments, with argv[0] being the command used to execute this program.
-int main(int argc, char ** argv) {
-	Test<int> test;
-	
-	return 1;
-}

data/examples/docs.rb

@@ -1,31 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'rainbow'
-require 'ffi/clang'
-
-index = FFI::Clang::Index.new
-
-# clang -Xclang -ast-dump -fsyntax-only ./examples/docs.cpp
-
-def title(declaration)
-	puts ["Symbol:", Rainbow(declaration.spelling).blue.bright, "Type:", Rainbow(declaration.type.spelling).green, declaration.kind.to_s].join(' ')
-end
-
-ARGV.each do |path|
-	translation_unit = index.parse_translation_unit(path)
-	
-	declarations = translation_unit.cursor.select(&:declaration?)
-	
-	declarations.each do |declaration|
-		title declaration
-		
-		if location = declaration.location
-			puts "Defined at #{location.file}:#{location.line}"
-		end
-		
-		if comment = declaration.comment
-			# puts Rainbow(comment.inspect).gray
-			puts Rainbow(comment.text)
-		end
-	end
-end

data/ffi-clang.gemspec

@@ -1,26 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'ffi/clang/version'
-
-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      = ""
-	spec.license       = "MIT"
-
-	spec.files         = `git ls-files`.split($/)
-	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-	spec.require_paths = ["lib"]
-
-	spec.add_dependency "ffi"
-
-	spec.add_development_dependency "bundler", "~> 1.3"
-	spec.add_development_dependency "rspec", "~> 3.4.0"
-	spec.add_development_dependency "rake"
-end

data/spec/ffi/clang/code_completion_spec.rb

@@ -1,181 +0,0 @@
-# Copyright, 2014, by Masahiro Sano.
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-describe CodeCompletion do
-	let(:filename) { fixture_path("completion.cxx") }
-	let(:translation_unit) { Index.new.parse_translation_unit(filename) }
-	let(:line) { 7 }
-	let(:column) { 6 }
-	let(:results) { translation_unit.code_complete(filename, line, column) }
-
-	describe "self.default_code_completion_options" do
-		let(:options) { FFI::Clang::CodeCompletion.default_code_completion_options }
-		it "returns a default set of code-completion options" do
-			expect(options).to be_kind_of(Hash)
-			options.keys.each { |key|
-				expect(FFI::Clang::Lib::CodeCompleteFlags.symbols).to include(key)
-			}
-		end
-	end
-
-	describe CodeCompletion::Results do
-		it "can be obtained from a translation unit" do
-			expect(results).to be_kind_of(CodeCompletion::Results)
-			
-			# At least 40 results, depends on standard library implementation:
-			expect(results.size).to be >= 40
-			
-			expect(results.results).to be_kind_of(Array)
-			expect(results.results.first).to be_kind_of(CodeCompletion::Result)
-		end
-
-		it "calls dispose_code_complete_results on GC" do
-			expect(Lib).to receive(:dispose_code_complete_results).at_least(:once)
-			expect{results.free}.not_to raise_error
-		end
-
-		it "#each" do
-			spy = double(stub: nil)
-			expect(spy).to receive(:stub).exactly(results.size).times
-			results.each { spy.stub }
-		end
-
-		it "#num_diagnostics" do
-			expect(results.num_diagnostics).to eq(2)
-		end
-
-		it "#diagnostic" do
-			expect(results.diagnostic(0)).to be_kind_of(Diagnostic)
-		end
-
-		it "#diagnostics" do
-			expect(results.diagnostics).to be_kind_of(Array)
-			expect(results.diagnostics.first).to be_kind_of(Diagnostic)
-			expect(results.diagnostics.size).to eq(results.num_diagnostics)
-		end
-
-		it "#contexts" do
-			expect(results.contexts).to be_kind_of(Hash)
-			results.contexts.keys.each { |key|
-				expect(FFI::Clang::Lib::CompletionContext.symbols).to include(key)
-			}
-		end
-
-		it "#container_usr" do
-			expect(results.container_usr).to be_kind_of(String)
-			expect(results.container_usr).to match(/std.+vector/)
-		end
-
-		it "#container_kind" do
-			expect(results.container_kind).to be_kind_of(Symbol)
-			expect(results.container_kind).to eq(:cursor_class_decl)
-		end
-
-		it "#incomplete?" do
-			expect(results.incomplete?).to be false
-		end
-
-		it "#objc_selector" do
-			#TODO
-		end
-
-		it "#sort!" do
-			results.sort!
-			
-			possibilities = results.first.string.chunks.select{|x| x[:kind] == :typed_text}.collect{|chunk| chunk[:text]}
-			
-			# may be sorted with typed_text kind, first result will start with 'a'.. not necessarily
-			expect(possibilities).to be == possibilities.sort
-		end
-	end
-
-	describe CodeCompletion::Result do
-		let(:result) { results.results.first }
-		it "#string" do
-			expect(result.string).to be_kind_of(CodeCompletion::String)
-		end
-
-		it "#kind" do
-			expect(result.kind).to be_kind_of(Symbol)
-		end
-	end
-
-	describe CodeCompletion::String do
-		let(:str) { results.sort!; results.find{|x| x.string.chunk_text(1) == 'assign'}.string }
-
-		it "#num_chunks" do
-			expect(str.num_chunks).to be >= 5
-		end
-
-		it "#chunk_kind" do
-			expect(str.chunk_kind(0)).to eq(:result_type)
-			expect(str.chunk_kind(1)).to eq(:typed_text)
-		end
-
-		it "#chunk_text" do
-			expect(str.chunk_text(0)).to be =~ /void/
-			expect(str.chunk_text(1)).to eq('assign')
-		end
-
-		it "#chunk_completion" do
-			expect(str.chunk_completion(0)).to be_kind_of(CodeCompletion::String)
-		end
-
-		it "#chunks" do
-			expect(str.chunks).to be_kind_of(Array)
-			expect(str.chunks.first).to be_kind_of(Hash)
-			expect(str.chunks.size).to eq(str.num_chunks)
-		end
-
-		it "#priority" do
-			expect(str.priority).to be_kind_of(Integer)
-		end
-
-		it "#availability" do
-			expect(str.availability).to be_kind_of(Symbol)
-			expect(str.availability).to eq(:available)
-		end
-
-		it "#num_annotations" do
-			expect(str.num_annotations).to be_kind_of(Integer)
-			expect(str.num_annotations).to eq(0)
-		end
-
-		it "#annotation" do
-			expect(str.annotation(100)).to be_nil
-			# TODO: need tests for String which has annotation
-		end
-
-		it "#annotations" do
-			expect(str.annotations).to be_kind_of(Array)
-			# TODO: need tests for String which has annotation
-		end
-
-		it "#parent" do
-			expect(str.parent).to be_kind_of(String)
-			expect(str.parent).to be =~ /std.+vector/
-		end
-
-		it "#comment" do
-			expect(str.comment).to be_nil
-			# TODO: need tests for String which has real comment
-		end
-	end
-end