Fixes the issue with folder inside extracted zip

The current library fails if there are no folders inside the extracted zip file. This fixes the issue

Author: susrisha

src/example.py

@@ -5,6 +5,7 @@
 ASSETS_DIR = os.path.join(PARENT_DIR, 'tests/assets')
 VALID_ZIP_FILE = os.path.join(ASSETS_DIR, 'valid.zip')
 INVALID_ZIP_FILE = os.path.join(ASSETS_DIR, 'invalid.zip')
+TEST_ZIP_FILE = os.path.join(ASSETS_DIR,'Archive.zip')
 SCHEMA_DIR = os.path.join(PARENT_DIR, 'src/python_osw_validation/schema')
 SCHEMA_FILE_PATH = os.path.join(SCHEMA_DIR, 'opensidewalks.schema.json')
 
@@ -35,9 +36,16 @@ def invalid_test_without_provided_schema():
     result = validator.validate()
     print(f'Invalid Test Without Schema: {"Failed" if result.is_valid else "Passed"}')
 
+def test_with_archive_file():
+    validator = OSWValidation(zipfile_path=TEST_ZIP_FILE)
+    result = validator.validate()
+    print(result.errors)
+    print(result.is_valid)
+
 
 if __name__ == '__main__':
-    valid_test_with_provided_schema()
-    valid_test_without_provided_schema()
-    invalid_test_with_provided_schema()
-    invalid_test_without_provided_schema()
+    # valid_test_with_provided_schema()
+    # valid_test_without_provided_schema()
+    # invalid_test_with_provided_schema()
+    # invalid_test_without_provided_schema()
+    test_with_archive_file()

src/python_osw_validation/zipfile_handler.py

@@ -50,11 +50,20 @@ def extract_zip(self) -> Optional[str]:
             if len(zip_ref.namelist()) == 0:
                 raise Exception('ZIP file is empty')
 
-            first_item = zip_ref.namelist()[0]
-
-            return f'{self.extracted_dir}/{first_item}'
+            internal_folder_name = self.find_internal_folder(zip_ref)
+            return os.path.join(self.extracted_dir,internal_folder_name)
         except Exception as e:
             self.error = f'Error extracting ZIP file: {e}'
+    
+    # finds the first folder available in the extracted folder. 
+    # returns empty if there are no folders inside
+    def find_internal_folder(self, zip_ref: zipfile.ZipFile)-> str:
+        for filename in zip_ref.namelist():
+            path = os.path.join(self.extracted_dir,filename)
+            if(os.path.isdir(path)):
+                return filename
+        return ''
+
 
     def remove_extracted_files(self) -> None:
         if self.extracted_dir and os.path.exists(self.extracted_dir):