added Value

README.md

@@ -9,15 +9,16 @@ something for you.
 
 This package currently supports the following:
 
+- Constructor (in case you're migrating from
+  [Spatie's PHP Enum](https://github.com/spatie/enum))
 - Comparison
-- From (for non-backed enums)
-- Ability to make from enum-name (Make methods)
+- From (for unit enums)
+- Make (Ability to make from enum-name)
 - Labels
 - Mappers
-- Reporting (Logging)
 - Properties
-- Constructor (in case you're migrating from 
-[Spatie's PHP Enum](https://github.com/spatie/enum))
+- Reporting (Logging)
+- Value
 
 
 ## Installation
@@ -57,6 +58,7 @@ implemented his own version of `Makers` and `Reporters`.
 - [Mappers](docs/mappers.md)
 - [Properties](docs/properties.md)
 - [Reporters](docs/reporters.md)
+- [Value](docs/value.md)
 
 ### Laravel
 When you are installing this package into a laravel project, Enumhancer will

docs/value.md

@@ -0,0 +1,25 @@
+# Value
+
+When you have a unit enum, you have no value. You have to use the `name` value. But what if you
+want to have the lowercase version of that name? That's where `Value` comes in.
+
+## Usage
+
+```php
+use Henzeb\Enumhancer\Concerns\Value;
+
+enum yourEnum {
+    use Value;
+
+    case MY_ENUM;
+
+}
+```
+
+### Examples
+
+```php
+YourEnum::MY_ENUM->value(); // will return `my_enum`;
+```
+
+Note: When used with a string or int backed enum, this method will return it's actual value.

src/Concerns/Enhancers.php

@@ -4,5 +4,5 @@
 
 trait Enhancers
 {
-    use Comparison, Labels, Mappers, Properties;
+    use Comparison, Labels, Mappers, Properties, Value;
 }

src/Concerns/Value.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Henzeb\Enumhancer\Concerns;
+
+trait Value
+{
+    public function value(): string|int
+    {
+        return $this->value ?? strtolower($this->name);
+    }
+}

tests/Fixtures/ConstructableNonBackedEnum.php → tests/Fixtures/ConstructableUnitEnum.php

@@ -10,7 +10,7 @@
 /**
  * @method static self CALLABLE()
  */
-enum ConstructableNonBackedEnum
+enum ConstructableUnitEnum
 {
     use Constructor, Mappers, Comparison, From;
 

tests/Fixtures/EnhancedEnum.php → tests/Fixtures/EnhancedBackedEnum.php

@@ -9,7 +9,7 @@
 /**
  * @method static self anotherMappedEnum()
  */
-enum EnhancedEnum: string
+enum EnhancedBackedEnum: string
 {
     use Enhancers, Constructor;
 
@@ -30,7 +30,7 @@ protected static function mapper(): ?Mapper
             protected function mappable(): array
             {
                 return [
-                    'anotherMappedEnum' => EnhancedEnum::ENUM
+                    'anotherMappedEnum' => EnhancedBackedEnum::ENUM
                 ];
             }
         };

tests/Fixtures/EnhancedUnitEnum.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Henzeb\Enumhancer\Tests\Fixtures;
+
+use Henzeb\Enumhancer\Concerns\Constructor;
+use Henzeb\Enumhancer\Concerns\Enhancers;
+use Henzeb\Enumhancer\Contracts\Mapper;
+
+/**
+ * @method static self anotherMappedEnum()
+ */
+enum EnhancedUnitEnum
+{
+    use Enhancers, Constructor;
+
+    case ENUM;
+    case ANOTHER_ENUM;
+}

tests/Unit/Concerns/ConstructorTest.php

@@ -3,7 +3,7 @@
 namespace Henzeb\Enumhancer\Tests\Unit\Concerns;
 
 use Henzeb\Enumhancer\Tests\Fixtures\IntBackedStaticCallableEnum;
-use Henzeb\Enumhancer\Tests\Fixtures\ConstructableNonBackedEnum;
+use Henzeb\Enumhancer\Tests\Fixtures\ConstructableUnitEnum;
 use Henzeb\Enumhancer\Tests\Fixtures\StringBackedStaticCallableEnum;
 use PHPUnit\Framework\TestCase;
 
@@ -13,15 +13,15 @@ class ConstructorTest extends TestCase
     public function testShouldGetEnumUsingStaticCall(): void
     {
         $this->assertEquals(
-            ConstructableNonBackedEnum::CALLABLE,
-            ConstructableNonBackedEnum::CALLABLE()
+            ConstructableUnitEnum::CALLABLE,
+            ConstructableUnitEnum::CALLABLE()
         );
     }
 
     public function testShouldFailUsingStaticCallToUnknownEnum(): void
     {
         $this->expectError();
-        ConstructableNonBackedEnum::CANNOT_CALL();
+        ConstructableUnitEnum::CANNOT_CALL();
     }
 
     public function testShouldGetStringBackedEnumByName(): void

tests/Unit/Concerns/FromTest.php

@@ -3,38 +3,38 @@
 namespace Henzeb\Enumhancer\Tests\Unit\Concerns;
 
 use PHPUnit\Framework\TestCase;
-use Henzeb\Enumhancer\Tests\Fixtures\ConstructableNonBackedEnum;
+use Henzeb\Enumhancer\Tests\Fixtures\ConstructableUnitEnum;
 
 
 class FromTest extends TestCase
 {
     function testNonBackedEnumCanCallFrom(): void
     {
         $this->assertEquals(
-            ConstructableNonBackedEnum::CALLABLE,
-            ConstructableNonBackedEnum::from('callable')
+            ConstructableUnitEnum::CALLABLE,
+            ConstructableUnitEnum::from('callable')
         );
     }
 
-    function testNonBackedEnumCanCallFromAndFail(): void
+    function testUnitEnumCanCallFromAndFail(): void
     {
         $this->expectError();
 
-        ConstructableNonBackedEnum::from('doesnotexist');
+        ConstructableUnitEnum::from('doesnotexist');
     }
 
-    function testNonBackedEnumCanCallTryFrom(): void
+    function testUnitEnumCanCallTryFrom(): void
     {
         $this->assertEquals(
-            ConstructableNonBackedEnum::CALLABLE,
-            ConstructableNonBackedEnum::tryFrom('callable')
+            ConstructableUnitEnum::CALLABLE,
+            ConstructableUnitEnum::tryFrom('callable')
         );
     }
 
     function testTryFromShouldReturnNull(): void
     {
         $this->assertNull(
-            ConstructableNonBackedEnum::tryFrom('doesNotExist')
+            ConstructableUnitEnum::tryFrom('doesNotExist')
         );
     }
 }

tests/Unit/Concerns/LabelsTest.php

@@ -3,7 +3,7 @@
 namespace Henzeb\Enumhancer\Tests\Unit\Concerns;
 
 use Henzeb\Enumhancer\Concerns\Labels;
-use Henzeb\Enumhancer\Tests\Fixtures\EnhancedEnum;
+use Henzeb\Enumhancer\Tests\Fixtures\EnhancedBackedEnum;
 use Mockery;
 use PHPUnit\Framework\TestCase;
 
@@ -20,11 +20,11 @@ public function testShouldGetNameWhenNoLabelsSpecifiedAtAll()
 
     public function testShouldGetLabelByName()
     {
-        $this->assertEquals('My label', EnhancedEnum::ENUM->label());
+        $this->assertEquals('My label', EnhancedBackedEnum::ENUM->label());
     }
 
     public function testShouldGetNameWhenLabelDoesNotExist()
     {
-        $this->assertEquals('ANOTHER_ENUM', EnhancedEnum::ANOTHER_ENUM->label());
+        $this->assertEquals('ANOTHER_ENUM', EnhancedBackedEnum::ANOTHER_ENUM->label());
     }
 }