Release 3.1.0

This is an official stable release of the 3.1.0b branch and only contains some code styling and documentation adjustments.

For a full changelog, please refer to the 3.1.0b release:
https://github.com/FujiMakoto/twitter-saucenao/releases/tag/3.1.0b

This release includes breaking changes and configuration updates. Please review the changelog before upgrading.

You will either need to delete the database you are currently using and allow SauceBot to generate a new one (models/database.sqlite if you are using the default configuration), or run the query specified in the changelog above.

Proper migration scripts will hopefully be added in a future release.

Pre-release 3.1.0b

This is a pre-release. It is considered beta and may be prone to stability issues. Furthermore, changes to the codebase have not been officially documented yet.

Use at your own risk!

Added

• Added support for intelligently processing tweets with multiple images via rudimentary language parsing (#22)
• Added official support for monitoring posts made by the bots own account. This can be enabled via the new monitor_self configuration directive. (#38)
• Added support for dynamically shortening tweet output in the event the bot exceeded Twitter's 240 character limit. This is fully dynamic and works by only removing the least essential fields until the tweet is short enough to post. (#6)
• Added localization support (#39)
  • English is currently the only officially supported language, but we welcome contributions for other language files.
• Added support for notifying users when they have requested sauce of an image posted by the original Twitter artist whenever possible (#36)

Changed

• The log_level configuration setting has been moved from [Logging] to [System] in the configuration file. Please adjust this accordingly if you have altered the bots default log level.
• A new column has been added to the tweetsaucecache database table to facilitate media ID caching. You will either need to delete the models/database.sql file before starting the new release of the bot, or update the column accordingly, as the bot does not have any means of managing migrations at the moment:

ALTER TABLE tweetsaucecache ADD COLUMN media_id BIGINT;

• The server module has undergone major refactoring and much of the sauce searching logic has been abstracted to a dedicated SauceManager class in the new sauce module
• Removed deprecated references to query searching
• Some log levels adjusted for more appropriate severity outside of development

Fixed

• Thanks to tweets now being rendered dynamically, there should no longer be instances where tweets fail to post due to the output exceeding twitters 240 character limit

Release 3.0.0

This is the official stable release for 3.0.0; for a more exhaustive changelog, refer to the pre-release build:
https://github.com/FujiMakoto/twitter-saucenao/releases/tag/3.0.0b

Added

• Added an Exact Match and Very Low accuracy indicator.
  • The bot will post a message that there's a good chance the result is inaccurate if it registers as very low.

Changed

• The monitored_keywords / query monitoring feature has been deprecated. This could be considered a violation of Twitter's automation rules and thus can no longer be supported.

Fixed

• Tweepy errors are now being properly caught and logged, no matter where they occur

Release 3.0.0b

Added

• Video previews are now supported for Anime results!
  • This service is provided via trace.moe and must be enabled in the configuration.
  • Free accounts are limited to 150 API queries per-day
• Possibly NSFW/sensitive posts are now flagged appropriately
• Support for AniList and MyAnimeList as anime source URL's implemented
• SauceBot will now try both the first and last images uploaded with a tweet if the first image returns no results
  • This is disabled by default as it can increase API usage. To enable it, see the updated config.example.ini
• Added an FAQ, CREDITS and SUPPORTERS page to the repository

Changed

• The bot's output formatting has been tweaked a bit to be more compact and user-friendly
• SauceBot will now always respond in a comment to inform users when an account has blocked it
• pysaucenao minimum version requirement upped to 1.3.3
• Code refactored to utilize pysaucenao's newly built-in source prioritization
• Refactored all calls to api.update_status to make the code more readable and maintainable

Fixed

• The requested argument was not being passed through correctly following SauceBot's caching implementation

---

Supporters

Thank you so much to all of our supporters on Patreon! It means a lot to me that you believe in this project enough to help fund it.

Waifus / Husbandos ($15+)

• Spina97
• Nyaaa
• Nyabe
• TotallyArk

Main Characters ($6)

• James P Harris
• Karter
• Part
• Patrick Swasey

Supporting Characters ($3)

• Caleb Dron
• Edward Simmons
• Izu
• JL
• Josiah Wolf
• Justin Whang
• MetalMallard
• Migi
• NeonTaeh
• Russel
• SUZUSHIIRO
• Sergio Juarez
• Tamschi
• Ulysses Duckler
• jclc

Release 2.0.0

Fixed

• Library now properly handles Twitter HTTP errors when download_file is enabled
• Utilize utf8mb4 as the database charset when using MySQL (resolves a database error when logging posts with some 4-byte emoji characters in them)
• Daily SauceNao API limit errors are now properly handled
• Console was displaying invalid analytics statistics

---

Supporters

Thank you so much to all of our supporters on Patreon! It means a lot to me that you believe in this project enough to help fund it.

Waifus / Husbandos ($15+)

• Spina97
• Nyaaa
• Nyabe
• TotallyArk

Main Characters ($6)

• James P Harris
• Karter
• Part
• Patrick Swasey

Supporting Characters ($3)

• Caleb Dron
• Edward Simmons
• Izu
• JL
• Josiah Wolf
• Justin Whang
• MetalMallard
• Migi
• NeonTaeh
• Russel
• SUZUSHIIRO
• Sergio Juarez
• Tamschi
• Ulysses Duckler
• jclc

Release 2.0.0 (Beta)

Added

• Database caching implemented for Tweets and SauceNao queries
  • Supports either sqlite or MySQL (defaults to sqlite)
  • Tweets are retained in cache for up to 24-hours
• Yandex and Tinyurl added as alternative search engines to Google when the bot fails to find the sauce itself
• Automatic logging of accounts that block the sauce bot to a dedicated TwitterBlocklist database table
• Support for providing artists with DMCA information if a user has blocked the bot
• Support for displaying Manga chapters
• Official support for E-Hentai results (a new SauceNao addition)
• Some very basic analytics are now printed to the console every 15-minutes (to be improved on in the future)

Fixed

• Resolved an issue where search queries were not disabling properly
• Source URL's are not available in some indexes and were incorrectly just printing "None" in tweets
• The bot now automatically trims comments a bit if tweet-length errors are encountered on monitored accounts
• Proper Tweepy error handling implemented to prevent the console from being spammed with errors that can occur during normal operation (tweets being deleted before we can process them, us being unable to process tweets from protected accounts, etc.)
• Various grammatical and localization fixes courtesy of our many supporters!

Changed

• Re-organized the reply tweet layout to prioritize the artist name / Twitter handle first and foremost
• Some Booru posts have bad source links cited, so we now always provide a Booru link with source URL's
• (API change) Tweepy instance is now configured and initialized globally. (from twsaucenao.api import api). Be wary of this if you're trying to integrate twsaucenao into other projects.
• Improved console logging
• Dependencies have been updated
  • Minimum supported tweepy version is now 3.9.0
  • Minimum supported pysaucenao library version is now 1.1.1

---

Supporters

Thank you so much to all of our supporters on Patreon! It means a lot to me that you believe in this project enough to help fund it.

Waifus / Husbandos ($15+)

• Spina97
• Nyaaa
• Nyabe
• TotallyArk

Main Characters ($6)

• James P Harris
• Karter
• Part

Supporting Characters ($3)

• Caleb Dron
• Edward Simmons
• Izu
• JL
• Josiah Wolf
• Justin Whang
• MetalMallard
• Migi
• NeonTaeh
• Russel
• SUZUSHIIRO
• Sergio Juarez
• Tamschi
• Ulysses Duckler
• jclc

Release 1.1.0

Added

• Support for multiple search queries has been implemented
• Pixiv integration implemented (Currently only used to scrape Pixiv for an artists Twitter handle when crediting artists)
• Configurable character limit implemented for search queries to help cut-back on false positives

Changed

• The monitored_keyword configurable variable has been renamed to monitored_keywords and now supports multiple comma separated values
• Improved logging
• Warnings are now printed when an account has blocked the bot

Fixed

• Resolved an issue where H-Misc results were not being returned and throwing an UnboundLocalError exception

Initial beta release

This tag marks the first official release of the Twitter SauceNao bot.

From this point forward, commits made to the master branch may introduce breaking changes, so please be wary if you decide to keep up-to-date with it.

These changes will be documented in future releases for easier upgrading and migration.

Thank you all for all the support you've shown this project!