Skip to main content

Configuration

Ogoron configuration lives under the project artifacts directory:

.ogoron/configs/

Typical files include:

  • config.yml — main repository configuration for generated tests and helpers
  • test_execution.yml — how ogoron run tests (and test-running workflows) execute tests

Quick start​

Minimal setup:

  1. Run ogoron init
  2. Set OGORON_KEY
  3. Review .ogoron/configs/config.yml
  4. Run ogoron analyze

Common fields​

Most repositories only need a few fields in config.yml:

  • paths.tests — where Ogoron generates and updates tests
  • paths.helpers — where shared generated helpers/support code should be written
  • test_codegen.test_file_template — file naming template for generated test files
  • test_codegen.helpers_file_template — file naming template for generated helper files

Precedence​

When a setting can be defined in multiple places, precedence is:

  1. .ogoron/configs/config.yml
  2. environment variables
  3. defaults

Path resolution​

When config.yml (or a path environment variable) contains a relative path, Ogoron resolves it against the repository root.

Empty values are ignored.

Environment variables​

Required:

  • OGORON_KEY

Optional (paths overrides):

  • OGORON_TESTS_PATH
  • OGORON_SUPPORT_PATH

Optional (output formatting):

  • OGORON_PLAIN (also enabled automatically when CI=true)
  • OGORON_NO_COLOR (also respects NO_COLOR)

Optional (networking):

  • HTTP_PROXY, HTTPS_PROXY, NO_PROXY (and lowercase variants)

Validate after changes​

After editing configs, validate:

ogoron init validate

Next steps​