Release 5.1.1

Author: lvukadinovic-ib

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to the library will be documented in this file.
 The format of the file is based on [Keep a Changelog](http://keepachangelog.com/)
 and this library adheres to [Semantic Versioning](http://semver.org/) as mentioned in [README.md][readme] file.
 
+## [ [5.1.1](https://github.com/infobip/infobip-api-python-client/releases/tag/5.1.1) ] - 2025-05-09
+
+### Added
+* [FileParameter](https://github.com/infobip/infobip-api-python-client/blob/master/infobip_api_client/models/file_parameter.py) class that represents a File passed to the API as a Parameter, allows using different backends for files.
+
+### Fixed
+* Adding trackingPixelPosition to Send fully featured email API method (https://github.com/infobip/infobip-api-python-client/issues/29).
+
 ## [ [5.1.0](https://github.com/infobip/infobip-api-python-client/releases/tag/5.1.0) ] - 2025-03-21
 
 ⚠️ **IMPORTANT NOTE:** This release contains breaking changes.

infobip_api_client/__init__.py

@@ -14,7 +14,7 @@
     Do not edit the class manually.
 """  # noqa: E501
 
-__version__ = "5.1.0"
+__version__ = "5.1.1"
 
 # import apis into sdk package
 from infobip_api_client.api.call_routing_api import CallRoutingApi

infobip_api_client/api/email_api.py

@@ -26,6 +26,7 @@
 from typing import Tuple, Optional, List, Dict, Union
 from pydantic import SecretStr
 
+from infobip_api_client.models.file_parameter import FileParameter
 from infobip_api_client.configuration import Configuration
 from infobip_api_client.api_response import ApiResponse, T as ApiResponseT
 import infobip_api_client.models
@@ -82,7 +83,7 @@ def __init__(
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = "infobip-api-client-python/5.1.0"
+        self.user_agent = "infobip-api-client-python/5.1.1"
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):
@@ -525,7 +526,7 @@ def parameters_to_url_query(self, params, collection_formats):
 
     def files_parameters(
         self,
-        files: Dict[str, Union[str, bytes, List[str], List[bytes], Tuple[str, bytes]]],
+        files: Dict[str, Union[str, bytes, List[str], List[bytes], Tuple[str, bytes], List[Union[str, bytes, FileParameter]]]],
     ):
         """Builds form parameters.
 
@@ -541,14 +542,22 @@ def files_parameters(
                     with open(file_param_content, "rb") as f:
                         filename = os.path.basename(f.name)
                         filedata = f.read()
+                        mimetype = (
+                            mimetypes.guess_type(filename)[0]
+                            or "application/octet-stream"
+                        )
                 elif isinstance(file_param_content, bytes):
                     filename = k
                     filedata = file_param_content
+                    mimetype = (
+                        mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                    )
+                elif isinstance(file_param_content, FileParameter):
+                    filename = file_param_content.name
+                    filedata = file_param_content.content.read()
+                    mimetype = file_param_content.content_type
                 else:
                     raise ValueError("Unsupported file value")
-                mimetype = (
-                    mimetypes.guess_type(filename)[0] or "application/octet-stream"
-                )
                 params.append(tuple([k, tuple([filename, filedata, mimetype])]))
         return params
 

infobip_api_client/api_client.py

@@ -415,7 +415,7 @@ def to_debug_report(self):
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 1.0.0\n"
-            "SDK Package Version: 5.1.0".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 5.1.1".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self):

infobip_api_client/configuration.py

@@ -0,0 +1,51 @@
+import io
+import os
+from typing import Optional, Union
+from pydantic import BaseModel, ConfigDict
+
+
+class FileParameter(BaseModel):
+    """
+    Represents a file passed to an API as a parameter.
+    Supports raw bytes or file-like streams (binary).
+    """
+
+    content: io.IOBase
+    name: str = "attachment"
+    content_type: str = "application/octet-stream"
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    def __init__(
+        self,
+        content: Union[bytes, io.IOBase],
+        name: Optional[str] = None,
+        content_type: Optional[str] = None
+    ):
+        """
+        Initialize FileParameter with content, name, and content_type.
+
+        :param content: Raw bytes or file-like binary stream (IOBase).
+        :param name: Optional filename.
+        :param content_type: Optional MIME type, defaults to 'application/octet-stream'.
+        """
+        if isinstance(content, bytes):
+            content = io.BytesIO(content)
+
+        if not isinstance(content, io.IOBase):
+            raise TypeError("content must be bytes or a file-like IOBase stream")
+
+        inferred_name = name or getattr(content, 'name', None)
+        if inferred_name:
+            inferred_name = os.path.basename(inferred_name)
+        else:
+            inferred_name = "attachment"
+
+        super().__init__(
+            content=content,
+            name=inferred_name,
+            content_type=content_type or "application/octet-stream"
+        )
+
+    def __repr__(self):
+        return f"<FileParameter name={self.name!r}, content_type={self.content_type!r}>"

infobip_api_client/models/file_parameter.py

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "infobip_api_client"
-version = "5.1.0"
+version = "5.1.1"
 description = "This is a Python package for Infobip API and you can use it as a dependency to add Infobip APIs to your application."
 authors = ["Infobip support <[email protected]>"]
 license = "MIT License"

pyproject.toml

@@ -21,7 +21,7 @@
 # prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 NAME = "infobip-api-python-client"
-VERSION = "5.1.0"
+VERSION = "5.1.1"
 PYTHON_REQUIRES = ">=3.8"
 REQUIRES = [
     "urllib3 >= 1.25.3, < 2.1.0",