Badges 1976650070

.env

@@ -0,0 +1,4 @@
+# Database Configuration
+NEO4J_ADDRESS=https://6f72daa1.databases.neo4j.io/
+NEO4J_USERNAME=neo4j
+NEO4J_PASSWORD=O9lWmptqBgxBOz8NVcTJjgs3cHPyYmsy63ui6Spmw1d0

.github/workflows/codecov.yml

@@ -0,0 +1,36 @@
+name: Code Coverage
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.1'
+
+      - name: Install dependencies
+        run: composer install
+
+      - name: Run tests and collect coverage
+        run: vendor/bin/phpunit --coverage-clover coverage.xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          fail_ci_if_error: true
+          verbose: true

.github/workflows/cs-fixer.yml

@@ -0,0 +1,26 @@
+name: PHP CS Fixer
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  php-cs-fixer:
+    name: PHP CS Fixer
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.1
+          tools: composer
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist
+
+      - name: Run PHP CS Fixer
+        run: vendor/bin/php-cs-fixer fix --dry-run --diff --allow-risky=yes

.github/workflows/psalm.yml

@@ -0,0 +1,27 @@
+name: Psalm Static Analysis
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  psalm:
+    name: Run Psalm
+    runs-on: ubuntu-latest
+
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.1
+          tools: composer, psalm
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist
+
+      - name: Run Psalm
+        run: vendor/bin/psalm --output-format=github

.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: PHP Tests
+
+on:
+  push:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tests:
+    services:
+      neo4j:
+        image: neo4j:latest
+        ports:
+          - 7474:7474
+          - 7687:7687
+        env:
+          NEO4J_AUTH: neo4j/password
+        options: >-
+          --health-cmd "wget --no-verbose --tries=1 --spider localhost:7474 || exit 1"
+          --health-interval 10s
+          --health-retries 5
+          --health-timeout 5s
+
+    name: Run PHPUnit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.1
+          tools: composer, xdebug
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: ${{ runner.os }}-composer-${{ hashFiles('composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --no-progress --prefer-dist
+
+      - name: Run Tests without phpunit.xml
+        env:
+          NEO4J_ADDRESS: "http://localhost:7474"
+          NEO4J_USERNAME: "neo4j"
+          NEO4J_PASSWORD: "password"
+        run: vendor/bin/phpunit --configuration phpunit.dist.xml

.github/workflows/ci.yml → .github/workflows/testaura.yml

@@ -1,28 +1,29 @@
-name: CI Pipeline
+name: Test Neo4j Aura
 
 on:
   push:
     branches:
       - main
-  pull_request:
+  workflow_dispatch: # Allows manual trigger
 
 concurrency:
-  group: ${{ github.ref }}
+  group: neo4j-aura-test-main
   cancel-in-progress: true
 
 jobs:
-  tests:
-    name: Run PHPUnit Tests
+  tests-aura:
+    name: Run PHPUnit Tests with Neo4j Aura
     runs-on: ubuntu-latest
 
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
 
       - name: Set up PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.1
           tools: composer, xdebug
 
       - name: Cache Composer dependencies
@@ -35,7 +36,9 @@ jobs:
       - name: Install dependencies
         run: composer install --no-progress --prefer-dist
 
-
-
-      - name: Run Tests without phpunit.xml
+      - name: Run Tests
+        env:
+          NEO4J_ADDRESS: ${{ secrets.NEO4J_ADDRESS }}
+          NEO4J_USERNAME: ${{ secrets.NEO4J_USERNAME }}
+          NEO4J_PASSWORD: ${{ secrets.NEO4J_PASSWORD }}
         run: vendor/bin/phpunit --configuration phpunit.dist.xml

.gitignore

@@ -1,5 +1,20 @@
+
+#IDE
 .idea/
+
+#COMPOSER
 vendor
+
+#PHPUNIT
 phpunit.xml
 test
-.phpunit.result.cache
+.phpunit.result.cache
+
+#PHP-CS-FIXER
+.php-cs-fixer.php
+.php-cs-fixer.cache
+
+
+coverage
+
+composer.lock

.php-cs-fixer.dist.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+
+return (new Config())
+    ->setRules([
+        '@PSR12' => true,
+    ])
+    ->setFinder(
+        Finder::create()
+            ->in(__DIR__)
+            ->exclude([
+                'vendor',
+            ])
+    );

.php-cs-fixer.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+
+return (new Config())
+    ->setRiskyAllowed(true) // Allow risky fixers
+    ->setRules([
+        '@PSR12' => true,
+        'strict_param' => true, // This is a risky rule
+    ])
+    ->setFinder(
+        Finder::create()
+            ->in(__DIR__)
+            ->exclude([
+                'vendor',
+            ])
+    );

Contributing.md

@@ -0,0 +1,102 @@
+# Contributing to Neo4j QueryAPI he PHP Client
+
+Thank you for your interest in contributing to the Neo4j QueryAPI PHP Client! We welcome all contributions, whether it's bug fixes, feature enhancements, or documentation improvements.
+
+## Getting Started
+
+1. **Fork the Repository**\
+
+
+Click the "Fork" button at the top right of the repository page.
+
+2. **Clone Your Fork**
+
+   ```bash
+   git clone https://github.com/your-username/Neo4j-Client.git
+   cd Neo4j-Client
+   ```
+
+3. **Set Up the Environment**
+
+
+
+   - Ensure you have PHP installed (compatible with PHP < 8.1).
+   - Install dependencies using Composer:
+
+   ```bash
+    composer install
+   ```
+
+- Copy the `phpunit.dist.xml` file to `phpunit.xml` and configure the necessary environment variables like `NEO4J_ADDRESS`, `NEO4J_USERNAME`, `NEO4J_PASSWORD`.
+
+
+
+
+4. **Run Tests**
+
+
+   - Ensure you have PHP installed (compatible with PHP < 8.1).
+   - Install dependencies using Composer:
+
+   ```bash
+   composer install
+   ```
+
+## Code Guidelines
+
+- Ensure your code is **PSR-12 compliant**.
+- Use **Psalm** for static analysis. Run:
+  ```bash
+  composer psalm
+  ```
+- Apply **code style fixes** using:
+  ```bash
+  composer cs:fix
+  ```
+
+## Making Changes
+
+1. **Create a New Branch**\
+   Use a descriptive branch name:
+
+   ```bash
+   git checkout -b fix/issue-123
+   ```
+
+2. **Make Your Edits**\
+   Ensure all tests pass and code is properly formatted.
+
+3. **Commit Your Changes**\
+   Write clear commit messages:
+
+   ```bash
+   git commit -m "Fix: Corrected query parsing for ProfiledQueryPlan"
+   ```
+
+4. **Push Your Branch**
+
+   ```bash
+   git push origin fix/issue-123
+   ```
+
+## Submitting a Pull Request
+
+1. Go to your forked repository on GitHub.
+2. Click on the "New pull request" button.
+3. Select your branch and submit the pull request.
+4. Add a clear description of the changes you made.
+
+## Review Process
+
+- All PRs are reviewed by the maintainers.
+- Ensure CI tests pass before requesting a review.
+- Be open to feedback and make revisions as needed.
+
+## Reporting Issues
+
+If you spot a bug or want to suggest a new feature, please [open an issue](https://github.com/NagelsIT/Neo4j-Client/issues) and provide detailed information.
+
+---
+
+We appreciate your contribution — let’s build something powerful together!
+

Dockerfile

@@ -0,0 +1,13 @@
+# Use an official PHP image as the base image
+FROM php:8.1-cli
+
+# Install necessary extensions (e.g., for Composer)
+RUN apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev git libzip-dev zip \
+    && docker-php-ext-configure gd --with-freetype --with-jpeg \
+    && docker-php-ext-install gd zip
+
+# Set working directory
+WORKDIR /var/www
+
+# Copy the composer.phar file to the container
+COPY --from=composer:latest /usr/bin/composer /usr/bin/composer