sharedkernel 1.6.10__tar.gz → 1.7.1__tar.gz

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sharedkernel
-Version: 1.6.10
+Version: 1.7.1
 Summary: sharekernel is a shared package between all python projects
 Author: Smilinno
 Description-Content-Type: text/markdown
@@ -14,11 +14,16 @@ Requires-Dist: persian_tools
 Requires-Dist: sentry-sdk
 Requires-Dist: jdatetime
 Requires-Dist: persiantools
+Requires-Dist: boto3
 
 # SharedKernel
 this a shared kernel package
 
 # Change Log
+### Version 1.7.1
+- Update BaseDocument initial values
+### Version 1.7.0
+- Implement S3 Uploader
 ### Version 1.6.10
 - Add updated_on to BaseDocument
 - Update phonenumber normalizer

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/README.md

@@ -2,6 +2,10 @@
 this a shared kernel package
 
 # Change Log
+### Version 1.7.1
+- Update BaseDocument initial values
+### Version 1.7.0
+- Implement S3 Uploader
 ### Version 1.6.10
 - Add updated_on to BaseDocument
 - Update phonenumber normalizer

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/setup.py

@@ -31,10 +31,11 @@ setup(
         "persian_tools",
         "sentry-sdk",
         "jdatetime",
-        "persiantools"
+        "persiantools",
+        "boto3"
     ],
     # *strongly* suggested for sharing
-    version="1.6.10",
+    version="1.7.1",
     description="sharekernel is a shared package between all python projects",
     long_description=long_description,
     long_description_content_type="text/markdown",

sharedkernel-1.7.1/sharedkernel/objects/base_document.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel, Field
+from typing import Optional
+from datetime import datetime
+
+
+class BaseDocument(BaseModel):
+    id: Optional[str]
+    is_deleted: bool = False
+    created_on: datetime = Field(default_factory=datetime.now)
+    updated_on: datetime = Field(default_factory=datetime.now)

sharedkernel-1.7.1/sharedkernel/s3_uploader.py

@@ -0,0 +1,77 @@
+import requests
+import boto3
+from io import BytesIO
+import uuid
+import os
+
+class S3Uploader:
+    def __init__(self, endpoint_url, bucket, access_key, secret_key):
+        """
+        Initializes the S3Uploader with credentials and optional endpoint/region.
+
+        :param endpoint_url: Custom endpoint URL (for S3-compatible services like MinIO)
+        :param bucket: Name of S3 bucket
+        :param access_key: Access key
+        :param secret_key: Secret key
+        """
+        self.endpoint_url = endpoint_url
+        self.bucket = bucket
+        self.access_key = access_key
+        self.secret_key = secret_key
+
+        # Initialize the S3 client
+        self.s3 = boto3.client(
+            's3',
+            endpoint_url=self.endpoint_url,
+            aws_access_key_id=self.access_key,
+            aws_secret_access_key=self.secret_key,
+        )
+
+    def upload_file_object(self, file_obj, object_name=None, file_extension=None):
+        """
+        Uploads a file object to an S3 bucket and returns its URL.
+
+        :param file_obj: File object to upload
+        :param object_name: S3 file name to save as (optional)
+        :param file_extension: File extension to append to object name (optional)
+        :return: URL of the uploaded file if successful, else False
+        """
+        # Use uuid4 to generate a unique object_name if not provided
+        if object_name is None:
+            object_name = str(uuid.uuid4())
+
+        # Append the file extension to the object_name
+        if file_extension:
+            object_name += file_extension
+
+        # Upload the file object
+        self.s3.upload_fileobj(file_obj, self.bucket, object_name, ExtraArgs={'ACL':'public-read'})
+        print(f"File object uploaded to {self.bucket} as {object_name}.")
+
+        # Construct the URL of the uploaded file
+        file_url = f"{self.endpoint_url}/{self.bucket}/{object_name}"
+
+        return file_url
+
+    def upload_file_from_url(self, file_url, object_name=None):
+        """
+        Downloads a file from a URL and uploads it to an S3 bucket, returning its URL.
+
+        :param file_url: URL of the file to download
+        :param object_name: S3 file name to save as (optional)
+        :return: URL of the uploaded file if successful, else False
+        """
+        # Step 1: Download the file from the provided URL
+        response = requests.get(file_url)
+        response.raise_for_status()  # Check if the request was successful
+
+         # Extract file extension from the URL if available
+        file_extension = os.path.splitext(file_url)[1]  # Get extension from URL (e.g., .jpg, .png, etc.)
+        
+        # Use the filename from the URL if no object_name is provided, otherwise use uuid4
+        if object_name is None:
+            object_name = str(uuid.uuid4())  # Default to UUID if filename can't be extracted
+
+        # Step 2: Upload the file to S3
+        file_obj = BytesIO(response.content)
+        return self.upload_file_object(file_obj, object_name, file_extension)

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/sharedkernel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sharedkernel
-Version: 1.6.10
+Version: 1.7.1
 Summary: sharekernel is a shared package between all python projects
 Author: Smilinno
 Description-Content-Type: text/markdown
@@ -14,11 +14,16 @@ Requires-Dist: persian_tools
 Requires-Dist: sentry-sdk
 Requires-Dist: jdatetime
 Requires-Dist: persiantools
+Requires-Dist: boto3
 
 # SharedKernel
 this a shared kernel package
 
 # Change Log
+### Version 1.7.1
+- Update BaseDocument initial values
+### Version 1.7.0
+- Implement S3 Uploader
 ### Version 1.6.10
 - Add updated_on to BaseDocument
 - Update phonenumber normalizer

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/sharedkernel.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ sharedkernel/common.py
 sharedkernel/date_converter.py
 sharedkernel/jwt_service.py
 sharedkernel/regex_masking.py
+sharedkernel/s3_uploader.py
 sharedkernel/string_extentions.py
 sharedkernel.egg-info/PKG-INFO
 sharedkernel.egg-info/SOURCES.txt

{sharedkernel-1.6.10 → sharedkernel-1.7.1}/sharedkernel.egg-info/requires.txt

@@ -8,3 +8,4 @@ persian_tools
 sentry-sdk
 jdatetime
 persiantools
+boto3

sharedkernel-1.6.10/sharedkernel/objects/base_document.py

@@ -1,10 +0,0 @@
-from pydantic import BaseModel
-from typing import Optional
-from datetime import datetime
-
-
-class BaseDocument(BaseModel):
-    id: Optional[str]
-    is_deleted: bool = False
-    created_on: datetime = datetime.now()
-    updated_on: datetime = datetime.now()