Changes

• RENAME main class MWClient --> MWSite
• REFACT:
  • SPLIT classes across HttpPipeline, HttpCall, HttpSession(handlers) & MwSite,
    so client operations can inspect and modify request & response with callbaks (handlers)
    (ala apache axis).
• UNIFY UNIFY HttpCall() + MWSite/apiCall() arg-parsing (uri, uriArgs, method, headers, body, hoptions)
  • MWSite.apiCall() accepts kv-pairs (see HttpCall.inputParser & HttpCall constructor).
  • Capitalize all props, rename Heaers-->Header.
• Refact DatumError --> MWError:
  • rename property Datum --> HttpCall.
  • store the hole call instead of just the response/request.
• ENH: Added User-Agent HTTP-header according to https://meta.wikimedia.org/wiki/User-Agent_policy
  _ Use GET for tokens, and pass most API params in the URI - keep the post only
  for password and tokens (by the API recomendation).

Status

• REQUIRES MATLAB >= R2016b(9.1.x) for string-vectors & proper HTTP support.
  (e.g. for cookies: https://www.mathworks.com/help/matlab/ref/matlab.net.http.cookieinfo-class.html).
• Features:
  • Allow bots to login.
  • run #ask semantic-queries.
  • Rudimentary error-handling.
  • Respects some of WP's UserAgent policies (Valid UserAgent, Easy to Debug).
  • Http machinery implemented as a pipeline of "handlers" (callbacks).
• Not tested for Matlab-9.4+ (R2018a or higher), where HTTP support
  for application/x-www-form-urlencoded were not fully there yet.
• Lightly tested only against MediaWiki-1.31.
• Read Contents for an overview of the library code.
• Read also the Changelog of the project.

Installation

• Download the archive,
• place all the mat-files of this project somewhere in your MATLAB's search-path,
• generate a bot-password with adequate permissions for your wiki, and
• try the sample code in the README.md and consult Contents.m.

• Download the archive,
• place all the mat-files of this project somewhere in your MATLAB's search-path,
• generate a bot-password with adequate permissions for your wiki, and
• try the sample code in the README.md.

• RENAME PROJECT: MatMWClient --> MatWiki
• REFACT:
  • Move HttpOptions from HttpSession-->MWClient.
  • Add utility factory methods to convert matlab builtin-types into HTTP-onjects.
  • User-friendlier client API.

Changes

• SUPPORT also MATLAB >= R2016b(9.1.x), instead of >= R2018a(9.4.x );
  managed to encode POST body-params without relying on QueryParam.
• FIX: do not ignore MWClient.DefaultApiParams, but add them into URI.
• fix: clean up cookies before MWClient.login(), so repeated calls possible.
• fix: do not override given HttpOptions in HttpSession constructor - now
  possible to debug http-requests and save their Payload in MwClient.History.
• enh: MWClient accepts HttpSession on construction.
• Chore & docs enhancements:
  • add MWClient.Version constant to discover project release on runtime.
  • add .gitignore and this changelog.
  • some function docs improved.