upload-post 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

upload_post/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 from .api_client import UploadPostClient, UploadPostError
 
 __all__ = ['UploadPostClient', 'UploadPostError']

upload_post/api_client.py

@@ -1,5 +1,5 @@
 from pathlib import Path
-from typing import Dict, List, Union
+from typing import Dict, List, Union, Optional
 
 import requests
 
@@ -24,43 +24,88 @@ class UploadPostClient:
         video_path: Union[str, Path],
         title: str,
         user: str,
-        platforms: List[str]
+        platforms: List[str],
+        **kwargs
     ) -> Dict:
         """
-        Upload a video to specified social media platforms
-        
+        Upload a video to specified social media platforms.
+
         Args:
-            video_path: Path to video file
-            title: Video title
-            user: User identifier
-            platforms: List of platforms (e.g. ["tiktok", "instagram"])
-            
+            video_path: Path to video file (str or Path) or video URL (str).
+            title: Video title.
+            user: User identifier.
+            platforms: List of platforms (e.g., ["tiktok", "instagram", "linkedin"]).
+            **kwargs: Platform-specific parameters.
+                tiktok: privacy_level (str), disable_duet (bool), disable_comment (bool),
+                        disable_stitch (bool), cover_timestamp (int), brand_content_toggle (bool),
+                        brand_organic (bool), branded_content (bool), brand_organic_toggle (bool),
+                        is_aigc (bool)
+                instagram: media_type (str), share_to_feed (bool), collaborators (str),
+                           cover_url (str), audio_name (str), user_tags (str),
+                           location_id (str), thumb_offset (str)
+                linkedin: description (str), visibility (str), target_linkedin_page_id (str)
+                youtube: description (str), tags (List[str]), categoryId (str),
+                         privacyStatus (str), embeddable (bool), license (str),
+                         publicStatsViewable (bool), madeForKids (bool)
+                facebook: facebook_page_id (str), description (str), video_state (str)
+                threads: description (str)
+                x: tagged_user_ids (List[str]), reply_settings (str), nullcast (bool),
+                   place_id (str), poll_duration (int), poll_options (List[str]),
+                   poll_reply_settings (str)
+                pinterest: pinterest_board_id (str), pinterest_link (str),
+                           pinterest_cover_image_url (str),
+                           pinterest_cover_image_content_type (str),
+                           pinterest_cover_image_data (str),
+                           pinterest_cover_image_key_frame_time (int)
+
         Returns:
-            API response JSON
-            
+            API response JSON.
+
         Raises:
-            UploadPostError: If upload fails
+            UploadPostError: If upload fails or video file not found.
         """
-        video_path = Path(video_path)
-        if not video_path.exists():
-            raise UploadPostError(f"Video file not found: {video_path}")
+        data_payload: List[tuple] = []
+        files_payload: List[tuple] = []
+        video_file_obj = None # To keep track of the opened file
 
         try:
-            with video_path.open("rb") as video_file:
-                files = {"video": video_file}
-                data = {
-                    "title": title,
-                    "user": user,
-                    "platform[]": platforms
-                }
+            # Prepare video
+            if isinstance(video_path, str) and \
+               (video_path.startswith('http://') or video_path.startswith('https://')):
+                # It's a URL
+                data_payload.append(('video', video_path))
+            else:
+                # It's a file path
+                video_p = Path(video_path)
+                if not video_p.exists():
+                    raise UploadPostError(f"Video file not found: {video_p}")
                 
-                response = self.session.post(
-                    f"{self.BASE_URL}/upload",
-                    files=files,
-                    data=data
-                )
-                response.raise_for_status()
-                return response.json()
+                video_file_obj = video_p.open("rb")
+                files_payload.append(('video', (video_p.name, video_file_obj)))
+
+            # Prepare common parameters
+            data_payload.append(('title', title))
+            data_payload.append(('user', user))
+            for p in platforms:
+                data_payload.append(('platform[]', p))
+
+            # Add platform-specific parameters from kwargs
+            for key, value in kwargs.items():
+                if isinstance(value, bool):
+                    data_payload.append((key, str(value).lower())) # 'true' or 'false'
+                elif isinstance(value, list):
+                    for v_item in value: # Handles array parameters like 'tags' or 'tagged_user_ids'
+                        data_payload.append((f'{key}[]' if key.endswith('s') else key, str(v_item))) # API expects tags[] for YouTube, etc.
+                else:
+                    data_payload.append((key, str(value)))
+            
+            response = self.session.post(
+                f"{self.BASE_URL}/upload", # Endpoint for video is /upload
+                files=files_payload if files_payload else None,
+                data=data_payload
+            )
+            response.raise_for_status()
+            return response.json()
                 
         except requests.exceptions.RequestException as e:
             raise UploadPostError(
@@ -70,3 +115,154 @@ class UploadPostClient:
             raise UploadPostError(
                 f"Invalid response format: {str(e)}"
             ) from e
+        finally:
+            if video_file_obj:
+                video_file_obj.close()
+
+    def upload_photos(
+        self,
+        photos: List[Union[str, Path]],
+        user: str,
+        platforms: List[str],
+        title: str,
+        caption: Optional[str] = None,
+        **kwargs
+    ) -> Dict:
+        """
+        Upload photos to specified social media platforms.
+
+        Args:
+            photos: List of photo file paths (str or Path) or photo URLs (str).
+            user: User identifier.
+            platforms: List of platforms (e.g., ["tiktok", "instagram"]).
+            title: Title of the post.
+            caption: Optional caption/description for the photos.
+            **kwargs: Platform-specific parameters.
+                linkedin: visibility (str), target_linkedin_page_id (str)
+                facebook: facebook_page_id (str)
+                tiktok: auto_add_music (bool), disable_comment (bool), 
+                        branded_content (bool), disclose_commercial (bool),
+                        photo_cover_index (int), description (str)
+                instagram: media_type (str)
+                pinterest: pinterest_board_id (str), pinterest_alt_text (str), 
+                           pinterest_link (str)
+
+        Returns:
+            API response JSON.
+
+        Raises:
+            UploadPostError: If upload fails or any photo file not found.
+        """
+        data_payload: List[tuple] = []
+        files_payload: List[tuple] = []
+        opened_files: List[object] = []  # To keep track of files to close them later
+
+        try:
+            # Prepare photos
+            for photo_item in photos:
+                if isinstance(photo_item, str) and \
+                   (photo_item.startswith('http://') or photo_item.startswith('https://')):
+                    # It's a URL
+                    data_payload.append(('photos[]', photo_item))
+                else:
+                    # It's a file path
+                    photo_path = Path(photo_item)
+                    if not photo_path.exists():
+                        raise UploadPostError(f"Photo file not found: {photo_path}")
+                    
+                    photo_file_obj = photo_path.open("rb")
+                    opened_files.append(photo_file_obj)
+                    files_payload.append(('photos[]', (photo_path.name, photo_file_obj)))
+            
+            # Prepare common parameters
+            data_payload.append(('user', user))
+            data_payload.append(('title', title))
+            if caption is not None:
+                data_payload.append(('caption', caption))
+
+            for p in platforms:
+                data_payload.append(('platform[]', p))
+
+            # Add platform-specific parameters from kwargs
+            for key, value in kwargs.items():
+                if isinstance(value, bool):
+                    data_payload.append((key, str(value).lower())) # 'true' or 'false'
+                elif isinstance(value, list):
+                    for v_item in value: # Handles cases where a kwarg value is a list
+                        data_payload.append((key, str(v_item)))
+                else:
+                    data_payload.append((key, str(value)))
+
+            response = self.session.post(
+                f"{self.BASE_URL}/upload_photos",
+                files=files_payload if files_payload else None,
+                data=data_payload
+            )
+            response.raise_for_status()
+            return response.json()
+
+        except requests.exceptions.RequestException as e:
+            raise UploadPostError(f"API request failed: {str(e)}") from e
+        except (ValueError, TypeError) as e: # ValueError for json parsing, TypeError for bad args
+            raise UploadPostError(f"Data or response format error: {str(e)}") from e
+        finally:
+            for f_obj in opened_files:
+                f_obj.close()
+
+    def upload_text(
+        self,
+        user: str,
+        platforms: List[str],
+        title: str, # As per API docs, 'title' is used for the text content
+        **kwargs
+    ) -> Dict:
+        """
+        Upload text posts to specified social media platforms.
+
+        Args:
+            user: User identifier.
+            platforms: List of platforms (e.g., ["x", "linkedin"]). 
+                       Supported: "linkedin", "x", "facebook", "threads".
+            title: The text content for the post.
+            **kwargs: Platform-specific parameters.
+                linkedin: target_linkedin_page_id (str)
+                facebook: facebook_page_id (str)
+
+        Returns:
+            API response JSON.
+
+        Raises:
+            UploadPostError: If upload fails.
+        """
+        data_payload: List[tuple] = []
+
+        try:
+            # Prepare common parameters
+            data_payload.append(('user', user))
+            data_payload.append(('title', title)) # 'title' carries the text content
+
+            for p in platforms:
+                data_payload.append(('platform[]', p))
+
+            # Add platform-specific parameters from kwargs
+            # (e.g., target_linkedin_page_id, facebook_page_id)
+            for key, value in kwargs.items():
+                if isinstance(value, bool): # Should not happen based on current docs for text
+                    data_payload.append((key, str(value).lower()))
+                elif isinstance(value, list): # Should not happen based on current docs for text
+                    for v_item in value:
+                        data_payload.append((key, str(v_item)))
+                else:
+                    data_payload.append((key, str(value)))
+            
+            response = self.session.post(
+                f"{self.BASE_URL}/upload_text",
+                data=data_payload
+            )
+            response.raise_for_status()
+            return response.json()
+
+        except requests.exceptions.RequestException as e:
+            raise UploadPostError(f"API request failed: {str(e)}") from e
+        except (ValueError, TypeError) as e: 
+            raise UploadPostError(f"Data or response format error: {str(e)}") from e

upload_post/cli.py

@@ -18,8 +18,8 @@ def main():
         "--platforms", 
         nargs="+",
         required=True,
-        choices=["tiktok", "instagram", "facebook", "youtube"],
-        help="Platforms to upload to"
+        choices=["tiktok", "instagram", "linkedin", "youtube", "facebook", "x", "threads", "pinterest"],
+        help="Platforms to upload to. For platform-specific parameters, please use the Python API."
     )
     parser.add_argument(
         "--verbose", 

upload_post-0.1.2.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: upload-post
+Version: 0.1.2
+Summary: Python client for Upload-Post.com API
+Home-page: https://www.upload-post.com/
+Author: Manuel Gracia
+Author-email: hi@img2html.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Requires-Dist: python-dotenv>=0.19.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# upload-post Python Client
+
+A Python client for the [Upload-Post.com](https://www.upload-post.com/) API, designed to facilitate interaction with the service. Upload-Post.com allows you to upload videos to multiple social media platforms simultaneously.
+
+[![PyPI version](https://img.shields.io/pypi/v/upload-post.svg)](https://pypi.org/project/upload-post/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/upload-post.svg)](https://pypi.org/project/upload-post/)
+
+## Features
+
+- 🚀 Upload videos to TikTok, Instagram, LinkedIn, YouTube, Facebook, X (Twitter), Threads, and Pinterest (platform support based on API availability)
+- 🖼️ Upload photos to TikTok, Instagram, LinkedIn, Facebook, X (Twitter), Threads, and Pinterest
+- ✍️ Upload text posts to LinkedIn, X (Twitter), Facebook, and Threads
+- 🔒 Secure API key authentication
+- 📁 File validation and error handling
+- 📊 Detailed logging
+- 🤖 Both CLI and Python API interfaces
+
+## Installation
+
+```bash
+pip install upload-post
+```
+
+## Usage
+
+### Command Line Interface
+
+```bash
+upload-post \
+  --api-key "your_api_key_here" \
+  --video "/path/to/video.mp4" \
+  --title "My Awesome Video" \
+  --user "testuser" \
+  --platforms tiktok instagram
+```
+
+### Python API
+
+```python
+from upload_post import UploadPostClient, UploadPostError
+from pathlib import Path
+
+# Initialize client
+client = UploadPostClient(api_key="your_api_key_here")
+
+# Example: Upload a video
+try:
+    response_video = client.upload_video(
+        video_path="/path/to/video.mp4", # Can also be a URL: "https://example.com/video.mp4"
+        title="My Awesome Video",
+        user="testuser",
+        platforms=["tiktok", "youtube", "linkedin"],
+        # TikTok specific
+        privacy_level="PUBLIC_TO_EVERYONE",
+        disable_comment=False,
+        # YouTube specific
+        description="Detailed description for YouTube",
+        tags=["tutorial", "python", "api"],
+        categoryId="22", # "People & Blogs"
+        privacyStatus="public",
+        # LinkedIn specific
+        visibility="PUBLIC", # Required for LinkedIn if not using default
+        description="Post commentary for LinkedIn" # Optional, uses title if not set
+    )
+    print(f"Video upload successful: {response_video}")
+except UploadPostError as e:
+    print(f"Video upload failed: {e}")
+
+# Example: Upload photos
+try:
+    response_photos = client.upload_photos(
+        photos=["/path/to/image1.jpg", Path("/path/to/image2.png"), "https://example.com/photo3.jpg"],
+        user="testuser",
+        platforms=["instagram", "facebook"],
+        title="My Photo Album",
+        caption="Check out these cool photos!",
+        # Platform-specific parameters
+        facebook_page_id="your_facebook_page_id", # Required for Facebook
+        media_type="IMAGE" # For Instagram, "IMAGE" or "STORIES"
+    )
+    print(f"Photo upload successful: {response_photos}")
+except UploadPostError as e:
+    print(f"Photo upload failed: {e}")
+
+# Example: Upload a text post
+try:
+    response_text = client.upload_text(
+        user="testuser",
+        platforms=["x", "linkedin"],
+        title="This is my awesome text post! #Python #API",
+        # Platform-specific parameters
+        # For LinkedIn, if posting to an organization page:
+        # target_linkedin_page_id="your_linkedin_page_id",
+        # For Facebook, facebook_page_id is required:
+        # facebook_page_id="your_facebook_page_id" 
+        # (add 'facebook' to platforms list too)
+    )
+    print(f"Text post successful: {response_text}")
+except UploadPostError as e:
+    print(f"Text post failed: {e}")
+```
+
+## Error Handling
+
+The client raises `UploadPostError` exceptions for API errors. Common error scenarios:
+
+- Invalid API key
+- Missing required parameters
+- File not found
+- Platform not supported
+- API rate limits exceeded
+
+## Documentation
+
+For full API documentation and platform availability, see the official [Upload-Post.com documentation](https://www.upload-post.com/).
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details.

upload_post-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+upload_post/__init__.py,sha256=WtahEoLXqDhFCLBEYmWJjNIvwTcPeBk0IeZ8yABUmA4,131
+upload_post/api_client.py,sha256=uF0vQzY4t2nIdvLSi8NF3HBImNrpFaSCA_vSFXLKy1E,11153
+upload_post/cli.py,sha256=Ruyl0sOpRVXnRnT3lUcObIM700pUFHJtWfIIXBsQSNY,1708
+upload_post-0.1.2.dist-info/METADATA,sha256=ZpLE62psTCDowYiSLsy9CFwGscysLJ96RkZ5VK_e5nM,4707
+upload_post-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+upload_post-0.1.2.dist-info/entry_points.txt,sha256=D_MqrtgTSJQkRIwPLVCvKcwxNnaoAS8my7_gBtU1X_I,53
+upload_post-0.1.2.dist-info/top_level.txt,sha256=c5Jpx2u159BqOkC2P3Gp3dSotri2_XAADesx3h9pCRU,12
+upload_post-0.1.2.dist-info/RECORD,,

{upload_post-0.1.1.dist-info → upload_post-0.1.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

upload_post-0.1.1.dist-info/METADATA

@@ -1,90 +0,0 @@
-Metadata-Version: 2.2
-Name: upload-post
-Version: 0.1.1
-Summary: Python client for Upload-Post.com API
-Home-page: https://www.upload-post.com/
-Author: Manuel Gracia
-Author-email: hi@img2html.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.25.1
-Requires-Dist: python-dotenv>=0.19.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# upload-post Python Client
-
-A Python client for the [Upload-Post.com](https://www.upload-post.com/) API, designed to facilitate interaction with the service. Upload-Post.com allows you to upload videos to multiple social media platforms simultaneously.
-
-[![PyPI version](https://img.shields.io/pypi/v/upload-post.svg)](https://pypi.org/project/upload-post/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/upload-post.svg)](https://pypi.org/project/upload-post/)
-
-## Features
-
-- 🚀 Upload videos to TikTok, Instagram, Facebook, and YouTube (platform support based on API availability)
-- 🔒 Secure API key authentication
-- 📁 File validation and error handling
-- 📊 Detailed logging
-- 🤖 Both CLI and Python API interfaces
-
-## Installation
-
-```bash
-pip install upload-post
-```
-
-## Usage
-
-### Command Line Interface
-
-```bash
-upload-post \
-  --api-key "your_api_key_here" \
-  --video "/path/to/video.mp4" \
-  --title "My Awesome Video" \
-  --user "testuser" \
-  --platforms tiktok instagram
-```
-
-### Python API
-
-```python
-from upload_post import UploadPostClient
-
-client = UploadPostClient(api_key="your_api_key_here")
-
-response = client.upload_video(
-    video_path="/path/to/video.mp4",
-    title="My Awesome Video",
-    user="testuser",
-    platforms=["tiktok", "instagram"]
-)
-```
-
-## Error Handling
-
-The client raises `UploadPostError` exceptions for API errors. Common error scenarios:
-
-- Invalid API key
-- Missing required parameters
-- File not found
-- Platform not supported
-- API rate limits exceeded
-
-## Documentation
-
-For full API documentation and platform availability, see the official [Upload-Post.com documentation](https://www.upload-post.com/).
-
-## License
-
-MIT License - See [LICENSE](LICENSE) for details.

upload_post-0.1.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-upload_post/__init__.py,sha256=qV2u_RV8hHd0WBkAyNe611kqJlPqy1bK-75grZg-cLA,131
-upload_post/api_client.py,sha256=lGfEQnCpZOPuabKduzS-k5Qc4t295S45heV_mXdXsIE,2134
-upload_post/cli.py,sha256=wb037f9A62Y4w4Awa3pLxuqekVbnFDlqzL8Uuu_tOlI,1605
-upload_post-0.1.1.dist-info/METADATA,sha256=CdS2fq78fvFIHDZXENxdES1lZvxVuA_Azy8b3OmU4CY,2414
-upload_post-0.1.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-upload_post-0.1.1.dist-info/entry_points.txt,sha256=D_MqrtgTSJQkRIwPLVCvKcwxNnaoAS8my7_gBtU1X_I,53
-upload_post-0.1.1.dist-info/top_level.txt,sha256=c5Jpx2u159BqOkC2P3Gp3dSotri2_XAADesx3h9pCRU,12
-upload_post-0.1.1.dist-info/RECORD,,