Github Actions | Codecov | Gem |
---|---|---|
Operating systems: GNU/Linux, OSX, FreeBSD.
gem install ocg
You can build it from source.
rake gem
gem install pkg/ocg-*.gem
You can also use overlay for gentoo.
require "ocg"
generator = OCG.new(
:a => %w[a b],
:b => 1..2
)
.or(
:c => %i[c d],
:d => 3..4
)
.and(
:e => %w[e f],
:f => 5..6
)
.mix(
:g => %i[g h],
:h => 7..8
)
generator.each { |combination| puts combination }
It will populate all option combinations.
Please review rdoc generated docs.
OCG.new options
will prepare a generator.
It will provide all possible option combinations.
Method | Description |
---|---|
and |
provides all combinations between generators |
mix |
merges combinations without combining, guarantees that both left and right generator combinations will be provided at least once |
or |
concats generator combinations without merging |
reset |
allows to receive combinations once again |
next |
returns next combination |
last |
returns last combination |
started? |
returns true when at least one combination was generated |
finished? |
returns true when all combination were generated |
length |
returns combinations length |
dup |
returns generator duplicate |
clone |
returns generator clone |
Generator is responsible to any method from Enumerable
.
Enumerator will be provided using generator duplicate.
So enumerable api is separated from bare metal api (reset
, next
, last
, started?
, finished?
).
You can combine generators using and
, mix
and or
.
Options should be prepared in the following form:
{
option_name => option_values,
...
}
Options hash may be empty.
option_name
can be any valid hash key.
option_values
should be convertable to array using to_a
.
option_values
should not be empty.
Many software uses multiple options and have complex relations between them. We want to test this software. We need to provide optimal option combination to maximize test coverage. The amount of combinations can be more than billion, it is not possible to store them (fuzzing testing).
Let's look at zstd compressor options.
compressionLevel
option is a preset for windowLog
, hashLog
, etc options.
We may set compressionLevel
or other options, mixing is pointless.
We can say that there are 2 option groups: group with single compressionLevel
option and group with other options.
general_generator = OCG.new(
:compressionLevel => -10..10
)
.or(
:windowLog => 0..10,
:hashLog => 0..10,
...
)
enableLongDistanceMatching
option enables usage of ldmHashLog
, ldmMinMatch
, etc options.
We may use :enableLongDistanceMatching => false
or :enableLongDistanceMatching => true
with other options.
ldm_generator = OCG.new(
:enableLongDistanceMatching => [false]
)
.or(
:enableLongDistanceMatching => [true],
:ldmHashLog => 0..10,
:ldmMinMatch => 0..10,
...
)
General compression and long distance matching option groups correlate between each other. We want to have all possible combinations between these option groups.
main_generator = general_generator.and ldm_generator
contentSizeFlag
, checksumFlag
, dictIDFlag
options are additional options.
These options may correlate between each other but don't correlate with main options.
almost_complete_generator = main_generator.mix(
:contentSizeFlag => [true, false],
:checksumFlag => [true, false],
:dictIDFlag => [true, false]
)
nbWorkers
, jobSize
and overlapLog
options are thread related options.
When nbWorkers
equals 0
, jobSize
and overlapLog
should not be used.
These options correlate between each other but don't correlate with main options.
complete_generator = almost_complete_generator.mix(
OCG.new(
:nbWorkers => [0]
)
.or(
:nbWorkers => 1..2,
:jobSize => 1..10,
:overlapLog => 0..9
)
)
Please visit scripts/test-images. See universal test script scripts/ci_test.sh for CI.