It is considered a good practice to store tests and test projects in source control. This way, you can easily work on your tests along with your teammates, share your test cases, revert changes, and so on.
ReadyAPI 2.5 and later include built-in support for Git repositories. This allows you to put your test project files to and get them from a Git repository directly from within the ReadyAPI UI, without using any third-party tool.
If you use a ReadyAPI version earlier than 2.5, then to integrate with Git, you should use the Git integration plugin.
ReadyAPI supports Git repositories located in repository-hosting systems like GitHub, GitLab or Bitbucket, as well as Git repositories that reside on servers in your local network.
Git integration commands in ReadyAPI works with composite projects only. These projects store test cases and other data as separate files instead of a single XML file. To make your project composite and enable integration with Git:
Double-click the project in the Navigator panel to open the project editor, and click the Enable integration with Git button in the editor toolbar:
If your project was not saved, ReadyAPI shows the Save project dialog. Select the location where you want to save the project, enter the project name and click Save.
|Note:||You can make your project composite by setting the Composite Project property of your project to
Also, we recommend that you enable the following two ReadyAPI settings:
Pretty print project files in the Preferences > WSDL dialog box, and
Normalize line-break in the Preferences > UI dialog box.
This will make your ReadyAPI project files friendlier to the “auto-merge” feature of Git. To learn more, see Merging changes.
To get a project from a Git repository and open it, select File > Import Project from Git and specify a Git repository:
In the Project Directory field, select an empty directory, to which ReadyAPI will place the project from the repository.
Select the protocol (SSH or HTTPS) you use to connect to the repository and specify the connection settings:
For the HTTPS protocol, specify the username and password to access the repository.
|If you use two-factor authentication on GitHub, specify a personal access token in the Password field.
For instructions on how to generate a personal access token, see https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line.
For the SSH protocol, specify the path to your private key and the passphrase you use when generating it.
ReadyAPI will clone the repository from the default branch to your hard drive and open the project.
ReadyAPI offers a number of commands to perform typical operations on the project files. You can find them in the context menu you invoke for a project in the Navigator panel, and in the Project submenu of the main menu:
Once your project is in the repository, you use the menu commands to work with it. For more information, see the following topics: