Repository files navigation

• Installation
• Usage
• Development
• Code generation
  • Type checking
  • Tests
  • Formatting
• Contributing
  • TODO
• Contributors
• License
• Code of Conduct

Install the gem and add to the application's Gemfile by executing:

$ bundle add bskyrb

If bundler is not being used to manage dependencies, install the gem by executing:

$ gem install bskyrb

You can also install the gem by cloning this repository and running./install-local.sh.

Create a new session:

require'bskyrb'username='your_username'password='your_password'pds_url='https://bsky.social'credentials=Bskyrb::Credentials.new(username,password)session=Bskyrb::Session.new(credentials,pds_url)bsky=Bskyrb::RecordManager.new(session)post_uri=bsky.create_post("Hello world from bskyrb!")["uri"]bsky.like(post_uri)bsky.repost(post_uri)bsky.create_reply(post_uri,"Replying to post from bskyrb")

After checking out the repo, runbin/setup to install dependencies. You can also runbin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, runbundle exec rake install. To release a new version, run./deploy.sh and you will be guided through updating the version number, bundling the gem, and pushing it to RubyGems. You must be signed in with a RubyGems account that has push access to bskyrb.

And configure the type checker:

We are working on a script to generate classes from the atproto lexicon. So far we have made non-query objects. To recreate them:

git submodule add https://github.com/bluesky-social/atproto.git# or just clone it!bin/codegen

This crawls the lexicon directory in your newly-cloned atproto repo, and generates formatted classes based on the json schemas embedded in the files. You can then hydrate them like so:

# make your RecordManager, then...post_by_url=manager.get_post_by_url("https://staging.bsky.app/profile/naia.bsky.social/post/3jszsrnruws27")my_post=Bskyrb::AppBskyFeedDefs::PostView.from_hashpost_by_url["thread"]["post"]=>#<Bskyrb::AppBskyFeedDefs::PostView:0x000000010432a0a0@author={"did"=>"did:plc:scx5mrfxxrqlfzkjcpbt3xfr","handle"=>"naia.bsky.social","displayName"=>"naia","avatar"=>"https://cdn.bsky.social/imgproxy/0uv5pCOimHKw44PfnCt5_XpnOICHz1KeHCl8dknI_ZY/rs:fill:1000:1000:1:0/plain/bafkreibabes4xznjzdwxqj4hzirg7lofhl2detvabroibakewssfkr      "alt"=>""}]}, @indexedAt="2023-04-10T16:51:21.391Z", @labels=[], @likeCount=27, @record=  {"text"=>"gmfromthenewdeckchairibuiltyesterday\n\ntheskyisveryblue",   "$type"=>"app.bsky.feed.post",   "embed"=>    {"$type"=>"app.bsky.embed.images",     "images"=>      [{"alt"=>"",        "image"=>{"$type"=>"blob", "ref"=>{"$link"=>"bafkreif52k6kev6xgy2ydptub5oryss3gsscajrec6zh5r2els4si2yj7i"}, "mimeType"=>"image/jpeg", "size"=>796921}}]},   "createdAt"=>"2023-04-10T16:51:21.049Z"}, @replyCount=4, @repostCount=2, @uri="at://did:plc:scx5mrfxxrqlfzkjcpbt3xfr/app.bsky.feed.post/3jszsrnruws27",@viewer={}>

Next steps:

• Recursion--hydrate the classes embedded in the classes. Some parsing to enable this already happens inLexiconParser.
• Generate classes for queries and other unusual object types.
• Integrate our new classes into the API call methods.

bskyrb uses.rbs type definitions. To check for accuracy, runbin/typecheck. Not all of the output will be useful, especially during rapid development, but it is a good idea to have types at least for the bluesky objects.

Use therbs collection tool to manage definitions for third-party dependencies, for example HTTParty. Usebundle exec rbs collection install to download third-party definitions (you will need to do this beforebin/typecheck will work).

Run the test suite with:

$ bundle exec rake test

So nobody has to argue about formatting, bskyrb uses thestandard gem. Runbin/format to format the code in this repo.

Please do!

• Build
• More/better tests
• (Eventually) Publish/release pipeline
• Split into separate modules for XRPC, Lexicon, ATProto, etc

The gem is available as open source under the terms of theMIT License.

Everyone interacting in the Bskyrb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow thecode of conduct.