agoras-platforms 1.1.6__tar.gz

agoras_platforms-1.1.6/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: agoras-platforms
+Version: 1.1.6
+Summary: Platform-specific implementations for Agoras social networks
+Home-page: https://github.com/LuisAlejandro/agoras
+Author: Luis Alejandro Martínez Faneyth
+Author-email: luis@luisalejandro.org
+Keywords: social networks,twitter,facebook,instagram,linkedin,discord,youtube,tiktok,telegram,threads,whatsapp,x
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+Requires-Dist: agoras-core>=2.0.0
+Requires-Dist: tweepy==4.16.0
+Requires-Dist: python-facebook-api==0.24.0
+Requires-Dist: linkedin-api-client==0.3.0
+Requires-Dist: discord.py==2.7.1
+Requires-Dist: google-api-python-client==2.194.0
+Requires-Dist: google-api-core>=2.0.0
+Requires-Dist: google-auth==2.47.0
+Requires-Dist: google-auth-oauthlib>=1.2.0
+Requires-Dist: google-auth-httplib2==0.3.1
+Requires-Dist: oauth2client==4.1.3
+Requires-Dist: platformdirs==4.9.6
+Requires-Dist: authlib==1.7.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: python-telegram-bot>=22.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+agoras-platforms
+================
+
+Platform-specific implementations for social networks.
+
+Installation
+------------
+
+.. code-block:: bash
+
+   pip install agoras-platforms
+
+Supported Platforms (10)
+-------------------------
+
+All platforms are fully extracted and functional:
+
+- ✅ **Discord** - Gaming and community platform
+- ✅ **Facebook** - Social network
+- ✅ **Instagram** - Photo and video sharing
+- ✅ **LinkedIn** - Professional network
+- ✅ **Telegram** - Messaging platform
+- ✅ **Threads** - Text-based conversations (Meta)
+- ✅ **TikTok** - Short-form video
+- ✅ **WhatsApp** - Messaging platform
+- ✅ **X** - Social network (formerly Twitter)
+- ✅ **YouTube** - Video platform
+
+Usage
+-----
+
+.. code-block:: python
+
+   import asyncio
+   from agoras.platforms.facebook import Facebook
+
+   async def post_to_facebook():
+       fb = Facebook(facebook_access_token='...')
+       await fb._initialize_client()
+       try:
+           post_id = await fb.post(
+               status_text='Hello World',
+               status_link='https://example.com'
+           )
+           print(f'Posted: {post_id}')
+       finally:
+           await fb.disconnect()
+
+   asyncio.run(post_to_facebook())
+
+Dependencies
+------------
+
+- agoras-core>=2.0.0
+- Platform-specific SDKs:
+
+  - tweepy (X/Twitter)
+  - python-facebook-api (Facebook)
+  - linkedin-api-client (LinkedIn)
+  - discord.py (Discord)
+  - google-api-python-client (YouTube)
+  - python-telegram-bot (Telegram)
+  - And more...

agoras_platforms-1.1.6/README.rst

@@ -0,0 +1,63 @@
+agoras-platforms
+================
+
+Platform-specific implementations for social networks.
+
+Installation
+------------
+
+.. code-block:: bash
+
+   pip install agoras-platforms
+
+Supported Platforms (10)
+-------------------------
+
+All platforms are fully extracted and functional:
+
+- ✅ **Discord** - Gaming and community platform
+- ✅ **Facebook** - Social network
+- ✅ **Instagram** - Photo and video sharing
+- ✅ **LinkedIn** - Professional network
+- ✅ **Telegram** - Messaging platform
+- ✅ **Threads** - Text-based conversations (Meta)
+- ✅ **TikTok** - Short-form video
+- ✅ **WhatsApp** - Messaging platform
+- ✅ **X** - Social network (formerly Twitter)
+- ✅ **YouTube** - Video platform
+
+Usage
+-----
+
+.. code-block:: python
+
+   import asyncio
+   from agoras.platforms.facebook import Facebook
+
+   async def post_to_facebook():
+       fb = Facebook(facebook_access_token='...')
+       await fb._initialize_client()
+       try:
+           post_id = await fb.post(
+               status_text='Hello World',
+               status_link='https://example.com'
+           )
+           print(f'Posted: {post_id}')
+       finally:
+           await fb.disconnect()
+
+   asyncio.run(post_to_facebook())
+
+Dependencies
+------------
+
+- agoras-core>=2.0.0
+- Platform-specific SDKs:
+
+  - tweepy (X/Twitter)
+  - python-facebook-api (Facebook)
+  - linkedin-api-client (LinkedIn)
+  - discord.py (Discord)
+  - google-api-python-client (YouTube)
+  - python-telegram-bot (Telegram)
+  - And more...

agoras_platforms-1.1.6/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agoras_platforms-1.1.6/setup.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Please refer to AUTHORS.rst for a complete list of Copyright holders.
+# Copyright (C) 2022-2026, Agoras Developers.
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from setuptools import find_namespace_packages, setup
+
+setup(
+    name='agoras-platforms',
+    version='1.1.6',
+    author='Luis Alejandro Martínez Faneyth',
+    author_email='luis@luisalejandro.org',
+    url='https://github.com/LuisAlejandro/agoras',
+    description='Platform-specific implementations for Agoras social networks',
+    long_description=open('README.rst').read(),
+    long_description_content_type='text/x-rst',
+    packages=find_namespace_packages(where='src'),
+    package_dir={'': 'src'},
+    python_requires='>=3.10',
+    install_requires=[
+        'agoras-core>=2.0.0',
+        'tweepy==4.16.0',
+        'python-facebook-api==0.24.0',
+        'linkedin-api-client==0.3.0',
+        'discord.py==2.7.1',
+        'google-api-python-client==2.194.0',
+        'google-api-core>=2.0.0',
+        'google-auth==2.47.0',
+        'google-auth-oauthlib>=1.2.0',
+        'google-auth-httplib2==0.3.1',
+        'oauth2client==4.1.3',
+        'platformdirs==4.9.6',
+        'authlib==1.7.0',
+        'cryptography>=42.0.0',
+        'python-telegram-bot>=22.1',
+    ],
+    classifiers=[
+        'Development Status :: 5 - Production/Stable',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: GNU General Public License v3 (GPLv3)',
+        'Natural Language :: English',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
+        'Programming Language :: Python :: 3.14',
+    ],
+    keywords=[
+        'social networks', 'twitter', 'facebook', 'instagram', 'linkedin',
+        'discord', 'youtube', 'tiktok', 'telegram', 'threads', 'whatsapp', 'x'
+    ],
+    zip_safe=False,
+)

agoras_platforms-1.1.6/src/agoras/__init__.py

@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+# Namespace package for agoras
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

agoras_platforms-1.1.6/src/agoras/platforms/__init__.py

@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+#
+# Please refer to AUTHORS.rst for a complete list of Copyright holders.
+# Copyright (C) 2022-2026, Agoras Developers.
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+"""
+agoras.platforms
+================
+
+Platform-specific implementations for social networks.
+
+This package provides concrete implementations of the SocialNetwork interface
+for 10 social media platforms.
+"""
+
+from .discord import Discord
+from .facebook import Facebook
+from .instagram import Instagram
+from .linkedin import LinkedIn
+from .telegram import Telegram
+from .threads import Threads
+from .tiktok import TikTok
+from .whatsapp import WhatsApp
+from .x import X
+from .youtube import YouTube
+
+__all__ = [
+    'Discord',
+    'Facebook',
+    'Instagram',
+    'LinkedIn',
+    'Telegram',
+    'Threads',
+    'TikTok',
+    'WhatsApp',
+    'X',
+    'YouTube',
+]

agoras_platforms-1.1.6/src/agoras/platforms/discord/__init__.py

@@ -0,0 +1,3 @@
+from .wrapper import Discord
+
+__all__ = ["Discord"]

agoras_platforms-1.1.6/src/agoras/platforms/discord/api.py

@@ -0,0 +1,249 @@
+# -*- coding: utf-8 -*-
+#
+# Please refer to AUTHORS.md for a complete list of Copyright holders.
+# Copyright (C) 2022-2026, Agoras Developers.
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from agoras.core.api_base import BaseAPI
+
+from .auth import DiscordAuthManager
+
+
+class DiscordAPI(BaseAPI):
+    """
+    Discord API handler that centralizes Discord operations.
+
+    Provides methods for Discord authentication, server/channel management,
+    message operations, and file uploads.
+    """
+
+    def __init__(self, bot_token, server_name, channel_name):
+        """
+        Initialize Discord API instance.
+
+        Args:
+            bot_token (str): Discord bot token
+            server_name (str): Discord server name
+            channel_name (str): Discord channel name
+        """
+        super().__init__(
+            bot_token=bot_token,
+            server_name=server_name,
+            channel_name=channel_name
+        )
+
+        # Initialize the authentication manager
+        self.auth_manager = DiscordAuthManager(
+            bot_token=bot_token,
+            server_name=server_name,
+            channel_name=channel_name
+        )
+
+    @property
+    def bot_token(self):
+        """Get the Discord bot token from the auth manager."""
+        return self.auth_manager.bot_token if self.auth_manager else None
+
+    @property
+    def server_name(self):
+        """Get the Discord server name from the auth manager."""
+        return self.auth_manager.server_name if self.auth_manager else None
+
+    @property
+    def channel_name(self):
+        """Get the Discord channel name from the auth manager."""
+        return self.auth_manager.channel_name if self.auth_manager else None
+
+    @property
+    def user_info(self):
+        """Get the Discord user info from the auth manager."""
+        return self.auth_manager.user_info if self.auth_manager else None
+
+    async def authenticate(self):
+        """
+        Authenticate with Discord API using the auth manager and client.
+
+        Returns:
+            DiscordAPI: Self for method chaining
+
+        Raises:
+            Exception: If authentication fails
+        """
+        if self._authenticated:
+            return self
+
+        # Authenticate with auth manager (this creates and sets up the client)
+        auth_success = await self.auth_manager.authenticate()
+        if not auth_success:
+            error_msg = 'Discord authentication failed'
+            if hasattr(self.auth_manager, '_last_error') and self.auth_manager._last_error:
+                error_msg += f': {self.auth_manager._last_error}'
+            raise Exception(error_msg)
+
+        # Ensure client was created during authentication
+        if not self.auth_manager.client:
+            raise Exception('Discord client not available after authentication')
+
+        self.client = self.auth_manager.client
+        self._authenticated = True
+        return self
+
+    async def disconnect(self):
+        """
+        Disconnect from Discord API and clean up resources.
+        """
+        # Disconnect the client first
+        if self.client:
+            self.client.disconnect()
+
+        # Clear auth manager data
+        if self.auth_manager:
+            self.auth_manager.access_token = None
+
+        # Clear BaseAPI client
+        self.client = None
+        self._authenticated = False
+
+    async def post(self, content=None, embeds=None, file=None):
+        """
+        Post a message to the configured Discord channel.
+
+        Args:
+            content (str, optional): Text content of the message
+            embeds (list, optional): List of Discord embeds
+            file (discord.File, optional): File to attach
+
+        Returns:
+            str: Message ID
+
+        Raises:
+            Exception: If message posting fails
+        """
+        if not self._authenticated:
+            await self.authenticate()
+
+        if not self.client:
+            raise Exception('Discord client not available')
+
+        await self._rate_limit_check('post', 1.0)
+        return await self.client.send_message(content=content, embeds=embeds, file=file)
+
+    async def like(self, message_id, emoji='❤️'):
+        """
+        Add a reaction (like) to a Discord message.
+
+        Args:
+            message_id (str): ID of the message to react to
+            emoji (str): Emoji to react with
+
+        Returns:
+            str: Message ID
+
+        Raises:
+            Exception: If reaction fails
+        """
+        if not self._authenticated:
+            await self.authenticate()
+
+        if not self.client:
+            raise Exception('Discord client not available')
+
+        await self._rate_limit_check('like', 0.5)
+        return await self.client.add_reaction(message_id, emoji)
+
+    async def delete(self, message_id):
+        """
+        Delete a Discord message.
+
+        Args:
+            message_id (str): ID of the message to delete
+
+        Returns:
+            str: Message ID
+
+        Raises:
+            Exception: If deletion fails
+        """
+        if not self._authenticated:
+            await self.authenticate()
+
+        if not self.client:
+            raise Exception('Discord client not available')
+
+        await self._rate_limit_check('delete', 0.5)
+        return await self.client.delete_message(message_id)
+
+    async def upload_file(self, file_content, filename, content=None, embeds=None):
+        """
+        Upload a file to Discord.
+
+        Args:
+            file_content: File-like object or bytes
+            filename (str): Name of the file
+            content (str, optional): Message content to accompany file
+            embeds (list, optional): Embeds to include with file
+
+        Returns:
+            str: Message ID
+
+        Raises:
+            Exception: If file upload fails
+        """
+        if not self._authenticated:
+            await self.authenticate()
+
+        if not self.client:
+            raise Exception('Discord client not available')
+
+        await self._rate_limit_check('upload_file', 1.0)
+        return await self.client.upload_file(file_content, filename, content, embeds)
+
+    async def share(self, message_id):
+        """
+        Share is not supported for Discord.
+
+        Args:
+            message_id (str): ID of the message
+
+        Raises:
+            Exception: Share not supported for Discord
+        """
+        raise Exception('Share not supported for Discord')
+
+    def create_embed(self, title=None, description=None, url=None,
+                     embed_type='rich', image_url=None):
+        """
+        Create a Discord embed object.
+
+        Args:
+            title (str, optional): Embed title
+            description (str, optional): Embed description
+            url (str, optional): Embed URL
+            embed_type (str): Embed type (default: 'rich')
+            image_url (str, optional): Image URL for embed
+
+        Returns:
+            discord.Embed: Discord embed object
+        """
+        if not self.client:
+            raise Exception('Discord client not available')
+
+        return self.client.create_embed(
+            title=title,
+            description=description,
+            url=url,
+            embed_type=embed_type,
+            image_url=image_url
+        )