Differences between revisions 2 and 6 (spanning 4 versions)
Revision 2 as of 2012-11-05 13:45:29
Size: 3423
Editor: ?markus tornow
Comment: copied content from piratepad. probably as temp solution.
Revision 6 as of 2012-11-06 19:53:40
Size: 3844
Editor: Praveen A
Comment: follow caps conventions
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from Diaspora/packaging/tests
Line 7: Line 8:
Note: temporary content, copied from piratepad (to got the page here and make sure it won't be overseen) If it is good it will stay. Note: temporary content, copied from piratepad (to have the page here and make sure it won't be overlooked) If it is good it will stay.
Line 9: Line 10:
Introduction to software testing: Most of the ruby libraries contain test code which uses the functionanlity provided by the library and compare results with known inputs. Commonly used testing framework is rspec. Look in your gem to see if there is a 'spec' directory. Other test frameworks may use a 'test' directory. Note: Probably a better place for this is Ruby/Packaging/Tests as it is common for any ruby gem.
Line 11: Line 12:
    Running tests: If the gem has tests defined (see if it has 'test or 'spec' directories), make sure you run them successfully. By default gem2deb creates 'debian/ruby-tests.yaml', but it may not work always. If your test or spec directory contains files with extentions other than .rb, this is most certainly going to fail. You can try removing non-ruby files from ruby-test-files.yaml and rebuild it. If it still does not work, try the other two methods described below. = Introduction to software testing =

Most of the ruby libraries contain test code which uses the functionality provided by the library and compare results with known inputs. Commonly used testing framework is rspec. Look in your gem to see if there is a 'spec' directory. Other test frameworks may use a 'test' directory.

=
Running tests =

If the gem has tests defined (see if it has 'test or 'spec' directories), make sure you run them successfully. By default gem2deb creates 'debian/ruby-tests.yaml', but it may not work always. If your test or spec directory contains files with extentions other than .rb, this is most certainly going to fail. You can try removing non-ruby files from ruby-test-files.yaml and rebuild it. If it still does not work, try the other two methods described below.
Line 35: Line 42:
== Case one: a required library is missing ==
Line 36: Line 44:
    If you see a file is missing in the error message, it may be provided by a gem not yet installed in your system. For example if you see no such file to load -- shoulda (LoadError), search for shoulda ie, apt-cache search shoulda. If you find it is already packaged, install it with apt-get install ruby-shoulda.     If you see a file is missing in the error message, it may be provided by a gem not yet installed in your system. For example if you see

{{{
no such file to load -- shoulda (LoadError),
}}}

search for shoulda ie,

{{{
$ apt-cache search shoulda
}}}

If you find it is already packaged, install it with

{{{
#
apt-get install ruby-shoulda
}}}
Line 41: Line 65:
    If you cannot find the package via apt, try if it is a gem file not yet packaged, then run gem list -r shoulda If you find it in the remote gem list, then you need to package it first :) So start from step 1 for this gem and come back to your current gem once your package enters debian!     If you cannot find the package via apt, try if it is a gem file not yet packaged, then run
Line 43: Line 67:
    If you see spec_helper or test_helper is missing, you may need to add spec or test directory to library load path. Uncomment the following line in ruby-tests.rb and modify it accordingly. {{{
gem list -r shoulda
}}}

If you find it in the remote gem list, then you need to package it first :) So start from step 1 for this gem and come back to your current gem once your package enters debian!

== Case two: lib/test/spec is not in library load path ==

    If you
see spec_helper or test_helper is missing, you may need to add spec or test directory to library load path.

{{{
  in `require': no such file to load -- test_helper (LoadError)
}}}

    
Uncomment the following line in ruby-tests.rb and modify it accordingly.

Translation(s): none


ruby tests

Note: temporary content, copied from piratepad (to have the page here and make sure it won't be overlooked) If it is good it will stay.

Note: Probably a better place for this is Ruby/Packaging/Tests as it is common for any ruby gem.

Introduction to software testing

Most of the ruby libraries contain test code which uses the functionality provided by the library and compare results with known inputs. Commonly used testing framework is rspec. Look in your gem to see if there is a 'spec' directory. Other test frameworks may use a 'test' directory.

Running tests

If the gem has tests defined (see if it has 'test or 'spec' directories), make sure you run them successfully. By default gem2deb creates 'debian/ruby-tests.yaml', but it may not work always. If your test or spec directory contains files with extentions other than .rb, this is most certainly going to fail. You can try removing non-ruby files from ruby-test-files.yaml and rebuild it. If it still does not work, try the other two methods described below.

  • You can try ruby-tests.rb, see ruby-warden for a sample file http://ur1.ca/ao6o8 It allows you to add custom directories to ruby library load path and you may need it if your tests fail to find files already present in 'lib' or 'test' directories.

Note: If you don't find ruby-tests.rb in debian directory, you have to create it from the sample file given above. You have to remove ruby-test-files.yaml too.

Uncomment this line in ruby-tests.rb to add custom library paths.

$: << 'lib' << '.'

If it could be done with not much effort, consider instead patching the tests not to override default $LOADPATH (aka $:) variable.

  • You may also try ruby-tests.rake if the gem uses rspec to run the tests (in this case you have a spec/ directory with *_spec.rb files). See ruby-dataobjects-sqlite3 for an example http://ur1.ca/ao6ok

fixing errors

Tips to fixing test errors:

  • Check for build-depencies on rubygems.org: they are listed as development (see the commented line in debian/control produced by gem2deb). You may not need all the build dependencies listed there, so the only way to be sure is to see the build errors. Normally, you need also the dependencies during the build, if you run the tests (since your library will be used).

Case one: a required library is missing

  • If you see a file is missing in the error message, it may be provided by a gem not yet installed in your system. For example if you see

no such file to load -- shoulda (LoadError), 

search for shoulda ie,

$ apt-cache search shoulda

If you find it is already packaged, install it with

# apt-get install ruby-shoulda

Note: Remember to add the build dependency you just found to Build-Depends: in debian/control

  • If you cannot find the package via apt, try if it is a gem file not yet packaged, then run

gem list -r shoulda

If you find it in the remote gem list, then you need to package it first :) So start from step 1 for this gem and come back to your current gem once your package enters debian!

Case two: lib/test/spec is not in library load path

  • If you see spec_helper or test_helper is missing, you may need to add spec or test directory to library load path.

  in `require': no such file to load -- test_helper (LoadError)
  • Uncomment the following line in ruby-tests.rb and modify it accordingly.

$: << 'lib' << '.' (something like $: << 'test' )