Introduce using() method to conveniently define lifetime and tags (spatie#491)

* Introduce using() method to conveniently define lifetime and tags

* Document and test CacheResponse::using middleware helper

Author: kamilkozak

README.md

@@ -404,6 +404,8 @@ Route::group(function() {
 If the [cache driver you configured supports tags](https://laravel.com/docs/5.8/cache#cache-tags), you can specify a list of tags when applying the middleware.
 
 ```php
+use Spatie\ResponseCache\Middlewares\CacheResponse;
+
 // add a "foo" tag to this route with a 300 second lifetime
 Route::get('/test1', 'SnowflakeController@index')->middleware('cacheResponse:300,foo');
 
@@ -416,6 +418,9 @@ Route::group(function() {
 
    Route::get('/test4', 'YetAnotherSnowflakeController@index');
 })->middleware('cacheResponse:foo,bar');
+
+// or use the using method for convenience
+Route::get('/test5', 'SnowflakeController@index')->middleware(CacheResponse::using(300, 'foo', 'bar'));
 ```
 
 #### Clearing tagged content

src/Middlewares/CacheResponse.php

@@ -23,6 +23,11 @@ public function __construct(ResponseCache $responseCache)
         $this->responseCache = $responseCache;
     }
 
+    public static function using($lifetime, ...$tags): string
+    {
+        return static::class.':'.implode(',', [$lifetime, ...$tags]);
+    }
+
     public function handle(Request $request, Closure $next, ...$args): Response
     {
         $lifetimeInSeconds = $this->getLifetime($args);

tests/TaggingTest.php

@@ -3,6 +3,7 @@
 use function PHPUnit\Framework\assertThat;
 use function PHPUnit\Framework\isTrue;
 
+use Spatie\ResponseCache\Middlewares\CacheResponse;
 use Spatie\ResponseCache\Test\Concerns\CanChangeCacheStore;
 
 uses(CanChangeCacheStore::class);
@@ -77,3 +78,14 @@
     assertRegularResponse($secondResponse);
     assertDifferentResponse($firstResponse, $secondResponse);
 });
+
+it('can generate middleware string for different tag combinations using the using method', function () {
+    $singleTag = CacheResponse::using('foo');
+    expect($singleTag)->toBe(CacheResponse::class.':foo');
+
+    $multipleTags = CacheResponse::using('foo', 'bar');
+    expect($multipleTags)->toBe(CacheResponse::class.':foo,bar');
+
+    $lifetime = CacheResponse::using(300);
+    expect($lifetime)->toBe(CacheResponse::class.':300');
+});