Renamed ProviderDataSource -> ProviderResource.

Author: Bilge

src/Porter/Collection/CountableProviderRecords.php

@@ -1,7 +1,7 @@
 <?php
 namespace ScriptFUSION\Porter\Collection;
 
-use ScriptFUSION\Porter\Provider\DataSource\ProviderDataSource;
+use ScriptFUSION\Porter\Provider\Resource\ProviderResource;
 
 class CountableProviderRecords extends ProviderRecords implements \Countable
 {
@@ -10,11 +10,11 @@ class CountableProviderRecords extends ProviderRecords implements \Countable
     /**
      * @param \Iterator $providerRecords
      * @param int $count
-     * @param ProviderDataSource $dataSource
+     * @param ProviderResource $resource
      */
-    public function __construct(\Iterator $providerRecords, $count, ProviderDataSource $dataSource)
+    public function __construct(\Iterator $providerRecords, $count, ProviderResource $resource)
     {
-        parent::__construct($providerRecords, $dataSource);
+        parent::__construct($providerRecords, $resource);
 
         $this->setCount($count);
     }

src/Porter/Collection/ProviderRecords.php

@@ -1,24 +1,24 @@
 <?php
 namespace ScriptFUSION\Porter\Collection;
 
-use ScriptFUSION\Porter\Provider\DataSource\ProviderDataSource;
+use ScriptFUSION\Porter\Provider\Resource\ProviderResource;
 
 class ProviderRecords extends RecordCollection
 {
-    private $dataSource;
+    private $resource;
 
-    public function __construct(\Iterator $providerRecords, ProviderDataSource $dataSource)
+    public function __construct(\Iterator $providerRecords, ProviderResource $resource)
     {
         parent::__construct($providerRecords);
 
-        $this->dataSource = $dataSource;
+        $this->resource = $resource;
     }
 
     /**
-     * @return ProviderDataSource
+     * @return ProviderResource
      */
-    public function getDataSource()
+    public function getResource()
     {
-        return $this->dataSource;
+        return $this->resource;
     }
 }

src/Porter/Porter.php

@@ -14,10 +14,10 @@
 use ScriptFUSION\Porter\Collection\ProviderRecords;
 use ScriptFUSION\Porter\Collection\RecordCollection;
 use ScriptFUSION\Porter\Mapper\PorterMapper;
-use ScriptFUSION\Porter\Provider\DataSource\ProviderDataSource;
 use ScriptFUSION\Porter\Provider\ObjectNotCreatedException;
 use ScriptFUSION\Porter\Provider\Provider;
 use ScriptFUSION\Porter\Provider\ProviderFactory;
+use ScriptFUSION\Porter\Provider\Resource\ProviderResource;
 use ScriptFUSION\Porter\Specification\ImportSpecification;
 
 class Porter
@@ -44,11 +44,11 @@ public function __construct()
      */
     public function import(ImportSpecification $specification)
     {
-        $records = $this->fetch($specification->getDataSource(), $specification->getCacheAdvice());
+        $records = $this->fetch($specification->getResource(), $specification->getCacheAdvice());
 
         if (!$records instanceof ProviderRecords) {
             // Wrap Iterator in ProviderRecords.
-            $records = new ProviderRecords($records, $specification->getDataSource());
+            $records = new ProviderRecords($records, $specification->getResource());
         }
 
         if ($specification->getFilter()) {
@@ -71,12 +71,12 @@ private function createPorterRecords(RecordCollection $records, ImportSpecificat
         return new PorterRecords($records, $specification);
     }
 
-    private function fetch(ProviderDataSource $dataSource, CacheAdvice $cacheAdvice = null)
+    private function fetch(ProviderResource $resource, CacheAdvice $cacheAdvice = null)
     {
-        $provider = $this->getProvider($dataSource->getProviderClassName(), $dataSource->getProviderTag());
+        $provider = $this->getProvider($resource->getProviderClassName(), $resource->getProviderTag());
         $this->applyCacheAdvice($provider, $cacheAdvice ?: $this->defaultCacheAdvice);
 
-        return $provider->fetch($dataSource);
+        return $provider->fetch($resource);
     }
 
     private function filter(ProviderRecords $records, callable $predicate, $context)

src/Porter/Provider/AbstractProvider.php

@@ -4,7 +4,7 @@
 use ScriptFUSION\Porter\Cache\CacheToggle;
 use ScriptFUSION\Porter\Cache\CacheUnavailableException;
 use ScriptFUSION\Porter\Connector\Connector;
-use ScriptFUSION\Porter\Provider\DataSource\ProviderDataSource;
+use ScriptFUSION\Porter\Provider\Resource\ProviderResource;
 
 abstract class AbstractProvider implements Provider, CacheToggle
 {
@@ -16,22 +16,22 @@ public function __construct(Connector $connector)
     }
 
     /**
-     * @param ProviderDataSource $dataSource
+     * @param ProviderResource $resource
      *
      * @return \Iterator
      *
-     * @throws ForeignDataSourceException A foreign data source was received.
+     * @throws ForeignResourceException A foreign resource was received.
      */
-    public function fetch(ProviderDataSource $dataSource)
+    public function fetch(ProviderResource $resource)
     {
-        if ($dataSource->getProviderClassName() !== static::class) {
-            throw new ForeignDataSourceException(sprintf(
+        if ($resource->getProviderClassName() !== static::class) {
+            throw new ForeignResourceException(sprintf(
                 'Cannot fetch data from foreign source: "%s".',
-                get_class($dataSource)
+                get_class($resource)
             ));
         }
 
-        return $dataSource->fetch($this->connector);
+        return $resource->fetch($this->connector);
     }
 
     /**

src/Porter/Provider/ForeignDataSourceException.php

@@ -0,0 +1,10 @@
+<?php
+namespace ScriptFUSION\Porter\Provider;
+
+/**
+ * The exception that is thrown when a foreign resource is received.
+ */
+class ForeignResourceException extends \RuntimeException
+{
+    // Intentionally empty.
+}

src/Porter/Provider/ForeignResourceException.php

@@ -1,19 +1,19 @@
 <?php
 namespace ScriptFUSION\Porter\Provider;
 
-use ScriptFUSION\Porter\Provider\DataSource\ProviderDataSource;
+use ScriptFUSION\Porter\Provider\Resource\ProviderResource;
 
 /**
- * Provides a method for fetching data from a data source.
+ * Provides a method for fetching data from a resource.
  */
 interface Provider
 {
     /**
-     * Fetches data from the specified data source.
+     * Fetches data from the specified resource.
      *
-     * @param ProviderDataSource $dataSource Data source.
+     * @param ProviderResource $resource Resource.
      *
      * @return \Iterator Enumerable data series.
      */
-    public function fetch(ProviderDataSource $dataSource);
+    public function fetch(ProviderResource $resource);
 }

src/Porter/Provider/Provider.php

@@ -1,7 +1,7 @@
 <?php
-namespace ScriptFUSION\Porter\Provider\DataSource;
+namespace ScriptFUSION\Porter\Provider\Resource;
 
-class NullDataSource extends StaticDataSource
+class NullResource extends StaticResource
 {
     public function __construct()
     {

…r/Provider/DataSource/NullDataSource.php …orter/Provider/Resource/NullResource.phpsrc/Porter/Provider/DataSource/NullDataSource.php renamed to src/Porter/Provider/Resource/NullResource.php src/Porter/Provider/DataSource/NullDataSource.php renamed to src/Porter/Provider/Resource/NullResource.php

@@ -1,15 +1,15 @@
 <?php
-namespace ScriptFUSION\Porter\Provider\DataSource;
+namespace ScriptFUSION\Porter\Provider\Resource;
 
 use ScriptFUSION\Porter\Connector\Connector;
 
 /**
- * Defines methods for fetching data from a specific provider data source.
+ * Defines methods for fetching data from a specific provider resource.
  */
-interface ProviderDataSource
+interface ProviderResource
 {
     /**
-     * Gets the class name of the provider this data source belongs to.
+     * Gets the class name of the provider this resource belongs to.
      *
      * @return string Provider class name.
      */

…ovider/DataSource/ProviderDataSource.php …r/Provider/Resource/ProviderResource.phpsrc/Porter/Provider/DataSource/ProviderDataSource.php renamed to src/Porter/Provider/Resource/ProviderResource.php src/Porter/Provider/DataSource/ProviderDataSource.php renamed to src/Porter/Provider/Resource/ProviderResource.php

@@ -1,11 +1,11 @@
 <?php
-namespace ScriptFUSION\Porter\Provider\DataSource;
+namespace ScriptFUSION\Porter\Provider\Resource;
 
 use ScriptFUSION\Porter\Connector\Connector;
 use ScriptFUSION\Porter\Options\EncapsulatedOptions;
 use ScriptFUSION\Porter\Provider\StaticDataProvider;
 
-class StaticDataSource implements ProviderDataSource
+class StaticResource implements ProviderResource
 {
     private $data;