v4.0.2

Fixed

• Issue #42, credentials checking

Added

• Testing for credentials checking

v4.0.1

Changed autocomplete API endpoint url

See Issue #39 for more information

Changed

• Switched from front-end API url to official REST API url for autocompletion.
• Updated documentation for rule34Py.autocomplete
• Updated unit tests
• Changed API_URLS.AUTOCOMPLETE to semi official endpoint

Version 4.0.0

Older versions of this library will no longer work, do to an REST Api change

This closes issue #35

Added

• Added a rule34Py.autocomplete method.
• Added AutocompleteTag class.
• Added parameter to rule34Py.search method for excluding ai generated content.
  • Added unit test

Changed

• Updated API wrapper to support website’s new authentication system.
• The underlying website API now requires authentication (api_key and user_id) for all requests.
• Updated unit tests.

Version 3.0.0

This version update is another big change in the API, there fore the major version changed.
We finally have a github page for our documentation, thanks to @ripariancommit .

Added

• Added captcha-compliance capabilities. You can now pass the client your captcha clearance token by completing the captcha in your browser, opening the response header, and writing your cf_clearance token into the client's rule34Py.captcha_clearance attribute and setting the client's user_agent attribute to match your browser.
  • Alternatively, set your execution environment's R34_CAPTCHA_CLEARANCE and R34_USER_AGENT variables to the appropriate values. The client will read form them during initialization.
  • See this user guide for more information. (#24)
• Added a rate limiter for requests to the rule34.xxx base site (the PHP endpoint). By default, the client will now limit API calls that use this endpoint to 1 per second.
  • This behavior can be disabled by setting rule34Py.set_base_site_rate_limit(False).
  • There is no rate limit on the api.rule34.xxx endpoint, which is assumed to handle rate-limiting on the server-side.
  • This new feature requires the requests-ratelimiter module.

Changed

• Changed the behavior of the rule34Py.random_post() method to function more like the website. The method now accepts no tag parameters, and returns a random post ID from all posts on the site. Users who want to use the old behavior of returning a random post from the first 1000 tag-search results are directed to do something like random.choice(rule34Py.search([tags...])).
• Changed the rule34Py.get_pool() method to return a Pool object containing more complete information about a Pool.
  • The Pool's post ids can be accessed via the Pool.posts attribute.
• Moved the :examples/ python recipes into tutorial documentation in the new sphinx documentation (:docs/tutorials). (#24)

Deprecated

• Deprecated support for python runtimes 3.5 to 3.8, as they are EOL. The minimum supported python version is now 3.9. (#27)