Enhancement: Add Function to Check Voucher Validity

.gitattributes

@@ -4,8 +4,6 @@
 # Ignore all test and documentation with "export-ignore".
 /.gitattributes     export-ignore
 /.gitignore         export-ignore
-/.travis.yml        export-ignore
 /phpunit.xml.dist   export-ignore
-/.scrutinizer.yml   export-ignore
 /tests              export-ignore
 /.editorconfig      export-ignore

.github/workflows/main.yml

@@ -6,23 +6,66 @@ on:
   pull_request:
     branches: [master]
 
+
 jobs:
-  test:
-    runs-on: ${{ matrix.os }}
+  php-tests:
+    runs-on: ubuntu-latest
+
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest]
-        php: [7.4, 8.0, 8.1]
-        laravel: [8.*, 10.*]
-        stability: [prefer-lowest, prefer-stable]
+        php:
+          - '8.3'
+          - '8.2'
+          - '8.1'
+          - '8.0'
+        laravel:
+          - '10.*'
+          - '9.*'
+          - '8.*'
+        dependency-version:
+          - 'prefer-stable'
+
+        exclude:
+          - laravel: '10.*'
+            php: '8.0'
         include:
-          - laravel: 10.*
-            testbench: ^8.0
-          - laravel: 8.*
-            testbench: ^6.6
+          - laravel: '10.*'
+            php: '8.3'
+            testbench: '8.*'
+          - laravel: '10.*'
+            php: '8.2'
+            testbench: '8.*'
+          - laravel: '10.*'
+            php: '8.1'
+            testbench: '8.*'
+          - laravel: '9.*'
+            php: '8.3'
+            testbench: '7.*'
+          - laravel: '9.*'
+            php: '8.2'
+            testbench: '7.*'
+          - laravel: '9.*'
+            php: '8.1'
+            testbench: '7.*'
+          - laravel: '9.*'
+            php: '8.0'
+            testbench: '7.*'
+          - laravel: '8.*'
+            php: '8.3'
+            testbench: '6.*'
+          - laravel: '8.*'
+            php: '8.2'
+            testbench: '6.*'
+          - laravel: '8.*'
+            php: '8.1'
+            testbench: '6.*'
+          - laravel: '8.*'
+            php: '8.0'
+            testbench: '6.*'
 
-    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
+
+    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.dependency-version }} - ubuntu-latest
 
     steps:
       - name: Checkout code
@@ -32,18 +75,13 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick
           coverage: none
 
-      - name: Setup problem matchers
-        run: |
-          echo "::add-matcher::${{ runner.tool_cache }}/php.json"
-          echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
-
       - name: Install dependencies
         run: |
           composer require "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
-          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+          composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction --no-suggest
 
       - name: Execute tests
         run: vendor/bin/phpunit

README.md

@@ -1,8 +1,6 @@
 # Laravel Vouchers 🎟
 
 [![Latest Version on Packagist](https://img.shields.io/packagist/v/beyondcode/laravel-vouchers.svg?style=flat-square)](https://packagist.org/packages/beyondcode/laravel-vouchers)
-[![Build Status](https://img.shields.io/travis/beyondcode/laravel-vouchers/master.svg?style=flat-square)](https://travis-ci.org/beyondcode/laravel-vouchers)
-[![Quality Score](https://img.shields.io/scrutinizer/g/beyondcode/laravel-vouchers.svg?style=flat-square)](https://scrutinizer-ci.com/g/beyondcode/laravel-vouchers)
 [![Total Downloads](https://img.shields.io/packagist/dt/beyondcode/laravel-vouchers.svg?style=flat-square)](https://packagist.org/packages/beyondcode/laravel-vouchers)
 
 This package can associate vouchers with your Eloquent models. This might come in handy, if you need to associate voucher codes with content that is stored in your Eloquent models.
@@ -130,7 +128,7 @@ class VideoCourse extends Model
     use HasVouchers;
     # ...
 }
-
+```
 ## Creating Vouchers
 
 ### Using the facade
@@ -220,6 +218,14 @@ $voucher = $user->redeemCode('ABCD-EFGH');
 $videoCourse = $voucher->model;
 ```
 
+## Validating Vouchers & Voucher Codes
+The `isValidCode` and `isValidVoucher` methods on the `Vouchers` facade allow you to check if a voucher code is valid or if a voucher model is valid.
+
+```php
+Vouchers::isValidCode('ABCD-EFGH'); // true or false
+Vouchers::isValidVoucher($voucher); // true or false
+```
+
 ## Handling Errors
 
 The `redeemCode` and `redeemVoucher` methods throw a couple of exceptions that you will want to catch and react to in your application:

src/Vouchers.php

@@ -82,6 +82,32 @@ public function check(string $code)
         return $voucher;
     }
 
+    /**
+     * @param string $code
+     * @return bool
+     */
+    public function isValidCode(string $code): bool
+    {
+        try {
+            $this->check($code);
+        } catch (VoucherIsInvalid $exception) {
+            return false;
+        } catch (VoucherExpired $exception) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * @param Voucher $voucher
+     * @return bool
+     */
+    public function isValidVoucher(Voucher $voucher): bool
+    {
+        return $this->isValidCode($voucher->code);
+    }
+
     /**
      * @return string
      */

tests/CanRedeemVouchersTest.php

@@ -101,4 +101,28 @@ public function redeeming_vouchers_fires_an_event()
             return $e->user->id === $user->id && $e->voucher->id === $voucher->id;
         });
     }
+
+    public function test_is_valid_code()
+    {
+        $this->assertFalse(Vouchers::isValidCode('invalid'));
+
+        $item = Item::create(['name' => 'Foo']);
+
+        $voucher = $item->createVoucher();
+
+        $this->assertTrue(Vouchers::isValidCode($voucher->code));
+    }
+
+    public function test_is_valid_voucher()
+    {
+        $item = Item::create(['name' => 'Foo']);
+        $voucher = $item->createVoucher([], today()->subDay());
+
+        $this->assertFalse(Vouchers::isValidVoucher($voucher));
+
+        $item = Item::create(['name' => 'Foo']);
+        $voucher = $item->createVoucher();
+
+        $this->assertTrue(Vouchers::isValidVoucher($voucher));
+    }
 }