multipart-decoder 0.0.1__tar.gz → 1.0.0__tar.gz

{multipart_decoder-0.0.1/src/multipart_decoder.egg-info → multipart_decoder-1.0.0}/PKG-INFO

@@ -1,21 +1,34 @@
 Metadata-Version: 2.4
 Name: multipart-decoder
-Version: 0.0.1
-Summary: A lightweight Python package for decoding multipart/form-data content
+Version: 1.0.0
+Summary: A lightweight Python package for parsing multipart/form-data content
 Author-email: Satya Tulasi Jalandhar C H <satyatulasijalandharch2@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/satyatulasijalandharch/multipart-decoder
 Project-URL: Issues, https://github.com/satyatulasijalandharch/multipart-decoder/issues
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: requests_toolbelt==1.0.0
 Dynamic: license-file
 
-# multipart_decoder
+# Multipart Decoder
 
-A lightweight Python package for decoding multipart/form-data content.
+[![Version](https://img.shields.io/pypi/v/multipart-decoder.svg?maxAge=86400)](https://pypi.org/project/multipart-decoder/)
+[![Supported Versions](https://img.shields.io/pypi/pyversions/multipart-decoder.svg)](https://pypi.org/project/multipart-decoder)
+[![Downloads](https://static.pepy.tech/badge/multipart-decoder/month)](https://pepy.tech/project/multipart-decoder)
+
+**Multipart Decoder** is a lightweight Python package for parsing multipart/form-data content.
 
 ## Installation
 
@@ -30,7 +43,7 @@ This example demonstrates how to parse simple form data with text fields.
 
 ```python
 
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 
 # Example with raw form data
 def basic_form_parsing():
@@ -39,18 +52,19 @@ def basic_form_parsing():
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5ZFZUbDJFQXAxc2NYWXNXWg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJ1c2VybmFtZSINCg0KZXhhbXBsZV91c2VyDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daDQpDb250ZW50LURpc3Bvc2l0aW9uOiBmb3JtLWRhdGE7IG5hbWU9ImVtYWlsIg0KDQp1c2VyQGV4YW1wbGUuY29tDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daLS0NCg=="
 
     # Parse the multipart form data
-    form_data = MultipartDecoder(body, content_type)
-    
+    form_data = MultipartFormParser(body, content_type)
+
     # Access the form fields
-    print(f"Username: {form_data['username']}")
-    print(f"Email: {form_data['email']}")
-    
+    print(f"Username: {form_data['fields']['username']}")
+    print(f"Email: {form_data['fields']['email']}")
+
     # Show the entire parsed data structure
     print("\nComplete form data dictionary:")
     print(form_data)
 
 if __name__ == "__main__":
     basic_form_parsing()
+
 ```
 ## Expected Output
 
@@ -61,9 +75,13 @@ if __name__ == "__main__":
 #### Complete Form Data Dictionary:
 ```json
 {
-    "username": "example_user",
-    "email": "user@example.com"
+    "fields": {
+        "username": "example_user",
+        "email": "user@example.com"
+    },
+    "files": {}
 }
+
 ```
 
 
@@ -72,39 +90,38 @@ if __name__ == "__main__":
 This example demonstrates how to handle file uploads in multipart form data.
 
 ```python
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 import os
 
 def process_file_upload():
-    """Process an example multipart form with file uploads."""
-    content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
-        )
+    content_type = "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnk0QVF3WU9VVUNFVXc5aHNYLS0NCg=="
 
-    form_data = MultipartDecoder(body, content_type)
-    # Process regular form field
-    print(f"Field 1: {form_data['field1']}")
-    print(f"Field 2: {form_data['field2']}")
+    form_data = MultipartFormParser(body, content_type)
+
+    # Access fields
+    print(f"Field 1: {form_data['fields']['field1']}")
+    print(f"Field 2: {form_data['fields']['field2']}")
 
-    # Process file uploads
-    if 'file1' in form_data:
-        filename, content_type, file_data = form_data['file1']
-        print(f"  - Filename: {filename}")
-        print(f"  - Content type: {content_type}")
-        print(f"  - File size: {len(file_data)} bytes")
+    # Access files
+    if 'file1' in form_data['files']:
+        file_info = form_data['files']['file1']
+        print(f"  - Filename: {file_info['filename']}")
+        print(f"  - Content type: {file_info['content_type']}")
+        print(f"  - File size: {file_info['size']} bytes")
 
         # Example: save the file
-        save_path = f"saved_{filename}"
+        save_path = f"saved_{file_info['filename']}"
         with open(save_path, "wb") as f:
-            f.write(file_data)
+            f.write(file_info['content'])
         print(f"  - File saved to: {save_path}")
 
-        # # After using the file, delete it for this example
+        # Cleanup (for demonstration)
         os.remove(save_path)
 
 if __name__ == "__main__":
     process_file_upload()
+
 ```
 # Expected Output:
 

{multipart_decoder-0.0.1 → multipart_decoder-1.0.0}/README.md

@@ -1,6 +1,10 @@
-# multipart_decoder
+# Multipart Decoder
 
-A lightweight Python package for decoding multipart/form-data content.
+[![Version](https://img.shields.io/pypi/v/multipart-decoder.svg?maxAge=86400)](https://pypi.org/project/multipart-decoder/)
+[![Supported Versions](https://img.shields.io/pypi/pyversions/multipart-decoder.svg)](https://pypi.org/project/multipart-decoder)
+[![Downloads](https://static.pepy.tech/badge/multipart-decoder/month)](https://pepy.tech/project/multipart-decoder)
+
+**Multipart Decoder** is a lightweight Python package for parsing multipart/form-data content.
 
 ## Installation
 
@@ -15,7 +19,7 @@ This example demonstrates how to parse simple form data with text fields.
 
 ```python
 
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 
 # Example with raw form data
 def basic_form_parsing():
@@ -24,18 +28,19 @@ def basic_form_parsing():
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5ZFZUbDJFQXAxc2NYWXNXWg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJ1c2VybmFtZSINCg0KZXhhbXBsZV91c2VyDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daDQpDb250ZW50LURpc3Bvc2l0aW9uOiBmb3JtLWRhdGE7IG5hbWU9ImVtYWlsIg0KDQp1c2VyQGV4YW1wbGUuY29tDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daLS0NCg=="
 
     # Parse the multipart form data
-    form_data = MultipartDecoder(body, content_type)
-    
+    form_data = MultipartFormParser(body, content_type)
+
     # Access the form fields
-    print(f"Username: {form_data['username']}")
-    print(f"Email: {form_data['email']}")
-    
+    print(f"Username: {form_data['fields']['username']}")
+    print(f"Email: {form_data['fields']['email']}")
+
     # Show the entire parsed data structure
     print("\nComplete form data dictionary:")
     print(form_data)
 
 if __name__ == "__main__":
     basic_form_parsing()
+
 ```
 ## Expected Output
 
@@ -46,9 +51,13 @@ if __name__ == "__main__":
 #### Complete Form Data Dictionary:
 ```json
 {
-    "username": "example_user",
-    "email": "user@example.com"
+    "fields": {
+        "username": "example_user",
+        "email": "user@example.com"
+    },
+    "files": {}
 }
+
 ```
 
 
@@ -57,39 +66,38 @@ if __name__ == "__main__":
 This example demonstrates how to handle file uploads in multipart form data.
 
 ```python
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 import os
 
 def process_file_upload():
-    """Process an example multipart form with file uploads."""
-    content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
-        )
+    content_type = "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnk0QVF3WU9VVUNFVXc5aHNYLS0NCg=="
 
-    form_data = MultipartDecoder(body, content_type)
-    # Process regular form field
-    print(f"Field 1: {form_data['field1']}")
-    print(f"Field 2: {form_data['field2']}")
+    form_data = MultipartFormParser(body, content_type)
+
+    # Access fields
+    print(f"Field 1: {form_data['fields']['field1']}")
+    print(f"Field 2: {form_data['fields']['field2']}")
 
-    # Process file uploads
-    if 'file1' in form_data:
-        filename, content_type, file_data = form_data['file1']
-        print(f"  - Filename: {filename}")
-        print(f"  - Content type: {content_type}")
-        print(f"  - File size: {len(file_data)} bytes")
+    # Access files
+    if 'file1' in form_data['files']:
+        file_info = form_data['files']['file1']
+        print(f"  - Filename: {file_info['filename']}")
+        print(f"  - Content type: {file_info['content_type']}")
+        print(f"  - File size: {file_info['size']} bytes")
 
         # Example: save the file
-        save_path = f"saved_{filename}"
+        save_path = f"saved_{file_info['filename']}"
         with open(save_path, "wb") as f:
-            f.write(file_data)
+            f.write(file_info['content'])
         print(f"  - File saved to: {save_path}")
 
-        # # After using the file, delete it for this example
+        # Cleanup (for demonstration)
         os.remove(save_path)
 
 if __name__ == "__main__":
     process_file_upload()
+
 ```
 # Expected Output:
 

multipart_decoder-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "multipart-decoder"
+dynamic = ["version"]
+authors = [
+  { name="Satya Tulasi Jalandhar C H", email="satyatulasijalandharch2@gmail.com" },
+]
+description = "A lightweight Python package for parsing multipart/form-data content"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+  "requests_toolbelt==1.0.0"
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICENSE*"]
+
+[tool.setuptools.dynamic]
+version = {attr = "multipart_decoder.__version__"}
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple/"
+publish-url = "https://upload.pypi.org/legacy/"
+
+[[tool.uv.index]]
+name = "testpypi"
+url = "https://test.pypi.org/simple/"
+publish-url = "https://test.pypi.org/legacy/"
+explicit = true
+
+[project.urls]
+Homepage = "https://github.com/satyatulasijalandharch/multipart-decoder"
+Issues = "https://github.com/satyatulasijalandharch/multipart-decoder/issues"

multipart_decoder-1.0.0/src/multipart_decoder/__init__.py

@@ -0,0 +1,8 @@
+"""
+multipart_decoder - A lightweight Python package for parsing multipart/form-data content.
+"""
+
+from .decoder import MultipartFormParser
+
+__version__ = "1.0.0"
+__all__ = ["MultipartFormParser"]

multipart_decoder-1.0.0/src/multipart_decoder/decoder.py

@@ -0,0 +1,99 @@
+"""
+Decoder module for parsing multipart/form-data content.
+"""
+
+import re
+import logging
+from base64 import b64decode
+from binascii import Error as BinasciiError
+from requests_toolbelt.multipart import decoder
+
+
+def MultipartFormParser(body, content_type):
+    """
+    Decode a multipart/form-data request body.
+    :param body: The body of the request, typically a byte string.
+    :param content_type: The content type of the request, typically 'multipart/form-data; boundary=...'.
+    :return: A dictionary containing the extracted fields and files.
+    :raises ValueError: If input parameters are invalid
+    :raises Exception: For various parsing errors
+    """
+    extracted_data = {"fields": {}, "files": {}}
+
+    # Validate input parameters
+    if not body:
+        raise ValueError("Request body cannot be empty")
+    if not content_type or "boundary=" not in content_type:
+        raise ValueError(
+            "Invalid content type: must be multipart/form-data with boundary"
+        )
+
+    try:
+        # Decode the base64 encoded body
+        try:
+            data = b64decode(body)
+        except BinasciiError as e:
+            raise ValueError(f"Invalid base64 encoded body: {str(e)}")
+
+        # Parse multipart data
+        try:
+            multipart_data = decoder.MultipartDecoder(data, content_type)
+        except Exception as e:
+            raise ValueError(f"Failed to decode multipart form data: {str(e)}")
+
+        # Process parts
+        for part in multipart_data.parts:
+            try:
+                # Get content disposition header
+                if b"Content-Disposition" not in part.headers:
+                    logging.warning("Skipping part without Content-Disposition header")
+                    continue
+
+                content_disposition = part.headers[b"Content-Disposition"].decode()
+
+                # Extract the field name
+                name_match = re.search(r'name="([^"]+)"', content_disposition)
+                if not name_match:
+                    logging.warning("Skipping part without field name")
+                    continue
+
+                field_name = name_match.group(1)
+
+                # Check if it's a file
+                filename_match = re.search(r'filename="([^"]+)"', content_disposition)
+
+                if filename_match:
+                    # Handle file upload
+                    filename = filename_match.group(1)
+                    content_type = part.headers.get(
+                        b"Content-Type", b"application/octet-stream"
+                    ).decode()
+                    file_data = part.content
+
+                    # Store file information
+                    extracted_data["files"][field_name] = {
+                        "filename": filename,
+                        "content_type": content_type,
+                        "content": file_data,
+                        "size": len(file_data),
+                    }
+                else:
+                    # Handle regular form fields
+                    try:
+                        field_value = part.text.strip()
+                    except UnicodeDecodeError:
+                        logging.warning(
+                            f"Could not decode text for field {field_name}, storing as binary"
+                        )
+                        field_value = part.content
+                    extracted_data["fields"][field_name] = field_value
+
+            except Exception as e:
+                logging.error(f"Error processing part: {str(e)}")
+                # Continue processing other parts instead of failing completely
+
+    except Exception as e:
+        # Re-raise with more context
+        raise Exception(f"Failed to parse multipart form data: {str(e)}") from e
+
+    return extracted_data

{multipart_decoder-0.0.1 → multipart_decoder-1.0.0/src/multipart_decoder.egg-info}/PKG-INFO

@@ -1,21 +1,34 @@
 Metadata-Version: 2.4
 Name: multipart-decoder
-Version: 0.0.1
-Summary: A lightweight Python package for decoding multipart/form-data content
+Version: 1.0.0
+Summary: A lightweight Python package for parsing multipart/form-data content
 Author-email: Satya Tulasi Jalandhar C H <satyatulasijalandharch2@gmail.com>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/satyatulasijalandharch/multipart-decoder
 Project-URL: Issues, https://github.com/satyatulasijalandharch/multipart-decoder/issues
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: requests_toolbelt==1.0.0
 Dynamic: license-file
 
-# multipart_decoder
+# Multipart Decoder
 
-A lightweight Python package for decoding multipart/form-data content.
+[![Version](https://img.shields.io/pypi/v/multipart-decoder.svg?maxAge=86400)](https://pypi.org/project/multipart-decoder/)
+[![Supported Versions](https://img.shields.io/pypi/pyversions/multipart-decoder.svg)](https://pypi.org/project/multipart-decoder)
+[![Downloads](https://static.pepy.tech/badge/multipart-decoder/month)](https://pepy.tech/project/multipart-decoder)
+
+**Multipart Decoder** is a lightweight Python package for parsing multipart/form-data content.
 
 ## Installation
 
@@ -30,7 +43,7 @@ This example demonstrates how to parse simple form data with text fields.
 
 ```python
 
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 
 # Example with raw form data
 def basic_form_parsing():
@@ -39,18 +52,19 @@ def basic_form_parsing():
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5ZFZUbDJFQXAxc2NYWXNXWg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJ1c2VybmFtZSINCg0KZXhhbXBsZV91c2VyDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daDQpDb250ZW50LURpc3Bvc2l0aW9uOiBmb3JtLWRhdGE7IG5hbWU9ImVtYWlsIg0KDQp1c2VyQGV4YW1wbGUuY29tDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlkVlRsMkVBcDFzY1hZc1daLS0NCg=="
 
     # Parse the multipart form data
-    form_data = MultipartDecoder(body, content_type)
-    
+    form_data = MultipartFormParser(body, content_type)
+
     # Access the form fields
-    print(f"Username: {form_data['username']}")
-    print(f"Email: {form_data['email']}")
-    
+    print(f"Username: {form_data['fields']['username']}")
+    print(f"Email: {form_data['fields']['email']}")
+
     # Show the entire parsed data structure
     print("\nComplete form data dictionary:")
     print(form_data)
 
 if __name__ == "__main__":
     basic_form_parsing()
+
 ```
 ## Expected Output
 
@@ -61,9 +75,13 @@ if __name__ == "__main__":
 #### Complete Form Data Dictionary:
 ```json
 {
-    "username": "example_user",
-    "email": "user@example.com"
+    "fields": {
+        "username": "example_user",
+        "email": "user@example.com"
+    },
+    "files": {}
 }
+
 ```
 
 
@@ -72,39 +90,38 @@ if __name__ == "__main__":
 This example demonstrates how to handle file uploads in multipart form data.
 
 ```python
-from multipart_decoder import MultipartDecoder
+from multipart_decoder import MultipartFormParser
 import os
 
 def process_file_upload():
-    """Process an example multipart form with file uploads."""
-    content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
-        )
+    content_type = "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
     body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnk0QVF3WU9VVUNFVXc5aHNYLS0NCg=="
 
-    form_data = MultipartDecoder(body, content_type)
-    # Process regular form field
-    print(f"Field 1: {form_data['field1']}")
-    print(f"Field 2: {form_data['field2']}")
+    form_data = MultipartFormParser(body, content_type)
+
+    # Access fields
+    print(f"Field 1: {form_data['fields']['field1']}")
+    print(f"Field 2: {form_data['fields']['field2']}")
 
-    # Process file uploads
-    if 'file1' in form_data:
-        filename, content_type, file_data = form_data['file1']
-        print(f"  - Filename: {filename}")
-        print(f"  - Content type: {content_type}")
-        print(f"  - File size: {len(file_data)} bytes")
+    # Access files
+    if 'file1' in form_data['files']:
+        file_info = form_data['files']['file1']
+        print(f"  - Filename: {file_info['filename']}")
+        print(f"  - Content type: {file_info['content_type']}")
+        print(f"  - File size: {file_info['size']} bytes")
 
         # Example: save the file
-        save_path = f"saved_{filename}"
+        save_path = f"saved_{file_info['filename']}"
         with open(save_path, "wb") as f:
-            f.write(file_data)
+            f.write(file_info['content'])
         print(f"  - File saved to: {save_path}")
 
-        # # After using the file, delete it for this example
+        # Cleanup (for demonstration)
         os.remove(save_path)
 
 if __name__ == "__main__":
     process_file_upload()
+
 ```
 # Expected Output:
 

{multipart_decoder-0.0.1 → multipart_decoder-1.0.0}/src/multipart_decoder.egg-info/SOURCES.txt

@@ -6,5 +6,6 @@ src/multipart_decoder/decoder.py
 src/multipart_decoder.egg-info/PKG-INFO
 src/multipart_decoder.egg-info/SOURCES.txt
 src/multipart_decoder.egg-info/dependency_links.txt
+src/multipart_decoder.egg-info/requires.txt
 src/multipart_decoder.egg-info/top_level.txt
 tests/test_decoder.py

multipart_decoder-1.0.0/src/multipart_decoder.egg-info/requires.txt

@@ -0,0 +1 @@
+requests_toolbelt==1.0.0

multipart_decoder-1.0.0/tests/test_decoder.py

@@ -0,0 +1,75 @@
+"""
+Unit tests for the multipart_decoder package.
+"""
+
+import unittest
+from multipart_decoder import MultipartFormParser
+
+
+class TestMultipartFormParser(unittest.TestCase):
+    def test_basic_form_fields(self):
+        """Test decoding of basic form fields."""
+        content_type = (
+            "multipart/form-data; boundary=----WebKitFormBoundaryp0mBfJEEcQtmxFCF"
+        )
+        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRi0tDQo="
+
+        result = MultipartFormParser(body, content_type)
+        self.assertEqual(result["fields"]["field1"], "value1")
+        self.assertEqual(result["fields"]["field2"], "value2")
+
+    def test_file_upload(self):
+        """Test decoding of file uploads."""
+        content_type = (
+            "multipart/form-data; boundary=----WebKitFormBoundaryI6YbOCiSAMjU6wK2"
+        )
+        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5STZZYk9DaVNBTWpVNndLMg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlJNlliT0NpU0FNalU2d0syLS0NCg=="
+
+        result = MultipartFormParser(body, content_type)
+        self.assertIn("file1", result["files"])
+
+        file_info = result["files"]["file1"]
+        self.assertEqual(file_info["filename"], "example.txt")
+        self.assertEqual(file_info["content_type"], "text/plain")
+        self.assertEqual(file_info["content"], b"Hello, world!")
+        self.assertEqual(file_info["size"], len(b"Hello, world!"))
+
+    def test_mixed_content(self):
+        """Test decoding of mixed content (form fields and file uploads)."""
+        content_type = (
+            "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
+        )
+        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnk0QVF3WU9VVUNFVXc5aHNYLS0NCg=="
+
+        result = MultipartFormParser(body, content_type)
+        self.assertEqual(result["fields"]["field1"], "value1")
+        self.assertEqual(result["fields"]["field2"], "value2")
+
+        file_info = result["files"]["file1"]
+        self.assertEqual(file_info["filename"], "example.txt")
+        self.assertEqual(file_info["content_type"], "text/plain")
+        self.assertEqual(file_info["content"], b"Hello, world!")
+        self.assertEqual(file_info["size"], len(b"Hello, world!"))
+
+    def test_empty_body(self):
+        """Test validation of empty request body."""
+        content_type = "multipart/form-data; boundary=something"
+        body = ""
+
+        with self.assertRaises(ValueError) as context:
+            MultipartFormParser(body, content_type)
+        self.assertIn("Request body cannot be empty", str(context.exception))
+
+    def test_malformed_multipart_data(self):
+        """Test handling of malformed multipart data."""
+        content_type = "multipart/form-data; boundary=boundary"
+        # Base64 encoded partial/malformed multipart data
+        body = "LS0tYm91bmRhcnkNCkNvbnRlbnQtRGlzcG9zaXRpb246IGZvcm0tZGF0YTsNCg=="
+
+        with self.assertRaises(Exception) as context:
+            MultipartFormParser(body, content_type)
+        self.assertIn("Failed to", str(context.exception))
+
+
+if __name__ == "__main__":
+    unittest.main()

multipart_decoder-0.0.1/pyproject.toml

@@ -1,23 +0,0 @@
-[build-system]
-requires = ["setuptools >= 77.0.3"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "multipart-decoder"
-version = "0.0.1"
-authors = [
-  { name="Satya Tulasi Jalandhar C H", email="satyatulasijalandharch2@gmail.com" },
-]
-description = "A lightweight Python package for decoding multipart/form-data content"
-readme = "README.md"
-requires-python = ">=3.8"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-]
-license = "MIT"
-license-files = ["LICENSE*"]
-
-[project.urls]
-Homepage = "https://github.com/satyatulasijalandharch/multipart-decoder"
-Issues = "https://github.com/satyatulasijalandharch/multipart-decoder/issues"

multipart_decoder-0.0.1/src/multipart_decoder/__init__.py

@@ -1,8 +0,0 @@
-"""
-multipart_decoder - A lightweight Python package for decoding multipart/form-data content.
-"""
-
-from .decoder import MultipartDecoder
-
-__version__ = "0.1.0"
-__all__ = ["MultipartDecoder"]

multipart_decoder-0.0.1/src/multipart_decoder/decoder.py

@@ -1,71 +0,0 @@
-"""
-Decoder module for parsing multipart/form-data content.
-"""
-
-import re
-import base64
-import email.parser
-from io import BytesIO
-from email.policy import default
-
-
-def MultipartDecoder(content_bytes, content_type):
-    """
-    Decode multipart form-data from bytes content.
-    
-    Args:
-        content_bytes (bytes): The raw multipart form-data content
-        content_type (str): The Content-Type header value (must include boundary)
-    
-    Returns:
-        dict: A dictionary where keys are field names and values are either:
-             - strings for regular form fields
-             - tuples of (filename, content_type, data) for file uploads
-             
-    Raises:
-        ValueError: If the content is not multipart or lacks required headers
-    """
-    if not content_type or 'boundary=' not in content_type:
-        raise ValueError("Content-Type header must include a boundary parameter")
-
-    try:
-        content_bytes = base64.b64decode(content_bytes)
-    except (base64.binascii.Error, TypeError) as e:
-        raise ValueError("Failed to decode base64 content") from e
-    # Prepare the content with proper headers for the email parser
-    content = BytesIO()
-    content.write(b'Content-Type: ' + content_type.encode('utf-8') + b'\r\n\r\n')
-    content.write(content_bytes)
-    content.seek(0)
-
-    # Parse the multipart content
-    parser = email.parser.BytesParser(policy=default)
-    message = parser.parse(content)
-
-    if not message.is_multipart():
-        raise ValueError("Content is not multipart")
-
-    form_data = {}
-
-    # Process each part of the multipart message
-    for part in message.get_payload():
-        # Get the Content-Disposition header to extract field name and filename
-        content_disposition = part.get("Content-Disposition", "")
-        # Use regex to extract field name from content disposition
-        name_match = re.search(r'name="([^"]*)"', content_disposition)
-
-        if name_match:
-            field_name = name_match.group(1)
-            filename_match = re.search(r'filename="([^"]*)"', content_disposition)
-
-            if filename_match:
-                # This is a file upload
-                filename = filename_match.group(1)
-                part_content_type = part.get_content_type()
-                data = part.get_payload(decode=True)  # Binary file content
-                form_data[field_name] = (filename, part_content_type, data)
-            else:
-                # This is a regular form field
-                form_data[field_name] = part.get_payload(decode=True).decode(part.get_content_charset('utf-8'))
-
-    return form_data

multipart_decoder-0.0.1/tests/test_decoder.py

@@ -1,72 +0,0 @@
-"""
-Unit tests for the multipart_decoder package.
-"""
-
-import unittest
-from multipart_decoder import MultipartDecoder
-
-
-class TestMultipartDecoder(unittest.TestCase):
-    def test_basic_form_fields(self):
-        """Test decoding of basic form fields."""
-        content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundaryp0mBfJEEcQtmxFCF"
-        )
-        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5cDBtQmZKRUVjUXRteEZDRi0tDQo="
-
-        result = MultipartDecoder(body, content_type)
-        self.assertEqual(result["field1"], "value1")
-        self.assertEqual(result["field2"], "value2")
-
-    def test_file_upload(self):
-        """Test decoding of file uploads."""
-        content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundaryI6YbOCiSAMjU6wK2"
-        )
-        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5STZZYk9DaVNBTWpVNndLMg0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnlJNlliT0NpU0FNalU2d0syLS0NCg=="
-
-        result = MultipartDecoder(body, content_type)
-        self.assertTrue("file1" in result)
-        self.assertTrue(isinstance(result["file1"], tuple))
-
-        filename, content_type, data = result["file1"]
-        self.assertEqual(filename, "example.txt")
-        self.assertEqual(content_type, "text/plain")
-        self.assertEqual(data, b"Hello, world!")
-
-    def test_mixed_content(self):
-        """Test decoding of mixed content (form fields and file uploads)."""
-        content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundary4AQwYOUUCEUw9hsX"
-        )
-        body = "LS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDEiDQoNCnZhbHVlMQ0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWVsZDIiDQoNCnZhbHVlMg0KLS0tLS0tV2ViS2l0Rm9ybUJvdW5kYXJ5NEFRd1lPVVVDRVV3OWhzWA0KQ29udGVudC1EaXNwb3NpdGlvbjogZm9ybS1kYXRhOyBuYW1lPSJmaWxlMSI7IGZpbGVuYW1lPSJleGFtcGxlLnR4dCINCkNvbnRlbnQtVHlwZTogdGV4dC9wbGFpbg0KDQpIZWxsbywgd29ybGQhDQotLS0tLS1XZWJLaXRGb3JtQm91bmRhcnk0QVF3WU9VVUNFVXc5aHNYLS0NCg=="
-
-        result = MultipartDecoder(body, content_type)
-        self.assertEqual(result["field1"], "value1")
-
-        filename, content_type, data = result["file1"]
-        self.assertEqual(filename, "example.txt")
-        self.assertEqual(content_type, "text/plain")
-        self.assertEqual(data, b"Hello, world!")
-
-    def test_invalid_content(self):
-        """Test handling of invalid content."""
-        content_type = (
-            "multipart/form-data; boundary=----WebKitFormBoundaryI6YbOCiSAMjU6wK2"
-        )
-        body = "LS0tWxsbCg=="
-
-        with self.assertRaises(ValueError):
-            MultipartDecoder(body, content_type)
-
-    def test_missing_boundary(self):
-        """Test handling of missing boundary parameter."""
-        content_type = "multipart/form-data"
-        body = "LS0tWxsbCg=="
-
-        with self.assertRaises(ValueError):
-            MultipartDecoder(body, content_type)
-
-
-if __name__ == "__main__":
-    unittest.main()