feat: introduce XcodeProjMapper to map XcodeProj to XcodeGraph (#87)

* [XcodeProjToGraph] add XcodeProjToGraph and tests

* lint files

* [ProjectDescriptionHelpers] add fixtures to resources

* [WorkspaceMapperTests] add unit tests

* [Integration Tests] remove

* [access modifiers] add missing access modifiers

* [swift tools version] 5.9

* Address code review feedback: refine mappers, clean up test data, and improve structure

* [XcodeProj] mainPBXProject extension

* refactor: add accidental public removal back

* feat: Strengthen error handling for unknown objects

* feat: Introduce PathDependencyMapper

* refactor: Remove ProjectParser & unify usage via XcodeGraphMapper

* chore: Bump XcodeProj version 8.26.0

* feat: Add command runner

* feat: MetadataProviders module

* feat: MetadataProvidersTests

* refactor: Test cleanup

* lint

* [Fixtures] add test fixtures for metadata module

* [Error] remove fatal error

* [Path] for unwrap proj and workspace path

* [Tuist] manifest update

* [Tests] fix tests

* [Lint] lint files

* [MockProvider] remove

* [metadata] integrate into mappers

* [Phases] fix access modifiers

* [Tests] fix flaky tests

* [Lint] lint files

* [Tuist] fix manifest

* [Doc] update readme

* [plis] remove dead code

* [Version] Update swift version to 5.10

* [Lint] lint errors

* Fix build on Linux

* Remove Project.swift

* Remove cache workflow

* Skip testing XcodeMetadataTests

* Update FileSystem

---------

Co-authored-by: fortmarek <marekfort@me.com>

Author: ajkolean

.gitattributes

@@ -0,0 +1 @@
+fixtures/* binary

.github/workflows/XcodeGraph.yml

@@ -30,7 +30,7 @@ jobs:
           - ubuntu-22.04
           - macos-15
         swift-version:
-          - "5.9"
+          - "6.0.3"
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
@@ -48,7 +48,12 @@ jobs:
         if: steps.debug_build.outcome == 'failure'
         run: |
           swift build --configuration debug
+      - name: Test on Linux
+        if: matrix.os == 'ubuntu-22.04'
+        # These momdules rely on some Xcode utilities like xcode-select
+        run: swift test --skip XcodeProjMapperTests --skip XcodeMetadataTests
       - name: Test
+        if: matrix.os != 'ubuntu-22.04'
         run: swift test
   spm_build:
     name: SPM Build
@@ -58,7 +63,7 @@ jobs:
           - ubuntu-22.04
           - macos-15
         swift-version:
-          - "5.9"
+          - "6.0.3"
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
@@ -85,38 +90,6 @@ jobs:
         if: steps.release_build.outcome == 'failure'
         run: |
           swift build --configuration release
-  tuist_test:
-    name: Tuist Test
-    strategy:
-      matrix:
-        os:
-          - macos-15
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: jdx/mise-action@v2
-        with:
-          version: 2024.11.8
-      - name: Install dependencies
-        run: tuist install
-      - name: Test
-        run: tuist test
-  tuist_build:
-    name: Tuist Build
-    strategy:
-      matrix:
-        os:
-          - macos-15
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: jdx/mise-action@v2
-        with:
-          version: 2024.11.8
-      - name: Install dependencies
-        run: tuist install
-      - name: Build
-        run: tuist build
   lint:
     name: Lint
     strategy:

.github/workflows/cache.yml

@@ -102,6 +102,7 @@ Tuist/Dependencies/graph.json
 
 # VSCode Settings
 .vscode/launch.json
+.vscode
 
 # Release artifacts
 .bundle

.gitignore

@@ -7,7 +7,7 @@
 --disable hoistAwait
 --disable hoistTry
 --disable redundantReturn
---swiftversion 5.9
+--swiftversion 5.10
 --minversion 0.53.0
 
 # format options

.swiftformat

@@ -8,6 +8,7 @@ disabled_rules:
   - function_parameter_count
   - opening_brace
   - line_length
+  - large_tuple
 identifier_name:
   min_length:
     error: 1
@@ -21,4 +22,10 @@ inclusive_language:
 type_name:
   min_length:
     error: 1
-    warning: 1
+    warning: 1
+custom_rules:
+  error_must_conform_to_localizederror:
+    name: "Error must conform to LocalizedError"
+    regex: '(struct|class|enum)\s+\w+Error:\s*Error\s*(?!,\s*LocalizedError)'
+    message: "Errors must conform to LocalizedError to provide user-friendly descriptions."
+    severity: error