instapost 0.1.1__tar.gz → 0.2.0__tar.gz

{instapost-0.1.1 → instapost-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instapost
-Version: 0.1.1
+Version: 0.2.0
 Summary: A Python library for automating Instagram posting (images, reels, carousels)
 Project-URL: Homepage, https://blaya.ia.br
 Project-URL: Repository, https://github.com/pedroluz/instapost
@@ -96,7 +96,7 @@ poster.post_reel(video="./video.mp4", caption="New reel! 🎬", share_to_feed=Tr
 
 # Post a carousel
 poster.post_carousel(
-    media_urls=[
+    media_items=[
         {"media": "./photo1.jpg", "type": "IMAGE"},
         {"media": "./video.mp4", "type": "VIDEO"},
     ],

{instapost-0.1.1 → instapost-0.2.0}/README.md

@@ -59,7 +59,7 @@ poster.post_reel(video="./video.mp4", caption="New reel! 🎬", share_to_feed=Tr
 
 # Post a carousel
 poster.post_carousel(
-    media_urls=[
+    media_items=[
         {"media": "./photo1.jpg", "type": "IMAGE"},
         {"media": "./video.mp4", "type": "VIDEO"},
     ],

{instapost-0.1.1 → instapost-0.2.0}/instapost/client.py

@@ -26,52 +26,52 @@ class InstagramPoster(BaseInstagramClient):
         raise NotImplementedError("Use post_image, post_reel, or post_carousel instead")
 
     # Image methods
-    def upload_image(self, image_url: str, caption: str = "") -> str:
+    def upload_image(self, image: str, caption: str = "") -> str:
         """Upload a single image and return container ID."""
-        return self._image.upload(image_url, caption)
+        return self._image.upload(image, caption)
 
-    def post_image(self, image_url: str, caption: str = "") -> dict:
+    def post_image(self, image: str, caption: str = "") -> dict:
         """Upload and publish a single image.
 
         Args:
-            image_url: URL or local file path to image
+            image: URL or local file path to image
             caption: Optional caption
 
         Returns:
             API response with published media ID
         """
         # Auto-upload if local file
-        if os.path.exists(image_url):
-            image_url = MediaUploader.upload_image(image_url)
+        if os.path.exists(image):
+            image = MediaUploader.upload_image(image)
 
-        return self._image.post(image_url, caption)
+        return self._image.post(image, caption)
 
     # Reel methods
     def upload_reel(
         self,
-        video_url: str,
+        video: str,
         caption: str = "",
-        cover_url: Optional[str] = None,
+        cover: Optional[str] = None,
         share_to_feed: bool = True,
         timeout: int = 120,
     ) -> str:
         """Upload a reel and return container ID."""
-        return self._reel.upload(video_url, caption, cover_url, share_to_feed, timeout)
+        return self._reel.upload(video, caption, cover, share_to_feed, timeout)
 
     def post_reel(
         self,
-        video_url: str,
+        video: str,
         caption: str = "",
-        cover_url: Optional[str] = None,
+        cover: Optional[str] = None,
         share_to_feed: bool = True,
         timeout: int = 120,
     ) -> dict:
         """Upload and publish a reel.
 
         Args:
-            video_url: URL or local file path to video
+            video: URL or local file path to video
             caption: Optional caption
-            cover_url: Optional URL or local path to cover image
+            cover: Optional URL or local path to cover image
             share_to_feed: Whether to also share to feed
             timeout: Video processing timeout in seconds
 
@@ -79,40 +79,40 @@ class InstagramPoster(BaseInstagramClient):
             API response with published media ID
         """
         # Auto-upload if local files
-        if os.path.exists(video_url):
-            video_url = MediaUploader.upload_video(video_url)
+        if os.path.exists(video):
+            video = MediaUploader.upload_video(video)
 
-        if cover_url and os.path.exists(cover_url):
-            cover_url = MediaUploader.upload_image(cover_url)
+        if cover and os.path.exists(cover):
+            cover = MediaUploader.upload_image(cover)
 
-        return self._reel.post(video_url, caption, cover_url, share_to_feed, timeout)
+        return self._reel.post(video, caption, cover, share_to_feed, timeout)
 
     # Carousel methods
-    def upload_carousel(self, media_urls: list[dict], caption: str = "") -> str:
+    def upload_carousel(self, media_items: list[dict], caption: str = "") -> str:
         """Upload a carousel and return container ID."""
-        return self._carousel.upload(media_urls, caption)
+        return self._carousel.upload(media_items, caption)
 
-    def post_carousel(self, media_urls: list[dict], caption: str = "") -> dict:
+    def post_carousel(self, media_items: list[dict], caption: str = "") -> dict:
         """Upload and publish a carousel.
 
         Args:
-            media_urls: List of dicts with 'media' (local file path or publicly accessible URL)
-                       and 'type' keys. Type must be 'IMAGE' or 'VIDEO'
+            media_items: List of dicts with 'media' (local file path or publicly accessible URL)
+                        and 'type' keys. Type must be 'IMAGE' or 'VIDEO'
             caption: Optional caption
 
         Returns:
             API response with published media ID
         """
         # Auto-upload local files
-        processed_urls = []
-        for item in media_urls:
+        processed_items = []
+        for item in media_items:
             media = item['media']
             if os.path.exists(media):
                 media = MediaUploader.upload(media)
 
-            processed_urls.append({
+            processed_items.append({
                 'media': media,
                 'type': item['type']
             })
 
-        return self._carousel.post(processed_urls, caption)
+        return self._carousel.post(processed_items, caption)

{instapost-0.1.1 → instapost-0.2.0}/instapost/posting/carousel.py

@@ -7,31 +7,31 @@ class CarouselPoster(BaseInstagramClient):
     MIN_ITEMS = 2
     MAX_ITEMS = 10
 
-    def upload(self, media_urls: list[dict], caption: str = "") -> str:
+    def upload(self, media_items: list[dict], caption: str = "") -> str:
         """
         Upload a carousel to Instagram.
 
         Args:
-            media_urls: List of dicts with 'media' (local file path or publicly accessible URL)
-                       and 'type' ('IMAGE' or 'VIDEO') keys.
+            media_items: List of dicts with 'media' (local file path or publicly accessible URL)
+                        and 'type' ('IMAGE' or 'VIDEO') keys.
             caption: Optional caption for the carousel.
 
         Returns:
             Container ID for publishing.
         """
-        if not self.MIN_ITEMS <= len(media_urls) <= self.MAX_ITEMS:
+        if not self.MIN_ITEMS <= len(media_items) <= self.MAX_ITEMS:
             raise ValueError(f"Carousel must have between {self.MIN_ITEMS} and {self.MAX_ITEMS} items")
 
-        children_ids = [self._create_child(media) for media in media_urls]
+        children_ids = [self._create_child(media) for media in media_items]
         return self._create_container({
             "media_type": "CAROUSEL",
             "children": ",".join(children_ids),
             "caption": caption,
         })
 
-    def post(self, media_urls: list[dict], caption: str = "") -> dict:
+    def post(self, media_items: list[dict], caption: str = "") -> dict:
         """Upload and publish a carousel."""
-        return self.publish(self.upload(media_urls, caption))
+        return self.publish(self.upload(media_items, caption))
 
     def _create_child(self, media: dict) -> str:
         """Create a child container for a carousel item."""

{instapost-0.1.1 → instapost-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "instapost"
-version = "0.1.1"
+version = "0.2.0"
 description = "A Python library for automating Instagram posting (images, reels, carousels)"
 readme = "README.md"
 requires-python = ">=3.10"

{instapost-0.1.1 → instapost-0.2.0}/tests/test_client.py

@@ -99,7 +99,7 @@ class TestInstagramPoster:
                 with patch.object(client._reel, 'post', return_value={'media_id': 'post_cover'}):
                     result = client.post_reel(
                         temp_video_file,
-                        cover_url=temp_image_file,
+                        cover=temp_image_file,
                         share_to_feed=True,
                         timeout=120
                     )
@@ -114,7 +114,7 @@ class TestInstagramPoster:
             container_id = client.upload_reel(
                 'https://example.com/video.mp4',
                 caption='Test reel',
-                cover_url='https://example.com/cover.jpg',
+                cover='https://example.com/cover.jpg',
                 share_to_feed=False,
                 timeout=60
             )
@@ -125,54 +125,54 @@ class TestInstagramPoster:
     def test_upload_carousel(self):
         """Test uploading a carousel."""
         client = InstagramPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': 'https://example.com/img1.jpg', 'type': 'IMAGE'},
             {'media': 'https://example.com/img2.jpg', 'type': 'IMAGE'},
         ]
 
         with patch.object(client._carousel, 'upload', return_value='carousel_123'):
-            container_id = client.upload_carousel(media_urls)
+            container_id = client.upload_carousel(media_items)
 
             assert container_id == 'carousel_123'
 
     def test_post_carousel_urls(self):
         """Test posting a carousel from URLs."""
         client = InstagramPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': 'https://example.com/img1.jpg', 'type': 'IMAGE'},
             {'media': 'https://example.com/img2.jpg', 'type': 'IMAGE'},
         ]
 
         with patch.object(client._carousel, 'post', return_value={'media_id': 'carousel_post'}):
-            result = client.post_carousel(media_urls)
+            result = client.post_carousel(media_items)
 
             assert result == {'media_id': 'carousel_post'}
 
     def test_post_carousel_local_files(self, temp_image_file):
         """Test posting a carousel with local files (auto-upload)."""
         client = InstagramPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': temp_image_file, 'type': 'IMAGE'},
             {'media': 'https://example.com/img2.jpg', 'type': 'IMAGE'},
         ]
 
         with patch('instapost.client.MediaUploader.upload', return_value='https://catbox.moe/img1.jpg'):
             with patch.object(client._carousel, 'post', return_value={'media_id': 'carousel_post_2'}):
-                result = client.post_carousel(media_urls)
+                result = client.post_carousel(media_items)
 
                 assert result == {'media_id': 'carousel_post_2'}
 
     def test_post_carousel_mixed_local_and_urls(self, temp_image_file):
         """Test posting carousel with mix of local files and URLs."""
         client = InstagramPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': temp_image_file, 'type': 'IMAGE'},
             {'media': 'https://example.com/video.mp4', 'type': 'VIDEO'},
         ]
 
         with patch('instapost.client.MediaUploader.upload', return_value='https://catbox.moe/uploaded.jpg'):
             with patch.object(client._carousel, 'post', return_value={'media_id': 'mixed_carousel'}):
-                result = client.post_carousel(media_urls, caption='Mixed carousel')
+                result = client.post_carousel(media_items, caption='Mixed carousel')
 
                 assert result == {'media_id': 'mixed_carousel'}
 

{instapost-0.1.1 → instapost-0.2.0}/tests/test_posting.py

@@ -94,46 +94,46 @@ class TestCarouselPoster:
     def test_upload_carousel_valid(self):
         """Test uploading a valid carousel."""
         poster = CarouselPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': 'https://example.com/img1.jpg', 'type': 'IMAGE'},
             {'media': 'https://example.com/img2.jpg', 'type': 'IMAGE'},
         ]
 
         with patch.object(poster, '_create_child', side_effect=['child_1', 'child_2']):
             with patch.object(poster, '_create_container', return_value='carousel_123'):
-                container_id = poster.upload(media_urls, caption='Carousel')
+                container_id = poster.upload(media_items, caption='Carousel')
 
                 assert container_id == 'carousel_123'
 
     def test_upload_carousel_too_few_items(self):
         """Test carousel with too few items."""
         poster = CarouselPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': 'https://example.com/img1.jpg', 'type': 'IMAGE'},
         ]
 
         with pytest.raises(ValueError, match='between'):
-            poster.upload(media_urls)
+            poster.upload(media_items)
 
     def test_upload_carousel_too_many_items(self):
         """Test carousel with too many items."""
         poster = CarouselPoster(access_token='token', ig_user_id='user')
-        media_urls = [{'media': f'https://example.com/img{i}.jpg', 'type': 'IMAGE'} for i in range(12)]
+        media_items = [{'media': f'https://example.com/img{i}.jpg', 'type': 'IMAGE'} for i in range(12)]
 
         with pytest.raises(ValueError, match='between'):
-            poster.upload(media_urls)
+            poster.upload(media_items)
 
     def test_upload_carousel_mixed_media(self):
         """Test carousel with mixed image and video."""
         poster = CarouselPoster(access_token='token', ig_user_id='user')
-        media_urls = [
+        media_items = [
             {'media': 'https://example.com/img1.jpg', 'type': 'IMAGE'},
             {'media': 'https://example.com/video1.mp4', 'type': 'VIDEO'},
         ]
 
         with patch.object(poster, '_create_child', side_effect=['child_1', 'child_2']):
             with patch.object(poster, '_create_container', return_value='carousel_456'):
-                container_id = poster.upload(media_urls)
+                container_id = poster.upload(media_items)
 
                 assert container_id == 'carousel_456'