1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOC] Update to use SPECOPTS instead of MSPECOPT

Browse Source
This commit is contained in:
Nobuyoshi Nakada 2023-08-12 12:33:05 +09:00
parent 0eb2108214
commit 6ebde04202
No known key found for this signature in database
GPG Key ID: 3582D74E1FEE4465
Notes: git 2023-08-12 05:32:40 +00:00 
Merged: https://github.com/ruby/ruby/pull/8210
2 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/contributing/testing_ruby.md
View File

@ -99,28 +99,28 @@ We can run any of the make scripts [in parallel](building_ruby.md#label-Running+
make test-spec
```
To run a specific directory, we can use `MSPECOPT` to specify the directory:
To run a specific directory, we can use `SPECOPTS` to specify the directory:
```
make test-spec MSPECOPT=spec/ruby/core/array
make test-spec SPECOPTS=spec/ruby/core/array
```
To run a specific file, we can also use `MSPECOPT` to specify the file:
To run a specific file, we can also use `SPECOPTS` to specify the file:
```
make test-spec MSPECOPT=spec/ruby/core/array/any_spec.rb
make test-spec SPECOPTS=spec/ruby/core/array/any_spec.rb
```
To run a specific test, we can use the `--example` flag to match against the test name:
```
make test-spec MSPECOPT="../spec/ruby/core/array/any_spec.rb --example='is false if the array is empty'"
make test-spec SPECOPTS="../spec/ruby/core/array/any_spec.rb --example='is false if the array is empty'"
```
To run these specs with logs, we can use:
```
make test-spec MSPECOPT=-Vfs
make test-spec SPECOPTS=-Vfs
```
To run a ruby-spec file or directory with GNU make, we can use

8
spec/README.md
View File

@ -91,24 +91,24 @@ To run all specs:
make test-spec
```
Extra arguments can be added via `MSPECOPT`.
Extra arguments can be added via `SPECOPTS`.
For instance, to show the help:
```bash
make test-spec MSPECOPT=-h
make test-spec SPECOPTS=-h
```
You can also run the specs in parallel, which is currently experimental.
It takes around 10s instead of 60s on a quad-core laptop.
```bash
make test-spec MSPECOPT=-j
make test-spec SPECOPTS=-j
```
To run a specific test, add its path to the command:
```bash
make test-spec MSPECOPT=spec/ruby/language/for_spec.rb
make test-spec SPECOPTS=spec/ruby/language/for_spec.rb
```
If ruby trunk is your current `ruby` in `$PATH`, you can also run `mspec` directly: