Merge pull request #122 from alleyinteractive/mantle-bin

Feature: bin/mantle

Author: srtfisher

.gitignore

@@ -8,6 +8,7 @@ vendor
 composer.lock
 bootstrap/cache
 .phpunit.result.cache
+.phpcs/*.json
 
 # Ignore temporary OS files
 .DS_Store

.phpcs/.gitkeep

@@ -7,10 +7,14 @@
 
 namespace App\Console;
 
+use Mantle\Facade\Console;
 use Mantle\Framework\Console\Kernel as Console_Kernel;
 
 /**
  * Application Console Kernel
+ *
+ * By default, the application will automatically register any command in this
+ * directory as well as any command registered in 'routes/console.php'.
  */
 class Kernel extends Console_Kernel {
 	/**
@@ -29,5 +33,7 @@ class Kernel extends Console_Kernel {
 	 */
 	public function commands(): void {
 		$this->load( __DIR__ );
+
+		require base_path( 'routes/console.php' ); // phpcs:ignore WordPressVIPMinimum.Files.IncludingFile.UsingCustomFunction
 	}
 }

app/console/class-kernel.php

@@ -18,9 +18,11 @@ class Handler extends ExceptionHandler {
 	/**
 	 * A list of the exception types that are not reported.
 	 *
-	 * @var array
+	 * @var string[]
 	 */
-	protected $dont_report = [];
+	protected $dont_report = [
+		// ...
+	];
 
 	/**
 	 * Report or log an exception.

app/exceptions/class-handler.php

@@ -0,0 +1,56 @@
+#!/usr/bin/env php
+<?php
+
+define( 'MANTLE_ISOLATION_MODE', true );
+defined( 'MANTLE_BASE_DIR' ) || define( 'MANTLE_BASE_DIR', dirname( __DIR__ ) );
+
+/*
+|--------------------------------------------------------------------------
+| Load Composer
+|--------------------------------------------------------------------------
+|
+| Check if Composer has been installed and attempt to load it. You can remove
+| this block of code if Composer is being loaded outside of the plugin.
+|
+*/
+
+if ( file_exists( __DIR__ . '/../vendor/autoload.php' ) ) {
+	require __DIR__ . '/../vendor/autoload.php';
+} elseif ( ! class_exists( Mantle\Contracts\Console\Kernel::class ) ) {
+	echo 'You need to run `composer install` to use bin/mantle. If your `vendor/autoload.php` file is in a different location, you must modify `bin/mantle` to load it.' . PHP_EOL;
+	exit( 1 );
+}
+
+$app = require_once __DIR__ . '/../bootstrap/app.php';
+
+/*
+|--------------------------------------------------------------------------
+| Run the Console Mantle Application
+|--------------------------------------------------------------------------
+|
+| Load the Mantle application and run the console application. With isolation
+| mode enabled, we shouldn't have a dependency on WordPress.
+|
+*/
+
+$kernel = $app->make( Mantle\Contracts\Console\Kernel::class );
+
+$status = $kernel->handle(
+	$input = new Symfony\Component\Console\Input\ArgvInput,
+	new Symfony\Component\Console\Output\ConsoleOutput(),
+);
+
+/*
+|--------------------------------------------------------------------------
+| Shutdown The Application
+|--------------------------------------------------------------------------
+|
+| Once the application has finished running, we will fire off the shutdown
+| events so that any final work may be done by the application before it
+| is shut down gracefully.
+|
+*/
+
+$kernel->terminate( $input, $status );
+
+exit( $status );

bin/clear-bootstrap.sh

@@ -11,7 +11,7 @@
   ],
   "require": {
     "alleyinteractive/composer-wordpress-autoloader": "^1.0",
-    "alleyinteractive/mantle-framework": "^0.7",
+    "alleyinteractive/mantle-framework": "^0.9",
     "fakerphp/faker": "^1.9",
     "symfony/mime": "^5.1"
   },
@@ -43,10 +43,15 @@
   "minimum-stability": "dev",
   "prefer-stable": true,
   "scripts": {
-    "pre-install-cmd": "./bin/clear-bootstrap.sh",
-    "pre-update-cmd": "./bin/clear-bootstrap.sh",
+    "post-install-cmd": [
+      "bin/mantle cache:clear"
+    ],
+    "post-update-cmd": [
+      "bin/mantle cache:clear"
+    ],
     "post-autoload-dump": [
-      "./bin/package-discover.sh"
+      "bin/mantle package:discover",
+      "bin/mantle model:discover"
     ],
     "lint": "@phpcs",
     "lint:fix": "@phpcbf",

bin/mantle

@@ -26,5 +26,8 @@
 	|
 	| This URL is used to properly generate the URL to built assets.
 	*/
-	'url'  => env( 'ASSET_BUILD_URL', \plugin_dir_url( __DIR__ ) ),
+	'url'  => env(
+		'ASSET_BUILD_URL',
+		function_exists( 'plugin_dir_url' ) ? \plugin_dir_url( __DIR__ ) : '', // todo: replace with a framework helper method.
+	),
 ];

bin/package-discover.sh

@@ -62,18 +62,28 @@ function() {
 	}
 }
 
-/**
- * Load the Mantle Application
- */
+/*
+|--------------------------------------------------------------------------
+| Load the Application
+|--------------------------------------------------------------------------
+|
+| Load the Mantle application from the bootstrap file.
+|
+*/
 $app = require_once __DIR__ . '/bootstrap/app.php';
 
 /*
- * Run the application.
- */
-// Load the Application's Kernel depending on the context it was called.
+|--------------------------------------------------------------------------
+| Run the Mantle Application
+|--------------------------------------------------------------------------
+|
+| Once we have the application, we can handle the incoming request and send it
+| the application's kernel (which depends on the context upon which it was
+| called). For the console, the kernel's `handle` method is not called intentionally.
+|
+*/
 if ( defined( 'WP_CLI' ) && \WP_CLI ) {
 	$app_kernel = $app->make( Contracts\Console\Kernel::class );
-	$app_kernel->handle();
 } else {
 	// Boot up the HTTP Kernel.
 	$app_kernel = $app->make( Contracts\Http\Kernel::class );