bsky's Introduction

Bsky (Atproto)

This is an API wrapper for BlueSky Social

Installation

Add the dependency to your shard.yml:

dependencies:
  bsky:
    github: jwoertink/bsky

Run shards install

Usage

require "bsky"

client = Bsky::Client.new
client.login("my.handle.social", "my-app-pass-word")

client.send_post("Posting from the API")

complex_post = Bsky::RichText.new("A complex post for @crystal.bsky.social https://crystal-lang.org")
complex_post.add_mention("@crystal.bsky.social", did: "did:plc:abc123")
complex_post.add_link("https://crystal-lang.org")

image_data = File.read("./images/crystal.png")
image = client.upload_image(image_data, mime_type: "image/png", alt: "A nice Crystal")

external_card = Bsky::ExternalCard.new(
  uri: "https://crystal-lang.org",
  title: "The Crystal Programming Language",
  description: "A language for computers and humans!",
  thumb: image
)
complex_post.embed_external(external_card)

# complex_post.embed_images([image])

client.send_post(complex_post)

client.logout

Development

Contributing

Fork it (https://github.com/jwoertink/bsky/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

Contributors

Jeremy Woertink - creator and maintainer

bsky's People

Contributors

Stargazers

Watchers

bsky's Issues

Error handling

The docs all seem to show every endpoint returning a 400 or 401 whether it was a bad request or unauthorized except for the calls that don't require authorization like createSession. It looks like the body is generally always a hash with error, and message. Some of the errors have specific values

Recommend Projects