Skip to content

Conversation

@jrfnl
Copy link
Member

@jrfnl jrfnl commented May 12, 2021

This class initially introduces five new utility methods for working with error/warning messages.

The class currently contains the following methods:

  • addMessage() - simple method to add either an error or a warning to PHPCS based on an $isError parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
  • addFixableMessage() - simple method to add either a fixable error or a fixable warning to PHPCS based on an $isError parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
  • stringToErrorcode() - to convert an arbitrary text string to an alphanumeric string with underscores. Returns the adjusted text string.
    This method is intended to pre-empt issues in XML and PHP when arbitrary text strings are used as (part of) an error code.
  • hasNewLineSupport() - to check whether PHPCS can properly handle new lines in violation messages.
    Prior to PHPCS 3.3.1, new line support in error messages was buggy.
    Ref: Report Full: various message formatting fixes squizlabs/PHP_CodeSniffer#2093
  • showEscapeChars() - to make the whitespace escape codes used in an arbitrary text string visible. Returns string.

Includes dedicated unit tests for each method.

@jrfnl jrfnl added this to the 1.0.0-alpha4 milestone May 12, 2021
@jrfnl jrfnl force-pushed the feature/new-message-helper-class branch from 25e1249 to 2bf2013 Compare May 12, 2021 08:32
This class initially introduces five new utility methods for working with error/warning messages.

The class currently contains the following methods:
* `addMessage()` - simple method to add either an error or a warning to PHPCS based on an `$isError` parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
* `addFixableMessage()` - simple method to add either a fixable error or a fixable warning to PHPCS based on an `$isError` parameter.  Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
* `stringToErrorcode()` - to convert an arbitrary text string to an alphanumeric string with underscores. Returns the adjusted text string.
    This method is intended to pre-empt issues in XML and PHP when arbitrary text strings are used as (part of) an error code.
* `hasNewLineSupport()` - to check whether PHPCS can properly handle new lines in violation messages.
    Prior to PHPCS 3.3.1, new line support in error messages was buggy.
    Ref: squizlabs/PHP_CodeSniffer#2093
* `showEscapeChars()` - to make the whitespace escape codes used in an arbitrary text string visible. Returns string.

Includes dedicated unit tests for each method.
@jrfnl jrfnl force-pushed the feature/new-message-helper-class branch from 157d2bb to 581c21a Compare May 12, 2021 19:58
@jrfnl jrfnl merged commit cb5f20c into develop May 12, 2021
@jrfnl jrfnl deleted the feature/new-message-helper-class branch May 12, 2021 21:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

2 participants