diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index d32bd45..b2033d8 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -112,28 +112,28 @@ jobs: - name: Build run: swift build --target IssueReporting --swift-sdk wasm32-unknown-wasi -Xlinker -z -Xlinker stack-size=$((1024 * 1024)) - windows: - name: Windows - strategy: - matrix: - os: [windows-latest] - config: - - debug - - release - fail-fast: false - runs-on: ${{ matrix.os }} - steps: - - uses: compnerd/gha-setup-swift@main - with: - branch: swift-6.0.3-release - tag: 6.0.3-RELEASE - - name: Set long paths - run: git config --system core.longpaths true - - uses: actions/checkout@v4 - - name: Build - run: swift build -c ${{ matrix.config }} - - name: Run tests (debug only) - run: swift test + # windows: + # name: Windows + # strategy: + # matrix: + # os: [windows-latest] + # config: + # - debug + # - release + # fail-fast: false + # runs-on: ${{ matrix.os }} + # steps: + # - uses: compnerd/gha-setup-swift@main + # with: + # branch: swift-6.0.3-release + # tag: 6.0.3-RELEASE + # - name: Set long paths + # run: git config --system core.longpaths true + # - uses: actions/checkout@v4 + # - name: Build + # run: swift build -c ${{ matrix.config }} + # - name: Run tests (debug only) + # run: swift test android: name: Android diff --git a/README.md b/README.md index 40798bf..534d5da 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,14 @@ assertions, and do so in a testable manner. ## Overview +> [!Important] +> Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such, +> to use this library you must depend on the old repository URL: +> +> ``` +> https://github.com/pointfreeco/xctest-dynamic-overlay +> ``` + This library provides robust tools for reporting issues in your application with a customizable degree of granularity and severity. In its most basic form you use the `reportIssue` function anywhere in your application to flag an issue in your code, such as a code path that you think @@ -72,9 +80,9 @@ There are many popular libraries out there using Issue Reporting. To name a few: to explicitly declare its dependencies, and when a new dependency is introduced to a feature, existing tests will fail until they account for it. - - - + * [**Swift Navigation**](https://github.com/pointfreeco/swift-navigation) provides concise + domain modeling tools for UI frameworks including SwiftUI, UIKit, and more; and it uses Swift + Issue Reporting to raise runtime warnings when APIs are used in unexpected ways. * [**The Composable Architecture**](https://github.com/pointfreeco/swift-composable-architecture) comes with powerful testing tools that support both Swift Testing and XCTest out of the box diff --git a/Sources/IssueReporting/Documentation.docc/Articles/GettingStarted.md b/Sources/IssueReporting/Documentation.docc/Articles/GettingStarted.md index 6084194..2ac0c3a 100644 --- a/Sources/IssueReporting/Documentation.docc/Articles/GettingStarted.md +++ b/Sources/IssueReporting/Documentation.docc/Articles/GettingStarted.md @@ -2,6 +2,33 @@ Learn how to report issues in your application code, and how to customize how issues are reported. +## Installation + +Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such, to use this +library you must depend on the old repository URL. This means if you are using the Xcode +"Package Dependencies" interface you will enter the following URL when adding the package: + +``` +https://github.com/pointfreeco/xctest-dynamic-overlay +``` + +And if you are using an SPM Package.swift file you will specify the dependency like so: + +```swift +.package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.5.0"), +``` + +…and add the dependency product to your target like so: + +```swift +.target( + "MyTarget", + dependencies: [ + .product(name: "IssueReporting", package: "xctest-dynamic-overlay") + ] +) +``` + ## Reporting issues The primary tool for reporting an issue in your application code is the diff --git a/Sources/IssueReporting/Documentation.docc/IssueReporting.md b/Sources/IssueReporting/Documentation.docc/IssueReporting.md index dc51e5a..c1b002d 100644 --- a/Sources/IssueReporting/Documentation.docc/IssueReporting.md +++ b/Sources/IssueReporting/Documentation.docc/IssueReporting.md @@ -5,6 +5,14 @@ assertions, and do so in a testable manner. ## Overview +> Important: +> Issue Reporting is an evolution of our previous library, XCTestDynamicOverlay. As such, +> to use this library you must depend on the old repository URL: +> +> ``` +> https://github.com/pointfreeco/xctest-dynamic-overlay +> ``` + This library provides robust tools for reporting issues in your application with a customizable degree of granularity and severity. In its most basic form you use the unified [`reportIssue`]() function anywhere in your