Merge branch 'update-dependencies' into 'master'

Release 1.11 preparations

Closes #544

See merge request se2/scratch/litterbox/litterbox!785

Author: b-fein

Dockerfile

@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2019-2024 LitterBox contributors
+# Copyright (C) 2019-2025 LitterBox contributors
 #
 # This file is part of LitterBox.
 #

README.md

@@ -27,15 +27,15 @@ produce an executable jar-file, run the following command:
 mvn package
 ```
 
-This will produce `target/Litterbox-1.10.full.jar`
+This will produce `target/Litterbox-1.11.full.jar`
 
 
 ## Using LitterBox
 
 To see an overview of the command line options available in LitterBox type:
 
 ```bash
-java -jar Litterbox-1.10.full.jar --help
+java -jar Litterbox-1.11.full.jar --help
 ```
 
 ### Basic usage
@@ -44,7 +44,7 @@ LitterBox parses the JSON file of a Scratch project, which contains
 its source code. Given such a JSON file, LitterBox is invoked as follows:
 
 ```bash
-java -jar Litterbox-1.10.full.jar check --path <path/to/project.json>
+java -jar Litterbox-1.11.full.jar check --path <path/to/project.json>
 ```
 
 As a result, LitterBox will report any occurrences of bug patterns or
@@ -57,7 +57,7 @@ If you want to check a specific project given its ID (which you can
 find in the URL of the project), you can use the following command:
 
 ```bash
-java -jar Litterbox-1.10.full.jar check --project-id <project-id> --path <path/to/store/downloaded/project>
+java -jar Litterbox-1.11.full.jar check --project-id <project-id> --path <path/to/store/downloaded/project>
 ```
 
 When invoked this way, LitterBox will retrieve the JSON file
@@ -73,7 +73,7 @@ project IDs to check in a text file (one project ID per line) and
 invoke LitterBox as follows:
 
 ```bash
-java -jar Litterbox-1.10.full.jar check --project-list <path/to/projectidlist.txt> --path <path/to/projects>
+java -jar Litterbox-1.11.full.jar check --project-list <path/to/projectidlist.txt> --path <path/to/projects>
 ```
 
 LitterBox will check the given path for the projects.
@@ -90,7 +90,7 @@ filename specified in order to decide whether to produce CSV or JSON
 output:
 
 ```bash
-java -jar Litterbox-1.10.full.jar check --path <path/to/project.json> --output <result.csv>
+java -jar Litterbox-1.11.full.jar check --path <path/to/project.json> --output <result.csv>
 ```
 
 The CSV file will contain a high-level summary of the number of
@@ -102,7 +102,7 @@ analyzed Scratch-project, where all occurrences of bug patterns are
 highlighted with comments.
 
 ```bash
-java -jar Litterbox-1.10.full.jar check --path <path/to/project.json> --annotate <results/>
+java -jar Litterbox-1.11.full.jar check --path <path/to/project.json> --annotate <results/>
 ```
 
 
@@ -118,7 +118,7 @@ comma-separated list of bug patterns, e.g.:
 
 
 ```bash
-java -jar Litterbox-1.10.full.jar \
+java -jar Litterbox-1.11.full.jar \
     check \
     --path <path/to/project.json> \
     --detectors endless_recursion,call_without_definition
@@ -127,7 +127,7 @@ java -jar Litterbox-1.10.full.jar \
 A full list of available bug checkers can be retrieved using:
 
 ```bash
-java -jar Litterbox-1.10.full.jar --help
+java -jar Litterbox-1.11.full.jar --help
 ```
 
 To select all bug patterns, you can also use the term `bugs` in the
@@ -139,7 +139,7 @@ list; to select all code smell checks use `smells`.
 The bug patterns can be reported per scripts and procedures instead of for the whole program. In this case, only the bug patterns that can be detected through intra-scripts and intra-procedures analysis are considered.
 
 ```bash
-java -jar Litterbox-1.10.full.jar check \
+java -jar Litterbox-1.11.full.jar check \
     --path <path/to/project.json> \
     --output <result.csv> \
     --detectors script-bugs \
@@ -164,7 +164,7 @@ LitterBox can produce statistics on code metrics of a project (e.g.,
 number of blocks, number of sprites, weighted method count):
 
 ```bash
-java -jar Litterbox-1.10.full.jar \
+java -jar Litterbox-1.11.full.jar \
     stats \
     --path <path/to/project.json> \
     --output <statsfile.csv>
@@ -176,7 +176,7 @@ java -jar Litterbox-1.10.full.jar \
 LitterBox can generate a Graphviz `.dot` file representing various graphs of the project, such as the Abstract Syntax Tree (AST) or Control Flow Graph (CFG).
 
 ```bash
-java -jar Litterbox-1.10.full.jar dot --path <path/to/project.json> --output <output.dot> [--graph <GraphType>]
+java -jar Litterbox-1.11.full.jar dot --path <path/to/project.json> --output <output.dot> [--graph <GraphType>]
 ```
 
 Available graph types:
@@ -195,7 +195,7 @@ Available graph types:
 LitterBox provides a dedicated `mine` command for bulk downloading of Scratch projects. This is useful for creating datasets.
 
 ```bash
-java -jar Litterbox-1.10.full.jar mine --output <path/to/output/dir> [options]
+java -jar Litterbox-1.11.full.jar mine --output <path/to/output/dir> [options]
 ```
 
 Available options:
@@ -220,7 +220,7 @@ Scratch user CodeClubRik.
 Since version 1.7 Litterbox can automatically refactor a given Scratch project to improve its readability:
 
 ```bash
-java -jar Litterbox-1.10.full.jar \
+java -jar Litterbox-1.11.full.jar \
     refactoring \
     --path <path/to/project.json> \
     --output <path/to/output-dir>
@@ -233,16 +233,16 @@ The resulting set of refactored versions of the original project will be placed
 
 ### LLM Interaction
 
-Since version 1.10 LitterBox allows you to ask an LLM about a Scratch program and makes it possible to automatically integrate LLM-provided issue fixes into the program.
+Since version 1.11 LitterBox allows you to ask an LLM about a Scratch program and makes it possible to automatically integrate LLM-provided issue fixes into the program.
 You can find all features under the `llm` subcommand:
 ```bash
-java -jar Litterbox-1.10.full.jar llm --help
+java -jar Litterbox-1.11.full.jar llm --help
 ```
 
 It supports either the OpenAI API, or a self-hosted Ollama instance.
 To provide an OpenAI API key, start LitterBox like
 ```bash
-java -Dlitterbox.llm.openai.api-key=KEY Litterbox-1.10.full.jar llm …
+java -Dlitterbox.llm.openai.api-key=KEY Litterbox-1.11.full.jar llm …
 ```
 You can find other configuration options that can be passed via `-D` flags (e.g., model choice, Ollama API endpoint) in `src/main/resources/scratchllm.properties`.
 

checkstyle-litterbox.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!--
 
-    Copyright (C) 2019-2024 LitterBox contributors
+    Copyright (C) 2019-2025 LitterBox contributors
 
     This file is part of LitterBox.
 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>de.uni_passau.fim.se2</groupId>
     <artifactId>Litterbox</artifactId>
-    <version>1.11-SNAPSHOT</version>
+    <version>1.12-SNAPSHOT</version>
 
     <repositories>
         <repository>
@@ -33,7 +33,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-enforcer-plugin</artifactId>
-                <version>3.6.1</version>
+                <version>3.6.2</version>
                 <executions>
                     <execution>
                         <id>enforce-maven</id>
@@ -166,7 +166,7 @@
             <plugin>
                 <groupId>org.jacoco</groupId>
                 <artifactId>jacoco-maven-plugin</artifactId>
-                <version>0.8.13</version>
+                <version>0.8.14</version>
                 <configuration>
                     <excludes>
                         <exclude>de/uni_passau/fim/se2/litterbox/generated/**/*</exclude>
@@ -194,7 +194,7 @@
                 <version>5.0.0</version>
                 <configuration>
                     <properties>
-                        <year>2019-2024</year>
+                        <year>2019-2025</year>
                     </properties>
                     <licenseSets>
                         <licenseSet>
@@ -244,19 +244,19 @@
                     <dependency>
                         <groupId>com.puppycrawl.tools</groupId>
                         <artifactId>checkstyle</artifactId>
-                        <version>12.1.2</version>
+                        <version>12.3.0</version>
                     </dependency>
                 </dependencies>
             </plugin>
             <plugin>
                 <groupId>com.github.spotbugs</groupId>
                 <artifactId>spotbugs-maven-plugin</artifactId>
-                <version>4.9.6.0</version>
+                <version>4.9.8.2</version>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-pmd-plugin</artifactId>
-                <version>3.27.0</version>
+                <version>3.28.0</version>
             </plugin>
             <plugin>
                 <groupId>org.antlr</groupId>
@@ -281,7 +281,7 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
-        <langchain.version>1.6.0</langchain.version>
+        <langchain.version>1.9.1</langchain.version>
     </properties>
 
     <dependencies>
@@ -316,31 +316,25 @@
             <version>4.7.7</version>
         </dependency>
         <dependency>
-            <groupId>com.fasterxml.jackson.core</groupId>
+            <groupId>tools.jackson.core</groupId>
             <artifactId>jackson-databind</artifactId>
-            <version>2.20.0</version>
-        </dependency>
-        <dependency>
-            <groupId>com.fasterxml.jackson.datatype</groupId>
-            <artifactId>jackson-datatype-jdk8</artifactId>
-            <version>2.20.0</version>
+            <version>3.0.3</version>
         </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-csv</artifactId>
             <version>1.14.1</version>
         </dependency>
-        <!-- https://mvnrepository.com/artifact/junit/junit -->
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter</artifactId>
-            <version>6.0.0</version>
+            <version>6.0.1</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
-            <version>3.19.0</version>
+            <version>3.20.0</version>
         </dependency>
         <dependency>
             <artifactId>guava</artifactId>
@@ -350,7 +344,7 @@
         <dependency>
             <groupId>commons-io</groupId>
             <artifactId>commons-io</artifactId>
-            <version>2.20.0</version>
+            <version>2.21.0</version>
         </dependency>
         <dependency>
             <artifactId>truth</artifactId>
@@ -366,13 +360,13 @@
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-core</artifactId>
-            <version>5.20.0</version>
+            <version>5.21.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-junit-jupiter</artifactId>
-            <version>5.20.0</version>
+            <version>5.21.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>

src/main/java/de/uni_passau/fim/se2/litterbox/LlmSubcommand.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *

src/main/java/de/uni_passau/fim/se2/litterbox/Main.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *
@@ -36,7 +36,7 @@
 @CommandLine.Command(
         name = "LitterBox",
         mixinStandardHelpOptions = true,
-        version = "LitterBox 1.11-SNAPSHOT",
+        version = "LitterBox 1.12-SNAPSHOT",
         subcommands = {
                 // general commands
                 Main.CheckProgramsSubcommand.class,

src/main/java/de/uni_passau/fim/se2/litterbox/MineSubcommand.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *

src/main/java/de/uni_passau/fim/se2/litterbox/analytics/AbstractIssueFinder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *

src/main/java/de/uni_passau/fim/se2/litterbox/analytics/AbstractRefactoringFinder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *

src/main/java/de/uni_passau/fim/se2/litterbox/analytics/BugAnalyzer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019-2024 LitterBox contributors
+ * Copyright (C) 2019-2025 LitterBox contributors
  *
  * This file is part of LitterBox.
  *