hacks/inline

module Inline

A hack for allowing inline C code inside a Ruby program.

Public Methods

self.check_dependency(target, dependency, &block)

A helper function for checking dependencies. Calls the block if the target is out of date.

self.inline(lang, source)

Put inline code in another language inside a Ruby script.

TODO: For now, you must have an Init_filename function in your C code, where filename is the name of your Ruby script (minus the .rb extension). This function could be automatically generated in the future.

TODO: Currently, this just checks dates to see if the Ruby file has been modified, and if so, it recompiles. Ideally, MD5 or some other mechanism should be used to see if the inline source has changed, so that the Ruby script can be modified without recompiling (I'm told that this is what the Perl inline module does).

E.g.:

  Inline.inline "C", <<END
  #include <stdio.h>
  void Init_inline_helper() {
    printf("hello, world!\n");
  }
  END
  Inline::require

lang	The language of the source (currently must be "C")
source	The source to inline

self.build(lang="C")

Explicitly build the _helper.so file from the source. You do not normally need to call this method.

lang	the language of the source

self.require filename, lineno, method = parse_caller(caller[0])

Automatically require the _helper.so file.

self.clean(lang="C")

Clean the _helper.c and _helper.so files

self.strip_extension(filename)

For internal use only.

Requires