Page MenuHomePhabricator

Do not generate warning on parameter `variant` for API requests
Closed, ResolvedPublic

Description

API requests supports the URL parameter variant. For instance, compare
https://sr.wikipedia.org/w/api.php?action=parse&format=jsonfm&formatversion=2&page=HTTP&variant=sr-ec and
https://sr.wikipedia.org/w/api.php?action=parse&format=jsonfm&formatversion=2&page=HTTP&variant=sr-el

But it generates the warning:

"warnings": "Unrecognized parameter: 'variant'"

So remove the warning and support the parameter officially.

Event Timeline

Fomafix claimed this task.
Fomafix raised the priority of this task from to Low.
Fomafix updated the task description. (Show Details)
Fomafix added a project: MediaWiki-Action-API.
Fomafix added subscribers: Reedy, Aklapper, Fomafix.

Change 250686 had a related patch set uploaded (by Gerrit Patch Uploader):
ApiParse: Support parameter variant

https://gerrit.wikimedia.org/r/250686

Quick cross-reference: the variant parameter is only documented here in phab: T44356#439479 and T34906#381101
The patch in gerrit seems to be stuck based on resolution of caching issues. Note that caching is apparently currently broken in some cases if you use this API parameter as a logged-in user, so beware.

Resolving T44240: LanguageConverter should not inspect global state to determine the variant would make it easier to progress on this task, since then the API can have more direct control over the variant used (or at least better knowledge of how the variant is going to be determined).

This task has been assigned to the same task owner for more than two years. Resetting task assignee due to inactivity, to decrease task cookie-licking and to get a slightly more realistic overview of plans. Please feel free to assign this task to yourself again if you still realistically work or plan to work on this task - it would be welcome!

For tips how to manage individual work in Phabricator (noisy notifications, lists of task, etc.), see https://phabricator.wikimedia.org/T228575#6237124 for available options.
(For the records, two emails were sent to assignee addresses before resetting assignees. See T228575 for more info and for potential feedback. Thanks!)

Change 732908 had a related patch set uploaded (by Samwilson; author: Samwilson):

[mediawiki/core@master] Downgrade HTTP caching when language variant is in use

https://gerrit.wikimedia.org/r/732908

Daimona renamed this task from ApiParse: Do not generate warning on parameter `variant` to Do not generate warning on parameter `variant` for API requests.Nov 2 2021, 9:40 AM
Daimona updated the task description. (Show Details)
Daimona subscribed.

FTR, according to my results detailed in T294848 (in particular, see section "One final word"), it should be possible to officially add support for this parameter without fixing the caching bug first.

Tagging PET as code stewards for the API component. The question is: would you be fine with officially supporting the "variant" parameter in ApiMain? The caching bug mentioned above wouldn't be affected, so my question is more like "do we want such a feature, or should there be a better way to achieve the same goal?".

Change 736618 had a related patch set uploaded (by Samwilson; author: Samwilson):

[mediawiki/core@master] Expose existing 'variant' API parameter

https://gerrit.wikimedia.org/r/736618

If it's decided that it's the right approach, here's a patch for adding the variant param: r736618

Daimona raised the priority of this task from Low to Needs Triage.Nov 8 2021, 9:21 PM

Change 732908 abandoned by Samwilson:

[mediawiki/core@master] Downgrade HTTP caching when language variant is in use

Reason:

https://gerrit.wikimedia.org/r/732908

Notes from the Platform Engineering meeting yesterday:

Sam: Do not generate warning on parameter variant for API requests (T117549): https://gerrit.wikimedia.org/r/c/mediawiki/core/+/736618

  • Should it be supported for ALL modules?
    • Uselang is available everyhwere (for error messages), so variant should be as well
    • Several modules parse content.
  • Variant uses global state internally
  • No technical reason to not support it for all modules, parity with uselang

So we're good to proceed with the above patch.

Change 736618 merged by jenkins-bot:

[mediawiki/core@master] Expose existing 'variant' API parameter

https://gerrit.wikimedia.org/r/736618

Change 250686 abandoned by Fomafix:

[mediawiki/core@master] ApiMain: Support parameter variant

Reason:

Superseded by https://gerrit.wikimedia.org/r/c/mediawiki/core/+/736618 (Ib7347f7c6fbffd4c0cbb378a14a0166da6b3d39c) with the same solution as in PS5.

https://gerrit.wikimedia.org/r/250686

Fomafix assigned this task to Samwilson.
Fomafix removed a project: Patch-For-Review.

api.php?action=parse&variant=sr-el generates no warning anymore.