WIP

Author: sebastiaanluca

.github/ISSUE_TEMPLATE/BUG_REPORT.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Create a report to help us improve this project
+title: ''
+labels: bug
+assignees: sebastiaanluca
+---
+
+### Description
+
+### Expected result
+
+### Steps to reproduce
+
+1.
+2.
+3.
+
+### Traces
+
+Logs, error output, etc.
+
+### Environment information
+
+Setup, environment, packages, versions, etc.

.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: feature
+assignees: sebastiaanluca
+---
+
+### Description
+
+A clear and concise description of the problem or proposal.
+
+### Suggested solution
+
+A clear and concise description of what you want to happen.
+
+### Possible alternatives
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+### Additional context
+
+Any other context or screenshots to help situate and understand the requested feature.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,37 @@
+---
+name: Pull request
+about: Create a new pull request to merge code into the main branch
+title: 'A short, descriptive title'
+labels: ''
+assignees: sebastiaanluca
+---
+
+## PR Type
+
+What kind of pull request is this? Put an `x` in all the boxes that apply:
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Extend feature (non-breaking change which extends existing functionality)
+- [ ] Change feature (non-breaking change which either changes or refactors existing functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+
+---
+
+### Description
+
+Clearly describe what this pull request changes and why.
+
+### Steps to follow to verify functionality
+
+1. Clearly state which actions should be performed to fully and correctly review this issue.
+2. …
+
+### Related issues
+
+Link to the issue(s) this pull request handles.
+
+### Related PRs
+
+Link to any related pull requests.
+

.github/workflows/test.yml

@@ -0,0 +1,50 @@
+name: test
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: '0 0 * * *'
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [8.0]
+        laravel: [8.*]
+        dependency-version: [prefer-lowest, prefer-stable]
+        os: [ubuntu-latest]
+        include:
+          - laravel: 8.*
+            testbench: 6.*
+
+    name: PHP ${{ matrix.php }} - Laravel ${{ matrix.laravel }} - ${{ matrix.dependency-version }} - ${{ matrix.os }}
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          path: ~/.composer/cache/files
+          key: dependencies-${{ runner.os }}-laravel-${{ matrix.laravel }}-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+
+      - name: Validate Composer configuration file
+        run: composer validate --strict
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: curl, mbstring, pdo
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction
+
+      - name: Execute tests
+        run: vendor/bin/phpunit

.gitignore

@@ -2,3 +2,4 @@ composer.phar
 composer.lock
 vendor
 tests/files/
+/.idea

CHANGELOG.md

@@ -4,7 +4,18 @@ All Notable changes to `sebastiaanluca/php-helpers` will be documented in this f
 
 Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
-## Unreleased
+## 3.0.0 (2021-03-11)
+
+### Added
+
+- Added support for PHP 8
+
+### Removed
+
+- Dropped support for PHP 7.4 and lower
+- Dropped support for Carbon 1.x
+- Removed Kint package requirement
+- Removed debug helpers
 
 ## 2.0.0 (2019-02-27)
 

README.md

@@ -28,11 +28,6 @@
     - [has\_public\_method](#has_public_method)
     - [carbon](#carbon)
     - [temporary_file](#temporary_file)
-- [Debug global helper functions](#debug-global-helper-functions)
-    - [sss](#sss)
-    - [ddd](#ddd)
-    - [sss_if](#sss_if)
-    - [ddd_if](#ddd_if)
 - [Class helpers](#class-helpers)
     - [Constants trait](#constants-trait)
         - [Retrieving constants](#retrieving-constants)
@@ -300,82 +295,6 @@ temporary_file();
 */
 ```
 
-## Global debug helper functions
-
-### sss
-
-Display structured debug information about one or more values **in plain text** using Kint and halt script execution afterwards. Accepts multiple arguments to dump.
-
-Output will be identical to `ddd` when used in a command line interface. In a browser, it'll display plain, but structured text.
-
-Requires the [kint-php/kint](https://github.com/raveren/kint) package.
-
-```php
-sss('string');
-
-/*
-┌─────────────────────────────────────────┐
-│ literal                                 │
-└─────────────────────────────────────────┘
-string (6) "string"
-═══════════════════════════════════════════
-Called from .../src/MyClass.php:42
-*/
-
-sss('string', 0.42, ['array']);
-
-/*
-┌─────────────────────────────────────────┐
-│ literal                                 │
-└─────────────────────────────────────────┘
-string (6) "string"
-┌─────────────────────────────────────────┐
-│ literal                                 │
-└─────────────────────────────────────────┘
-double 0.42
-┌─────────────────────────────────────────┐
-│ literal                                 │
-└─────────────────────────────────────────┘
-array (1) [
-    0 => string (5) "array"
-]
-═══════════════════════════════════════════
-Called from .../src/MyClass.php:42
-*/
-```
-
-### ddd
-
-Display structured debug information about one or more values using Kint and halt script execution afterwards. Accepts multiple arguments to dump. Output will be identical to `sss` when used in a command line interface. In a browser, it'll display an interactive, structured tree-view.
-
-Requires the [kint-php/kint](https://github.com/raveren/kint) package.
-
-See the [sss helper](#sss) for example output.
-
-### sss_if
-
-Display structured debug information about one or more values **in plain text** using Kint and halt script execution afterwards, but only if the condition is truthy. Does nothing if falsy. Accepts multiple arguments to dump.
-
-Requires the [kint-php/kint](https://github.com/raveren/kint) package.
-
-```php
-sss_if($user->last_name, 'User has a last name', $user->last_name);
-```
-
-See the [sss helper](#sss) for example output.
-
-### ddd_if
-
-Display structured debug information about one or more values using Kint and halt script execution afterwards, but only if the condition is truthy. Does nothing if falsy. Accepts multiple arguments to dump.
-
-Requires the [kint-php/kint](https://github.com/raveren/kint) package.
-
-```php
-ddd_if(app()->environment('local'), 'Debugging in a local environment!');
-```
-
-See the [ddd helper](#ddd) for example output.
-
 ## Class helpers
 
 ### Enum trait

composer.json

@@ -23,24 +23,21 @@
         }
     ],
     "require": {
-        "php": "^7.2"
+        "php": "^8.0"
     },
     "require-dev": {
-        "kint-php/kint": "^3.3",
-        "nesbot/carbon": "^1.22|^2.0",
-        "phpunit/phpunit": "^8.5"
+        "nesbot/carbon": "^2.0",
+        "phpunit/phpunit": "^9.5"
     },
     "suggest": {
-        "kint-php/kint": "A powerful and modern PHP debugging tool. Required for the debug helpers.",
         "nesbot/carbon": "A simple PHP API extension for DateTime. Required for the carbon helper."
     },
     "autoload": {
         "psr-4": {
             "SebastiaanLuca\\PhpHelpers\\": "src"
         },
         "files": [
-            "src/Functions/generic.php",
-            "src/Functions/debug.php"
+            "src/Functions/generic.php"
         ]
     },
     "autoload-dev": {

phpunit.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
+    bootstrap="vendor/autoload.php"
+    backupGlobals="false"
+    backupStaticAttributes="false"
+    colors="true"
+    verbose="true"
+    processIsolation="false"
+    convertErrorsToExceptions="true"
+    convertNoticesToExceptions="true"
+    convertWarningsToExceptions="true"
+    beStrictAboutTestsThatDoNotTestAnything="true"
+    beStrictAboutOutputDuringTests="true"
+    stopOnFailure="false"
+    failOnRisky="true"
+    failOnWarning="true"
+    stopOnError="false"
+    cacheResult="false">
+    <coverage>
+        <include>
+            <directory suffix=".php">src/</directory>
+        </include>
+    </coverage>
+    <testsuites>
+        <testsuite name="Unit Tests">
+            <directory suffix="Test.php">./tests/Unit</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>