Add methods for getting task lists

Added suport for retrieving lending requests and requested resources
(pick from shelf). No API for borrowing requests is currently available.

Author: danmichaelo

CHANGELOG.md

@@ -6,7 +6,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
-(none yet)
+- Added methods for retrieving task lists (lending requests and requested resources).
 
 ## [0.7.0] - 2018-09-02
 

README.md

@@ -430,6 +430,34 @@ convert a filter to SQL. The results looks like this:
 But used with the API, the response is the same as if you forget to include an
 "is prompted" filter: a loong wait follow by a "400 No more rows to fetch".
 
+## Task lists
+
+### Lending requests
+
+````php
+$library = $alma->conf->libraries['LIBRARY_CODE'];
+$requests = $alma->taskLists->getLendingRequests($library, [
+    'printed' => 'N',
+    'status' => 'REQUEST_CREATED_LEND',
+]);
+foreach ($requests as $request) {
+    echo "- {$request->request_id} {$request->status}\n";
+}
+````
+
+Note: As of 2018-10-13, there is a bug preventing you from retrieving more than 100 lending requests.
+
+### Requested resources (pick from shelf)
+
+````php
+$library = $alma->conf->libraries['LIBRARY_CODE'];
+$requests = $alma->taskLists->getRequestedResources($library, 'DEFAULT_CIRC_DESK', [
+    'printed' => 'N',
+]);
+foreach ($requests as $request) {
+    echo "- {$request->resource_metadata->title} {$request->resource_metadata->mms_id->value}\n";
+}
+````
 
 ## Laravel 5 integration
 

spec/TaskLists/LendingRequestsSpec.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace spec\Scriptotek\Alma\TaskLists;
+
+use Scriptotek\Alma\Client as AlmaClient;
+use Scriptotek\Alma\Conf\Library;
+use PhpSpec\ObjectBehavior;
+use Scriptotek\Alma\TaskLists\ResourceSharingRequest;
+use spec\Scriptotek\Alma\SpecHelper;
+
+class LendingRequestsSpec extends ObjectBehavior
+{
+    function it_provides_filtering_options(AlmaClient $client, Library $library)
+    {
+        $library->code = 'SOME_LIBRARY';
+        $this->beConstructedWith($client, $library, [
+            'printed' => 'N',
+            'status' => 'REQUEST_CREATED_LEND',
+        ]);
+
+        $client->getJSON('/task-lists/rs/lending-requests?printed=N&status=REQUEST_CREATED_LEND&library=SOME_LIBRARY')
+            ->shouldBeCalled()
+            ->willReturn(SpecHelper::getDummyData('lending_requests_created.json'));
+
+        $result = $this->all();
+        $result->shouldBeArray();
+        $result->shouldHaveCount(3);
+        $result[0]->shouldBeAnInstanceOf(ResourceSharingRequest::class);
+    }
+}

spec/TaskLists/RequestedResourceSpec.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace spec\Scriptotek\Alma\TaskLists;
+
+use Scriptotek\Alma\Bibs\Bib;
+use Scriptotek\Alma\Client as AlmaClient;
+use Scriptotek\Alma\Conf\Library;
+use Scriptotek\Alma\TaskLists\RequestedResource;
+use PhpSpec\ObjectBehavior;
+use Prophecy\Argument;
+
+
+class RequestedResourceSpec extends ObjectBehavior
+{
+    public function let(AlmaClient $client, Library $library, Bib $bib)
+    {
+        $this->beConstructedWith($client, $library, 'SUPER_DESK', $bib);
+    }
+
+    function it_is_initializable()
+    {
+        $this->shouldHaveType(RequestedResource::class);
+    }
+}

spec/TaskLists/RequestedResourcesSpec.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace spec\Scriptotek\Alma\TaskLists;
+
+use Scriptotek\Alma\Bibs\Bib;
+use Scriptotek\Alma\Bibs\Bibs;
+use Scriptotek\Alma\Client as AlmaClient;
+use Scriptotek\Alma\Conf\Library;
+use Scriptotek\Alma\TaskLists\RequestedResource;
+use PhpSpec\ObjectBehavior;
+use Prophecy\Argument;
+use spec\Scriptotek\Alma\SpecHelper;
+
+class RequestedResourcesSpec extends ObjectBehavior
+{
+    function it_provides_filtering_options(AlmaClient $client, Library $library, Bibs $bibs, Bib $bib)
+    {
+        $library->code = 'SOME_LIBRARY';
+        $this->beConstructedWith($client, $library, 'DEFAULT_CIRC_DESK', [
+            'printed' => 'N',
+        ]);
+
+        $client->bibs = $bibs;
+        $bibs->get('991120800814702204')
+            ->shouldBeCalled()
+            ->willReturn($bib);
+
+        $client->getJSON('/task-lists/requested-resources?printed=N&library=SOME_LIBRARY&circ_desk=DEFAULT_CIRC_DESK&offset=0&limit=10')
+            ->shouldBeCalled()
+            ->willReturn(SpecHelper::getDummyData('requested-resources_response.json'));
+
+        $result = $this->all();
+
+        $result->shouldBeArray();
+        $result->shouldHaveCount(1);
+        $result[0]->shouldBeAnInstanceOf(RequestedResource::class);
+    }
+}

spec/TaskLists/ResourceSharingRequestSpec.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace spec\Scriptotek\Alma\TaskLists;
+
+use Scriptotek\Alma\Client as AlmaClient;
+use Scriptotek\Alma\Conf\Library;
+use Scriptotek\Alma\TaskLists\LendingRequests;
+use Scriptotek\Alma\TaskLists\LendingRequest;
+use PhpSpec\ObjectBehavior;
+use spec\Scriptotek\Alma\SpecHelper;
+
+class ResourceSharingRequestSpec extends ObjectBehavior
+{
+    public function let(AlmaClient $client)
+    {
+        $id = '123';
+        $this->beConstructedWith($client, $id);
+    }
+}