Using Subversion (SVN) Source Control From ATEasy

Knowledge Base Article # Q200298

Read Prior Article Read Next Article
Summary Tutorial to describe how to use the ATEasy integrated Source Control interface used to Add, Check In, Check Out, Merge, Show History and more. ATEasy supports two source control clients SCC API and a command line interface. In this example we are using the Subversion Tortoise command-line client. Other clients perform in a similar manner.

How to Use Tortoise SVN With ATEasy

1. Download and install TortoiseSVN (x86 or x64 depending on your system) from SourceForge.net. Make sure Command line client tools are installed.
Install TortoiseSVN and make sure command line client tools are installed
Figure 1: Install TortoiseSVN and make sure command line client tools are installed.


2. Using Windows explorer, create a folder to host the repository (local or server). Right click the newly created folder and select TortoiseSVN and select Create Repository Here. Click on Create folder structure.
Creating a TortoiseSVN repository
Figure 2: Creating a TortoiseSVN repository.


3. Open ATEasy, select Tools, Options, then the Source Control tab. In the drop-down box select Subversion. Make sure the executable is correct; if not, locate the file and update the Executable field. Click Close and confirm your selection.
Select the TortoiseSVN executable
Figure 3: Select the TortoiseSVN executable.


4. Open a workspace and select the project you wish to add to the source control repository. Right click on the Project from the workspace window and select Add:
Add your project to the Source Control Repository
Figure 4: Add your project to the Source Control Repository.


5. In the Add Files to Source Control dialog do the following:
  • Type in the Repository Root (server or local folder where you created the repository).
  • Type in the Subfolder - usually the project name where the files added will be stored in the repository.
  • Type in the Working Copy Folder - the root folder for your local files where the project resides. Note that all the Added files should be located below this root folder.
  • Check the files that you want to add. Note not to select files that reside in a folder outside of the working folder.
Add Files to Source Control
Figure 5: Add Files to Source Control.


Next, click OK to add the files. You will get the following message if TestExec Subfolder in the repository does not exist.
Subfolder if the repository does not exist
Figure 6: Subfolder if the repository does not exist.


Click Yes to add the files to the repository and put them under source control (show in Cyan color in the workspace window). The files are also checked off as shown here:
Files under source control have check marks
Figure 7: Files under source control have check marks.


Note: The Log window's Source Control tab will show all the commands invoked by ATEasy to perform the operation (Add Files in this case). This log can also be used to troubleshoot the operation in case of issues that may result from wrong command line configuration set by the Options dialog or wrong parameters invoked by ATEasy. The command reply is also visible. The Log window is color coded so that commands invoked by ATEasy shows in blue, reply from the source control tool show in green, and error replies in red.
The Log window Source Control tab
Figure 8: The Log window Source Control tab.


Note: The information about the repository and the local working folder is saved in the ATEasy Workspace file used when you added the file to the source control repository.

6. You can check the latest status of the file in the source control repository using the Source Control > Show Properties command.
Source Control File Properties
Figure 9: Source Control File Properties.


7.
To add the other files that reside under the Drivers folder, repeat steps 4 and 5. Select the Profile and the Test Exec drivers and add them to the repository under the Drivers subfolder and C:\Program Files\ATEasy 9.0\Drivers working folder.
Add the Other Files that reside under the Drivers folder
Figure 10: Add the Other Files that reside under the Drivers folder.


At this point all the project files are added and checked off as shown here:
All project files are added and checked off
Figure 11: All project files are added and checked off.


8. You now can make changes to the files , save them, and when ready, re-check the files in. For example, change the TestExec1.prg and check it in. You can also add a comment to describe the changes made as shown here:
Check In
Figure 12: Check In.


9. You can open the Source Control History dialog and see all the revisions of the files that were checked in, including the revision number, the user, the date and the comment:
Source Control History
Figure 13: Source Control History.


You  can select the revision you need and then click on Get to copy that revision to a folder you select:
Get a copy of a revision
Figure 14: Get a copy of a revision.


Use Open to open that revision in ATEasy, View Text to view the revision in text mode, and Diff to show the difference between the revision and the version you have as shown here:
Use Diff to show the difference between the revision and the version you have
Figure 15: Use Diff to show the difference between the revision and the version you have.


10. The Get Files operation is useful when you no longer have the files locally and you want to retrieve them from source control. To get files from the repository, right click and go to Source Control > Get Files.
Get Files from Source Control
Figure 16: Get Files from Source Control.

Article Date 9/28/2016 3:30:13 PM     Updated: 2/22/2017 12:15:47 PM
Keywords

0 ratings | 0 out of 5
Read Prior Article Read Next Article