All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
- Bluesky connection: revert increase on maximum image size (introduced in v0.13.1), as the increase applies only to images uploaded as media attachments and not to embed thumbnails, which are still limited to 1MB by Bluesky.
- Renamed relevant constants and methods to reflect that the limit is specific to embed thumbnails, to prevent confusion in the future.
- Minor dependency updates.
- Connection queues and posted message ID collections are now bounded to prevent unlimited memory growth. Default bounds are large enough to not affect deduplication logic, and bounded structures are LRU to keep the most recent messages and connections in memory if the bounds are exceeded.
- General refactors to reduce memory usage across the codebase:
- Reducing memory overhead of all classes and objects by using
__slots__where possible. - Maintaining messages queues in
dequeobjects instead of lists, to prevent extra copies of the queues when adding and removing messages.
- Reducing memory overhead of all classes and objects by using
- Refactored image compression logic on the Bluesky connection with early returns and less memory copies.
- Expanded unit test coverage.
- Removed warnings on test runs.
- Mastodon Activity Bot connection: added support for posting one image to the message, with optional alt text.
- Bluesky connection: increased maximum image size to 2MB, after a recent Bluesky appview update.
- Mastodon Activity Bot was incorrectly logging a failure when trying to post a message, even though the message was posted successfully.
- General improvements on memory usage and performance
Media,Message,MessageMetadataobjects should use less memory overall- Reduced initialization of default metadata objects
- Improved cleanup of just-sent messages on the writing thread
- Minor dependency updates
- Modernize
pyproject.tomlconfiguration withpoetryv2 features - Updates to Github Actions workflows
- WebhookConnection: added a new connection class to support posting messages to any platform that supports incoming webhooks.
- This is a write-only connection, with options to set the webhook endpoint and payload key, as well as an optional Bearer token for authentication.
- Logging improvements: remove some redundant logs and add context to minimum ID changes on some connections.
- Minor dependency updates
- BlueskyConnection: fixed an issue where, if a user's most recent post was a repost, the updated
min_idcould be set incorrectly to the repost's URI, which could be lexicographically less than any of the user's posts, causing the connection to fetch the same posts again on the next read, and cycle through the same posts indefinitely.
- TwitterConnection is now thread-aware for cross-posting threads from other connections
- Expanded unit test coverage
aka the reply thread update!
- Initial support for (self-)thread-aware connections in Bluesky and Mastodon connections:
- When reading messages, if a message is a reply to another message, Barkr will record the reply-to relationship between the two messages.
- When posting messages, if a message is a reply to another message AND the original message was also posted by Barkr to the destination connection, Barkr will set the reply-to relationship on the posted message accordingly
- This allows Barkr to maintain threads when cross-posting replies between connections that support threading.
- Replies to messages that were not posted by Barkr, or replies to messages on connections that do not support threading, will continue to be skipped when posting.
- When fetching new posts from a connection, messages are now returned in chronological order (from oldest to newest), and they are processed in this order when posting them on other connections.
- Bluesky connection: posts now use the created record URI as an ID, instead of indexation time. Created record URIs are unique and can be sorted chronologically by design.
- Minor dependency updates.
- Minor tweak to Github Actions pipeline.
- Bluesky connection now ignores quote posts when fetching new messages, to prevent reposting them across connections without the underlying context.
- Minor fixes on tests.
- Add support for Python 3.14, drop support for Python 3.9
- Minor dependency updates.
- Better logging on errors for the RSS and the Mastodon ActivityBot connections.
- Minor dependency updates
- Bluesky connection: added exponential back-off logic when fetching new posts, to account for transient network issues.
- Increased unit test coverage
- Minor dependency updates and other refactors
- Increased timeout for Bluesky-related network requests to 15 seconds, to prevent timeouts on slow connections or when uploading blobs.
- Addressed a bug on the Bluesky connection where retrying to post a message after certain kinds of failures would post correctly, but break the rest of the writing thread, preventing further messages from being posted. The root cause is an unbound local variable in the retry logic that was not being assigned correctly.
- Minor dependency updates
- Bluesky connection: added support to set who can reply to a post (through thread gates) when posting a message, with the
allowed_repliesparameter.- This is an optional parameter, and defaults to
None, which means that anyone can reply to the post (default behavior before this update). - If set, it will be used to set the thread gate for the post, allowing only users who meet the criteria to reply.
- This is an optional parameter, and defaults to
- Implemented exponential back-off retry logic when retrieving a recently posted message's details on Bluesky.
- Minor dependency updates
- Minor tweaks to error messages and logging statements to support debugging flows.
- Minor dependency updates
- Catch the right exception on Mastodon connections when there's timeouts and network issues
- Prevent the RSS tests from getting stuck
- Minor dependency updates
- Minor test coverage updates
- Improved error message on Bluesky errors
- Early return when trying to compress an image that's already within the maximum size allowed by Bluesky, to avoid unnecessary processing.
- Handle invalid MIME types when posting images to Bluesky
- Bluesky connection: handle Bluesky internal server errors gracefully when attempting to upload an embed image for a post.
- Bluesky connection: added a new, optional parameter (off by default) to allow Barkr to compress images that are being posted to Bluesky, if their size exceeds the maximum allowed by the platform.
- Initially this is only done on embed blobs (e.g. for URL previews), as Barkr doesn't yet support posting images as embeds.
- This is useful to prevent Bluesky from rejecting images that are too large, and to avoid having to manually resize images before posting them.
- The default behavior is to not compress images, to keep the current behavior. Images too large will still be rejected by Bluesky, resulting in posts without images.
- Minor performance improvements to the Bluesky connection
- Minor dependency updates
- Minor dependency updates.
- Bluesky connection: fixed an issue where URL facets were not being correctly added to a post with a URL when a request to get embed metadata for the URL failed, even though the facet doesn't need said metadata.
aka the media update!
- Implemented support for storing media (images, videos) in the
Messagemodel, with descriptive or alt text.- Connections can decide whether to support text-only messages or text+media messages.
- Empty message filter now considers supported message type when deciding if a message is empty (e.g. a message with only media is not empty if the connection supports media).
- Bluesky connection: added support for reading media from messages.
- Mastodon connection: added support for reading media from messages, and adding media to messages.
- Minor dependency updates
- Minor tweaks to Github Actions pipeline
- Mastodon connection: added support for reading and writing messages with
visibilitymetadata: public, unlisted, private, direct.- Note that private and direct messages will not be published to the other connections, to prevent accidental leaks of private messages.
- Minor dependency updates
- Minor tweaks to the
Messagemodel
- Mastodon connection: added support for reading and writing messages with
labelmetadata: content warnings, spoiler tags, etc.
- Minor dependency updates
- Tweaks to logging statements
- Increased unit test coverage
- Bluesky connection: properly handle errors when uploading embed images for posted links.
- Minor dependency updates
- More unit test coverage for utility and helper functions.
- Bluesky connection: fixed an issue where the writing thread would stop working after an unhandled timeout exception.
- Bluesky connection: fixed an issue where the writing thread would stop working if a message is posted and the details are not retrieved successfully.
- Added support for
languagemetadata on theMessagemodel, which is currently supported by the Mastodon and Bluesky connections, on read and write operations.
- Connections will now raise an error if duplicate modes are being passed on instantiation.
- Minor dependency updates
- Twitter connection: fixed an issue retrieving the ID of a posted tweet
- Telegram connection: fixed an issue where the message content was not properly being passed to the bot when sending a message
- When posting messages via
Barkr.write_message, each connection will have its own error-catching logic, so that if one connection fails, the others will still be able to post.
- Implemented a new connection class for ActivityBot, a Mastodon bot implementation, with write support.
- Minor dependency updates
- Barkr will not attempt to publish a message whose length exceeds a channel's known maximum (Bluesky, Twitter)
- Removed unneeded / empty method implementations from non-read/write connections
- Increased test coverage for Mastodon connection
- Minor dependency updates
- When posting on Bluesky, an exception trying to retrieve an image thumbnail for a URL embed will no longer cause the whole writing thread to stop working.
- When posting on Bluesky, if the message contains accented characters (e.g. the é in "Andrés") and a URL, the URL facet is now being set to the right substring.
- Minor refactors
- Adding small tests for uncovered cases
- Bluesky connection can now recover when attempting to post a message with an embed whose preview image is too large
- Minor dependency updates
- Increased test coverage for RSS and Telegram connections
Messagemodel can now be imported frombarkr.models(barkr.models.messageis still supported to keep backwards compatibility)- Documented
write_messagemethod onREADME.mdsample code.
- Add support for embedding URLs (with URL preview and clickable URLs) when creating posts in Bluesky
- Unit tests for MastodonConnection's retry logic
- Minor dependency updates
- RSS connections will no longer attempt to publish all old entries on connection init.
- Minor refactor of the Bluesky connection to handle post embeds.
- Minor dependency updates.
- Bluesky posts that contain a single link and multiple words are now being reconstructed successfully.
- Connections no longer attempt to publish a post with an empty message
- Bluesky posts that contain a single link (which is trimmed when stored on
atprotoand stored as an embed) are now being reconstructed successfully.
- Minor dependency updates
- Gracefully handles server errors when trying to read new messages from connections
- Minor dependency updates
- New option on the
Barkrclass to set up a "write rate limit", optional and defaults toNone. If set,barkrwill only write the specified amount of messages per each polling period, as a safeguard to prevent publishing too many posts in a limited time.
- Minor refactor and more validations added to the
Barkrclass
- New method on the
Barkrclass to enable posting a message to the existing Connections on a non-blocking way, i.e. not requiring the read-write loop to be started.
- Introduce artificial delay after posting on Bluesky to prevent an error when querying for the new post's indexed datetime
- Modified minimum supported Python version from 3.9 to 3.9.2
- Support for Python 3.9 and 3.10 (all the way to 3.13)
- Minor dependency updates
- Implement an initial, read-only connection class for RSS feeds.
- Minor dependency updates
- Implement an initial, write-only connection class for Discord.
- All connection classes and enums are now exported from
barkr.connectionsin addition to their specific submodules for ease of use (e.g. to usefrom barkr.connections import MastodonConnection, DiscordConnectioninstead of requiring two different import lines) - Updated sample code in the README to showcase all existing connections.
- Minor Python type annotation non-breaking tweaks.
- New Github Actions pipeline to publish new releases directly to PyPI from a clean state, to solve the issue of releases having unneeded, development or test files inside by accident.
- Sample code in the README file had typos when importing
barkrmodules.
- Updated the
mastodonpackage to its latest release - Other minor dependency updates
- Implemented Telegram connection with write support to a chat or channel through a Telegram bot
- Minor dependency updates
- Minor dependency updates
- Fixed an issue in which posted messages were not being tracked successfully on Bluesky, leading to duplicates
- Cleaner filtering of reblogs and replies for Bluesky and Mastodon
- Cleaner logging statements
- Implemented Bluesky connection with read and write support
- Minor dependency updates
- Addressed a bug that caused messages to constantly push in a loop due to not keeping track of previously seen messages properly. New unit tests added to prevent this issue from arising again in the future.
- Implemented Twitter connection with support for write-only mode
- Dependency updates
- Dependency updates
- Cohost support has been removed since the platform is now on read-only mode and is being sunsetted.
- Test coverage for Cohost Connection increased
- Initial implementation of a Cohost connection. This is the first version to officially support distinct channels!
- Test coverage for Mastodon Connection increased
- Library is now marked as a typed package
- Messages retrieved from Mastodon will no longer include HTML tags
- Messages are now wrapped in a custom wrapper class to allow connections to provide with optional metadata
- Connections no longer will attempt to queue / distribute a fetched message that they actually posted before (i.e. only messages posted outside of each connection will be queued)
- Use most recent Mastodon status to retrieve next
min_id
Initial release!
- Initial implementation of the Barkr social media cross-posting tool.
- Implementation of a Mastodon connection
- Basic documentation for the project