Merge pull request #11 from DutchCodingCompany/v1

V1

Author: dododedodonl

.php-cs-fixer.php

@@ -170,6 +170,9 @@
         ],
     ],
     'trim_array_spaces' => true,
+    'types_spaces' => [
+        'space' => 'single',
+    ],
     'unary_operator_spaces' => true,
     'visibility_required' => [
         'elements' => [
@@ -188,12 +191,9 @@
 
 $finder = Finder::create()
     ->in([
-        __DIR__.'/app',
-        __DIR__.'/config',
-        __DIR__.'/database',
-        __DIR__.'/resources',
-        __DIR__.'/routes',
-        __DIR__.'/tests',
+        __DIR__ . '/src',
+        __DIR__ . '/config',
+        __DIR__ . '/tests',
     ])
     ->name('*.php')
     ->notName('*.blade.php')

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `laravel-hetzner-dns-api` will be documented in this file.
 
+## 1.0.0 - 2023-11-07
+
+### Changes
+- renamed `\DutchCodingCompany\HetznerDnsClient\RequestCollections\RecordCollection` to `\DutchCodingCompany\HetznerDnsClient\Resources\RecordResource`
+- renamed `\DutchCodingCompany\HetznerDnsClient\RequestCollections\ZoneCollection` to `\DutchCodingCompany\HetznerDnsClient\Resources\ZoneResource`
+- removed `bensampo/laravel-enum` package, `\DutchCodingCompany\HetznerDnsClient\Enums\RecordType` is now a native enum
+- dropped support for laravel 8.0
+- added support for laravel 10.0
+- removed `spatie/data-transfer-object`
+
 ## 0.1.0 - 2022-06-23
 
 Initial release

README.md

@@ -2,8 +2,6 @@
 # An unofficial PHP SDK for the Hetzner DNS API.
 
 [![Latest Version on Packagist](https://img.shields.io/packagist/v/dutchcodingcompany/laravel-hetzner-dns-api.svg?style=flat-square)](https://packagist.org/packages/dutchcodingcompany/laravel-hetzner-dns-api)
-[![GitHub Tests Action Status](https://img.shields.io/github/workflow/status/dutchcodingcompany/laravel-hetzner-dns-api/run-tests?label=tests)](https://github.com/dutchcodingcompany/laravel-hetzner-dns-api/actions?query=workflow%3Arun-tests+branch%3Amain)
-[![GitHub Code Style Action Status](https://img.shields.io/github/workflow/status/dutchcodingcompany/laravel-hetzner-dns-api/Check%20&%20fix%20styling?label=code%20style)](https://github.com/dutchcodingcompany/laravel-hetzner-dns-api/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain)
 [![Total Downloads](https://img.shields.io/packagist/dt/dutchcodingcompany/laravel-hetzner-dns-api.svg?style=flat-square)](https://packagist.org/packages/dutchcodingcompany/laravel-hetzner-dns-api)
 
 This PHP/Laravel client around the [Hetzner DNS API](https://dns.hetzner.com/api-docs) support:
@@ -21,24 +19,36 @@ You can install the package via composer:
 composer require dutchcodingcompany/laravel-hetzner-dns-api
 ```
 
+Set your hetzner dns api token in your .env file:
+```env
+HETZNER_DNS_API_TOKEN=hetzner-dns-token-here
+```
+
+## Configuration (optional)
 You can publish the config file with:
 
 ```bash
-php artisan vendor:publish --tag="laravel-hetzner-dns-api-config"
+php artisan vendor:publish --tag="hetzner-dns-api-config"
 ```
 
-This is the contents of the published config file:
-
-```php
-return [
-    'api_token' => env('HETZNER_DNS_API_TOKEN')
-];
-```
+This is the contents of the published config file [can be found here](config/hetzner-dns.php).
 
 If you would like to store the API Token outside of the config (e.g. encrypted in the database), you can override the resolver in the `boot` method of the `AppServiceProvider`
 ```php
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
 use DutchCodingCompany\HetznerDnsClient\HetznerDnsClient;
-HetznerDnsClient::resolveApiTokenUsing(fn () => 'your-token');
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        HetznerDnsClient::resolveApiTokenUsing(fn () => 'your-token');
+    }
+}
 ```
 
 ## Usage
@@ -49,18 +59,9 @@ $records = HetznerDnsClient::records()->all();
 ```
 
 ## ToDo
-- Caching
+- add caching
 - ...
 
-[//]: # (## Testing)
-
-[//]: # ()
-[//]: # (```bash)
-
-[//]: # (composer test)
-
-[//]: # (```)
-
 ## Changelog
 
 Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

composer.json

@@ -13,15 +13,18 @@
             "name": "Niek Brekelmans",
             "email": "[email protected]",
             "role": "Developer"
+        },
+        {
+            "name": "Tom Janssen",
+            "email": "[email protected]",
+            "role": "Developer"
         }
     ],
     "require": {
-        "php": "^8.0",
-        "bensampo/laravel-enum": "^4.2|^5.3",
-        "illuminate/contracts": "^8.0|^9.0",
-        "sammyjo20/saloon-laravel": "^1.4",
-        "spatie/data-transfer-object": "^3.8",
-        "spatie/laravel-package-tools": "^1.9.2"
+        "php": "^8.1",
+        "illuminate/contracts": "^9.0 | ^10.0",
+        "saloonphp/saloon": "^3.0",
+        "spatie/laravel-package-tools": "^1.16.1"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.8",

config/hetzner-dns.php

@@ -1,4 +1,5 @@
 <?php
+
 // config for DutchCodingCompany/HetznerDnsClient
 return [
     'api_token' => env('HETZNER_DNS_API_TOKEN'),
@@ -7,5 +8,5 @@
         env('HETZNER_NAMESERVER_1', 'hydrogen.ns.hetzner.com.'),
         env('HETZNER_NAMESERVER_2', 'oxygen.ns.hetzner.com.'),
         env('HETZNER_NAMESERVER_3', 'helium.ns.hetzner.de.'),
-    ]
+    ],
 ];

phpstan-baseline.neon

@@ -1,12 +1,8 @@
-includes:
-    - phpstan-baseline.neon
-
 parameters:
-    level: 4
+    level: 8
     paths:
         - src
         - config
-        - database
     tmpDir: build/phpstan
     checkOctaneCompatibility: true
     checkModelProperties: true

phpstan.neon.dist

@@ -2,38 +2,20 @@
 
 namespace DutchCodingCompany\HetznerDnsClient\Enums;
 
-use BenSampo\Enum\Enum;
-
-/**
- * @method static static A()
- * @method static static AAAA()
- * @method static static NS()
- * @method static static MX()
- * @method static static CNAME()
- * @method static static RP()
- * @method static static TXT()
- * @method static static SOA()
- * @method static static HINFO()
- * @method static static SRV()
- * @method static static DANE()
- * @method static static TLSA()
- * @method static static DS()
- * @method static static CAA()
- */
-final class RecordType extends Enum
+enum RecordType: string
 {
-    public const A = 'A';
-    public const AAAA = 'AAAA';
-    public const NS = 'NS';
-    public const MX = 'MX';
-    public const CNAME = 'CNAME';
-    public const RP = 'RP';
-    public const TXT = 'TXT';
-    public const SOA = 'SOA';
-    public const HINFO = 'HINFO';
-    public const SRV = 'SRV';
-    public const DANE = 'DANE';
-    public const TLSA = 'TLSA';
-    public const DS = 'DS';
-    public const CAA = 'CAA';
+    case A = 'A';
+    case AAAA = 'AAAA';
+    case NS = 'NS';
+    case MX = 'MX';
+    case CNAME = 'CNAME';
+    case RP = 'RP';
+    case TXT = 'TXT';
+    case SOA = 'SOA';
+    case HINFO = 'HINFO';
+    case SRV = 'SRV';
+    case DANE = 'DANE';
+    case TLSA = 'TLSA';
+    case DS = 'DS';
+    case CAA = 'CAA';
 }

src/Enums/RecordType.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace DutchCodingCompany\HetznerDnsClient\Exceptions;
+
+interface HetznerDnsApiException
+{
+    //
+}

src/Exceptions/HetznerDnsApiException.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace DutchCodingCompany\HetznerDnsClient\Exceptions;
+
+use InvalidArgumentException as BaseInvalidArgumentException;
+
+class InvalidArgumentException extends BaseInvalidArgumentException implements HetznerDnsApiException
+{
+    //
+}