Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

MediaWiki API overhaul #83

Open
cyberpower678 opened this issue Jul 29, 2014 · 0 comments
Open

MediaWiki API overhaul #83

cyberpower678 opened this issue Jul 29, 2014 · 0 comments

Comments

@cyberpower678
Copy link
Contributor

The Media Wiki API is going to be overhauled. This means radical changes that we need to apply to Peachy to keep Peachy bots running. Since this change is radical, we need to ensure that backwards compatibility is maintained for some time while other wikis run the current APIs. I have listed the things that may be changed that will affect Peachy. Please add on to this list if more comes out.

Things that are being changed:

  1. Anything using '' as a key will be renamed to something more natural. In some cases this may result in something like "query.page[1].foo['']" becoming simply "query.page[1].foo", and in others something like "query.page[1].foo.content".
  2. Boolean result properties will use boolean true as the value, rather than the empty string. Whether a property will be present with a boolean false value or will continue to be entirely absent from the result when false will be determined on a case-by-case basis.
  3. Page lists will be returned as arrays rather than objects with page_ids as keys. This will make it easier for clients to iterate over the results.
  4. Internationalizing API warnings and errors where error-language=none will need to be added to all API queries.
  5. Token handling: we will likely deprecate the get_tokens function and maintain it for backwards compatibility. The new meta=tokens will allow us to have Peachy retrieve fresh tokens in the same query as page content is retrieved.
  6. Removal of long-deprecated parameters. Most have already updated, but a double check may need to be required.
  7. Simplified continuation as default for action=query will likely affect list handler
  8. Simplified continuation should indicate "pause points" may improve list handling.
  9. Rewrite prop=imageinfo from scratch as prop=fileinfo. This will also likely lead to deprecating the Image and writing a brand new File class, which can better handle non-images.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants