Merge pull request #16 from borkweb/add/composer-json

Add composer.json with PHP 7.4+ support, phpcs, phpstan, and phpunit

Author: JasonTheAdams

composer.json

@@ -0,0 +1,64 @@
+{
+    "name": "wordpress/php-ai-client",
+    "description": "A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.",
+    "license": "GPL-2.0-or-later",
+    "type": "library",
+    "keywords": [
+        "ai",
+        "api",
+        "llm"
+    ],
+    "authors": [
+        {
+            "name": "WordPress AI Team",
+            "homepage": "https://make.wordpress.org/ai/"
+        }
+    ],
+    "homepage": "https://github.com/WordPress/php-ai-client",
+    "support": {
+        "issues": "https://github.com/WordPress/php-ai-client/issues",
+        "source": "https://github.com/WordPress/php-ai-client"
+    },
+    "require": {
+        "php": ">=7.4",
+        "ext-json": "*"
+    },
+    "require-dev": {
+        "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
+        "phpstan/phpstan": "~2.1",
+        "phpunit/phpunit": "^9.5 || ^10.0",
+        "squizlabs/php_codesniffer": "^3.7"
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "autoload": {
+        "psr-4": {
+            "WordPress\\AiClient\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "WordPress\\AiClient\\Tests\\": "tests/"
+        }
+    },
+    "config": {
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true
+        },
+        "optimize-autoloader": true,
+        "platform": {
+            "php": "7.4"
+        },
+        "sort-packages": true
+    },
+    "scripts": {
+        "lint": [
+            "@phpcs",
+            "@phpstan"
+        ],
+        "phpcbf": "phpcbf",
+        "phpcs": "phpcs",
+        "phpstan": "phpstan analyze",
+        "phpunit": "phpunit"
+    }
+}

phpcs.xml.dist

@@ -0,0 +1,25 @@
+<?xml version="1.0"?>
+<ruleset name="PHP AI Client Coding Standards">
+    <description>PSR-12 coding standards for PHP AI Client SDK</description>
+
+    <!-- Scan these files -->
+    <file>src</file>
+
+    <!-- Ignore vendor directory -->
+    <exclude-pattern>*/vendor/*</exclude-pattern>
+
+    <!-- Use PSR-12 standard -->
+    <rule ref="PSR12"/>
+
+    <!-- Show progress, show sniff codes in all reports -->
+    <arg value="sp"/>
+
+    <!-- Set minimum supported PHP version -->
+    <config name="testVersion" value="7.4-"/>
+
+    <!-- Enable colors in output -->
+    <arg name="colors"/>
+
+    <!-- Check PHP syntax -->
+    <arg name="parallel" value="8"/>
+</ruleset>

phpstan.neon.dist

@@ -0,0 +1,4 @@
+parameters:
+    level: max
+    paths:
+        - src

src/DummyForAnalysis.php

@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * DummyForAnalysis class file.
+ *
+ * @package WordPress\AiClient
+ */
+
+declare(strict_types=1);
+
+namespace WordPress\AiClient;
+
+/**
+ * Class DummyForAnalysis
+ *
+ * This is a dummy class for testing that phpcs and phpstan are working.
+ * It should be removed once we have a real class.
+ */
+class DummyForAnalysis
+{
+    public function dummy(): void
+    {
+        // Placeholder.
+    }
+}