mirror of
https://github.com/mruby/mruby
synced 2026-06-08 16:11:16 +00:00
Merge branch 'master' of github.com:mruby/mruby
This commit is contained in:
+19
-4
@@ -75,6 +75,8 @@ contains every gem found in the *mrbgems* directory.
|
||||
The maximal GEM structure looks like this:
|
||||
|
||||
+- GEM_NAME <- Name of GEM
|
||||
|
|
||||
+- include/ <- Header for Ruby extension (will exported)
|
||||
|
|
||||
+- mrblib/ <- Source for Ruby extension
|
||||
|
|
||||
@@ -87,10 +89,10 @@ The maximal GEM structure looks like this:
|
||||
+- README.md <- Readme for GEM
|
||||
|
||||
The folder *mrblib* contains pure Ruby files to extend mruby. The folder *src*
|
||||
contains C files to extend mruby. The folder *test* contains C and pure Ruby files
|
||||
for testing purposes which will be used by `mrbtest`. *mrbgem.rake* contains
|
||||
the specification to compile C and Ruby files. *README.md* is a short description
|
||||
of your GEM.
|
||||
contains C/C++ files to extend mruby. The folder *include* contains C/C++ header
|
||||
files. The folder *test* contains C/C++ and pure Ruby files for testing purposes
|
||||
which will be used by `mrbtest`. *mrbgem.rake* contains the specification
|
||||
to compile C and Ruby files. *README.md* is a short description of your GEM.
|
||||
|
||||
## Build process
|
||||
|
||||
@@ -173,6 +175,19 @@ the following options additionally inside of your GEM specification:
|
||||
* `spec.test_objs` (Object test files for integration into mrbtest)
|
||||
* `spec.test_preload` (Initialization files for mrbtest)
|
||||
|
||||
### include_paths and depencency
|
||||
|
||||
Your GEM can export include paths to another GEMs that depends on your GEM.
|
||||
By default, `/...absolute path.../{GEM_NAME}/include` will be exported.
|
||||
So it is recommended not to put GEM's local header files on include/.
|
||||
|
||||
These exports are retroactive.
|
||||
For example: when B depends to C and A depends to B, A will get include paths exported by C.
|
||||
|
||||
Exported include_paths are automatically appended to GEM local include_paths by Minirake.
|
||||
You can use `spec.export_include_paths` accessor if you want more complex build.
|
||||
|
||||
|
||||
## C Extension
|
||||
|
||||
mruby can be extended with C. This is possible by using the C API to
|
||||
|
||||
+26
-5
@@ -34,6 +34,8 @@ module MRuby
|
||||
attr_accessor :requirements
|
||||
attr_reader :dependencies
|
||||
|
||||
attr_accessor :export_include_paths
|
||||
|
||||
attr_block MRuby::Build::COMMANDS
|
||||
|
||||
def initialize(name, &block)
|
||||
@@ -49,22 +51,19 @@ module MRuby
|
||||
|
||||
def setup
|
||||
MRuby::Gem.current = self
|
||||
@build.compilers.each do |compiler|
|
||||
compiler.include_paths << "#{dir}/include"
|
||||
end if File.directory? "#{dir}/include"
|
||||
MRuby::Build::COMMANDS.each do |command|
|
||||
instance_variable_set("@#{command}", @build.send(command).clone)
|
||||
end
|
||||
@linker = LinkerConfig.new([], [], [], [])
|
||||
|
||||
@rbfiles = Dir.glob("#{dir}/mrblib/*.rb").sort
|
||||
@objs = Dir.glob("#{dir}/src/*.{c,cpp,cxx,cc,m,asm,S}").map do |f|
|
||||
@objs = Dir.glob("#{dir}/src/*.{c,cpp,cxx,cc,m,asm,s,S}").map do |f|
|
||||
objfile(f.relative_path_from(@dir).to_s.pathmap("#{build_dir}/%X"))
|
||||
end
|
||||
@objs << objfile("#{build_dir}/gem_init")
|
||||
|
||||
@test_rbfiles = Dir.glob("#{dir}/test/*.rb")
|
||||
@test_objs = Dir.glob("#{dir}/test/*.{c,cpp,cxx,cc,m,asm,S}").map do |f|
|
||||
@test_objs = Dir.glob("#{dir}/test/*.{c,cpp,cxx,cc,m,asm,s,S}").map do |f|
|
||||
objfile(f.relative_path_from(dir).to_s.pathmap("#{build_dir}/%X"))
|
||||
end
|
||||
@test_preload = nil # 'test/assert.rb'
|
||||
@@ -74,6 +73,8 @@ module MRuby
|
||||
|
||||
@requirements = []
|
||||
@dependencies = []
|
||||
@export_include_paths = []
|
||||
@export_include_paths << "#{dir}/include" if File.directory? "#{dir}/include"
|
||||
|
||||
instance_eval(&@initializer)
|
||||
|
||||
@@ -88,6 +89,7 @@ module MRuby
|
||||
compilers.each do |compiler|
|
||||
compiler.define_rules build_dir, "#{dir}"
|
||||
compiler.defines << %Q[MRBGEM_#{funcname.upcase}_VERSION=#{version}]
|
||||
compiler.include_paths << "#{dir}/include" if File.directory? "#{dir}/include"
|
||||
end
|
||||
|
||||
define_gem_init_builder
|
||||
@@ -338,6 +340,25 @@ module MRuby
|
||||
rescue TSort::Cyclic => e
|
||||
fail "Circular mrbgem dependency found: #{e.message}"
|
||||
end
|
||||
|
||||
each do |g|
|
||||
import_include_paths(g)
|
||||
end
|
||||
end
|
||||
|
||||
def import_include_paths(g)
|
||||
gem_table = @ary.reduce({}) { |res,v| res[v.name] = v; res }
|
||||
g.dependencies.each do |dep|
|
||||
dep_g = gem_table[dep[:gem]]
|
||||
# We can do recursive call safely
|
||||
# as circular dependency has already detected in the caller.
|
||||
import_include_paths(dep_g)
|
||||
|
||||
g.compilers.each do |compiler|
|
||||
compiler.include_paths += dep_g.export_include_paths
|
||||
g.export_include_paths += dep_g.export_include_paths
|
||||
end
|
||||
end
|
||||
end
|
||||
end # List
|
||||
end # Gem
|
||||
|
||||
@@ -35,8 +35,9 @@ module MRuby
|
||||
Gem.current.build_config_initializer = block
|
||||
gems << Gem.current
|
||||
|
||||
cxx_srcs = Dir.glob("#{Gem.current.dir}/src/*.{cpp,cxx,cc}")
|
||||
cxx_srcs += Dir.glob("#{Gem.current.dir}/test/*.{cpp,cxx,cc}")
|
||||
cxx_srcs = ['src', 'test', 'tools'].map do |subdir|
|
||||
Dir.glob("#{Gem.current.dir}/#{subdir}/*.{cpp,cxx,cc}")
|
||||
end.flatten
|
||||
enable_cxx_abi unless cxx_srcs.empty?
|
||||
|
||||
Gem.current
|
||||
|
||||
Reference in New Issue
Block a user