AutoCast flags (#48)

* Boolean flags auto-casting

* Timestamp flags auto-casting

Author: antonkomarev

CHANGELOG.md

@@ -7,6 +7,7 @@ All notable changes to `laravel-eloquent-flag` will be documented in this file.
 ### Added
 
 - Laravel 5.8 support
+- Flag fields auto-casting
 
 ### Changed
 
@@ -15,8 +16,8 @@ All notable changes to `laravel-eloquent-flag` will be documented in this file.
 
 ### Removed
 
-- PHP 5.6, 7.0 support
-- Laravel 5.2, 5.3, 5.4 support
+- Dropped PHP 5.6, 7.0 support
+- Dropped Laravel 5.2, 5.3, 5.4, 5.5, 5.6 support
 
 ## [4.0.0] - 2018-09-09
 

README.md

@@ -38,6 +38,7 @@ Eloquent boolean & timestamp flagged attributes behavior. Enhance Eloquent Model
 - Each flag adds global query scopes to models.
 - 2 logical groups of flags: `Classic`, `Inverse`.
 - 2 types of flags: `Boolean`, `Timestamp`.
+- Flag fields auto-casting to `bool` & `DateTime`.
 - Following PHP Standard Recommendations:
   - [PSR-1 (Basic Coding Standard)](http://www.php-fig.org/psr/psr-1/).
   - [PSR-2 (Coding Style Guide)](http://www.php-fig.org/psr/psr-2/).
@@ -91,6 +92,8 @@ Omitted entities could be retrieved by using special global scope methods, uniqu
 
 > **Example:** If your `Article` model has `PublishedAt` flag then `Article::get()` will return you only published records. When you need to get only unpublished records you could call `Article::onlyUnpublished()->get()` and `Article::withUnpublished()->get()` will return you published and unpublished articles as well.
 
+Helper traits will automatically cast flag attributes to a `DateTime` / `Carbon` instance or `bool` for you.
+
 ## Installation
 
 Pull in the package through Composer.

composer.json

@@ -54,14 +54,14 @@
     },
     "require": {
         "php": "^7.1.3",
-        "illuminate/database": "5.5.*|5.6.*|5.7.*|5.8.*"
+        "illuminate/database": "5.7.*|5.8.*"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^2.10",
         "mockery/mockery": "^1.0",
-        "orchestra/database": "~3.5.0|~3.6.0|~3.7.0|~3.8.0",
-        "orchestra/testbench": "~3.5.0|~3.6.0|~3.7.0|~3.8.0",
-        "phpunit/phpunit": "^5.7|^6.2|^7.0|^8.0"
+        "orchestra/database": "~3.7.0|~3.8.0",
+        "orchestra/testbench": "~3.7.0|~3.8.0",
+        "phpunit/phpunit": "^7.0|^8.0"
     },
     "autoload": {
         "psr-4": {

src/Traits/Classic/HasAcceptedAtHelpers.php

@@ -17,6 +17,11 @@
 
 trait HasAcceptedAtHelpers
 {
+    public function initializeHasAcceptedAtHelpers(): void
+    {
+        $this->dates[] = 'accepted_at';
+    }
+
     /**
      * Set accepted flag.
      *

src/Traits/Classic/HasAcceptedFlagHelpers.php

@@ -15,6 +15,11 @@
 
 trait HasAcceptedFlagHelpers
 {
+    public function initializeHasAcceptedFlagHelpers(): void
+    {
+        $this->casts['is_accepted'] = 'boolean';
+    }
+
     /**
      * Set accepted flag.
      *
@@ -46,7 +51,7 @@ public function unsetAcceptedFlag()
      */
     public function isAccepted(): bool
     {
-        return (bool) $this->getAttributeValue('is_accepted');
+        return $this->getAttributeValue('is_accepted');
     }
 
     /**

src/Traits/Classic/HasActiveFlagHelpers.php

@@ -15,6 +15,11 @@
 
 trait HasActiveFlagHelpers
 {
+    public function initializeHasActiveFlagHelpers(): void
+    {
+        $this->casts['is_active'] = 'boolean';
+    }
+
     /**
      * Set active flag.
      *
@@ -46,7 +51,7 @@ public function unsetActivatedFlag()
      */
     public function isActivated(): bool
     {
-        return (bool) $this->getAttributeValue('is_active');
+        return $this->getAttributeValue('is_active');
     }
 
     /**

src/Traits/Classic/HasApprovedAtHelpers.php

@@ -17,6 +17,11 @@
 
 trait HasApprovedAtHelpers
 {
+    public function initializeHasApprovedAtHelpers(): void
+    {
+        $this->dates[] = 'approved_at';
+    }
+
     /**
      * Set approved flag.
      *

src/Traits/Classic/HasApprovedFlagHelpers.php

@@ -15,6 +15,11 @@
 
 trait HasApprovedFlagHelpers
 {
+    public function initializeHasApprovedFlagHelpers(): void
+    {
+        $this->casts['is_approved'] = 'boolean';
+    }
+
     /**
      * Set approved flag.
      *
@@ -46,7 +51,7 @@ public function unsetApprovedFlag()
      */
     public function isApproved(): bool
     {
-        return (bool) $this->getAttributeValue('is_approved');
+        return $this->getAttributeValue('is_approved');
     }
 
     /**

src/Traits/Classic/HasInvitedAtHelpers.php

@@ -17,6 +17,11 @@
 
 trait HasInvitedAtHelpers
 {
+    public function initializeHasInvitedAtHelpers(): void
+    {
+        $this->dates[] = 'invited_at';
+    }
+
     /**
      * Set invited flag.
      *

src/Traits/Classic/HasInvitedFlagHelpers.php

@@ -15,6 +15,11 @@
 
 trait HasInvitedFlagHelpers
 {
+    public function initializeHasInvitedFlagHelpers(): void
+    {
+        $this->casts['is_invited'] = 'boolean';
+    }
+
     /**
      * Set invited flag.
      *
@@ -46,7 +51,7 @@ public function unsetInvitedFlag()
      */
     public function isInvited(): bool
     {
-        return (bool) $this->getAttributeValue('is_invited');
+        return $this->getAttributeValue('is_invited');
     }
 
     /**