init

vendor/yiisoft/yii2-faker/CHANGELOG.md

@@ -0,0 +1,47 @@
+Yii Framework 2 faker extension Change Log
+==============================================
+
+2.0.4 February 19, 2018
+-----------------------
+
+- Bug #29: Fixed `FixtureController::findTemplatesFiles()` trim `$templatePath` from `$fileName` correctly via `DIRECTORY_SEPARATOR` (ofixone)
+- Enh #22: Made `FixtureController` private methods protected for better class extensibility (samdark)
+- Enh #24: Added support for fixture templates in subdirectories (d1rtyf1ng3rs)
+- Enh #28: `FixtureController::generateFixtureFile()` now uses `$templateName` to index fixtures for easier debug (drsdre)
+- Chg: Switched to asset-packagist
+
+
+2.0.3 March 01, 2015
+--------------------
+
+- no changes in this release.
+
+
+2.0.2 January 11, 2015
+----------------------
+
+- no changes in this release.
+
+
+2.0.1 December 07, 2014
+-----------------------
+
+- no changes in this release.
+
+
+2.0.0 October 12, 2014
+----------------------
+
+- no changes in this release.
+
+
+2.0.0-rc September 27, 2014
+---------------------------
+
+- Chg #4622: Simplified the way of creating a Faker fixture template file (qiangxue)
+
+
+2.0.0-beta April 13, 2014
+-------------------------
+
+- Initial release.

vendor/yiisoft/yii2-faker/FixtureController.php

@@ -0,0 +1,493 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\faker;
+
+use Yii;
+use yii\console\Exception;
+use yii\helpers\Console;
+use yii\helpers\FileHelper;
+use yii\helpers\VarDumper;
+
+/**
+ * This command creates fixtures based on a given template.
+ *
+ * Fixtures are one of the important paths in unit testing. To speed up developers
+ * work these fixtures can be generated automatically, based on prepared template.
+ * This command is a simple wrapper for the [Faker](https://github.com/fzaninotto/Faker) library.
+ *
+ * You should configure your application as follows (you can use any alias, not only "fixture"):
+ *
+ * ~~~
+ * 'controllerMap' => [
+ *     'fixture' => [
+ *         'class' => 'yii\faker\FixtureController',
+ *     ],
+ * ],
+ * ~~~
+ *
+ * To start using the command you need to be familiar (read guide) with the Faker library and
+ * generate fixtures template files, according to the given format:
+ *
+ * ```php
+ * // users.php file under template path (by default @tests/unit/templates/fixtures)
+ * return [
+ *     'name' => $faker->firstName,
+ *     'phone' => $faker->phoneNumber,
+ *     'city' => $faker->city,
+ *     'password' => Yii::$app->getSecurity()->generatePasswordHash('password_' . $index),
+ *     'auth_key' => Yii::$app->getSecurity()->generateRandomString(),
+ *     'intro' => $faker->sentence(7, true),  // generate a sentence with 7 words
+ * ];
+ * ```
+ *
+ * If you use callback as an attribute value it will be called with the following three parameters:
+ *
+ * - `$faker`: the Faker generator instance
+ * - `$index`: the current fixture index. For example if user need to generate 3 fixtures for user table, it will be 0..2.
+ *
+ * After you set all needed fields in callback, you need to return $fixture array back from the callback.
+ *
+ * After you prepared needed templates for tables you can simply generate your fixtures via command
+ *
+ * ~~~
+ * yii fixture/generate user
+ *
+ * //generate fixtures from several templates, for example:
+ * yii fixture/generate user profile team
+ * ~~~
+ *
+ * In the code above "users" is template name, after this command run, new file named same as template
+ * will be created under the `$fixtureDataPath` folder.
+ * You can generate fixtures for all templates, for example:
+ *
+ * ~~~
+ * yii fixture/generate-all
+ * ~~~
+ *
+ * This command will generate fixtures for all template files that are stored under $templatePath and
+ * store fixtures under `$fixtureDataPath` with file names same as templates names.
+ *
+ * You can specify how many fixtures per file you need by the second parameter. In the code below we generate
+ * all fixtures and in each file there will be 3 rows (fixtures).
+ *
+ * ~~~
+ * yii fixture/generate-all --count=3
+ * ~~~
+ *
+ * You can specify different options of this command:
+ *
+ * ~~~
+ * //generate fixtures in russian language
+ * yii fixture/generate user --count=5 --language=ru_RU
+ *
+ * //read templates from the other path
+ * yii fixture/generate-all --templatePath=@app/path/to/my/custom/templates
+ *
+ * //generate fixtures into other folders
+ * yii fixture/generate-all --fixtureDataPath=@tests/unit/fixtures/subfolder1/subfolder2/subfolder3
+ * ~~~
+ *
+ * You can see all available templates by running command:
+ *
+ * ~~~
+ * //list all templates under default template path (i.e. '@tests/unit/templates/fixtures')
+ * yii fixture/templates
+ *
+ * //list all templates under specified template path
+ * yii fixture/templates --templatePath='@app/path/to/my/custom/templates'
+ * ~~~
+ *
+ * You also can create your own data providers for custom tables fields, see Faker library guide for more info (https://github.com/fzaninotto/Faker);
+ * After you created custom provider, for example:
+ *
+ * ~~~
+ * class Book extends \Faker\Provider\Base
+ * {
+ *
+ *     public function title($nbWords = 5)
+ *     {
+ *         $sentence = $this->generator->sentence($nbWords);
+ *         return mb_substr($sentence, 0, mb_strlen($sentence) - 1);
+ *     }
+ *
+ * }
+ * ~~~
+ *
+ * you can use it by adding it to the $providers property of the current command. In your console.php config:
+ *
+ * ~~~
+ *    'controllerMap' => [
+ *        'fixture' => [
+ *            'class' => 'yii\faker\FixtureController',
+ *            'providers' => [
+ *                'app\tests\unit\faker\providers\Book',
+ *            ],
+ *        ],
+ *    ],
+ * ~~~
+ *
+ * @property \Faker\Generator $generator This property is read-only.
+ *
+ * @author Mark Jebri <mark.github@yandex.ru>
+ * @since 2.0.0
+ */
+class FixtureController extends \yii\console\controllers\FixtureController
+{
+    /**
+     * @var string Alias to the template path, where all tables templates are stored.
+     */
+    public $templatePath = '@tests/unit/templates/fixtures';
+    /**
+     * @var string Alias to the fixture data path, where data files should be written.
+     */
+    public $fixtureDataPath = '@tests/unit/fixtures/data';
+    /**
+     * @var string Language to use when generating fixtures data.
+     */
+    public $language;
+    /**
+     * @var integer total count of data per fixture. Defaults to 2.
+     */
+    public $count = 2;
+    /**
+     * @var array Additional data providers that can be created by user and will be added to the Faker generator.
+     * More info in [Faker](https://github.com/fzaninotto/Faker.) library docs.
+     */
+    public $providers = [];
+
+    /**
+     * @var \Faker\Generator Faker generator instance
+     */
+    private $_generator;
+
+
+    /**
+     * @inheritdoc
+     */
+    public function options($actionID)
+    {
+        return array_merge(parent::options($actionID), [
+            'templatePath', 'language', 'fixtureDataPath', 'count'
+        ]);
+    }
+    
+    /**
+     * @inheritdoc
+     */
+    public function beforeAction($action)
+    {
+        if (parent::beforeAction($action)) {
+            $this->checkPaths();
+            $this->addProviders();
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * Lists all available fixtures template files.
+     */
+    public function actionTemplates()
+    {
+        $foundTemplates = $this->findTemplatesFiles();
+
+        if (!$foundTemplates) {
+            $this->notifyNoTemplatesFound();
+        } else {
+            $this->notifyTemplatesCanBeGenerated($foundTemplates);
+        }
+    }
+
+    /**
+     * Generates fixtures and fill them with Faker data.
+     * For example,
+     *
+     * ~~~
+     * //generate fixtures in russian language
+     * yii fixture/generate user --count=5 --language=ru_RU
+     *
+     * //generate several fixtures
+     * yii fixture/generate user profile team
+     * ~~~
+     *
+     * @throws \yii\base\InvalidParamException
+     * @throws \yii\console\Exception
+     */
+    public function actionGenerate()
+    {
+        $templatesInput = func_get_args();
+
+        if (empty($templatesInput)) {
+            throw new Exception('You should specify input fixtures template files');
+        }
+
+        $foundTemplates = $this->findTemplatesFiles($templatesInput);
+
+        $notFoundTemplates = array_diff($templatesInput, $foundTemplates);
+
+        if ($notFoundTemplates) {
+            $this->notifyNotFoundTemplates($notFoundTemplates);
+        }
+
+        if (!$foundTemplates) {
+            $this->notifyNoTemplatesFound();
+            return static::EXIT_CODE_NORMAL;
+        }
+
+        if (!$this->confirmGeneration($foundTemplates)) {
+            return static::EXIT_CODE_NORMAL;
+        }
+
+        $templatePath = Yii::getAlias($this->templatePath);
+        $fixtureDataPath = Yii::getAlias($this->fixtureDataPath);
+
+        FileHelper::createDirectory($fixtureDataPath);
+
+        $generatedTemplates = [];
+
+        foreach ($foundTemplates as $templateName) {
+            $this->generateFixtureFile($templateName, $templatePath, $fixtureDataPath);
+            $generatedTemplates[] = $templateName;
+        }
+
+        $this->notifyTemplatesGenerated($generatedTemplates);
+    }
+
+    /**
+     * Generates all fixtures template path that can be found.
+     */
+    public function actionGenerateAll()
+    {
+        $foundTemplates = $this->findTemplatesFiles();
+
+        if (!$foundTemplates) {
+            $this->notifyNoTemplatesFound();
+            return static::EXIT_CODE_NORMAL;
+        }
+
+        if (!$this->confirmGeneration($foundTemplates)) {
+            return static::EXIT_CODE_NORMAL;
+        }
+
+        $templatePath = Yii::getAlias($this->templatePath);
+        $fixtureDataPath = Yii::getAlias($this->fixtureDataPath);
+
+        FileHelper::createDirectory($fixtureDataPath);
+
+        $generatedTemplates = [];
+
+        foreach ($foundTemplates as $templateName) {
+            $this->generateFixtureFile($templateName, $templatePath, $fixtureDataPath);            
+            $generatedTemplates[] = $templateName;
+        }
+
+        $this->notifyTemplatesGenerated($generatedTemplates);
+    }
+
+    /**
+     * Notifies user that given fixtures template files were not found.
+     * @param array $templatesNames
+     * @since 2.0.4
+     */
+    protected function notifyNotFoundTemplates($templatesNames)
+    {
+        $this->stdout("The following fixtures templates were NOT found:\n\n", Console::FG_RED);
+
+        foreach ($templatesNames as $name) {
+            $this->stdout("\t * $name \n", Console::FG_GREEN);
+        }
+
+        $this->stdout("\n");
+    }
+
+    /**
+     * Notifies user that there was not found any files matching given input conditions.
+     * @since 2.0.4
+     */
+    protected function notifyNoTemplatesFound()
+    {
+        $this->stdout("No fixtures template files matching input conditions were found under the path:\n\n", Console::FG_RED);
+        $this->stdout("\t " . Yii::getAlias($this->templatePath) . " \n\n", Console::FG_GREEN);
+    }
+
+    /**
+     * Notifies user that given fixtures template files were generated.
+     * @param array $templatesNames
+     * @since 2.0.4
+     */
+    protected function notifyTemplatesGenerated($templatesNames)
+    {
+        $this->stdout("The following fixtures template files were generated:\n\n", Console::FG_YELLOW);
+
+        foreach ($templatesNames as $name) {
+            $this->stdout("\t* " . $name . "\n", Console::FG_GREEN);
+        }
+
+        $this->stdout("\n");
+    }
+
+    /**
+     * Notifies user about templates which could be generated.
+     * @param array $templatesNames
+     * @since 2.0.4
+     */
+    protected function notifyTemplatesCanBeGenerated($templatesNames)
+    {
+        $this->stdout("Template files path: ", Console::FG_YELLOW);
+        $this->stdout(Yii::getAlias($this->templatePath) . "\n\n", Console::FG_GREEN);
+
+        foreach ($templatesNames as $name) {
+            $this->stdout("\t* " . $name . "\n", Console::FG_GREEN);
+        }
+
+        $this->stdout("\n");
+    }
+
+    /**
+     * Returns array containing fixtures templates file names. You can specify what files to find
+     * by the given parameter.
+     * @param array $templatesNames template file names to search. If empty then all files will be searched.
+     * @return array
+     * @since 2.0.4
+     */
+    protected function findTemplatesFiles(array $templatesNames = [])
+    {
+        $findAll = ($templatesNames == []);
+
+        if ($findAll) {
+            $files = FileHelper::findFiles(Yii::getAlias($this->templatePath), ['only' => ['*.php']]);
+        } else {
+            $filesToSearch = [];
+
+            foreach ($templatesNames as $fileName) {
+                $filesToSearch[] = $fileName . '.php';
+            }
+
+            $files = FileHelper::findFiles(Yii::getAlias($this->templatePath), ['only' => $filesToSearch]);
+        }
+
+        $foundTemplates = [];
+
+        foreach ($files as $fileName) {
+            // strip templatePath from current template's full path
+            $relativeName = str_replace(Yii::getAlias($this->templatePath) . DIRECTORY_SEPARATOR, "", $fileName);
+            $relativeDir = dirname($relativeName) == '.' ? '' : dirname($relativeName) . '/';
+            // strip extension
+            $relativeName = $relativeDir . basename($relativeName,'.php');
+            $foundTemplates[] = $relativeName;
+        }
+
+        return $foundTemplates;
+    }
+
+    /**
+     * Returns Faker generator instance. Getter for private property.
+     * @return \Faker\Generator
+     */
+    public function getGenerator()
+    {
+        if ($this->_generator === null) {
+            $language = $this->language === null ? Yii::$app->language : $this->language;
+            $this->_generator = \Faker\Factory::create(str_replace('-', '_', $language));
+        }
+        return $this->_generator;
+    }
+
+    /**
+     * Check if the template path and migrations path exists and writable.
+     */
+    public function checkPaths()
+    {
+        $path = Yii::getAlias($this->templatePath, false);
+
+        if (!$path || !is_dir($path)) {
+            throw new Exception("The template path \"{$this->templatePath}\" does not exist");
+        }
+    }
+
+    /**
+     * Adds users providers to the faker generator.
+     */
+    public function addProviders()
+    {
+        foreach ($this->providers as $provider) {
+            $this->generator->addProvider(new $provider($this->generator));
+        }
+    }
+
+    /**
+     * Returns exported to the string representation of given fixtures array.
+     * @param array $fixtures
+     * @return string exported fixtures format
+     */
+    public function exportFixtures($fixtures)
+    {
+        return "<?php\n\nreturn " . VarDumper::export($fixtures) . ";\n";
+    }
+
+    /**
+     * Generates fixture from given template
+     * @param string $_template_ the fixture template file
+     * @param int $index the current fixture index
+     * @return array fixture
+     */
+    public function generateFixture($_template_, $index)
+    {
+        // $faker and $index are exposed to the template file
+        $faker = $this->getGenerator();
+        return require($_template_);
+    }
+
+    /**
+     * Generates fixture file by the given fixture template file.
+     * @param string $templateName template file name
+     * @param string $templatePath path where templates are stored
+     * @param string $fixtureDataPath fixture data path where generated file should be written
+     */
+    public function generateFixtureFile($templateName, $templatePath, $fixtureDataPath)
+    {
+        $fixtures = [];
+
+        for ($i = 0; $i < $this->count; $i++) {
+            $fixtures[$templateName . $i] = $this->generateFixture($templatePath . '/' . $templateName . '.php', $i);
+        }
+
+        $content = $this->exportFixtures($fixtures);
+
+        // data file full path
+        $dataFile = $fixtureDataPath . '/'. $templateName . '.php';
+
+        // data file directory, create if it doesn't exist
+        $dataFileDir = dirname($dataFile);
+        if (!file_exists($dataFileDir)) {
+            FileHelper::createDirectory($dataFileDir);
+        }
+        file_put_contents($dataFile, $content);
+    }
+
+    /**
+     * Prompts user with message if he confirm generation with given fixture templates files.
+     * @param array $files
+     * @return bool
+     */
+    public function confirmGeneration($files)
+    {
+        $this->stdout("Fixtures will be generated under the path: \n", Console::FG_YELLOW);
+        $this->stdout("\t" . Yii::getAlias($this->fixtureDataPath) . "\n\n", Console::FG_GREEN);
+        $this->stdout("Templates will be taken from path: \n", Console::FG_YELLOW);
+        $this->stdout("\t" . Yii::getAlias($this->templatePath) . "\n\n", Console::FG_GREEN);
+
+        foreach ($files as $fileName) {
+            $this->stdout("\t* " . $fileName . "\n", Console::FG_GREEN);
+        }
+
+        return $this->confirm('Generate above fixtures?');
+    }
+
+}

vendor/yiisoft/yii2-faker/LICENSE.md

@@ -0,0 +1,32 @@
+The Yii framework is free software. It is released under the terms of
+the following BSD License.
+
+Copyright © 2008-2013 by Yii Software LLC (http://www.yiisoft.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+ * Neither the name of Yii Software LLC nor the names of its
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

vendor/yiisoft/yii2-faker/Makefile

@@ -0,0 +1,26 @@
+
+# default versions to test against
+# these can be overridden by setting the environment variables in the shell
+PHP_VERSION=php-5.6.8
+YII_VERSION=dev-master
+
+# ensure all the configuration variables above are in environment of the shell commands below
+export
+
+help:
+	@echo "make test    - run phpunit tests using a docker environment"
+#	@echo "make clean   - stop docker and remove container"
+
+test: docker-php
+	composer require "yiisoft/yii2:${YII_VERSION}" --prefer-dist
+	composer install --prefer-dist
+	docker run --rm=true -v $(shell pwd):/opt/test yiitest/php:${PHP_VERSION} phpunit --verbose --color
+
+docker-php: dockerfiles
+	cd tests/docker/php && sh build.sh
+
+dockerfiles:
+	test -d tests/docker || git clone https://github.com/cebe/jenkins-test-docker tests/docker
+	cd tests/docker && git checkout -- . && git pull
+	mkdir -p tests/dockerids
+

vendor/yiisoft/yii2-faker/README.md

@@ -0,0 +1,51 @@
+<p align="center">
+    <a href="https://github.com/yiisoft" target="_blank">
+        <img src="https://avatars0.githubusercontent.com/u/993323" height="100px">
+    </a>
+    <h1 align="center">Faker Extension for Yii 2</h1>
+    <br>
+</p>
+
+This extension provides a [`Faker`](https://github.com/fzaninotto/Faker) fixture command for the [Yii framework 2.0](http://www.yiiframework.com).
+
+For license information check the [LICENSE](LICENSE.md)-file.
+
+Documentation is at [docs/guide/README.md](docs/guide/README.md).
+
+[![Latest Stable Version](https://img.shields.io/packagist/v/yiisoft/yii2-faker.svg)](https://packagist.org/packages/yiisoft/yii2-faker)
+[![Total Downloads](https://img.shields.io/packagist/dt/yiisoft/yii2-faker.svg)](https://packagist.org/packages/yiisoft/yii2-faker)
+[![Build Status](https://travis-ci.org/yiisoft/yii2-faker.svg?branch=master)](https://travis-ci.org/yiisoft/yii2-faker)
+
+
+Installation
+------------
+
+The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
+
+Either run
+
+```
+php composer.phar require --prefer-dist yiisoft/yii2-faker
+```
+
+or add
+
+```json
+"yiisoft/yii2-faker": "~2.0.0"
+```
+
+to the require section of your composer.json.
+
+
+Usage
+-----
+
+To use this extension,  simply add the following code in your application configuration (console.php):
+
+```php
+'controllerMap' => [
+    'fixture' => [
+        'class' => 'yii\faker\FixtureController',
+    ],
+],
+```

vendor/yiisoft/yii2-faker/composer.json

@@ -0,0 +1,38 @@
+{
+    "name": "yiisoft/yii2-faker",
+    "description": "Fixture generator. The Faker integration for the Yii framework.",
+    "keywords": ["yii2", "faker", "fixture"],
+    "type": "yii2-extension",
+    "license": "BSD-3-Clause",
+    "support": {
+        "issues": "https://github.com/yiisoft/yii2-faker/issues",
+        "forum": "http://www.yiiframework.com/forum/",
+        "wiki": "http://www.yiiframework.com/wiki/",
+        "irc": "irc://irc.freenode.net/yii",
+        "source": "https://github.com/yiisoft/yii2-faker"
+    },
+    "authors": [
+        {
+            "name": "Mark Jebri",
+            "email": "mark.github@yandex.ru"
+        }
+    ],
+    "require": {
+        "yiisoft/yii2": "~2.0.0",
+        "fzaninotto/faker": "~1.4"
+    },
+    "autoload": {
+        "psr-4": { "yii\\faker\\": "" }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "2.0.x-dev"
+        }
+    },
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://asset-packagist.org"
+        }
+    ]
+}