74 lines
No EOL
2.3 KiB
Python
74 lines
No EOL
2.3 KiB
Python
from abc import ABC, abstractmethod
|
|
from typing import List, Optional, Union, BinaryIO
|
|
from fediverse_types import FediverseNotification, FediversePost, Visibility
|
|
|
|
|
|
class FediverseService(ABC):
|
|
"""Abstract interface for Fediverse platform services (Misskey, Pleroma, etc.)"""
|
|
|
|
@abstractmethod
|
|
def get_notifications(self, since_id: Optional[str] = None) -> List[FediverseNotification]:
|
|
"""
|
|
Retrieve notifications from the Fediverse instance.
|
|
|
|
Args:
|
|
since_id: Optional ID to get notifications newer than this ID
|
|
|
|
Returns:
|
|
List of FediverseNotification objects
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def create_post(
|
|
self,
|
|
text: str,
|
|
reply_to_id: Optional[str] = None,
|
|
visibility: Visibility = Visibility.HOME,
|
|
file_ids: Optional[List[str]] = None,
|
|
visible_user_ids: Optional[List[str]] = None
|
|
) -> str:
|
|
"""
|
|
Create a new post on the Fediverse instance.
|
|
|
|
Args:
|
|
text: The text content of the post
|
|
reply_to_id: Optional ID of post to reply to
|
|
visibility: Visibility level for the post
|
|
file_ids: Optional list of file IDs to attach
|
|
visible_user_ids: Optional list of user IDs who can see the post (for specified visibility)
|
|
|
|
Returns:
|
|
ID of the created post
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def get_post_by_id(self, post_id: str) -> Optional[FediversePost]:
|
|
"""
|
|
Retrieve a specific post by its ID.
|
|
|
|
Args:
|
|
post_id: The ID of the post to retrieve
|
|
|
|
Returns:
|
|
FediversePost object if found, None otherwise
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def upload_file(self, file_data: Union[BinaryIO, bytes], filename: Optional[str] = None) -> str:
|
|
"""
|
|
Upload a file to the Fediverse instance.
|
|
|
|
Args:
|
|
file_data: File data as binary stream or bytes
|
|
filename: Optional filename for the uploaded file
|
|
|
|
Returns:
|
|
File ID that can be used in posts
|
|
|
|
Raises:
|
|
RuntimeError: If file upload fails
|
|
"""
|
|
pass |