Add function to get resources by asset folder

Author: adimiz1

cloudinary-core/src/main/java/com/cloudinary/Api.java

@@ -129,6 +129,14 @@ public ApiResponse resourcesByAssetIDs(Iterable<String> assetIds, Map options) t
         return response;
     }
 
+    public ApiResponse resourcesByAssetFolder(String assetFolder, Map options) throws Exception {
+        if (options == null) options = ObjectUtils.emptyMap();
+        Map params = ObjectUtils.only(options, "next_cursor", "direction", "max_results", "tags", "context", "moderations");
+        params.put("asset_folder", assetFolder);
+        ApiResponse response = callApi(HttpMethod.GET, Arrays.asList("resources/by_asset_folder"), params, options);
+        return response;
+    }
+
     public ApiResponse resourcesByIds(Iterable<String> publicIds, Map options) throws Exception {
         if (options == null) options = ObjectUtils.emptyMap();
         String resourceType = ObjectUtils.asString(options.get("resource_type"), "image");

cloudinary-test-common/src/main/java/com/cloudinary/test/AbstractApiTest.java

@@ -4,6 +4,7 @@
 import com.cloudinary.api.ApiResponse;
 import com.cloudinary.api.exceptions.BadRequest;
 import com.cloudinary.api.exceptions.NotFound;
+import com.cloudinary.test.helpers.Feature;
 import com.cloudinary.test.rules.RetryRule;
 import com.cloudinary.transformation.TextLayer;
 import com.cloudinary.utils.ObjectUtils;
@@ -52,6 +53,7 @@ abstract public class AbstractApiTest extends MockableTest {
     private static final String CUSTOM_USER_AGENT_VERSION = "9.9.9";
     private static String assetId1;
     private static String assetId2;
+    private static String assetId3;
 
     private static final int SLEEP_TIMEOUT = 5000;
 
@@ -77,6 +79,8 @@ public static void setUpClass() throws IOException {
         assetId2 = cloudinary.uploader().upload(SRC_TEST_IMAGE, options).get("asset_id").toString();
         options.remove("public_id");
 
+        assetId3 = cloudinary.uploader().upload(SRC_TEST_IMAGE, ObjectUtils.asMap("asset_folder", "test_asset_folder")).get("public_id").toString();
+
         options.put("eager", Collections.singletonList(UPDATE_TRANSFORMATION));
         cloudinary.uploader().upload(SRC_TEST_IMAGE, options);
 
@@ -292,6 +296,14 @@ public void testResourceByAssetId() throws Exception {
         assertEquals(API_TEST, result.get("public_id").toString());
     }
 
+    @Test
+    public void testResourceByAssetFolder() throws Exception {
+        if (MockableTest.shouldTestFeature(Feature.DYNAMIC_FOLDERS)) {
+            Map result = api.resourcesByAssetFolder("test_asset_folder", ObjectUtils.asMap("tags", true, "context", true));
+            assertNotNull(findByAttr((List<Map>) result.get("resources"), "public_id", assetId3));
+        }
+    }
+
     @Test
     public void testResourcesByPublicIds() throws Exception {
         // should allow listing resources by public ids

cloudinary-test-common/src/main/java/com/cloudinary/test/MockableTest.java

@@ -1,6 +1,7 @@
 package com.cloudinary.test;
 
 import com.cloudinary.Cloudinary;
+import com.cloudinary.test.helpers.Feature;
 import com.cloudinary.utils.ObjectUtils;
 import com.cloudinary.utils.StringUtils;
 
@@ -58,4 +59,13 @@ private static List<String> getEnabledAddons() {
 
         return Arrays.asList(envAddons.split(","));
     }
+
+    protected static boolean shouldTestFeature(String feature) {
+        String sdkFeatures = System.getenv()
+                .getOrDefault("CLD_TEST_FEATURES", "")
+                .toLowerCase()
+                .replaceAll("\\s", "");
+        List<String> sdkFeaturesList = Arrays.asList(sdkFeatures.split(","));
+        return sdkFeatures.contains(feature.toLowerCase()) || (sdkFeaturesList.size() == 1 && sdkFeaturesList.get(0).equalsIgnoreCase(Feature.ALL));
+    }
 }

cloudinary-test-common/src/main/java/com/cloudinary/test/helpers/Feature.java

@@ -0,0 +1,6 @@
+package com.cloudinary.test.helpers;
+
+public class Feature {
+    public static final String ALL = "all";
+    public static final String DYNAMIC_FOLDERS = "dynamic_folders";
+}