igal / rubychecker
watch download tarball
public
Forks0Right
Watchers2Right
Description: Checks a Ruby interpreter against a suite o,f tests, using a Ruby script
Homepage: http://code.google.com/p/rubychecker/
Clone URL: git://github.com/igal/rubychecker.git
rubychecker / README.txt
100644 103 lines (80 sloc) 2.6 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

RUBYCHECKER - RUNS CHECKS ON A RUBY INTERPRETER
===============================================
 
USAGE
-----
  rubychecker.rb [options] [suite or suites to run]
 
 
OPTIONS
-------
  * -t TAG
    A tag to include in the filenames of the reports, e.g., a tag of
    "p111" may create report files like "rspec_1.1.4_with_p111.log"
  * -v
    Displays version information and exits.
  * -h
    Displays this help information and exits.
  * -F
    Don't freshen existing checkouts (skip git pull, svn update, etc).
  * -f
    Freshens existing checkouts (git pull, svn update, etc).
  * -p
    Prepares dependencies and exits without running checks.
  * -n
    Dry-run, display commands to execute but don't run them.
 
 
BASIC EXAMPLES
--------------
  # Runs test suites against the "ruby" interpreter in your current
  # shell's PATH and records them to the "reports" directory:
  ./rubychecker.rb
 
  # Run only the test suite for rspec:
  ./rubychecker.rb rspec
 
  # Run only the test suite for rails version 2.1.0 and record the results
  # into a report with the tag "p265" in the filenames:
  ./rubychecker.rb -t p265 rails=2.1.0
 
 
COMPLEX EXAMPLE
---------------
  # Download, compile and check a Ruby interpreter from SVN:
 
  rubysvn=$PWD/cache/ruby
  rubytmp=$PWD/tmp/ruby
  export PATH=$rubytmp/bin:$PATH
  mkdir -p cache
  svn co http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8_6 $rubysvn
  pushd $rubysvn
      autoconf
      ./configure --prefix=$rubytmp && make && make install
  popd
  ./rubychecker.rb -t svn186
 
 
DEPENDENCIES:
-------------
  * ruby
  * ruby headers
  * complete build environment, e.g., gcc, make, etc
  * grep
  * git
  * svn
  * unzip
  * MySQL headers
  * SQLite3 headers
  * MySQL server
      You'll need to login as DBA and run:
        CREATE DATABASE activerecord_unittest;
        CREATE DATABASE activerecord_unittest2;
        CREATE DATABASE actionwebservice_unittest;
        CREATE USER 'rails'@'localhost' IDENTIFIED BY PASSWORD '';
        GRANT ALL ON activerecord_unittest.* TO 'rails'@'localhost';
        GRANT ALL ON activerecord_unittest2.* TO 'rails'@'localhost';
        GRANT ALL ON actionwebservice_unittest.* TO 'rails'@'localhost';
        FLUSH PRIVILEGES;
 
 
WHAT DOESN'T WORK YET:
----------------------
  * Any OS other than UNIX
  * Any Ruby interpreter other than MRI 1.8
 
 
SOURCE CODE:
------------
  http://github.com/igal/rubychecker
 
 
ISSUE TRACKER:
--------------
  http://code.google.com/p/rubychecker
 
 
LICENSE:
--------
  This program is provided under the same license as Ruby:
    http://www.ruby-lang.org/en/LICENSE.txt