This section lists and answers frequently asked questions about usage of Arjuna.

Although some information might be repeated from elsewhere, it extends the overall documentation coverage by providing new, additional insights and pointers.

Can I Make an Arjuna Test Project depend on another Arjuna Test Project?


Method 1 (Basic): ArjunaOption.DEPS_DIR

For simple dependency, where you just want to use the library from another Arjuna Test Project, you can set ArjunaOption.DEPS_DIR in your reference configuration (e.g. project.yaml) or CLI option to point to the directory that contains the project.

For example let’s say “parent” project depends on “child” and “child” is contained in the /abc/def/root/child location. Then:
  • You can set deps.dir = /abc/def/root in project.yaml
  • You can as well pass --ao deps.dir /abc/def/root in the command line.

The path can also be a relative path. Arjuna will consider it relative to the root of parent Arjuna project.

For example, let’s consider the following directory structre:
  • Child project: /abc/def/root/child
  • Parent project: /abc/def/xyz/parent

In the above case deps.dir can be passed as ../../root.

Can I Maintain Local Configuration (.local) Files That Override the Default Configuration Files?


Need for Local Config Files

When you work as team then at times you need to create configuration files that are local to your development machine.

There are various reasons to need this feature:
  • You are experimenting with a configuration value.
  • You have local deployed environments.
  • You want to use a temporary user account to test a transient/under-development feature.

and so on.

Supported Local Config Files

Arjuna supports maintaining local versions of all its configuration files. Following table provides the names of the local files and corresponding default files:

Local Config File Names
Local Config File Name Corresponding Default Config File Name
project.local.yaml project.yaml
data.local.yaml data.yaml
envs.local.yaml envs.yaml
groups.local.yaml groups.yaml
withx.local.yaml withx.yaml

What Happens When a Local Config File is Present?

When a local file is present then Arjuna loads this file and IGNORES the default corresponding config file.

Creating local config files is optional and you can create one or more of them as paer your need.

Configuring Version Control To Avoid Check-In of Local Config Files

A suggested practice is to set your version control software to ignore local config files during check-in so that different people in your team can maintain their own versions of these local config files.

For example, if you are using Git, then you can add the following to .gitignore: