Merge branch 'main' into dev

Author: CodeWithSushil

.github/CONTRIBUTING.md

@@ -1 +1,21 @@
-## Contribute
+# Contributing
+
+Thanks for contributing!
+
+## Requirements
+
+- PHP 8.2+
+- Composer
+- PSR-12 Code Style
+
+## How to Contribute
+
+1. Fork & create a branch: `feature/my-feature`
+2. Add tests and changelog if needed
+3. Open a PR and link changelog issue: `#123`
+
+## Checklist
+
+- [ ] Code follows style
+- [ ] CI (PHPStan, PHPUnit) passes
+- [ ] Changelog submitted

.github/ISSUE_TEMPLATE/changelog.yml

@@ -0,0 +1,29 @@
+name: 🔄 Changelog Entry
+description: Suggest a changelog entry
+labels: [changelog]
+body:
+  - type: dropdown
+    attributes:
+      label: Type of change
+      options:
+        - Added
+        - Changed
+        - Deprecated
+        - Removed
+        - Fixed
+        - Security
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Describe the change
+      placeholder: "Added support for X..."
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: Related PR or Issue
+      placeholder: "#123"

.github/ISSUE_TEMPLATE/config.yaml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 🙋 Ask a Question
+    url: https://github.com/your-org/your-repo/discussions
+    about: Ask questions and get help from the community.
+  - name: 🛠️ Contributing Guide
+    url: https://github.com/your-org/your-repo/blob/main/CONTRIBUTING.md
+    about: Learn how to contribute to this project.

.github/workflows/auto-merge.yml

@@ -0,0 +1,24 @@
+name: 🤖 Auto Merge
+
+on:
+  pull_request:
+    types: [labeled, unlabeled, synchronize, opened, reopened]
+
+permissions:
+  pull-requests: write
+  contents: read
+  checks: read
+
+jobs:
+  enable-auto-merge:
+    if: |
+      contains(github.event.pull_request.labels.*.name, 'automerge') &&
+      github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Enable Auto Merge
+        uses: peter-evans/enable-pull-request-automerge@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          merge-method: squash

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: ✅ PHP CI (PHPStan + PHPUnit)
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  tests:
+    name: Run Static Analysis and Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.4
+          extensions: mbstring, xml, pdo, curl
+          tools: phpstan, phpunit
+
+      - name: Install Dependencies
+        run: composer install --no-progress --prefer-dist
+
+      - name: Run PHPStan
+        run:  composer test:type
+
+      - name: Run PHPUnit
+        run: composer test:unit

.gitignore

@@ -6,3 +6,4 @@ composer.lock
 /*.db
 /*.sqlite
 /*.sqlite3
+.phpunit.cache/

composer.json

@@ -34,7 +34,7 @@
           "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
         ],
         "test:unit": "phpunit",
-        "test:type": "phpstan analyse src",
+        "test:type": "phpstan analyse --ansi",
         "test": ["@test:unit", "@test:type"]
     },
     "config": {

config/ErrorHandler.php

@@ -12,7 +12,7 @@
 }
 
 // Custom error handler
-function errorHandler($errNo, $errStr, $errFile, $errLine)
+function errorHandler(string $errNo, string $errStr, string $errFile, string $errLine): mixed
 {
     $errorTypes = [
         E_ERROR             => 'Error',
@@ -41,7 +41,7 @@ function errorHandler($errNo, $errStr, $errFile, $errLine)
 }
 
 // Custom exception handler
-function exceptionHandler(Throwable $exception)
+function exceptionHandler(Throwable $exception): void
 {
     $timestamp = date('Y-m-d H:i:s');
     $message = "[$timestamp] Uncaught Exception: " . $exception->getMessage() .
@@ -54,4 +54,3 @@ function exceptionHandler(Throwable $exception)
 
 set_error_handler('errorHandler');
 set_exception_handler('exceptionHandler');
-

phpstan.neon.dist

@@ -0,0 +1,9 @@
+parameters:
+    level: 6
+
+    reportUnmatchedIgnoredErrors: false
+    treatPhpDocTypesAsCertain: false
+
+    paths:
+        - 'app/'
+

tests/ExampleTest.php

@@ -5,25 +5,29 @@
 namespace Tests;
 
 use PHPUnit\Framework\TestCase;
-use App\App;
+//use App\App;
 
 final class ExampleTest extends TestCase
 {
     private $app;
 
+   /*
     public function setUp(): void
     {
         $this->app = new App("sushil");
        // $this->app->getName();
     }
+    */
 
     public function testTwoNumbersAreSame(): void
     {
         $this->assertSame(1, 1);
     }
 
+    /*
     public function testSetName()
     {
         $this->assertSame('sushil', $this->app->getName());
     }
+     */
 }