Run lambda HTTP APIs via xp web lambda [class]

[thekid]

This pull request makes it possible to run HTTP APIs locally via xp web, improving the developer experience.

use com\amazon\aws\lambda\HttpApi;

class Greet extends HttpApi {

  /**
   * Returns routes
   *
   * @param  web.Environment $env
   * @return web.Application|web.Routing|[:var]
   */
  public function routes($env) {
    return ['/' => function($req, $res) {
      $greeting= sprintf(
        'Hello %s from PHP %s on stage %s @ %s',
        $req->param('name') ?? $req->header('User-Agent') ?? 'Guest',
        PHP_VERSION,
        $req->value('request')->stage,
        $req->value('context')->region
      );

      $res->answer(200);
      $res->send($greeting, 'text/plain');
    }];
  }
}

Run via:

$ xp web lambda Greet
@xp.web.srv.Standalone(HTTP @ peer.ServerSocket(Resource id #116 -> tcp://127.0.0.1:8080))
Serving prod:xp.lambda.Web<Greet>[] > web.logging.ToConsole
════════════════════════════════════════════════════════════════════════
> Server started: http://localhost:8080 in 0.046 seconds
  Mon, 20 Nov 2023 19:57:35 +0100 - PID 16340; press Ctrl+C to exit

# ...

See also xp-forge/lambda#21

[thekid]

xp web com.amazon.aws.lambda.Ws Greet is quite long, how about:

• Shortening the class name: xp web xp.lambda.Ws Greet using the xp namespace used for commands
• Introducing @[name]: xp web @lambda Greet as a shorthand for xp.[name].App
• Extending the lambda subcommand: xp lambda ws Greet by mapping ws to xp.lambda.WsCommand

[thekid]

Introducing @[name]: xp web @lambda Greet as a shorthand for xp.[name].App

We don't even need the @ prefix, we can simply use the convention that PHP types start with an uppercase character:

• xp web lambda loads the class web xp.lambda.Web
• xp web Lambda loads the class Lambda

Implementation:

diff --git a/src/main/php/xp/web/Source.class.php b/src/main/php/xp/web/Source.class.php
index ded3208..a66d1a5 100755
--- a/src/main/php/xp/web/Source.class.php
+++ b/src/main/php/xp/web/Source.class.php
@@ -24,7 +24,13 @@ class Source {
 
     $cl= ClassLoader::getDefault();
     try {
-      $class= is_file($application) ? $cl->loadUri($application) : $cl->loadClass($application);
+      if (is_file($application)) {
+        $class= $cl->loadUri($application);
+      } else if ($application[0] < 'a' || false !== strpos($application, '.')) {
+        $class= $cl->loadClass($application);
+      } else {
+        $class= $cl->loadClass("xp.{$application}.Web");
+      }
     } catch (ClassLoadingException $e) {
       throw new IllegalArgumentException('Cannot load class '.$application, $e);
     }

[thekid]

Released in https://github.com/xp-forge/lambda-ws/releases/tag/v1.3.0