allow all settings to be defined without cli arguments

[cs01]

Is your feature request related to a problem? Please describe.
Some arguments, such as loglevel or cleanup, can only be defined as CLI arguments, which forces the user to use the detox-cli. While the detox cli is very convenient, we are integrating detox into a toolchain that cannot use it, yet still want to modify these parameters.

Describe the solution you'd like
The option to pass all configurations values as optional parameters to functions.

The order of preference would be:

• default value
• parameter value (overrides default)
• cli value (overrides parameter)

Alternative solution
In cases where it's impractical to pass the arguments, an environment variable could be used.

[LeoNatan]

Let's follow this in #1238 as they seem to discuss the same subject.

[cs01]

I noticed #1238 references this issue in the last checkbox, so @noomorph should either remove that reference or this issue should be re-opened. FWIW I think it makes sense to reopen this issue to separate concerns. Commits can be tagged with this issue number rather than the catch-all issue of #1238, but that is just my two cents 😄. Either way, thanks for your quick responses, much appreciated.

[cs01]

Just wanted to note that all command line arguments will fall back to checking for the equivalent camel-cased environment variables. (see detox/src/utils/argparse.js)

[noomorph]

With #1729, we added all artifacts collection options to Detox's package.json section.

[noomorph]

With #2038, --reuse and --cleanup CLI options can be used via detox.behavior object in package.json.

[noomorph]

Currently, I am planning to add support for:

  -H, --headless            [Android Only] Launch emulator in headless mode. Useful
                            when running on CI.                               [boolean]
      --gpu                 [Android Only] Launch emulator with the specific -gpu [gpu
                            mode] parameter.
      --device-launch-args  Custom arguments to pass (through) onto the device
                            (emulator/simulator) binary when launched.
      --force-adb-install   Due to problems with the "adb install" command on Android,
                            Detox resorts to a different scheme for install APK's.
                            Setting true will disable that and force usage of "adb
                            install", instead.               [boolean] [default: false]

Will post soon a link to a WiP PR.

[d4vidi]

@noomorph can this be closed, then?

[noomorph]

@d4vidi, yeah, let's close it.