[ English | Japanese | Wiki | Project page on SF.JP ]

Typing Ruby - ruby type checker


What is Typing Ruby ?

Typing Ruby is a type checker for ruby programs. It statically analyzes ruby programs and finds type errors. The type check cannot be complete but can help your debugging and testing.

Typing Ruby uses a Duck Typing compatible type checking algorithm, so it's check is almost compatible with Ruby's run-time type check. The target of Typing Ruby is pure ruby language (with no language extensions), so you don't have to rewrite your programs to check.

Currently, Typing Ruby is in pre-alpha stage. It only checks very trivial programs now.

Examples

#Programtruby reportsExecution resultsComments
01 
123.hoge()
ERROR NO_METHOD_ERROR Fixnum#hoge is not defined.
02 
x = 123
x.foo()
ERROR NO_METHOD_ERROR Variable assignment is supported.
03 
def foo(x)
  x.hoge()
end

foo(123)
ERROR NO_METHOD_ERROR User defined method is supported.
04 
def foo(x)
  x.to_s()
end

foo(123).bar()
ERROR NO_METHOD_ERROR foo returns String object and String#bar is not defined.

Currently, "If", "While", and other ruby's statements are not supported. Also instance variables and global variables are not supported. You can't check programs including a class definition inherits another.

Your programs can only call methods or functions, define classes and instance methods.

Download

Typing Ruby is a free software with ABSOLUTELY NO WARRANTY under the terms of the GNU GPL2 (or Ruby's License).

No files are released now (07 Jan 2005). The first release will be available soon. Please wait.

Subversion Repository

You can check out the source code from Subversion repository anonymously. The source code checked out from the repository may be impossible to build.

Installation

Requirements

Maybe, it is possible to build and use under different versions.

Installation of NodeDump-truby

NodeDump is a ruby's extension library to dump syntax tree nodes parsed by the parser of the original ruby. Typing Ruby uses hacked version NodeDump to avoid write a parser from scratch.

To install NodeDump-truby, run the following commands. 

$ tar xfz nodedump-truby-xyz.tgz
$ cd nodedump-truby-xyz
$ ruby ./extconf.rb
$ make
$ su
# make install

Build of Typing Ruby

To build truby, run the following commands. 

$ tar xfz truby-xyz.tgz
$ cd truby-xyz
$ make release

You don't have to install Typing Ruby into your system. Instead, you can try it in the build directory.

Usage

Use the truby-run command. 

$ ./truby-run foo.rb

It is equal to run following commands manually. 

$ ruby -r NodeDumpT foo.rb | ./truby

TODO

  1. Support more standard libraries.
  2. Support more ruby's syntaxes. (If, While, etc...)
  3. Support class inheritance and module mix-in.
  4. Support global variables and instance variables.
  5. Support Array and iterator block.
  6. Exception handling.

MATSUMOTO Soutaro < soutaro@score.cs.tsukuba.ac.jp >
$Date: 2005-01-22 03:42:41 +0900 (Sat, 22 Jan 2005) $

SourceForge.jp