acromedia/mock-totara

An application pretending to be Totara

dev-master 2020-04-02 20:48 UTC

This package is not auto-updated.

Last update: 2024-04-11 00:00:41 UTC


README

This application pretends that it's a Moodle site's API and remembers some state so it can assert things like you can't add someone to a group that hasn't been added to a course.

Install the Application

Use composer to install dependencies.

$ composer install

Usage

Point a web server at index.php or use the php built-in server.

$ composer start
> php -S localhost:8080 -t public

Send requests to /api?wsfunction=foo where foo is the name of the Moodle web service.

POST localhost:8080/api?wsfunction=core_users_create_user

... Some request to create a user.

Responses will be a standard response for that web service.

{
  "id": 1234,
  "some other stuff": "huzzah!"
}

Or an error!

{
  "exception": "invalid parameter exception",
  "message": "Invalid parameter value detected.",
  "errorcode": "invalidparameter",
  // Moodle doesn't like to explain its errors but that doesn't mean we can't.
  "debuginfo": [
    "User 123 must first be enrolled in course 456."
  ]
}

State of the application is saved between requests. Set the path to a file where the state will be stored in settings.php.

'state' => [
    // State is saved here between requests.
    'path' => '../state.json',
],

To reset the state, make a DELETE request to /api/state or use composer reset-state

$ composer reset-state
> curl -s localhost:8080/api/state --header "Accept: application/json"  --header "Content-Type: application/JSON" --request DELETE