add a rule to check that affirm is used for Assertion

[pnatashap]

In case of using org.llorllale.cactoos.matchers.Assertion<>() affirm method should be called to perform validation.

new Assertion<>(
            "toArray() must be equals to original",
            new Immutable<>(
                new ListOf<>(1, 2)
            ).toArray(),
            new IsEqual<>(
                new ListOf<>(1, 2).toArray()
            )
        ).affirm(); // is good

new Assertion<>(
            "toArray() must be equals to original",
            new Immutable<>(
                new ListOf<>(1, 2)
            ).toArray(),
            new IsEqual<>(
                new ListOf<>(1, 2).toArray()
            )
        ); // error should be displayed, affirm is needed

[github-actions]

@pnatashap thanks for the report, but here some unclear moments:

• The title of the bug report is not clear. It should be more specific and descriptive about the bug.
• The description of the bug is not detailed enough. It should clearly state the expected and actual behavior.
• The bug report lacks information about the environment in which the bug was found. This could include the software version, operating system, and hardware.
• The bug report lacks steps to reproduce the bug. This is crucial for developers to understand and fix the bug.
• The bug report does not include any error messages or logs. These can provide valuable clues about the cause of the bug.

How to fix:

• Make the title more descriptive and specific to the bug.
• Provide a detailed description of the bug including the expected and actual behavior.
• Include information about the environment such as the software version, operating system, and hardware.
• Provide clear steps to reproduce the bug.
• Include any error messages or logs that were displayed when the bug occurred.

Please fix the bug report in order it to get resolved faster.
Analyzed with gpt-4

[IlyaPechersky]

@pnatashap can you please assign this issue to me?

[pnatashap]

@IlyaPechersky I do not have permissions to assign issues, you can ask Yegor or just create a PR.
Fill free to ping me for review

[IlyaPechersky]

@pnatashap, I looked at different options, but I don’t see a suitable one. Can you please suggest me which AST class is best to use to describe org.llorllale.cactoos.matchers.Assertion<>()?
Or can you tell me who to turn to for advice?

[pnatashap]

@IlyaPechersky actually you need to create a new rule, so you can check the full list and find something similar https://docs.pmd-code.org/latest/pmd_rules_java.html. For example, XPath rules is easy to write, but it is not so powerfull, some of them are implemented in code.

Example rule with the similar functionality https://github.com/pmd/pmd/blob/master/pmd-java/src/main/java/net/sourceforge/pmd/lang/java/rule/bestpractices/CheckResultSetRule.java