Ezra_yendau created this task.
Ezra_yendau added projects: PendingChangesBot, Pywikibot, FlaggedRevs.

TASK DESCRIPTION
  Description
  -----------
  
  Add support for retrieving the **stable (reviewed) revision** of a page in 
Pywikibot via the **FlaggedRevs** extension.
  
  On wikis with FlaggedRevs enabled (e.g., **fiwiki**, **dewiki**), the 
**stable revision** is the default version shown to readers — not necessarily 
the latest edit. 
  Currently, `pages.latest_revision()` returns the most recent revision, but 
bots and tools need access to the **stable revision** and its ID.
  
  This task implements:
  
  - `_basepage.stable_revision()` → returns `Revision` object (like 
`latest_revision()`)
  
  ---
  
  Technical Approach
  ------------------
  
  Add a new function `stable_revision()` to pywikibot/pages/_basepage.py to 
return the latest stable (reviewed) revision of the page.
  
  Returns `None` if:
  
  - FlaggedRevs is not enabled on the site
  - No stable revision exists
  
  ---
  
  Code Review Requirements:
  -------------------------
  
  For the patch to pass Pywikibot code review, please ensure:
  
  **Follow Gerrit guidelines:**
     * Manual:Pywikibot/Gerrit - For_developers
     * Gerrit: Commit message guidelines
     * See also: T407059 <https://phabricator.wikimedia.org/T407059> (Pywikibot 
contribution how-to documentation)
  
  **Code quality:**
  Patch must follow the Pywikibot style guide
  No flake8 errors or warnings
  
     * Commit message must follow style guidelines
  
  **Testing:**
  
  - Added error handling must include unit tests
  - Tests should verify proper error detection and messaging for 
OAuth/BotPassword scenarios

TASK DETAIL
  https://phabricator.wikimedia.org/T409848

EMAIL PREFERENCES
  https://phabricator.wikimedia.org/settings/panel/emailpreferences/

_______________________________________________
pywikibot-bugs mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to