Metadata-Version: 2.1
Name: bsky-bridge
Version: 1.0.0
Summary: A Python interface for interacting with the BlueSky social network's API.
Home-page: https://github.com/4xe1/bsky-bridge
Author: Axel Merlo
Author-email: contact@axelm.fr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

  # bsky-bridge Library

  `bsky-bridge` is a Python library providing a streamlined interface to interact with the BlueSky social network via its API.

  ## Table of Contents

  - [Features](#features)
  - [Installation](#installation)
  - [Usage](#usage)
    - [Creating a Session](#creating-a-session)
    - [Posting Content](#posting-content)
    - [Posting Images](#posting-images)
  - [Contribution](#contribution)
  - [License](#license)

  ## Features

  - Easy authentication with BlueSky.
  - Functions to post text and images to BlueSky.

  ## Installation

  ```bash
  pip install bsky-bridge
  ```

  ## Usage

  ### Creating a Session

  Start by establishing a session with your BlueSky handle and password:

  ```python
  from bsky_bridge import BskySession

  session = BskySession("your_handle.bsky.social", "your_password")
  ```

  ### Posting Content

  After initializing a session, you can post text to BlueSky:

  ```python
  from bsky_bridge import post_text

  response = post_text(session, "Hello BlueSky!")
  print(response)
  ```

  ### Posting Images

  To post images along with text, you can use the `post_image` method:

  ```python
  from bsky_bridge import post_image

  postText = "Check out this cool image!"
  imagePath = "path_to_your_image.jpeg"
  altText = "An awesome image"
  response = post_image(session, postText, imagePath, altText)
  print(response)
  ```

  **Note**: The library automatically handles resizing and compressing larger images to ensure they do not exceed 1 MB in size, all while maintaining a quality balance. This ensures efficient and quick image uploads.

  ## Contribution

  Contributions are welcome! Please submit issues for any bug or problem you discover, and pull requests for new features or fixes.

  ## License

  [MIT License](LICENSE)
