instapost 0.1.0__tar.gz → 0.2.0__tar.gz

instapost-0.2.0/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,51 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/project/instapost/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

instapost-0.2.0/.github/workflows/python-package.yml

@@ -0,0 +1,44 @@
+name: Python package
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y ffmpeg
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install flake8 pytest pytest-asyncio pytest-cov
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        pip install -e .
+    
+    - name: Lint with flake8
+      run: |
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    
+    - name: Test with pytest
+      run: |
+        pytest tests/

{instapost-0.1.0 → instapost-0.2.0}/.gitignore

@@ -136,3 +136,4 @@ dmypy.json
 *.pem
 *.key
 .flake8
+

{instapost-0.1.0 → instapost-0.2.0}/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instapost
-Version: 0.1.0
+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.0 → 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.0 → 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.0 → 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.0 → instapost-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "instapost"
-version = "0.1.0"
+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.0 → 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.0 → 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'