Installation

composer require macfja/book-retriever

Usage

Simple provider

$htmlGetter =new \MacFJA\BookRetriever\Helper\HtmlGetter();$isbnTool =new \Isbn\Isbn();$antoineOnline =new \MacFJA\BookRetriever\Provider\AntoineOnline($htmlGetter,$isbnTool);$books =$antoineOnline->searchIsbn('9782253006329');// $books contains a list of \MacFJA\BookRetriever\SearchResultInterface

Configurable provider

$providerConfiguration =...;// A class that implement \MacFJA\BookRetriever\ProviderConfigurationInterface$configurator =new \MacFJA\BookRetriever\ProviderConfigurator($providerConfiguration);$amazon =new \MacFJA\BookRetriever\Provider\Amazon();$configurator->configure($amazon);$books =$amazon->searchIsbn('9782253006329');// $books contains a list of \MacFJA\BookRetriever\SearchResultInterface

Multiple providers

$providerConfiguration =...;// A class that implement \MacFJA\BookRetriever\ProviderConfigurationInterface$configurator =new \MacFJA\BookRetriever\ProviderConfigurator($providerConfiguration);$htmlGetter =new \MacFJA\BookRetriever\Helper\HtmlGetter();$isbn =new \Isbn\Isbn();$opds =new \MacFJA\BookRetriever\Helper\OPDSParser();$sru =new \MacFJA\BookRetriever\Helper\SRUParser();$providers = [new \MacFJA\BookRetriever\Provider\AbeBooks($htmlGetter),new \MacFJA\BookRetriever\Provider\Amazon(),new \MacFJA\BookRetriever\Provider\AntoineOnline($htmlGetter,$isbn),new \MacFJA\BookRetriever\Provider\ArchiveOrg($opds),new \MacFJA\BookRetriever\Provider\LibraryHub($sru),new \MacFJA\BookRetriever\Provider\DigitEyes(),new \MacFJA\BookRetriever\Provider\Ebay()];array_walk($providers, [$configurator,'configure']);$pool =new \MacFJA\BookRetriever\Pool($providers,$providerConfiguration);$books =$pool->searchIsbn('9782253006329');// $books contains a list of \MacFJA\BookRetriever\SearchResultInterface

With Symfony (and Doctrine)

services:_instanceof:# services whose classes are instances of ProviderInterface will be tagged automaticallyMacFJA\BookRetriever\ProviderInterface:tags:['app.provider']MacFJA\BookRetriever\:resource:'../vendor/macfja/book-retriever/lib/'MacFJA\BookRetriever\Pool:arguments:$providers:!tagged_iterator app.providerMacFJA\BookRetriever\ProviderConfigurationInterface:'@App\Repository\ProviderConfigurationRepository'

<?phpnamespaceApp\Entity;useDoctrine\ORM\MappingasORM;/** @ORM\Entity(repositoryClass="App\Repository\ProviderConfigurationRepository") */class ProviderConfiguration{/**     * @ORM\Id()     * @ORM\GeneratedValue()     * @ORM\Column(type="integer")     */private$id;/** @ORM\Column(type="string", length=50) */private$provider;/** @ORM\Column(type="boolean") */private$active;/** @ORM\Column(type="json") */private$parameters = [];// All Getters/Setters// Removed in this example for readability}

<?phpnamespaceApp\Repository;useApp\Entity\ProviderConfiguration;useDoctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;useDoctrine\Common\Persistence\ManagerRegistry;useMacFJA\BookRetriever\ProviderConfigurationInterface;useMacFJA\BookRetriever\ProviderInterface;class ProviderConfigurationRepositoryextends ServiceEntityRepositoryimplements ProviderConfigurationInterface{publicfunction__construct(ManagerRegistry$registry)    {parent::__construct($registry, ProviderConfiguration::class);    }publicfunctiongetParameters(ProviderInterface$provider):array    {$configuration =$this->findOneBy(['provider' =>$provider->getCode()]);return$configuration !==null ?$configuration->getParameters() : [];    }publicfunctionisActive(ProviderInterface$provider):bool    {$configuration =$this->findOneBy(['provider' =>$provider->getCode()]);// not active by defaultreturn$configuration !==null ?$configuration->getActive() :false;    }}

<?phpnamespaceApp\Controller;useMacFJA\BookRetriever\Pool;useSymfony\Bundle\FrameworkBundle\Controller\AbstractController;useSymfony\Component\HttpFoundation\JsonResponse;useSymfony\Component\Routing\Annotation\Route;class SomeControllerextends AbstractController{/** @Route("/test") */publicfunctionindex(Pool$pool)    {returnnewJsonResponse($pool->searchIsbn('9782253006329'));    }}

Providers

Contributing

Local installation

make install# Install project vendormake all# Run QA tools + tests suites + generate docs

Validate your code

make analyze# Run QA tools + tests suites

make analyze-tests# Run QA tools on tests suites

License