feat: implement GitLab source fetching

Author: butschster

src/Console/GenerateCommand.php

@@ -157,7 +157,7 @@ public function __invoke(Container $container, DirectoriesInterface $dirs): int
                             $result[] = [
                                 'output_path' => $compiledDocument->outputPath,
                                 'context_path' => $compiledDocument->contextPath,
-                                'errors' => \iterator_to_array($compiledDocument->errors->getIterator()),
+                                'errors' => $compiledDocument->errors,
                             ];
                         }
                     }

src/Document/Compiler/Error/ErrorCollection.php

@@ -9,7 +9,7 @@
  * @template TError of \Stringable|string
  * @implements \IteratorAggregate<TError>
  */
-final class ErrorCollection implements \Countable, \IteratorAggregate
+final class ErrorCollection implements \Countable, \IteratorAggregate, \JsonSerializable
 {
     public function __construct(
         /**
@@ -50,4 +50,12 @@ public function getIterator(): \Traversable
     {
         return new \ArrayIterator($this->errors);
     }
+
+    public function jsonSerialize(): array
+    {
+        return \array_map(
+            static fn(\Stringable|string $error): string => (string) $error,
+            $this->errors,
+        );
+    }
 }

src/Lib/PathFilter/ExcludePathFilter.php

@@ -53,6 +53,10 @@ public function apply(array $items): array
      */
     private function matchesPattern(string $string, string $pattern): bool
     {
+        if (\str_contains($string, $pattern)) {
+            return true;
+        }
+
         if (FileHelper::isRegex($pattern)) {
             return (bool) \preg_match($pattern, $string);
         }

src/Source/Gitlab/GitlabFinder.php

@@ -16,7 +16,6 @@
 use Butschster\ContextGenerator\Lib\TreeBuilder\FileTreeBuilder;
 use Butschster\ContextGenerator\Lib\Variable\VariableResolver;
 use Butschster\ContextGenerator\Source\Fetcher\FilterableSourceInterface;
-use Butschster\ContextGenerator\Source\Gitlab\Config\ServerRegistry;
 
 final class GitlabFinder implements FinderInterface
 {
@@ -29,7 +28,6 @@ final class GitlabFinder implements FinderInterface
 
     public function __construct(
         private readonly GitlabClientInterface $gitlabClient,
-        private readonly ServerRegistry $serverRegistry,
         private readonly VariableResolver $variableResolver = new VariableResolver(),
         private readonly FileTreeBuilder $fileTreeBuilder = new FileTreeBuilder(),
     ) {}

src/Source/Gitlab/GitlabSourceFetcher.php

@@ -64,6 +64,10 @@ public function fetch(SourceInterface $source, ModifiersApplierInterface $modifi
             ->create()
             ->addTitle($source->getDescription(), 2);
 
+        if (!$source->server) {
+            throw new \RuntimeException('GitLab server is not set');
+        }
+
         // Determine server URL from source or default
         $serverUrl = $source->server->url;
 

tests/fixtures/Console/GenerateCommand/GitlabSource/basic.yaml

@@ -0,0 +1,14 @@
+documents:
+  - description: "Basic GitLab Source Test"
+    outputPath: "gitlab-source.md"
+    sources:
+      - type: gitlab
+        description: "Basic GitLab Source Test"
+        repository: "group/project"
+        sourcePaths: "src"
+        server:
+          url: "https://gitlab.com"
+          token: "your_gitlab_token"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true

tests/fixtures/Console/GenerateCommand/GitlabSource/custom-server.yaml

@@ -0,0 +1,16 @@
+documents:
+  - description: "Custom Server GitLab Test"
+    outputPath: "custom-server-gitlab.md"
+    sources:
+      - type: gitlab
+        description: "Custom Server GitLab Test"
+        repository: "group/project"
+        sourcePaths: "src"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true
+        server:
+          url: "https://custom-gitlab.example.com"
+          token: "${GITLAB_TOKEN}"
+          headers:
+            X-Custom-Header: "custom-value"

tests/fixtures/Console/GenerateCommand/GitlabSource/filtered.yaml

@@ -0,0 +1,17 @@
+documents:
+  - description: "Filtered GitLab Source"
+    outputPath: "filtered-gitlab.md"
+    sources:
+      - type: gitlab
+        description: "Filtered GitLab Source"
+        repository: "group/project"
+        sourcePaths: "src"
+        filePattern: "*.php"
+        path: "Controller"
+        notPath:
+          - "Model"
+        branch: "main"
+        showTreeView: true
+        server:
+          url: "https://gitlab.com"
+          token: "your_gitlab_token"

tests/fixtures/Console/GenerateCommand/GitlabSource/invalid.yaml

@@ -0,0 +1,11 @@
+documents:
+  - description: "Basic GitLab Source Test"
+    outputPath: "gitlab-source.md"
+    sources:
+      - type: gitlab
+        description: "Basic GitLab Source Test"
+        repository: "group/project"
+        sourcePaths: "src"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true

tests/fixtures/Console/GenerateCommand/GitlabSource/multiple-paths.yaml

@@ -0,0 +1,16 @@
+documents:
+  - description: "Multiple Paths GitLab Source"
+    outputPath: "multiple-paths-gitlab.md"
+    sources:
+      - type: gitlab
+        description: "Multiple Paths GitLab Source"
+        repository: "group/project"
+        sourcePaths:
+          - "src/Controller"
+          - "tests"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true
+        server:
+          url: "https://gitlab.com"
+          token: "your_gitlab_token"

tests/fixtures/Console/GenerateCommand/GitlabSource/tree-view.yaml

@@ -0,0 +1,19 @@
+documents:
+  - description: "GitLab Tree View Test"
+    outputPath: "tree-view-gitlab.md"
+    sources:
+      - type: gitlab
+        description: "GitLab Tree View Test"
+        repository: "group/project"
+        sourcePaths: "src"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true
+        treeView:
+          enabled: true
+          showSize: true
+          showLastModified: true
+          includeFiles: true
+        server:
+          url: "https://gitlab.com"
+          token: "your_gitlab_token"

tests/fixtures/Console/GenerateCommand/GitlabSource/with-token.yaml

@@ -0,0 +1,14 @@
+documents:
+  - description: "Private GitLab Repository"
+    outputPath: "private-gitlab.md"
+    sources:
+      - type: gitlab
+        description: "Private GitLab Repository"
+        repository: "group/private-project"
+        sourcePaths: "src"
+        filePattern: "*.php"
+        branch: "main"
+        showTreeView: true
+        server:
+          url: "https://gitlab.com"
+          token: "${GITLAB_TOKEN}"

tests/src/Feature/Console/GenerateCommand/CompilingResult.php

@@ -97,7 +97,6 @@ public function assertDocumentError(string $document, array $contains): self
     {
         foreach ($this->result['result'] as $documentData) {
             if ($documentData['context_path'] === $document) {
-                trap($documentData['errors']);
                 foreach ($contains as $string) {
                     TestCase::assertStringContainsString(
                         $string,