Map factory documentation description

Author: sokolovsky

Diff for: README.md

@@ -832,12 +832,14 @@ CollectionFactory::numbers(10)
 ```
 
 #### Collection creation factory methods
-- [*from* – Generating a collection from an array of elements](#from---generating-a-collection-from-an-array-of-elements)
-- [*fromIterable* – Generating a collection using any iterable](#fromiterable---generating-a-collection-using-any-iterable)
-- [*numbers* – Generating a collection of a sequence of integers](#numbers---generating-a-collection-of-a-sequence-of-integers)
-- [*generate* – Generating a collection using a generator](#generate---generating-a-collection-using-a-generator)
-
-#### from - Generating a collection from an array of elements
+- [*CollectionFactory::from* – Generating a collection from an array of elements](#CollectionFactory--from---generating-a-collection-from-an-array-of-elements)
+- [*CollectionFactory::fromIterable* – Generating a collection using any iterable](#CollectionFactory--fromiterable---generating-a-collection-using-any-iterable)
+- [*CollectionFactory::numbers* – Generating a collection of a sequence of integers](#CollectionFactory--numbers---generating-a-collection-of-a-sequence-of-integers)
+- [*CollectionFactory::generate* – Generating a collection using a generator](#CollectionFactory--generate---generating-a-collection-using-a-generator)
+- [*MapFactory::fromIterable* – Map generation from any iterated value](#MapFactory--fromIterable---генерирование-карты-при-помощи-любого-итерируемого-значения)
+- [*MapFactory::assoc* – Map generation from associative array](#MapFactory--assoc---Map-generation-from-associative-array)
+
+#### _CollectionFactory::from_ - Generating a collection from an array of elements
 [[↑ Collection factory]](#collection-factory)
 ```
 from($values: array): Collection
@@ -856,7 +858,7 @@ CollectionFactory::from([1 ,2, 3])
 
 ```
 
-#### fromIterable - Generating a collection using any iterable
+#### _CollectionFactory::fromIterable_ - Generating a collection using any iterable
 [[↑ Collection factory]](#collection-factory)
 ```
 fromIterable($iterable: iterable): Collection
@@ -876,7 +878,7 @@ CollectionFactory::fromIterable(new DirectoryIterator(__DIR__))
     ->each(Consumers::dump()); // Dumps strings with filenames
 ```
 
-#### numbers - Generating a collection of a sequence of integers
+#### __CollectionFactory::numbers_ - Generating a collection of a sequence of integers
 [[↑ Collection factory]](#collection-factory)
 ```
 numbers($from: int, $to: ?int): Collection
@@ -895,7 +897,7 @@ CollectionFactory::numbers(10, 15)
     ->each(Consumers::dump()); // Dumps  [10, 11, 12, 13, 14, 15]
 ```
 
-#### generate - Generating a collection using a generator
+#### _CollectionFactory::generate_ - Generating a collection using a generator
 [[↑ Collection factory]](#collection-factory) 
 ```
 generate($times: int, $generator: ?callable): Collection
@@ -917,6 +919,42 @@ CollectionFactory::generate(3, static function () {
     ->each(Consumers::dump()); // Dumps for example [9, 7, 2]
 ```
 
+#### _MapFactory::fromIterable_ - Map generating from any iterated value
+[[↑ Collection factory]](#collection-factory)
+```
+MapFactory::fromIterable($iterable: iterable): Map
+```
+
+Method created map object from any iterated object.
+
+```php
+
+use WS\Utils\Collections\MapFactory;
+
+MapFactory::fromIterable(['a' => 1, 'b' => 2])
+    ->keys() // ['a', 'b']
+;
+
+```
+
+#### _MapFactory::assoc_ - Map generating from associative array
+[[↑ Collection factory]](#collection-factory)
+```
+MapFactory::assoc(array $assocArray): Map
+```
+
+Method creates map object from associative array.
+
+```php
+
+use WS\Utils\Collections\MapFactory;
+
+MapFactory::assoc(['a' => 1, 'b' => 2])
+    ->keys() // ['a', 'b']
+;
+
+```
+
 ## Collection streams
 [[↑ Up]](#php-collections)
 

Diff for: doc/README.ru.md

@@ -816,7 +816,8 @@ foreach($map as $key => $value) {
 ## Фабрика создания коллекции
 [[↑ В начало]](#PHP-Коллекции)
 
-Фабрика ```CollectionFactory``` позволяет создавать объекты коллекций без использования конструктора конкретной реализации, а так же обладает другими удобными методами создания объектов коллекций. На данный момент, основной структурой библиотеки является ```ArrayList```, который и порождается фабрикой в статических методах.
+Фабрики ```CollectionFactory/MapFactory``` позволяют создавать объекты коллекций без использования конструктора конкретной реализации, а так же обладает другими удобными методами создания объектов коллекций. 
+На данный момент основной структурой библиотеки являются ```ArrayList, HashMap, HashSet```, которые и порождается фабрикой в статических методах.
 
 ### Пример использования фабрики
 
@@ -831,12 +832,14 @@ CollectionFactory::numbers(10)
 
 ```
 #### Методы фабрики создания коллекции
-- [*from* – Генерирование коллекции из массива элементов](#from---генерирование-коллекции-из-массива-элементов)
-- [*fromIterable* – Генерирование коллекции при помощи любой итерируемой величины](#fromIterable---генерирование-коллекции-при-помощи-любой-итерируемой-величины)
-- [*numbers* – Генерирование коллекции состоящей из элементов последовательности целых чисел](#numbers---генерирование-коллекции-состоящей-из-элементов-последовательности-целых-чисел)
-- [*generate* – Генерирование коллекции при помощи генератора](#generate---генерирование-коллекции-при-помощи-генератора)
-
-#### _from_ - Генерирование коллекции из массива элементов
+- [*CollectionFactory::from* – Генерирование коллекции из массива элементов](#CollectionFactory--from---генерирование-коллекции-из-массива-элементов)
+- [*CollectionFactory::fromIterable* – Генерирование коллекции при помощи любой итерируемой величины](#CollectionFactory--fromIterable---генерирование-коллекции-при-помощи-любой-итерируемой-величины)
+- [*CollectionFactory::numbers* – Генерирование коллекции состоящей из элементов последовательности целых чисел](#CollectionFactory--numbers---генерирование-коллекции-состоящей-из-элементов-последовательности-целых-чисел)
+- [*CollectionFactory::generate* – Генерирование коллекции при помощи генератора](#CollectionFactory--generate---генерирование-коллекции-при-помощи-генератора)
+- [*MapFactory::fromIterable* – Генерирование карты при помощи любого итерируемого значения](#MapFactory--fromIterable---генерирование-карты-при-помощи-любого-итерируемого-значения)
+- [*MapFactory::assoc* – Генерирование карты из ассоциативного массива](#MapFactory--assoc---Генерирование-карты-при-помощи-ассоциативного-массива)
+
+#### _CollectionFactory::from_ - Генерирование коллекции из массива элементов
 [[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
 ```
 from($values: array): Collection
@@ -855,7 +858,7 @@ CollectionFactory::from([1 ,2, 3])
 
 ```
 
-#### _fromIterable_ - Генерирование коллекции при помощи любой итерируемой величины
+#### _CollectionFactory::fromIterable_ - Генерирование коллекции при помощи любой итерируемой величины
 [[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
 ```
 fromIterable($iterable: iterable): Collection
@@ -875,7 +878,7 @@ CollectionFactory::fromIterable(new DirectoryIterator(__DIR__))
     ->each(Consumers::dump()); // Dumps strings with filenames
 ```
 
-#### _numbers_ - Генерирование коллекции состоящей из элементов последовательности целых чисел
+#### _CollectionFactory::numbers_ - Генерирование коллекции состоящей из элементов последовательности целых чисел
 [[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
 ```
 numbers($from: int, $to: ?int): Collection
@@ -893,7 +896,7 @@ CollectionFactory::numbers(10, 15)
     ->each(Consumers::dump()); // Dumps  [10, 11, 12, 13, 14, 15]
 ```
 
-#### _generate_ - Генерирование коллекции при помощи генератора
+#### _CollectionFactory::generate_ - Генерирование коллекции при помощи генератора
 [[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
 ```
 generate($times: int, $generator: ?callable): Collection
@@ -914,6 +917,42 @@ CollectionFactory::generate(3, static function () {
     ->each(Consumers::dump()); // Dumps for example [9, 7, 2]
 ```
 
+#### _MapFactory::fromIterable_ - Генерирование карты при помощи любого итерируемого значения
+[[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
+```
+MapFactory::fromIterable($iterable: iterable): Map
+```
+
+Метод создает объект карты из любого итерируемого объекта.
+
+```php
+
+use WS\Utils\Collections\MapFactory;
+
+MapFactory::fromIterable(['a' => 1, 'b' => 2])
+    ->keys() // ['a', 'b']
+;
+
+```
+
+#### _MapFactory::assoc_ - Генерирование карты при помощи ассоциативного массива
+[[↑ Фабрика создания коллекции]](#Фабрика-создания-коллекции)
+```
+MapFactory::assoc(array $assocArray): Map
+```
+
+Метод создает объект карты из ассоциативного массива.
+
+```php
+
+use WS\Utils\Collections\MapFactory;
+
+MapFactory::assoc(['a' => 1, 'b' => 2])
+    ->keys() // ['a', 'b']
+;
+
+```
+
 ## Потоки обхода коллекций
 [[↑ В начало]](#PHP-Коллекции)