157 lines
3.8 KiB
PHP
157 lines
3.8 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Behat Gherkin Parser.
|
|
* (c) Konstantin Kudryashov <ever.zet@gmail.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Behat\Gherkin;
|
|
|
|
use Behat\Gherkin\Filter\FeatureFilterInterface;
|
|
use Behat\Gherkin\Filter\LineFilter;
|
|
use Behat\Gherkin\Filter\LineRangeFilter;
|
|
use Behat\Gherkin\Loader\FileLoaderInterface;
|
|
use Behat\Gherkin\Loader\LoaderInterface;
|
|
use Behat\Gherkin\Node\FeatureNode;
|
|
|
|
/**
|
|
* Gherkin manager.
|
|
*
|
|
* @author Konstantin Kudryashov <ever.zet@gmail.com>
|
|
*/
|
|
class Gherkin
|
|
{
|
|
/**
|
|
* @deprecated this constant will not be updated for releases after 4.8.0 and will be removed in the next major.
|
|
* You can use composer's runtime API to get the behat version if you need it. Note that composer's versions will
|
|
* not always be simple numeric values.
|
|
*/
|
|
public const VERSION = '4.8.0';
|
|
|
|
/**
|
|
* @var list<LoaderInterface>
|
|
*/
|
|
protected $loaders = [];
|
|
/**
|
|
* @var list<FeatureFilterInterface>
|
|
*/
|
|
protected $filters = [];
|
|
|
|
/**
|
|
* Adds loader to manager.
|
|
*
|
|
* @param LoaderInterface $loader Feature loader
|
|
*
|
|
* @return void
|
|
*/
|
|
public function addLoader(LoaderInterface $loader)
|
|
{
|
|
$this->loaders[] = $loader;
|
|
}
|
|
|
|
/**
|
|
* Adds filter to manager.
|
|
*
|
|
* @param FeatureFilterInterface $filter Feature filter
|
|
*
|
|
* @return void
|
|
*/
|
|
public function addFilter(FeatureFilterInterface $filter)
|
|
{
|
|
$this->filters[] = $filter;
|
|
}
|
|
|
|
/**
|
|
* Sets filters to the parser.
|
|
*
|
|
* @param array<array-key, FeatureFilterInterface> $filters
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setFilters(array $filters)
|
|
{
|
|
$this->filters = [];
|
|
array_map($this->addFilter(...), $filters);
|
|
}
|
|
|
|
/**
|
|
* Sets base features path.
|
|
*
|
|
* @param string $path Loaders base path
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setBasePath($path)
|
|
{
|
|
foreach ($this->loaders as $loader) {
|
|
if ($loader instanceof FileLoaderInterface) {
|
|
$loader->setBasePath($path);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Loads & filters resource with added loaders.
|
|
*
|
|
* @param mixed $resource Resource to load
|
|
* @param array<array-key, FeatureFilterInterface> $filters Additional filters
|
|
*
|
|
* @return list<FeatureNode>
|
|
*/
|
|
public function load($resource, array $filters = [])
|
|
{
|
|
$filters = array_merge($this->filters, $filters);
|
|
|
|
$matches = [];
|
|
if (preg_match('/^(.*):(\d+)-(\d+|\*)$/', $resource, $matches)) {
|
|
$resource = $matches[1];
|
|
$filters[] = new LineRangeFilter($matches[2], $matches[3]);
|
|
} elseif (preg_match('/^(.*):(\d+)$/', $resource, $matches)) {
|
|
$resource = $matches[1];
|
|
$filters[] = new LineFilter($matches[2]);
|
|
}
|
|
|
|
$loader = $this->resolveLoader($resource);
|
|
|
|
if ($loader === null) {
|
|
return [];
|
|
}
|
|
|
|
$features = [];
|
|
foreach ($loader->load($resource) as $feature) {
|
|
foreach ($filters as $filter) {
|
|
$feature = $filter->filterFeature($feature);
|
|
|
|
if (!$feature->hasScenarios() && !$filter->isFeatureMatch($feature)) {
|
|
continue 2;
|
|
}
|
|
}
|
|
|
|
$features[] = $feature;
|
|
}
|
|
|
|
return $features;
|
|
}
|
|
|
|
/**
|
|
* Resolves loader by resource.
|
|
*
|
|
* @param mixed $resource Resource to load
|
|
*
|
|
* @return LoaderInterface|null
|
|
*/
|
|
public function resolveLoader($resource)
|
|
{
|
|
foreach ($this->loaders as $loader) {
|
|
if ($loader->supports($resource)) {
|
|
return $loader;
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
}
|