Added package-info.java to every module package

Author: maksymuimanov

cache/spring-boot-python-executor-cache-autoconfigure/src/main/java/io/w4t3rcs/python/condition/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package io.w4t3rcs.python.condition;
+
+import org.jspecify.annotations.NullMarked;

cache/spring-boot-python-executor-cache-autoconfigure/src/main/java/io/w4t3rcs/python/config/PythonCacheAutoConfiguration.java

@@ -2,7 +2,7 @@
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.w4t3rcs.python.cache.CacheKeyGenerator;
-import io.w4t3rcs.python.cache.impl.HashCacheKeyGenerator;
+import io.w4t3rcs.python.cache.HashCacheKeyGenerator;
 import io.w4t3rcs.python.condition.ExecutorCacheLevelCondition;
 import io.w4t3rcs.python.condition.FileCacheLevelCondition;
 import io.w4t3rcs.python.condition.ProcessorCacheLevelCondition;

cache/spring-boot-python-executor-cache-autoconfigure/src/main/java/io/w4t3rcs/python/config/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package io.w4t3rcs.python.config;
+
+import org.jspecify.annotations.NullMarked;

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/CacheKeyGenerator.java

@@ -1,6 +1,6 @@
 package io.w4t3rcs.python.cache;
 
-import io.w4t3rcs.python.cache.impl.HashCacheKeyGenerator;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Interface for generating cache keys with optional prefix and suffix.
@@ -46,7 +46,7 @@ default String generateKey(String body) {
      * @param suffix an optional suffix object to append to the key; may be null.
      * @return a non-null generated cache key string.
      */
-    default String generateKey(String body, Object suffix) {
+    default String generateKey(String body, @Nullable Object suffix) {
         return this.generateKey(null, body, suffix);
     }
 
@@ -57,7 +57,7 @@ default String generateKey(String body, Object suffix) {
      * @param body non-null string representing the main part of the key.
      * @return a non-null generated cache key string.
      */
-    default String generateKey(Object prefix, String body) {
+    default String generateKey(@Nullable Object prefix, String body) {
         return this.generateKey(prefix, body, null);
     }
 
@@ -73,5 +73,5 @@ default String generateKey(Object prefix, String body) {
      * @param suffix an optional suffix object to append to the key; may be null.
      * @return a non-null generated cache key string.
      */
-    String generateKey(Object prefix, String body, Object suffix);
+    String generateKey(@Nullable Object prefix, String body, @Nullable Object suffix);
 }

…on/cache/impl/HashCacheKeyGenerator.java …/python/cache/HashCacheKeyGenerator.javacache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/impl/HashCacheKeyGenerator.java renamed to cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/HashCacheKeyGenerator.java cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/impl/HashCacheKeyGenerator.java renamed to cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/HashCacheKeyGenerator.java

@@ -1,13 +1,13 @@
-package io.w4t3rcs.python.cache.impl;
+package io.w4t3rcs.python.cache;
 
-import io.w4t3rcs.python.cache.CacheKeyGenerator;
 import io.w4t3rcs.python.exception.CacheKeyGenerationException;
 import io.w4t3rcs.python.executor.CachingPythonExecutor;
 import io.w4t3rcs.python.file.CachingPythonFileReader;
 import io.w4t3rcs.python.processor.CachingPythonProcessor;
 import io.w4t3rcs.python.properties.PythonCacheProperties;
 import io.w4t3rcs.python.resolver.CachingPythonResolverHolder;
 import lombok.RequiredArgsConstructor;
+import org.jspecify.annotations.Nullable;
 
 import java.security.MessageDigest;
 import java.util.Base64;
@@ -71,7 +71,7 @@ public class HashCacheKeyGenerator implements CacheKeyGenerator {
      * @throws CacheKeyGenerationException if hashing fails due to unsupported algorithm or encoding.
      */
     @Override
-    public String generateKey(Object prefix, String body, Object suffix) {
+    public String generateKey(@Nullable Object prefix, String body, @Nullable Object suffix) {
         try {
             var keyProperties = cacheProperties.key();
             MessageDigest digest = MessageDigest.getInstance(keyProperties.hashAlgorithm());

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/cache/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package io.w4t3rcs.python.cache;
+
+import org.jspecify.annotations.NullMarked;

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/exception/CacheKeyGenerationException.java

@@ -1,7 +1,7 @@
 package io.w4t3rcs.python.exception;
 
 import io.w4t3rcs.python.cache.CacheKeyGenerator;
-import io.w4t3rcs.python.cache.impl.HashCacheKeyGenerator;
+import io.w4t3rcs.python.cache.HashCacheKeyGenerator;
 
 /**
  * Runtime exception thrown when cache key generation fails.

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/exception/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package io.w4t3rcs.python.exception;
+
+import org.jspecify.annotations.NullMarked;

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/executor/CachingPythonExecutor.java

@@ -1,13 +1,16 @@
 package io.w4t3rcs.python.executor;
 
 import io.w4t3rcs.python.cache.CacheKeyGenerator;
-import io.w4t3rcs.python.dto.PythonExecutionResponse;
 import io.w4t3rcs.python.exception.PythonCacheException;
 import io.w4t3rcs.python.properties.PythonCacheProperties;
+import io.w4t3rcs.python.response.PythonExecutionResponse;
 import io.w4t3rcs.python.script.PythonScript;
+import org.jspecify.annotations.Nullable;
 import org.springframework.cache.Cache;
 import org.springframework.cache.CacheManager;
 
+import java.util.Objects;
+
 /**
  * {@link PythonExecutor} implementation that adds caching capabilities.
  * <p>
@@ -49,7 +52,7 @@ public class CachingPythonExecutor implements PythonExecutor {
      */
     public CachingPythonExecutor(PythonCacheProperties cacheProperties, PythonExecutor pythonExecutor, CacheManager cacheManager, CacheKeyGenerator keyGenerator) {
         this.pythonExecutor = pythonExecutor;
-        this.cache = cacheManager.getCache(cacheProperties.name().executor());
+        this.cache = Objects.requireNonNull(cacheManager.getCache(cacheProperties.name().executor()));
         this.keyGenerator = keyGenerator;
     }
 
@@ -66,13 +69,13 @@ public CachingPythonExecutor(PythonCacheProperties cacheProperties, PythonExecut
      *
      * @param <R> the expected body type
      * @param script non-null Python script to execute
-     * @param resultClass non-null {@link Class} representing the expected body type
+     * @param resultClass nullable {@link Class} representing the expected body type
      * @return the execution body, guaranteed non-null if the delegate returns non-null
      * @throws PythonCacheException if any caching or execution error occurs
      */
     @Override
     @SuppressWarnings("unchecked")
-    public <R> PythonExecutionResponse<R> execute(PythonScript script, Class<? extends R> resultClass) {
+    public <R> PythonExecutionResponse<R> execute(PythonScript script, @Nullable Class<? extends R> resultClass) {
         try {
             String scriptBody = script.toString();
             String key = keyGenerator.generateKey(scriptBody, resultClass);

cache/spring-boot-python-executor-cache/src/main/java/io/w4t3rcs/python/executor/package-info.java

@@ -0,0 +1,4 @@
+@NullMarked
+package io.w4t3rcs.python.executor;
+
+import org.jspecify.annotations.NullMarked;