WIP

.gitignore

@@ -19,3 +19,4 @@ yarn-error.log
 
 npm-debug.log*
 .phpunit.result.cache
+composer.lock

README.md

@@ -82,6 +82,19 @@ that now:
 composer update modules/my-module
 ```
 
+### Optional: Initialization
+
+You can run the initialization command to make sure that your project is set up
+for module support:
+
+```shell script
+php artisan module:init
+```
+
+This will add a `Modules` test suite to your `phpunit.xml` file (if one exists)
+and may, in the future, add other scaffolding as needed. It should be safe to run
+this command at any time, as it will only add missing configuration.
+
 ### Optional: Customize namespaces & paths
 
 By default, modules will be in the `Modules\` namespace and installed into the
@@ -128,6 +141,17 @@ expected in most cases:
 
 Most things *just work*.
 
+### Commands
+
+We provide a few helper commands:
+
+- `php artisan make:module` — scaffold a new module
+- `php artisan module:cache` — cache the loaded modules for slightly faster auto-discovery
+- `php artisan module:clear` — clear the module cache
+- `php artisan module:init` — initialize your project for modular
+- `php artisan module:list` — list all modules
+- `php artisan module:update-phpstorm-config` — update PhpStorm configs for module support
+
 We also add a `--module=` option to most Laravel `make:` commands so that you can
 use all the existing tooling that you know. The commands themselves are exactly the
 same, which means you can use your [custom stubs](https://laravel.com/docs/7.x/artisan#stub-customization)

composer.json

@@ -0,0 +1,44 @@
+{
+    "name": "internachi/modular",
+    "description": "Modularize your Laravel apps",
+    "keywords": [
+        "laravel",
+        "modules",
+        "modular",
+        "module"
+    ],
+    "version": "1.0",
+    "type": "library",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "InterNACHI\\Modular\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "InterNACHI\\Modular\\Tests\\": "tests/"
+        }
+    },
+    "minimum-stability": "stable",
+    "extra": {
+        "laravel": {
+            "providers": [
+                "InterNACHI\\Modular\\Support\\ModularServiceProvider",
+                "InterNACHI\\Modular\\Support\\ModularizedCommandsServiceProvider"
+            ],
+            "aliases": {
+                "Modules": "InterNACHI\\Modular\\Support\\Facades\\Modules"
+            }
+        }
+    },
+    "require": {
+        "php": ">=7.4",
+        "illuminate/support": "^7.0|^8.0"
+    },
+    "require-dev": {
+        "orchestra/testbench": "^5.0",
+        "phpunit/phpunit": "^8.0",
+        "mockery/mockery": "^1.3"
+    }
+}

config.php

@@ -0,0 +1,7 @@
+<?php
+
+return [
+	'modules_directory' => 'app-modules',
+	'modules_namespace' => 'Modules',
+	'tests_base' => 'Tests\TestCase',
+];

tests/TestCase.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace InterNACHI\Modular\Tests;
+
+use InterNACHI\Modular\Support\Facades\Modules;
+use InterNACHI\Modular\Support\ModularizedCommandsServiceProvider;
+use InterNACHI\Modular\Support\ModularServiceProvider;
+use Orchestra\Testbench\TestCase as Orchestra;
+
+abstract class TestCase extends Orchestra
+{
+	protected function setUp() : void
+	{
+		parent::setUp();
+
+		$config = $this->app['config'];
+
+		// Add encryption key for HTTP tests
+		$config->set('app.key', 'base64:tfsezwCu4ZRixRLA/+yL/qoouX++Q3lPAPOAbtnBCG8=');
+
+		// Add feature stubs to view
+		$this->app['view']->addLocation(__DIR__.'/Feature/stubs');
+	}
+
+	protected function getPackageProviders($app)
+	{
+		return [
+			ModularServiceProvider::class,
+			ModularizedCommandsServiceProvider::class,
+		];
+	}
+
+	protected function getPackageAliases($app)
+	{
+		return [
+			'Modules' => Modules::class,
+		];
+	}
+}