lookup-path.php

#!/usr/bin/env hhvm
<?hh // strict
/**
 * This file is partially generated. Only make modifications between BEGIN
 * MANUAL SECTION and END MANUAL SECTION designators.
 *
 * To re-generate this file run vendor/hhvm/hacktest/bin/hacktest
 *
 *
 * @partially-generated SignedSource<<61e1a0bcff805162c34d005bb526d587>>
 */
namespace Facebook\HackRouter\CodeGen\Tests\Generated;

/**
 * A quick way to validate that a path or url routes to the controller you
 * expect.
 *
 * Usage: path/to/this/utility <%path or url%>.
 * The output will look something like this:
 *
 * ```
 * $ tests/examples/codegen/lookup-path.php /a-string/123/derp
 * HEAD:    Facebook\HackRouter\CodeGen\Tests\GetRequestExampleController
 * GET:     Facebook\HackRouter\CodeGen\Tests\GetRequestExampleController
 * ```
 *
 * You may also copy paste the whole url:
 * ```
 * $ tests/examples/codegen/lookup-path.php
 * http://localhost:8080/a-string/123/derp?query=abcd#fragment
 * HEAD:    Facebook\HackRouter\CodeGen\Tests\GetRequestExampleController
 * GET:     Facebook\HackRouter\CodeGen\Tests\GetRequestExampleController
 * ```
 *
 * If the given path does not match any controllers, you'll get the following
 * result:
 * ```
 * $ tests/examples/codegen/lookup-path.php /a/b/c
 * No controller found for '/a/b/c'.
 * ```
 *
 * You can edit the manual sections to change the router and formatter used.
 */
<<__EntryPoint>>
function hack_router_cli_lookup_generated_main(): void {
  /* BEGIN MANUAL SECTION init */
  $autoloader = null;
  $autoloader_candidates = vec[
    __DIR__.'/vendor/autoload.hack',
    __DIR__.'/../vendor/autoload.hack',
    __DIR__.'/../../vendor/autoload.hack',
    __DIR__.'/../../../vendor/autoload.hack',
  ];
  foreach ($autoloader_candidates as $candidate) {
    if (\file_exists($candidate)) {
      $autoloader = $candidate;
      break;
    }
  }
  if ($autoloader === null) {
    \fwrite(\STDERR, "Can't find autoloader.\n");
    exit(1);
  }
  require_once($autoloader);
  \Facebook\AutoloadMap\initialize();
  /* END MANUAL SECTION */

  $argv = \Facebook\TypeAssert\matches<vec<string>>(\HH\global_get('argv'));
  (new MySiteRouterCLILookup())->main($argv);
}

final class MySiteRouterCLILookup {

  private function getRouter(
  ): \Facebook\HackRouter\CodeGen\Tests\Generated\MySiteRouter {
    /* BEGIN MANUAL SECTION MySiteRouterCLILookup::getRouter */
    return new \Facebook\HackRouter\CodeGen\Tests\Generated\MySiteRouter();
    /* END MANUAL SECTION */
  }

  private function prettifyControllerName(string $controller): string {
    /* BEGIN MANUAL SECTION MySiteRouterCLILookup::prettifyControllerName */
    return $controller;
    /* END MANUAL SECTION */
  }

  private function getControllersForPath(
    string $path,
  ): ImmMap<\Facebook\HackRouter\HttpMethod, string> {
    $router = $this->getRouter();
    try {
      $controllers = Map { };
      foreach (\Facebook\HackRouter\HttpMethod::getValues() as $method) {
        try {
          list($controller, $_params) =
            $router->routeMethodAndPath($method, $path);
          $controllers[$method] = $controller;
        } catch (\Facebook\HackRouter\MethodNotAllowedException $_) {
          // Ignore
        }
      }
      return $controllers->immutable();
    } catch (\Facebook\HackRouter\NotFoundException $_) {
      return ImmMap { };
    }
  }

  public function main(vec<string> $argv): void {
    $path = $argv[1] ?? null;
    if ($path === null) {
      \fprintf(\STDERR, "Usage: %s PATH\n", $argv[0]);
      exit(1);
    }
    // The parser is very lenient, `?: $path` is almost never needed.
    $path = \parse_url($path, \PHP_URL_PATH) ?: $path;
    $controllers = $this->getControllersForPath($path);
    if ($controllers->isEmpty()) {
      \printf("No controller found for '%s'.\n", $path);
      exit(1);
    }
    foreach ($controllers as $method => $controller) {
      $pretty = $this->prettifyControllerName($controller);
      \printf("%-8s %s\n", $method.':', $pretty);
    }
  }
}