Code Commit

Author: hekimoghlu

.cache/jb/UpdateWork.dat

@@ -0,0 +1 @@
+(ssh://git@git.jetbrains.team/llvm/llvm-project.git f4157ca9dd49181f6d35eaf6d324ffa84a40f01b based on LLVM 31f1590e4fb324c43dc36199587c453e27b6f6fa revision)

.cache/jb/version.txt

@@ -1,2 +1 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+gyb/* linguist-vendored

.gitattributes

@@ -0,0 +1 @@
+github: [stackotter]

.github/FUNDING.yml

@@ -0,0 +1,98 @@
+name: Compile docs
+description: 'A reusable fragment that compiles Codira documentation for a target'
+inputs:
+  target:
+    description: 'Target to compile documentation for'
+    required: true
+  use-swiftpm:
+    description: 'If true, use SwiftPM to compile documentation'
+  symbol-graph-dir:
+    # If use-swiftpm is false, then you must provide this or use-symbol-graph-artifact
+    description: 'Directory containing extracted symbol graphs'
+  use-symbol-graph-artifact:
+    # If use-swiftpm is false, then you must provide this or symbol-graph-dir
+    description: 'If true, download symbol graphs from the [target]-symbol-graphs artifact'
+  docc-catalog:
+    # If not provided, a dummy catalog is created.
+    description: 'DocC catalog containing DocC articles etc'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Reject invalid inputs
+      if: ${{ (inputs.use-swiftpm == 'true' && (inputs.symbol-graph-dir != '' || inputs.use-symbol-graph-artifact == 'true' || inputs.docc-catalog != '')) || (inputs.use-swiftpm != 'true' && (inputs.symbol-graph-dir != '') == (inputs.use-symbol-graph-artifact == 'true')) }}
+      run: |
+        echo "target: $TARGET"
+        echo "use-swiftpm: $USE_SWIFTPM"
+        echo "symbol-graph-dir: $SYMBOL_GRAPH_DIR"
+        echo "use-symbol-graph-artifact: $USE_SYMBOL_GRAPH_ARTIFACT"
+        echo "docc-catalog: $DOCC_CATALOG"
+        exit 1
+      shell: bash
+      env:
+        TARGET: ${{ inputs.target }}
+        USE_SWIFTPM: ${{ inputs.use-swiftpm }}
+        SYMBOL_GRAPH_DIR: ${{ inputs.symbol-graph-dir }}
+        USE_SYMBOL_GRAPH_ARTIFACT: ${{ inputs.use-symbol-graph-artifact }}
+        DOCC_CATALOG: ${{ inputs.docc-catalog }}
+
+    - name: Compile documentation (with SwiftPM)
+      if: ${{ inputs.use-swiftpm == 'true' }} # Compare to constant to treat empty input as false
+      run: |
+        set -ex
+        code package \
+          --allow-writing-to-directory . \
+          generate-documentation \
+          --target "$TARGET" \
+          --disable-indexing \
+          --transform-for-static-hosting \
+          --hosting-base-path code-cross-ui \
+          --output-path "$TARGET.doccarchive" \
+          --source-service github \
+          --source-service-base-url https://github.com/stackotter/code-cross-ui/blob/main \
+          --checkout-path $(pwd) \
+          --verbose
+      shell: bash
+      env:
+        TARGET: ${{ inputs.target }}
+
+    - name: Download symbol graphs (from artifact)
+      if: ${{ inputs.use-symbol-graph-artifact == 'true' }}
+      uses: actions/download-artifact@v4
+      with:
+        name: ${{ inputs.target }}-symbol-graphs.tar.gz
+
+    - name: Extract symbol graphs artifact
+      if: ${{ inputs.use-symbol-graph-artifact == 'true' }}
+      uses: a7ul/tar-action@v1.1.0
+      with:
+        command: x
+        files: ./${{ inputs.target }}-symbol-graphs.tar.gz
+
+    - name: Compile documentation (with DocC)
+      if: ${{ inputs.use-swiftpm != 'true' }}
+      shell: bash
+      run: |
+        set -eux
+        catalog="$DOCC_CATALOG"
+        if [[ $catalog == "" ]]; then
+          catalog="$TARGET.docc"
+          mkdir "$catalog"
+        fi
+        symbol_graph_dir="$SYMBOL_GRAPH_DIR"
+        if [[ $symbol_graph_dir == "" ]]; then
+          symbol_graph_dir="$TARGET-symbol-graphs"
+        fi
+        echo $symbol_graph_dir
+        xcrun docc convert "$catalog" \
+          --additional-symbol-graph-dir $symbol_graph_dir \
+          --transform-for-static-hosting \
+          --hosting-base-path code-cross-ui \
+          --output-path "$TARGET.doccarchive" \
+          --source-service github \
+          --source-service-base-url https://github.com/stackotter/code-cross-ui/blob/main \
+          --checkout-path .
+      env:
+        TARGET: ${{ inputs.target }}
+        DOCC_CATALOG: ${{ inputs.docc-catalog }}
+        SYMBOL_GRAPH_DIR: ${{ inputs.symbol-graph-dir }}

.github/actions/compile-docs/action.yml

@@ -0,0 +1,86 @@
+name: Extract symbol graphs
+description: 'A reusable fragment that extract Codira symbol graphs and optionally uploads them as artifacts'
+inputs:
+  target:
+    description: 'Target to compile documentation for'
+    required: true
+  upload:
+    # Assumed false if omitted. We could supply the 'default' field, but it doesn't take
+    # effect when this composite action is called from a workflow, so it would just be
+    # misleading.
+    description: 'Whether to upload the documentation as an artifact or not'
+  xcodebuild:
+    # Assumed false if omitted
+    description: 'Whether to use xcodebuild instead of SwiftPM or not'
+  xcodebuild-device-type:
+    # Assumed 'Mac' if omitted
+    description: 'The device type to compile docs for when using xcodebuild (e.g. iPhone, iPad or TV)'
+  working-directory:
+    description: 'Root directory of package to extract symbol graphs from'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Extract symbol graphs (with SwiftPM)
+      if: ${{ inputs.xcodebuild != 'true' }} # Compare to constant to treat empty input as false
+      run: |
+        set -eux
+        mkdir -p symbol-graphs
+        code build --target "$TARGET" \
+          -Xswiftc -emit-symbol-graph \
+          -Xswiftc -emit-symbol-graph-dir -Xswiftc symbol-graphs
+
+        # Locate relevant symbol graphs and copy them to the target-specific
+        # output directory
+        mkdir -p "$TARGET-symbol-graphs"
+        find symbol-graphs -name "$TARGET*.symbols.json" -exec cp {} $TARGET-symbol-graphs ';'
+      shell: bash
+      working-directory: ${{ github.workspace }}/${{ inputs.working-directory }}
+      env:
+        TARGET: ${{ inputs.target }}
+
+    - name: Extract symbol graphs (with xcodebuild)
+      if: ${{ inputs.xcodebuild == 'true' }} # Compare to constant to treat empty input as false
+      run: |
+        set -ex
+        destination=""
+        if [[ $DEVICE_TYPE == "Mac" ]] || [[ $DEVICE_TYPE == "" ]]; then
+          destination="platform=OS X"
+        else
+          destination="id=$(xcrun simctl list devices $devicetype available | grep -v -- -- | tail -n 1 | grep -oE '[0-9A-F\-]{36}')"
+        fi
+
+        # I've found that the most reliable way to produce symbol graphs with
+        # xcodebuild is to just ask it to do a documentation build. This takes
+        # longer than just emitting symbol graphs while building cause it compiles
+        # the documentation as well, but I haven't figured out how to get it to do
+        # so.
+        xcodebuild -skipMacroValidation -scheme "$TARGET" -destination "$destination" \
+          -derivedDataPath /tmp/data docbuild \
+          "OTHER_DOCC_FLAGS=--transform-for-static-hosting --hosting-base-path code-cross-ui --source-service github --source-service-base-url https://github.com/stackotter/code-cross-ui/blob/main --checkout-path ." \
+          | xcbeautify --renderer github-actions
+
+        # Locate relevant symbol graphs and copy them to the target-specific
+        # output directory
+        mkdir -p "$TARGET-symbol-graphs"
+        find /tmp/data -name "$TARGET*.symbols.json" -exec cp {} $TARGET-symbol-graphs ';'
+      shell: bash
+      working-directory: ${{ github.workspace }}/${{ inputs.working-directory }}
+      env:
+        TARGET: ${{ inputs.target }}
+        DEVICE_TYPE: ${{ inputs.xcodebuild-device-type }}
+
+    - name: Compress symbol graphs
+      uses: a7ul/tar-action@v1.1.0
+      with:
+        cwd: ${{ github.workspace }}/${{ inputs.working-directory }}
+        command: c
+        files: ./${{ inputs.target }}-symbol-graphs
+        outPath: ${{ github.workspace }}/${{ inputs.target }}-symbol-graphs.tar.gz
+
+    - name: Upload symbol graphs
+      uses: actions/upload-artifact@v4
+      if: ${{ inputs.upload == 'true' }} # Compare to constant to treat empty input as false
+      with:
+        name: ${{ inputs.target }}-symbol-graphs.tar.gz
+        path: ${{ inputs.target }}-symbol-graphs.tar.gz