SONARPY-2379 Update the custom rules in the sonar-python repository to match LAYC format (#2188)

Author: maksim-grebeniuk-sonarsource

docs/pom.xml

@@ -14,7 +14,7 @@
   <name>SonarQube Python :: Documentation</name>
 
   <modules>
-    <module>python-custom-rule-examples</module>
+    <module>python-custom-rules-example</module>
   </modules>
 
 </project>

docs/python-custom-rule-examples/src/main/java/org/sonar/samples/python/CustomPythonRuleRepository.java

@@ -9,44 +9,51 @@
     <version>4.25-SNAPSHOT</version>
   </parent>
 
-  <artifactId>python-custom-rule-examples</artifactId>
+  <artifactId>python-custom-rules-example</artifactId>
   <packaging>sonar-plugin</packaging>
 
   <name>SonarQube Python :: Documentation :: Custom Rules Example</name>
   <description>Python custom rule examples for SonarQube</description>
 
   <properties>
-    <sonar.python.version>3.15.0.9787</sonar.python.version>
+    <sonar.python.version>4.24.0.18631</sonar.python.version>
   </properties>
   <dependencies>
     <dependency>
-      <groupId>org.sonarsource.sonarqube</groupId>
+      <groupId>org.sonarsource.api.plugin</groupId>
       <artifactId>sonar-plugin-api</artifactId>
-      <version>7.9</version>
       <scope>provided</scope>
     </dependency>
+    <dependency>
+      <groupId>org.sonarsource.analyzer-commons</groupId>
+      <artifactId>sonar-analyzer-commons</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.sonarsource.sonarqube</groupId>
+      <artifactId>sonar-plugin-api-impl</artifactId>
+      <scope>test</scope>
+    </dependency>
     <dependency>
       <groupId>org.sonarsource.python</groupId>
       <artifactId>sonar-python-plugin</artifactId>
       <type>sonar-plugin</type>
-      <version>${sonar.python.version}</version>
+      <version>${project.version}</version>
       <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>org.sonarsource.python</groupId>
       <artifactId>python-checks-testkit</artifactId>
-      <version>${sonar.python.version}</version>
+      <version>${project.version}</version>
       <scope>test</scope>
     </dependency>
     <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <version>4.13.1</version>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
       <scope>test</scope>
     </dependency>
     <dependency>
-      <groupId>org.mockito</groupId>
-      <artifactId>mockito-core</artifactId>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-api</artifactId>
       <scope>test</scope>
     </dependency>
   </dependencies>
@@ -56,22 +63,21 @@
       <plugin>
         <groupId>org.sonarsource.sonar-packaging-maven-plugin</groupId>
         <artifactId>sonar-packaging-maven-plugin</artifactId>
-        <version>1.21.0.505</version>
         <extensions>true</extensions>
         <configuration>
           <pluginClass>org.sonar.samples.python.CustomPythonRulesPlugin</pluginClass>
-          <requirePlugins>python:${sonar.python.version}</requirePlugins>
-          <sonarLintSupported>true</sonarLintSupported>
-          <skipDependenciesPackaging>true</skipDependenciesPackaging>
+          <requirePlugins>python:${project.version}</requirePlugins>
+          <pluginApiMinVersion>${pluginApiMinVersion}</pluginApiMinVersion>
+          <requiredForLanguages>py,ipynb</requiredForLanguages>
         </configuration>
       </plugin>
 
       <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.7.0</version>
         <configuration>
-          <source>1.8</source>
-          <target>1.8</target>
+          <source>17</source>
+          <target>17</target>
         </configuration>
       </plugin>
       <plugin>

docs/python-custom-rule-examples/src/test/java/org/sonar/samples/python/CustomPythonRuleRepositoryTest.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (C) 2011-2024 SonarSource SA - mailto:info AT sonarsource DOT com
+ * This code is released under [MIT No Attribution](https://opensource.org/licenses/MIT-0) license.
+ */
+package org.sonar.samples.python;
+
+import java.util.ArrayList;
+import java.util.List;
+import org.sonar.api.SonarRuntime;
+import org.sonar.api.server.rule.RulesDefinition;
+import org.sonar.plugins.python.api.PythonCustomRuleRepository;
+import org.sonarsource.analyzer.commons.RuleMetadataLoader;
+
+public class CustomPythonRuleRepository implements RulesDefinition, PythonCustomRuleRepository {
+  public static final String RESOURCE_BASE_PATH = "/org/sonar/l10n/python/rules/python";
+  public static final String REPOSITORY_KEY = "python-custom-rules-example";
+  public static final String REPOSITORY_NAME = "MyCompany Custom Repository";
+
+  private final SonarRuntime runtime;
+
+  public CustomPythonRuleRepository(SonarRuntime runtime) {
+    this.runtime = runtime;
+  }
+
+  @Override
+  public void define(Context context) {
+    NewRepository repository = context.createRepository(REPOSITORY_KEY, "py").setName(REPOSITORY_NAME);
+    RuleMetadataLoader ruleMetadataLoader = new RuleMetadataLoader(RESOURCE_BASE_PATH, runtime);
+    ruleMetadataLoader.addRulesByAnnotatedClass(repository, new ArrayList<>(RulesList.getChecks()));
+    repository.done();
+  }
+
+  @Override
+  public String repositoryKey() {
+    return REPOSITORY_KEY;
+  }
+
+  @Override
+  public List<Class<?>> checkClasses() {
+    return new ArrayList<>(RulesList.getChecks());
+  }
+}

docs/python-custom-rule-examples/pom.xml renamed to docs/python-custom-rules-example/pom.xml

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2011-2024 SonarSource SA - mailto:info AT sonarsource DOT com
+ * This code is released under [MIT No Attribution](https://opensource.org/licenses/MIT-0) license.
+ */
+package org.sonar.samples.python;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Stream;
+import org.sonar.plugins.python.api.PythonCheck;
+import org.sonar.samples.python.checks.CustomPythonSubscriptionCheck;
+import org.sonar.samples.python.checks.CustomPythonVisitorCheck;
+
+public final class RulesList {
+
+  private RulesList() {
+  }
+
+  public static List<Class<? extends PythonCheck>> getChecks() {
+    return new ArrayList<>(Stream.concat(
+      getPythonChecks().stream(),
+      getPythonTestChecks().stream()
+    ).toList());
+  }
+
+  /**
+   * These rules are going to target MAIN code only
+   */
+  public static List<Class<? extends PythonCheck>> getPythonChecks() {
+    return new ArrayList<>(List.of(
+      CustomPythonSubscriptionCheck.class
+    ));
+  }
+
+  /**
+   * These rules are going to target TEST code only
+   */
+  public static List<Class<? extends PythonCheck>> getPythonTestChecks() {
+    return new ArrayList<>(List.of(
+      CustomPythonVisitorCheck.class
+    ));
+  }
+}

docs/python-custom-rules-example/src/main/java/org/sonar/samples/python/CustomPythonRuleRepository.java

@@ -4,17 +4,12 @@
  */
 package org.sonar.samples.python.checks;
 
-import org.sonar.check.Priority;
 import org.sonar.check.Rule;
 import org.sonar.plugins.python.api.PythonSubscriptionCheck;
 import org.sonar.plugins.python.api.tree.ForStatement;
 import org.sonar.plugins.python.api.tree.Tree;
 
-@Rule(
-  key = CustomPythonSubscriptionCheck.RULE_KEY,
-  priority = Priority.MINOR,
-  name = "Python subscription visitor check",
-  description = "desc")
+@Rule(key = CustomPythonSubscriptionCheck.RULE_KEY)
 public class CustomPythonSubscriptionCheck extends PythonSubscriptionCheck {
 
   public static final String RULE_KEY = "subscription";

docs/python-custom-rule-examples/src/main/java/org/sonar/samples/python/CustomPythonRulesPlugin.java renamed to docs/python-custom-rules-example/src/main/java/org/sonar/samples/python/CustomPythonRulesPlugin.java

@@ -4,16 +4,11 @@
  */
 package org.sonar.samples.python.checks;
 
-import org.sonar.check.Priority;
 import org.sonar.check.Rule;
 import org.sonar.plugins.python.api.PythonVisitorCheck;
 import org.sonar.plugins.python.api.tree.FunctionDef;
 
-@Rule(
-  key = CustomPythonVisitorCheck.RULE_KEY,
-  priority = Priority.MINOR,
-  name = "Python visitor check",
-  description = "desc")
+@Rule(key = CustomPythonVisitorCheck.RULE_KEY)
 public class CustomPythonVisitorCheck extends PythonVisitorCheck {
 
   public static final String RULE_KEY = "visitor";