Naming Conventions Checking

Many times naming conventions are established. For example each constant identifier should be written using capital letters or each buffer should end with _buff.

Naming conventions are automatically checked when building a project. You just need to define them:

Right click on the project, choose Properties ‣ DVT ‣ Naming Conventions preference page.

Naming conventions can be shared using Settings Management. Managed naming conventions are not editable and are marked with gray color.

The conventions are identical if they have the same name and apply to the same language. In this case, the precedence is:

  • name checks defined in .dvt (the last defined convention has the highest priority)

  • name checks coming from $DVT_USER_SETTINGS/naming_conventions.xml

  • name checks coming from $DVT_COMMON_SETTINGS/naming_conventions.xml

Overridden naming conventions are marked with a strike out line.

Note

If no naming_conventions.xml file is present in the project’s .dvt directory, default rules will be shown. They are not enabled and will not override any rule defined in $DVT_USER_SETTINGS or $DVT_COMMON_SETTINGS.

../../_images/pss-get_started-naming_conv-props.png
../../_images/pss-get_started-naming_conv-newrule.png

Naming convention violations are presented as warnings in the Problems View. You can show the Problems View from menu Window ‣ Show View ‣ Other… ‣ General ‣ Problems. Double clicking on some warning will jump to the source location.

Configuration file

User defined naming conventions are stored in the .dvt/naming_conventions.xml file.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE conventions PUBLIC "-//DVT//naming_conventions" "naming_conventions.dtd">
<conventions version="1">
<convention description="" enabled="true" kind="STREAM" language="PSS" match="POSITIVE" name="MY_CONVENTION">.*_str$</convention>
<convention description="" enabled="true" kind="ACTION" language="PSS" match="POSITIVE" name="ANOTHER_CONVENTION">.*_a$</convention>
</conventions>

For example, the first convention is for PSS, is named “MY_CONVENTION”, is applicable for streams and the pattern .*_str$ (the name of the stream must end with _str ) must match the name of every stream, else a warning will be triggered.