Flags should have consitent api

docs/function/local-development.md

@@ -71,22 +71,19 @@ Instead, you can use the [`bref/dev-server`](https://github.com/brefphp/dev-serv
 If you do not use `serverless.yml` but something else, like SAM/AWS CDK/Terraform, use the `vendor/bin/bref-local` command instead:
 
 ```bash
-$ vendor/bin/bref-local <handler> <event-data>
-
-# For example
-$ vendor/bin/bref-local my-function.php
+$ vendor/bin/bref-local -f my-function.php
 Hello world
 
 # With JSON event data
-$ vendor/bin/bref-local my-function.php '{"name": "Jane"}'
+$ vendor/bin/bref-local -f my-function.php --data '{"name": "Fred"}'
 Hello Jane
 
-# With a path to a file containing a JSON event.
+# With JSON in a file
 $ cat event.json
 {
     "name": "Alex"
 }
-$ vendor/bin/bref-local --path event.json my-function.php
+$ vendor/bin/bref-local -f my-function.php --path event.json
 Hello Alex
 ```
 

src/bref-local

@@ -16,19 +16,36 @@ if (file_exists(__DIR__ . '/../vendor/autoload.php')) {
     require_once __DIR__ . '/../../../autoload.php';
 }
 
-$handler = $argv[1] ?? '';
-$data = $argv[2] ?? null;
-$opts = getopt('', ['path:']);
+$opts = getopt('f:', ['path:', 'data:']);
+$handler = $opts['f'] ?? null;
+$data = $opts['data'] ?? null;
+
+// Retains backward compatibilty with `./vendor/bin/bref-local <handler> <event-data>`
+if (empty($opts)) {
+    $handler = $argv[1] ?? '';
+    $data = $argv[2] ?? null;
+}
 
 if (isset($opts['path'])) {
     if (! file_exists($opts['path'])) {
         throw new Exception('The file ' . $opts['path'] . ' could not be found.');
     }
 
-    $handler = $argv[array_key_last($argv)];
     $data = file_get_contents($opts['path']);
 }
 
+if (isset($opts['f'])) {
+    if (! file_exists($opts['f'])) {
+        throw new Exception('Handler file ' . $opts['f'] . ' could not be found.');
+    }
+
+    if (! isset($opts['path']) && isset($opts['data'])) {
+        $data = $opts['data'];
+    }
+
+    $handler = $opts['f'];
+}
+
 try {
     $handler = Bref::getContainer()->get($handler);
 } catch (NotFoundExceptionInterface $e) {