# Artistic Style Subversion Repository

### Artistic Style

The latest development source is in the Artistic Style repository at SourceForge. It can be checked out using Subversion. The source code is under development and some changes take several weeks to complete. The intermediate source files have not been through the extensive system tests that are done before each release. Use reasonable precautions when using source code from the repository.

The current version is in the "trunk/AStyle" branch of the repository. The file and directory names are case sensitive.

A sample checkout is:
svn checkout "https://svn.code.sf.net/p/astyle/code/trunk/AStyle" "$HOME/astyle"

You can also browse the subversion repository. The current development release is in the "trunk" directory. This gives you a view into the current status of the project's code without actually checking-out the files.

### Other Projects

Two additional Artistic Style projects are available in the repository. They are not maintained for the general public, but are available if you want them. You may have to create your own project files and scripts to use them.

All projects, and any additional source required, should be installed in the same top level folder. A sample file directory containing ALL the projects should look as follows. The project dependencies are described below.

        Projects
            AStyle
            AStyleDev
            AStyleTest
            AStyleWx
            AStyleWxTest
            googlemock
            googletest

#### AStyleDev

AStyleDev contains the development files that are made available in the "Developer Information" section. Refer to that section for more information.

These projects require the Artistic Style project to compile.

A sample checkout is:
svn checkout "https://svn.code.sf.net/p/astyle/code/trunk/AStyleDev" "$HOME/astyledev"

#### AStyleTest

AStyleTest contains the unit test programs and test scripts for Artistic Style. There are over 2500 tests in the main test program.

This project requires the Artistic Style project to compile. In addition, the test program requires Google Mock and Google Test described below.

The main test project, AStyleTest, can be run in Visual Studio using the graphical Visual Studio Test Explorer. The procedure is described below.

A sample checkout is:
svn checkout "https://svn.code.sf.net/p/astyle/code/trunk/AStyleTest" "$HOME/astyletest"

#### AStyleWx

AStyleWx contains a GUI test program for Artistic Style that uses the wxWidgets C++ library.

This project requires the Artistic Style project to compile. Files for download are made available in the Artistic Style Wx subproject. The download contains all files needed to compile the project. The subproject can be accessed from the Artistic Style SourceForge pages.

A sample checkout is:
svn checkout "https://svn.code.sf.net/p/astyle/code/trunk/AStyleWx" "$HOME/astylewx"

#### AStyleWxTest

AStyleTest contains the unit test programs and test scripts for AStyleWx.

This project requires the AStyleWx project to compile. In addition, the test program requires Google Mock and Google Test described below.

A sample checkout is:
svn checkout "https://svn.code.sf.net/p/astyle/code/trunk/AStyleWxTest" "$HOME/astylewxtest"

#### Google Mock and Google Test

Google Test and Google Mock is the Google multi-platform framework for writing C++ unit tests. It is available on GitHub and can be downloaded as a zip file by pressing the green "clone or download" button and selecting "Download ZIP". The default is to download the master development branch. The latest stable release can be obtained by using the drop-down box labeled "Branch: master", selecting the "tags" tab, and then selecting the latest release. The selected release can then be downloaded using the "clone or download" button. Download the latest release for googletest and googlemock from the repository.

The Artistic Style project files are set up to use googletest and googlemock installed in the top level folder as indicated above. The library compile for googlemock includes googletest. The library compile for googletest includes only googletest. The AStyle test programs have their own project files for compiling the test platform. There are also compile project files in the downloaded google modules if you want to use them. They create a static library file that is linked to the test program. The google downloads contain instructions for using the package.

#### Visual Studio Test Explorer

Some of the test projects can be run in Visual Studio Community using Visual Studio Test Explorer. If there is a .gta.runsettings file in the solution directory for a test project, the test will run in the Test Explorer.

The "Google Test Adapter" extension must be installed from the Tools > "Extensions and Updates" menu. After restarting Visual Studio the test window is activated from the Test > Window > "Test Explorer" menu option. After compiling, the tests will appear in the test window. Then they may be run from the "Test Explorer" window or from the Test menu options.

Test Explorer may be used for other test projects. The tests can also be run as a command line program by using the standard debug or run button on the menu or toolbar.