Extensions and 'require'

Hello!

I’m creating a ‘gem’ package for a ruby extension written in C.

I have a little problem:

First, let’s suppose the package is called “Mambo”.

Now, the “.so” (or “.dll”, or whatever) is called “mambo.so”.

In addition to “mambo.so”, I also have a “mambo.rb” which adds some
finishing touches to the Mambo module defined in “mambo.so”.

The problem is this:

If the user does “require ‘mambo’” in his code, Ruby will load
“mambo.rb”. It won’t load “mambo.so” (because require first checks for
.rb, only then for .so).

So how can I cause “mambo.so” to get loaded?

One solution is to rename “mambo.rb” to, say, “mambo_something.rb”, and
in it to “require ‘mambo’”. But… it doesn’t look neat.

What’s the “official” way to solve this problem?

Albert S. wrote:

[…]
One solution is to rename “mambo.rb” to, say, “mambo_something.rb”, and
in it to “require ‘mambo’”. But… it doesn’t look neat.

Ah, another solution, I think, is to have “autorequires =
[‘mambo_something’, ‘mambo’]” in the gem spec. This will load the two
files. Still, it doens’t look neat to have such a central file,
‘mambo_something.rb’, have something tucked to its name. Or does it?

Albert S. wrote:

[…]
So how can I cause “mambo.so” to get loaded?

Hello again.

I found two gems, “rubynode” and “bcrypt” that solve this problem by
appending “_ext” to the .so name.

So it seems that I’ll have “mambo.rb” and “mambo_ext.so”. The former
will ‘require’ the latter.

I’m still interested in hearing other opinions.

Albert S. wrote:

Albert S. wrote:

[…]
So how can I cause “mambo.so” to get loaded?

Hello again.

I found two gems, “rubynode” and “bcrypt” that solve this problem by
appending “_ext” to the .so name.

So it seems that I’ll have “mambo.rb” and “mambo_ext.so”. The former
will ‘require’ the latter.

I’m still interested in hearing other opinions.

In mambo.rb require ‘mambo.so’.

Tim H. wrote:

In mambo.rb require ‘mambo.so’.

But ‘.so’ is specific to unix. Windows, for example, has ‘.dll’.

Tim H. wrote:

Albert S. wrote:

Tim H. wrote:

In mambo.rb require ‘mambo.so’.

But ‘.so’ is specific to unix. Windows, for example, has ‘.dll’.

And OS X has .dylib. Ruby translates .so to whatever is appropriate for
the host.

Ah. That’s nice. Thanks.

(I’ve found two more gems that use the ‘_ext’ pattern.)

Albert S. wrote:

Tim H. wrote:

In mambo.rb require ‘mambo.so’.

But ‘.so’ is specific to unix. Windows, for example, has ‘.dll’.

And OS X has .dylib. Ruby translates .so to whatever is appropriate for
the host.