first commit

Author: denisdulici

.gitattributes

@@ -0,0 +1,25 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text eol=lf
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.c text
+*.h text
+
+# Declare files that will always have CRLF line endings on checkout.
+*.sln text eol=crlf
+
+# Denote all files that are truly binary and should not be modified.
+*.png binary
+*.jpg binary
+*.otf binary
+*.eot binary
+*.svg binary
+*.ttf binary
+*.woff binary
+*.woff2 binary
+
+*.css linguist-vendored
+*.scss linguist-vendored
+*.js linguist-vendored
+CHANGELOG.md export-ignore

.gitignore

@@ -0,0 +1,4 @@
+/vendor
+composer.phar
+composer.lock
+.DS_Store

.scrutinizer.yml

@@ -0,0 +1,9 @@
+checks:
+    php: true
+filter:
+    excluded_paths: [vendor/*, tests/*]
+coding_style:
+    php: {  }
+tools:
+    external_code_coverage: true
+    php_code_coverage: true

.styleci.yml

@@ -0,0 +1,4 @@
+preset: psr2
+
+enabled:
+ - concat_with_spaces

.travis.yml

@@ -0,0 +1,18 @@
+language: php
+
+php:
+  - '7.1'
+  - '7.2'
+  - '7.3'
+
+sudo: false
+
+before_install:
+  # turn off XDebug
+  - phpenv config-rm xdebug.ini || return
+
+before_script:
+  - composer install --no-interaction --prefer-source
+
+script:
+  - vendor/bin/phpunit

LICENSE.md

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Pingpong Labs
+
+Copyright (c) 2016 Nicolas Widart
+
+Copyright (c) 2019 Akaunting
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,80 @@
+# Module management package for Laravel
+
+[![Version](https://poser.pugx.org/akaunting/module/v/stable.svg)](https://github.com/akaunting/module/releases)
+![Downloads](https://poser.pugx.org/akaunting/module/d/total.svg)
+![Build Status](https://travis-ci.com/akaunting/module.svg)
+[![StyleCI](https://styleci.io/repos/180799968/shield?style=flat&branch=master)](https://styleci.io/repos/180799968)
+[![Quality](https://scrutinizer-ci.com/g/akaunting/module/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/akaunting/module)
+[![License](https://poser.pugx.org/akaunting/module/license.svg)](LICENSE.md)
+
+This package intends to make your Laravel app extendible via modules. A module is kinda small Laravel app, shipping with its own views, controllers, models etc.
+
+## Getting Started
+
+### 1. Install
+
+Run the following command:
+
+```bash
+composer require akaunting/module
+```
+
+### 2. Register
+
+Service provider and facade will be registered automatically. If you want to register them manually in `config/app.php`:
+
+```php
+Akaunting\Module\Facade::class,
+Akaunting\Module\Providers\Laravel::class,
+```
+
+### 3. Publish
+
+Publish config file.
+
+```bash
+php artisan vendor:publish --tag=module
+```
+
+### 4. Configure
+
+You can change the configuration from `config/module.php` file
+
+### 5. Autoloading
+
+By default, the module classes are not loaded automatically. You can autoload your modules using `psr-4`. For example:
+
+``` json
+{
+  "autoload": {
+    "psr-4": {
+      "App\\": "app/",
+      "Modules\\": "modules/"
+    }
+  }
+}
+```
+
+**Tip: don't forget to run `composer dump-autoload` afterwards.**
+
+## Usage
+
+Check out the [wiki](../../wiki) about the usage and further documentation.
+
+## Changelog
+
+Please see [Releases](../../releases) for more information what has changed recently.
+
+## Contributing
+
+Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
+
+## Credits
+
+- [Denis Duliçi](https://github.com/denisdulici)
+- [Nicolas Widart](https://github.com/nwidart)
+- [All Contributors](../../contributors)
+
+## License
+
+The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information.

composer.json

@@ -0,0 +1,52 @@
+{
+    "name": "akaunting/module",
+    "description": "Module management package for Laravel.",
+    "keywords": ["laravel", "module", "rad", "akaunting"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Denis Duliçi",
+            "email": "[email protected]",
+            "homepage": "https://akaunting.com",
+            "role": "Developer"
+        }
+    ],
+    "require": {
+        "php": ">=7.1"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "~7.0",
+        "mockery/mockery": "~1.0",
+        "orchestra/testbench": "^3.8",
+        "friendsofphp/php-cs-fixer": "^2.14",
+        "spatie/phpunit-snapshot-assertions": "^2.1.0",
+        "phpstan/phpstan": "^0.9.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "Akaunting\\Module\\": "./src"
+        },
+        "files": [
+            "src/helpers.php"
+        ]
+    },
+    "autoload-dev": {
+        "psr-4": {
+			"Akaunting\\Module\\Tests\\": "tests",
+			"Modules\\Recipe\\": "tests/stubs/valid/Recipe"
+        }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Akaunting\\Module\\Providers\\Laravel"
+            ],
+            "aliases": {
+                "Module": "Akaunting\\Module\\Facade"
+            }
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}
+

phpunit.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         verbose="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+>
+    <testsuites>
+        <testsuite name="Akaunting Module Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+    <logging>
+        <log type="tap" target="build/report.tap"/>
+        <log type="junit" target="build/report.junit.xml"/>
+        <log type="coverage-html" target="build/coverage"/>
+        <log type="coverage-text" target="build/coverage.txt"/>
+        <log type="coverage-clover" target="build/logs/clover.xml"/>
+    </logging>
+</phpunit>

src/Collection.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Akaunting\Module;
+
+use Illuminate\Contracts\Support\Arrayable;
+use Illuminate\Support\Collection as BaseCollection;
+
+class Collection extends BaseCollection
+{
+    /**
+     * Get items collections.
+     *
+     * @return array
+     */
+    public function getItems()
+    {
+        return $this->items;
+    }
+
+    /**
+     * Get the collection of items as a plain array.
+     *
+     * @return array
+     */
+    public function toArray()
+    {
+        return array_map(function ($value) {
+            if ($value instanceof Module) {
+                $attributes = $value->json()->getAttributes();
+                $attributes["path"] = $value->getPath();
+
+                return $attributes;
+            }
+
+            return $value instanceof Arrayable ? $value->toArray() : $value;
+        }, $this->items);
+    }
+}