# ManageIQ cross-repository testing framework

```
Usage: manageiq-cross_repo --test-repo repo [--repos repo1 repo2 ...]

manageiq-cross_repo is a cross repository test framework for the ManageIQ project.
Its purpose is to allow running multiple repository tests suites in the context
of other repositories and is particularly useful when trying to determine if the
changes you are making as a developer will affect the other test suites.

Options:
  -t, --test-repo=<s>     This is the repository which will be tested.
                          Can also be passed as a TEST_REPO environment variable.
                           (default: ManageIQ/manageiq@master)
  -r, --repos=<s+>        Optional, a list of other repos and/or gems to override while running the tests.
                          If any of the repositories in the list are a core repository that will
                          be used as the root repository, otherwise ManageIQ/manageiq@master will be the default.
                          Can also be passed as a REPOS environment variable.
                           (default: )
  -e, --test-suite=<s>    Optional, the name of a rake test suite to pass as an environment variable to the test being run.
                          This is commonly used by the CI config to conditionally perform different setup tasks
                          and also to run different test suites, e.g. spec:javascript.
  -s, --script-cmd=<s>    Optional, a command string for running the specs.
                          If present this will override the the script section of the test_repo's CI config

  -v, --version           Print version and exit
  -h, --help              Show this message

Repo Formats:
  Remote: [org/]repository[@ref|#pr]
    org:        Optional, defaults to ManageIQ.
    repository: Required, the name of the repository.
    @ref:       Optional, defaults to master if #pr not set. Can be a branch, tag, or SHA. Mutually exclusive with #pr.
    #pr:        Optional, references a pull-request number. Mutually exclusive with @ref.

  URL: https://github.com/org/repository, https://github.com/org/repository/tree/branch,
       https://github.com/org/repository/commit/sha, https://github.com/org/repository/pull/pr

  Local: Either a fully qualified path or a relative path (e.g. /path/to/repo, ~/relative/to/home, ../relative/to/current/dir)

Examples:
  # Test a plugin against ManageIQ master
  manageiq-cross_repo --test-repo manageiq-ui-classic

  # Test a plugin against a ManageIQ SHA
  manageiq-cross_repo --test-repo manageiq-ui-classic --repos manageiq@1234abcd

  # Test a plugin branch
  manageiq-cross_repo --test-repo manageiq-ui-classic@feature

  # Test a plugin branch from a fork
  manageiq-cross_repo --test-repo johndoe/manageiq-ui-classic@feature

  # Test a plugin PR
  manageiq-cross_repo --test-repo manageiq-ui-classic#1234

  # Test a plugin with a set of other plugins
  manageiq-cross_repo --test-repo manageiq-ui-classic --repos manageiq-providers-vmware@feature manageiq-content@feature

  # Test a plugin branch with a ManageIQ SHA and a set of other plugins
  manageiq-cross_repo --test-repo manageiq-ui-classic@feature --repos manageiq@1234abcd manageiq-providers-vmware@feature manageiq-content@feature

  # Run core tests with ManageIQ master using a gem version
  manageiq-cross_repo --repos johndoe/manageiq-ui-classic@feature

  # Run core tests for a branch and a set of gems
  manageiq-cross_repo --test-repo johndoe/manageiq@feature --repos manageiq-providers-vmware@feature manageiq-content@feature
```

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).