/**
* Generate documentation with the name and version.
*
* @param string $name
* @param string $version
*
* @return bool
*/
public function generate(Collection $controllers, $name, $version)
{
$resources = $controllers->map(function ($controller) use($version) {
$controller = $controller instanceof ReflectionClass ? $controller : new ReflectionClass($controller);
$actions = new Collection();
// Spin through all the methods on the controller and compare the version
// annotation (if supplied) with the version given for the generation.
// We'll also build up an array of actions on each resource.
foreach ($controller->getMethods() as $method) {
if ($versionAnnotation = $this->reader->getMethodAnnotation($method, Annotation\Versions::class)) {
if (!in_array($version, $versionAnnotation->value)) {
continue;
}
}
if ($annotations = $this->reader->getMethodAnnotations($method)) {
if (!$actions->contains($method)) {
$actions->push(new Action($method, new Collection($annotations)));
}
}
}
$annotations = new Collection($this->reader->getClassAnnotations($controller));
return new Resource($controller->getName(), $controller, $annotations, $actions);
});
return $this->generateContentsFromResources($resources, $name);
}
/**
* Gets an annotation.
*
* @param mixed $from
* @param string $name
* @return Annotation
*/
protected function getAnnotation($from, $name)
{
if (!$this->reader) {
$this->reader = new SimpleAnnotationReader();
$this->reader->addNamespace($this->namespace);
}
$name = "{$this->namespace}\\{$name}";
if ($from instanceof \ReflectionClass) {
$annotation = $this->reader->getClassAnnotation($from, $name);
} elseif ($from instanceof \ReflectionMethod) {
$annotation = $this->reader->getMethodAnnotation($from, $name);
} elseif ($from instanceof \ReflectionProperty) {
$annotation = $this->reader->getPropertyAnnotation($from, $name);
}
return $annotation;
}