Skip to main content

Python wrapper for the ATProtocol API

Project description

atprotocol

🚧 Under construction 🚧

Python 3.10 wrapper for the ATProtocol API. It aims to closely emulate the Typescript implementation, including:

  • APIs for ATProtocol and Bluesky
  • Validation and (almost) complete types

Getting started

First install the package:

pip install atprotocol

Then in your application:

from atprotocol.bsky import BskyAgent

agent = BskyAgent()

Usage

Session management

Log into a server using these APIs. You'll need an active session for most methods.

from atprotocol.bsky import BskyAgent

agent = BskyAgent()
agent.login(identifier='jett.ai', password='letsgoduke')

API calls

These are the calls currently available in atprotocol. More are being added regularly.

# Feeds and content
agent.get_timeline()
agent.get_author_feed(actor, limit)
agent.get_post_thread(uri, depth)
agent.get_likes(uri, cid, limit)
agent.get_reposted_by(uri, cid, limit)

# Social graph
agent.get_followers(actor)

# Actors
agent.get_profile(actor)
agent.get_profiles(actors)
agent.search_actors(term, limit)

# Session management
agent.login(params)

Advanced

Generic agent

If you want a generic AT Protocol agent without methods related to the Bluesky social lexicon, use the AtpAgent instead of the BskyAgent.

from atprotocol import AtpAgent

agent = AtpAgent(service='https://example.com')

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atprotocol-0.0.2.tar.gz (11.8 kB view details)

Uploaded Source

Built Distribution

atprotocol-0.0.2-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file atprotocol-0.0.2.tar.gz.

File metadata

  • Download URL: atprotocol-0.0.2.tar.gz
  • Upload date:
  • Size: 11.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.10.8 Darwin/21.6.0

File hashes

Hashes for atprotocol-0.0.2.tar.gz
Algorithm Hash digest
SHA256 6786c33a89842f62e485841a63eefb0158bf0d86b1a4e6e86c1e8d5151dd4948
MD5 73bc63f2dfdaf0201285e2004542742a
BLAKE2b-256 789c0f8ee2cd93dd07e9c22c979cd33fdf70ee649b73b79df9b6c27816db4a5e

See more details on using hashes here.

File details

Details for the file atprotocol-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: atprotocol-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.2 CPython/3.10.8 Darwin/21.6.0

File hashes

Hashes for atprotocol-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fa53d49bad5e0f2ca9d755d080e8eb481cdf20504c2acc2b8a9265850b551076
MD5 a71726ef17c48a2f820731be2d2f15cc
BLAKE2b-256 8918658e1b55af0c35b9a075ce0e5c7e36dbb27c8a6afd8d55ad0bcb61446951

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page