add github action

Author: farhadzand

.gitattributes

@@ -0,0 +1,17 @@
+# Path-based git attributes
+# https://www.kernel.org/pub/software/scm/git/docs/gitattributes.html
+
+# Ignore all test and documentation with "export-ignore".
+/.github                export-ignore
+/.gitattributes         export-ignore
+/.gitignore             export-ignore
+/phpunit.xml.dist       export-ignore
+/pint.json              export-ignore
+/phpstan.neon           export-ignore
+/tests                  export-ignore
+/docs                   export-ignore
+/art                    export-ignore
+/.editorconfig          export-ignore
+
+# Configure diff output for .php files.
+*.php diff=php 

.github/workflows/coding-standards.yml

@@ -0,0 +1,32 @@
+name: Coding Standards
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  lint:
+    name: PHP CS & Static Analysis
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.2
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, bcmath, intl
+          coverage: none
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction --no-progress
+
+      - name: Check code style with Laravel Pint
+        run: vendor/bin/pint --test
+
+      - name: Run PHPStan
+        run: vendor/bin/phpstan analyse 

.github/workflows/tests.yml

@@ -0,0 +1,58 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  schedule:
+    - cron: '0 0 * * *'  # Run daily at midnight
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        php: [8.2, 8.3, 8.4]
+        laravel: [11.*, 12.*]
+        stability: [prefer-lowest, prefer-stable]
+        exclude:
+          # Skip incompatible PHP versions and Laravel versions
+          - php: 8.2
+            laravel: 12.*
+          - php: 8.4
+            stability: prefer-lowest
+
+    name: PHP ${{ matrix.php }} - Laravel ${{ matrix.laravel }} - ${{ matrix.stability }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, intl, exif, iconv
+          coverage: xdebug
+          ini-values: error_reporting=E_ALL
+
+      - name: Setup problem matchers
+        run: |
+          echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+          echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+      - name: Install dependencies
+        run: |
+          composer require "laravel/framework:${{ matrix.laravel }}" --no-interaction --no-update
+          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+
+      - name: Run PHPUnit tests
+        run: vendor/bin/phpunit --coverage-text
+
+      - name: Run PHP Static Analysis
+        run: |
+          if [ -f vendor/bin/phpstan ]; then
+            vendor/bin/phpstan analyze
+          fi 

README.md

@@ -400,6 +400,44 @@ For MongoDB, collections are created with similar fields and appropriate indexes
    composer require mongodb/laravel-mongodb
    ```
 
+## Development
+
+### Testing
+
+Run the tests with:
+
+```bash
+composer test
+```
+
+### Code Style
+
+This package follows the Laravel coding style. You can check and fix the code style with:
+
+```bash
+# Check code style
+composer pint:test
+
+# Fix code style issues
+composer pint
+```
+
+### Static Analysis
+
+Run static analysis with PHPStan:
+
+```bash
+composer analyse
+```
+
+### Continuous Integration
+
+This package uses GitHub Actions for continuous integration. The following checks are run on each push and pull request:
+
+- **Tests**: PHPUnit tests against multiple PHP and Laravel versions
+- **Coding Standards**: Laravel Pint for code style
+- **Static Analysis**: PHPStan for static analysis
+
 ## License
 
 The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

composer.json

@@ -21,7 +21,10 @@
     "require-dev": {
         "phpunit/phpunit": "^10.0|^11.0",
         "orchestra/testbench": "^8.0|^9.0",
-        "mockery/mockery": "^1.6"
+        "mockery/mockery": "^1.6",
+        "phpstan/phpstan": "^1.10",
+        "phpstan/phpstan-strict-rules": "^1.5",
+        "laravel/pint": "^1.13"
     },
     "autoload": {
         "psr-4": {
@@ -40,6 +43,16 @@
             ]
         }
     },
+    "scripts": {
+        "test": "vendor/bin/phpunit",
+        "analyse": "vendor/bin/phpstan analyse",
+        "pint": "vendor/bin/pint",
+        "pint:test": "vendor/bin/pint --test",
+        "cs": [
+            "@pint",
+            "@analyse"
+        ]
+    },
     "minimum-stability": "stable",
     "prefer-stable": true
 }

phpstan.neon

@@ -0,0 +1,15 @@
+includes:
+    - vendor/phpstan/phpstan-strict-rules/rules.neon
+
+parameters:
+    level: 5
+    paths:
+        - src
+
+    checkMissingIterableValueType: false
+    checkGenericClassInNonGenericObjectType: false
+    reportUnmatchedIgnoredErrors: false
+
+    ignoreErrors:
+        # Add specific error patterns to ignore if needed
+        - '#PHPDoc tag @var#' 

pint.json

@@ -0,0 +1,13 @@
+{
+    "preset": "laravel",
+    "rules": {
+        "declare_strict_types": true,
+        "single_trait_insert_per_statement": true,
+        "fully_qualified_strict_types": true,
+        "final_class": true,
+        "ordered_imports": {
+            "sort_algorithm": "length"
+        },
+        "no_unused_imports": true
+    }
+}