Switch the command line tool to using reflection by default

The legacy `TokenAnalyser` can be used by specifying the `--legacy` (`-l`) option.

README.md

@@ -68,6 +68,9 @@ The `openapi` command line interface can be used to generate the documentation t
 ```bash
 ./vendor/bin/openapi --help
 ```
+Starting with version 4 the default analyser used on the command line is the new `ReflectionAnalyser`.
+
+Using the `--legacy` flag (`-l`) the legacy `TokenAnalyser` can still be used.
 
 ### Usage from the Deserializer
 

bin/openapi

@@ -1,6 +1,9 @@
 #!/usr/bin/env php
 <?php
 
+use OpenApi\Analysers\AttributeAnnotationFactory;
+use OpenApi\Analysers\DocBlockAnnotationFactory;
+use OpenApi\Analysers\ReflectionAnalyser;
 use OpenApi\Analysers\TokenAnalyser;
 use OpenApi\Generator;
 use OpenApi\Util;
@@ -18,6 +21,7 @@ error_reporting(E_ALL);
 
 // Possible options and their default values.
 $options = [
+    'legacy' => false,
     'output' => false,
     'format' => 'auto',
     'exclude' => [],
@@ -28,6 +32,7 @@ $options = [
     'processor' => [],
 ];
 $aliases = [
+    'l' => 'legacy',
     'o' => 'output',
     'e' => 'exclude',
     'n' => 'pattern',
@@ -110,6 +115,7 @@ if ($options['help']) {
 Usage: openapi [--option value] [/path/to/project ...]
 
 Options:
+  --legacy (-l)     Use legacy TokenAnalyser; default is the new ReflectionAnalyser
   --output (-o)     Path to store the generated documentation.
                     ex: --output openapi.yaml
   --exclude (-e)    Exclude path(s).
@@ -193,8 +199,12 @@ foreach ($options["processor"] as $processor) {
     $generator->addProcessor($processor);
 }
 
+$analyser = $options['legacy']
+    ? new TokenAnalyser()
+    : new ReflectionAnalyser([new DocBlockAnnotationFactory(), new AttributeAnnotationFactory()]);
+
 $openapi = $generator
-    ->setAnalyser(new TokenAnalyser())
+    ->setAnalyser($analyser)
     ->generate(Util::finder($paths, $exclude, $pattern));
 
 if ($logger->called()) {