Allow to specify file via Vcr attribute (#8)

* Updated to accept vcr attribute

* Updated readme usage example

README.md

@@ -18,6 +18,7 @@ Use `@vcr cassette_name` on your tests to turn VCR automatically on and off.
 ``` php
 
 use PHPUnit\Framework\TestCase;
+use VCR\PHPUnit\TestListener\Attributes\Vcr;
 
 class VCRTest extends TestCase
 {
@@ -30,6 +31,14 @@ class VCRTest extends TestCase
         $result = file_get_contents('http://google.com');
         $this->assertEquals('This is a annotation test dummy.', $result, 'Call was not intercepted (using annotations).');
     }
+
+    #[Vcr('unittest_annotation_test')]
+    public function testInterceptsWithAttributes(): void
+    {
+        // Content of tests/fixtures/unittest_annotation_test: "This is a annotation test dummy".
+        $result = file_get_contents('http://google.com');
+        $this->assertEquals('This is a annotation test dummy.', $result, 'Call was not intercepted (using attributes).');
+    }
 }
 ```
 

src/Attributes/Vcr.php

@@ -0,0 +1,35 @@
+<?php declare(strict_types=1);
+
+namespace VCR\PHPUnit\TestListener\Attributes;
+
+use Attribute;
+
+/**
+ * @immutable
+ *
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+ */
+#[Attribute(Attribute::TARGET_METHOD)]
+final class Vcr
+{
+    /**
+     * @var non-empty-string
+     */
+    private string $cassette;
+
+    /**
+     * @param non-empty-string $cassette
+     */
+    public function __construct(string $cassette)
+    {
+        $this->cassette = $cassette;
+    }
+
+    /**
+     * @return non-empty-string
+     */
+    public function cassette(): string
+    {
+        return $this->cassette;
+    }
+}

tests/VCRTestListenerTest.php

@@ -4,6 +4,7 @@
 namespace Tests\VCR\PHPUnit\TestListener;
 
 use PHPUnit\Framework\TestCase;
+use VCR\PHPUnit\TestListener\Attributes\Vcr;
 
 final class VCRTestListenerTest extends TestCase
 {
@@ -48,6 +49,14 @@ public function testNoVcrAnnotationRunsSuccessfulAndDoesNotProduceWarnings()
         $this->assertTrue(true, 'just adding an assertion here');
     }
 
+    #[Vcr('unittest_annotation_test')]
+    public function testInterceptsWithAttributes(): void
+    {
+        // Content of tests/fixtures/unittest_annotation_test: "This is a annotation test dummy".
+        $result = file_get_contents('http://google.com');
+        $this->assertEquals('This is a annotation test dummy.', $result, 'Call was not intercepted (using attributes).');
+    }
+
     /**
      * @return \int[][]
      */