Developing guide. how to run/develop the tests

[mrgum]

Hello

I'd like to submit couple of PRs for ood-portal-generator. They change the template and therefore the output. A can see there are tests to check the output but I cannot figure out how to run them or how they work.

Could a testing section be added to the development.md please.

I guessed at running rake test:setup but got

cd /my/path/ondemand/ood-portal-generator
rake aborted!
NameError: uninitialized constant Bundler (NameError)

        Bundler.with_unbundled_env do
        ^^^^^^^
/root/ondemand/lib/tasks/test.rb:26:in 'block (4 levels) in <top (required)>'
/root/ondemand/lib/tasks/test.rb:23:in 'block (3 levels) in <top (required)>'
/root/ondemand/lib/tasks/test.rb:22:in 'Hash#each_pair'
/root/ondemand/lib/tasks/test.rb:22:in 'block (2 levels) in <top (required)>'
Tasks: TOP => test:setup
(See full trace by running task with --trace)

Thank you.

[johrstrom]

I think the best practice is to bundle exec commands. so that becomes bundle exec rake test:setup.

[mrgum]

Hello @johrstrom, Thanks for the tip that got me going in the right direction.
I had to install a load of packages, including things I would not have expected, like rclone, in order to run the full tests.
But for the ood-portal-generator the main thing I needed was to use bundle3.2 (3.4 is the default on ubuntu2404) e.g. bundle3.2 exec rake spec

I will repeat the exercise on a fresh machine to get a list of what ubuntu24.04 needs to run the tests I suspect tests.yml answers that though

[johrstrom]

OK i think if you follow this procedure you should be able to get it without updating the OS or escalating privileges. I believe ruby/rubygems is smart enough to just install the correct version bundler in vendor/bundle and swap them out at runtime.

bundle config path --local vendor/bundle
bundle install
bundle exec rake spec