Merge pull request #7 from va-fursenko/dev

Dev

src/Client/EntityClient.php

@@ -3,6 +3,9 @@
 namespace MoySklad\Client;
 
 use MoySklad\ApiClient;
+use MoySklad\Entity\Meta;
+use MoySklad\Http\RequestExecutor;
+use MoySklad\Util\Exception\ApiClientException;
 
 class EntityClient
 {
@@ -144,11 +147,6 @@ public function group(): GroupClient
         return new GroupClient($this->api);
     }
 
-    public function image(): ImageClient
-    {
-        return new ImageClient($this->api);
-    }
-
     /**
      * @return OrganizationClient
      */
@@ -276,4 +274,16 @@ public function getEntityByClass(string $class): string
         $class = explode('\\', $class);
         return array_pop($class);
     }
+
+    /**
+     * Получение модели по её мета-данным
+     *
+     * @param Meta $meta
+     * @return object
+     * @throws ApiClientException
+     */
+    public function getByMeta(Meta $meta): object
+    {
+        return RequestExecutor::path($this->api, $meta->href)->get($meta->getClassName());
+    }
 }

src/Client/StockClient.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace MoySklad\Client;
+
+use MoySklad\ApiClient;
+use MoySklad\Client\Endpoint\GetEntitiesListEndpoint;
+use MoySklad\Client\Endpoint\GetEntityEndpoint;
+use MoySklad\Client\Endpoint\GetMetadataAttributeEndpoint;
+use MoySklad\Client\Endpoint\GetMetadataEndpoint;
+use MoySklad\Entity\Stock;
+
+/**
+ * Class StockClient
+ * @package MoySklad\Client
+ *
+ * Клиент работы с отчётом остатков
+ *
+ * @copyright CDEK.MARKET, Ltd. (ООО «СДЭК.МАРКЕТ» http://cdek.market)
+ * @project ms-lib
+ * @date 20.05.2020 14:23
+ * @author Viktor.Fursenko
+ */
+class StockClient extends EntityClientBase
+{
+    use GetEntitiesListEndpoint,
+        GetMetadataEndpoint,
+        GetMetadataAttributeEndpoint,
+        GetEntityEndpoint;
+
+    /**
+     * ServiceClient constructor.
+     * @param ApiClient $api
+     */
+    public function __construct(ApiClient $api)
+    {
+        parent::__construct($api, '/report/stock/all');
+    }
+
+    /**
+     * @return string
+     */
+    protected function getMetaEntityClass(): string
+    {
+        return Stock::class;
+    }
+}

src/Entity/Characteristic.php

@@ -28,4 +28,12 @@ class Characteristic
      * @Generator()
      */
     public $value;
+
+    /**
+     * @return Meta|null
+     */
+    public function getMeta(): ?Meta
+    {
+        return $this->meta;
+    }
 }

src/Entity/Meta.php

@@ -119,4 +119,23 @@ public static function getClassNameByType(string $type): string
 
         return self::TYPES[$type];
     }
+
+    /**
+     * @return string
+     */
+    public function getClassName(): string
+    {
+        return static::getClassNameByType($this->type);
+    }
+
+    /**
+     * id не всегда передаётся в объекты, зато всегда есть в ссылке на объект в мета-данных
+     *
+     * @return string
+     */
+    public function getId() : string
+    {
+        $href = explode('/', $this->href);
+        return end($href);
+    }
 }

src/Entity/StockTrait.php

@@ -10,8 +10,8 @@
  * @package MoySklad\Entity
  *
  * Трейт сущностей, которые хранятся на складе - товары и варианты
- * Данные поля по большей части используются только в отчёте остатков. Но поскольку у нас формат респонса типизованный
- * и вендор задал тип Product или Variant, то придётся добавить в них все когда-либо использованные поля
+ * Данные поля по большей части используются только в отчёте остатков и ассортименте, но отсутствуют в списке товаров
+ * Но поскольку у нас формат респонса типизованный и вендор задал тип Product или Variant, то придётся добавить в них все когда-либо использованные поля
  *
  * При этом, на них нельзя повесить генераторы для тестов, потому что тогда упадут тесты создания базовых сущностей
  * А уж как тогда тестировать отчёты... разве что только руками