About Aqua IDE

Testing

Besides UI testing and API testing, Aqua supports most of the popular frameworks such as JUnit, TestNG, Cucumber, Arquillian, JUnit, and so on.

You can take full advantage of such default key features as navigation between source code and tests, test statistics, and code coverage analysis.

Editor basics

Since in Aqua you can undo refactorings and revert changes from Local History, it makes no sense to ask you to save your changes every time.

The most useful Editor shortcuts are:

To expand a selection based on grammar, press Ctrl+W. To shrink it, press Ctrl+Shift+W.

Aqua can select more than one piece of code at a time. You can select next occurrence via Alt+J and deselect by pressing Alt+Shift+J. You can even select all occurrences at once, by pressing Ctrl+Alt+Shift+J.

Code completion

When you access Basic Completion by pressing Ctrl+Space, you get basic suggestions for variables, types, methods, expressions, for a parameter name you get type suggestions and so on. When you call Basic Completion twice, it shows you more results, including methods from implicit conversions that you can import.

The Smart Completion feature is aware of the expected type and data flow, and offers the options relevant to the context. To call Smart Completion, press Ctrl+Shift+Space. When you call Smart Completion twice, it shows you more results, including chains.

To let Aqua complete a statement for you, press Ctrl+Shift+Enter. Statement Completion will automatically add the missing parentheses, brackets, braces and the necessary formatting.

If you want to see the suggested parameters for any method or constructor, press Ctrl+P. Aqua shows the parameter info for each overloaded method or constructor, and highlights the best match for the parameters already typed.

The Postfix Completion feature lets you transform an already typed expression to another one, based on the postfix you type after a dot.

Navigation

Navigation shortcuts include:

Quick popups

Quick Popups are helpful for checking additional information related to the symbol at the caret. Below is a list of popups you should know if you want to be more productive:

Refactoring basics

Aqua offers a comprehensive set of automated code refactorings that lead to significant productivity gains when used correctly. Firstly, don't bother selecting anything before you apply a refactoring. Aqua is smart enough to figure out what statement you're going to refactor, and only asks for confirmation if several choices are possible.

Finding usages

Find Usages helps you quickly find all pieces of code referencing the symbol at the caret (cursor), no matter if the symbol is a class, method, field, parameter, or another statement. Just press Alt+F7 and get a list of references grouped by usage type, module, and file.

If you want to set custom options for the Find Usages algorithm, press Ctrl+Alt+Shift+F7, or click the first button on the right panel with search results.

If what you're looking for is plain text, use Find in Files by pressing Ctrl+Shift+F.

Inspections

Inspections are built-in static code analysis tools that help you find probable bugs, locate dead code, detect performance issues, and improve the overall code structure.

Most inspections not only tell you where a problem is, but also provide quick fixes to deal with it right away. Press Alt+Enter to choose a quick-fix.

Inspections that are too complex to be run on-the-fly are available when you perform code analysis for the entire project. You can do this in one of the following two ways: by selecting Code | Running Code Cleanup with profile ''{0}''… from the main menu, or by selecting Code | Analyze Code | Run Inspection by Name… to run an inspection by its name.

Note that while inspections provide quick-fixes for code that has potential problems, intentions help you apply automatic changes to code that is correct. To get a list of intentions applicable to the code at the caret, press Alt+Enter.

Code style and formatting

Aqua automatically applies a code style you've configured in the Code Style settings as you edit, and in most cases you don't need to call the Reformat Code action explicitly.

Check the following formatting shortcuts:

Run and debug

Once you've created a run/debug configuration by selecting Run | Edit Configurations from the main menu, you are able to run and debug your tests.

The regular actions for run/debug are as follows:

When in the debug mode, you can evaluate any expression by using the Evaluate expression tool, which is accessed by pressing Alt+F8. This tool provides code completion in the same way as in the editor, so it's easy to enter any expression.

Sometimes, you may want to step into a particular method, but not the first one which will be invoked. In this case, use Smart step into by pressing Shift+F7 to choose a particular method.

If you want to "rewind" while debugging, you can do it via the Drop Frame action. This is particularly helpful if you mistakenly stepped too far. This will no revert the global state of your application, but will at least let you revert to a previous stack frame.

Build

When you've imported or created a project with Gradle or Maven, you can edit its build script file directly in the editor. You can specify compiler options, information about your sub-projects, and also define your tasks and settings. Every time you change the build script file, you need to synchronize your changes with the project model in Aqua.

You can configure the Reload project after changes in the build scripts option to synchronize the changes made to the build script file automatically. To access this option, select File | Settings | Build, Execution, Deployment | Build Tools.

For manual synchronization, use the corresponding action on the build tool window toolbar: .

Other supported tools

Aqua IDE also supports the following additional tools to improve your testing experience:

• Databases: a plugin with top-tier functionality available for every part of your workflow that needs testing including database work. DataGrip is an IDE specifically designed for database development, and a powerful database plugin, which provides Aqua with this very same support for all the features. Aqua comes with a database browser and editor built in, so you can easily run verification tests and manipulate your test data.

• Docker: a plugin for deploying and running executables in isolated and reproducible environments. This may be useful, for example, to test code in an environment identical to production. Aqua provides Docker support using the Docker plugin. The plugin is bundled and enabled by default.

  For more information, refer to Docker.

• Test Management: a plugin that provides integration with test management tools for more transparent interaction between the DEV and QA teams. It supports browsing test suites and case hierarchies, navigation for TMS items, generates unit tests for selected test scenarios, and helps find non-automated test cases or obsolete test methods.

  For more information, refer to Get started with TMS integration.

• Test Data: a plugin that allows generating test data of different types such as names, emails, dates, and so on.

  For more information, refer to the plugin's page.