v4

.github/workflows/php-cs-fixer.yaml

@@ -0,0 +1,35 @@
+name: php-cs-fixer
+
+on:
+ push:
+ branches: [ master ]
+ pull_request:
+ branches: [ master ]
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+
+ strategy:
+ matrix:
+ include:
+ - { operating-system: 'ubuntu-latest', php-version: '8.1', dependencies: '--ignore-platform-req=php' }
+
+ name: PHP ${{ matrix.php-version }}
+
+ steps:
+ - uses: actions/checkout@v2
+
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php-version }}
+ coverage: pcov
+ tools: composer:v2
+
+ - name: Install dependencies
+ run: |
+ composer install --no-interaction --prefer-dist --no-progress ${{ matrix.dependencies }}
+ - name: Check code style
+ run: |
+ php vendor/bin/php-cs-fixer --using-cache=no --diff --dry-run --stop-on-violation --verbose fix

.github/workflows/phpunit.yaml

@@ -0,0 +1,36 @@
+name: PHPUnit
+
+on:
+ push:
+ branches: [ master ]
+ pull_request:
+ branches: [ master ]
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+
+ strategy:
+ matrix:
+ include:
+ - { operating-system: 'ubuntu-latest', php-version: '8.0', dependencies: '--ignore-platform-req=php' }
+ - { operating-system: 'ubuntu-latest', php-version: '8.1', dependencies: '--ignore-platform-req=php' }
+
+ name: PHP ${{ matrix.php-version }}
+
+ steps:
+ - uses: actions/checkout@v2
+
+ - name: Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php-version }}
+ coverage: pcov
+ tools: composer:v2
+
+ - name: Install dependencies
+ run: |
+ composer install --no-interaction --prefer-dist --no-progress ${{ matrix.dependencies }}
+ - name: Run tests
+ run: |
+ php vendor/bin/phpunit tests

.gitignore

@@ -1,3 +1,3 @@
 .idea
 vendor
-.php_cs.cache
+.php-cs-fixer.cache

.php-cs-fixer.dist.php

@@ -0,0 +1,19 @@
+<?php
+
+return (new PhpCsFixer\Config())
+ ->setRiskyAllowed(false)
+ ->setRules([
+ '@PSR2' => true,
+ '@Symfony' => true,
+ '@PhpCsFixer' => true,
+ '@DoctrineAnnotation' => true,
+ 'concat_space' => ['spacing' => 'one'],
+
+ ])
+ ->setFinder(
+ PhpCsFixer\Finder::create()
+ ->in(__DIR__ . '/src')
+ ->in(__DIR__ . '/examples')
+ ->in(__DIR__ . '/generators')
+ ->in(__DIR__ . '/tests')
+ );

README.md

@@ -15,19 +15,32 @@ composer require easybill/php-sdk
 ## Usage
 
 ```php
-use easybill\SDK\Client;
-use easybill\SDK\Endpoint;
+use Easybill\SDK\Client;
+use Easybill\SDK\Endpoint;
+use Easybill\SDK\Models\Customer;
 
 $client = new Client(new Endpoint('... your API key ...'));
 
-$result = $client->request('GET', 'documents');
+$customerCreate = new Customer();
+$customerCreate->setFirstName('Foo');
+$customerCreate->setLastName('Bar');
+$customerCreate->setCompanyName('FooBar GmbH');
+$customerCreate->setEmails(['[email protected]']);
 
-print_r($result);
+$result = $client->request('POST', 'customers', $customerCreate->toArray());
+
+$customer = new Customer($result);
+
+var_dump($customer)
 ```
 
 ## More examples
 
-Check the **examples** folder.
+Check the [examples](examples) folder and run:
+
+```shell
+API_KEY=<your_api_key> php examples/customers_01_load-list.php
+```
 
 ## Documentation
 

UPGRADE.md

@@ -0,0 +1,8 @@
+easybill PHP SDK Upgrade Guide
+==============================
+
+3.0 to 4.0
+----------
+
+- Namespace from `easybill\` to `Easybill\`
+- Requires min PHP 8.0

composer.json

@@ -1,6 +1,6 @@
 {
  "name": "easybill/php-sdk",
- "description": "easybill PHP SDK (API)",
+ "description": "easybill PHP SDK (REST API)",
  "keywords": [
  "PHP",
  "easybill",
@@ -19,16 +19,36 @@
  }
  ],
  "require": {
- "php": "^7.4 || ^8.0",
+ "php": "^8.0 || ^8.1",
  "ext-json": "*",
- "guzzlehttp/guzzle": "^7.3"
+ "guzzlehttp/guzzle": "^7.4"
  },
  "autoload": {
  "psr-4": {
- "easybill\\SDK\\": "src/"
+ "Easybill\\SDK\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Easybill\\SDK\\Tests\\": "tests/"
  }
  },
  "require-dev": {
- "friendsofphp/php-cs-fixer": "^2.17"
+ "friendsofphp/php-cs-fixer": "^3.4",
+ "nette/php-generator": "^3.6",
+ "phpunit/phpunit": "^9.5"
+ },
+ "scripts": {
+ "sdk:models": [
+ "@php generators/models.php",
+ "@sdk:cs-fix"
+ ],
+ "sdk:cs-fix": "./vendor/bin/php-cs-fixer fix",
+ "sdk:test": "./vendor/bin/phpunit tests"
+ },
+ "scripts-descriptions": {
+ "sdk:models": "Gnerate models from swagger.json file.",
+ "sdk:cs-fix": "Run php-cs-fixer to reformat php files.",
+ "sdk:test": "Run test with PHPUnit"
  }
 }