ContextQMD
Back to Swift Package Manager

swift test

Sources/PackageManagerDocs/Documentation.docc/SwiftTest.md

0.6.025.4 KB
Original Source

swift test

@Metadata { @PageImage(purpose: icon, source: command-icon) }

<!-- Generated by swift-argument-parser -->

Build and run tests.

test [--package-path=<package-path>]
  [--cache-path=<cache-path>] [--config-path=<config-path>]
  [--security-path=<security-path>]
  [--scratch-path=<scratch-path>]
  [--swift-sdks-path=<swift-sdks-path>]
  [--toolset=<toolset>...]
  [--pkg-config-path=<pkg-config-path>...]
  [--enable-dependency-cache|disable-dependency-cache]
  [--enable-build-manifest-caching|disable-build-manifest-caching]
  [--manifest-cache=<manifest-cache>]
  [--enable-experimental-prebuilts|disable-experimental-prebuilts]
  [--verbose] [--very-verbose|vv] [--quiet]
  [--color-diagnostics|no-color-diagnostics]
  [--disable-sandbox] [--netrc] 
  [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>]
  [--enable-keychain|disable-keychain]
  [--resolver-fingerprint-checking=<resolver-fingerprint-checking>]
  [--resolver-signing-entity-checking=<resolver-signing-entity-checking>]
  [--enable-signature-validation|disable-signature-validation]
  [--enable-prefetching|disable-prefetching]
  [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file]
  [--skip-update] [--disable-scm-to-registry-transformation]
  [--use-registry-identity-for-scm]
  [--replace-scm-with-registry]
  [--default-registry-url=<default-registry-url>]
  [--configuration=<configuration>] [--=<Xcc>...]
  [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]
  [--triple=<triple>] [--sdk=<sdk>]
  [--toolchain=<toolchain>] [--swift-sdk=<swift-sdk>]
  [--sanitize=<sanitize>...]
  [--auto-index-store|enable-index-store|disable-index-store]
  [--enable-parseable-module-interfaces] [--jobs=<jobs>]
  [--use-integrated-swift-driver]
  [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>]
  [--build-system=<build-system>] [--=<debug-info-format>]
  [--enable-dead-strip|disable-dead-strip]
  [--disable-local-rpath] [--skip-build]
  [--enable-xctest|disable-xctest]
  [--enable-swift-testing|disable-swift-testing]
  [--attachments-path=<attachments-path>]
  [--parallel|no-parallel] [--num-workers=<num-workers>]
  [--list-tests]
  [--show-codecov-path|show-code-coverage-path|show-coverage-path]
  [--specifier=<specifier>] [--filter=<filter>...]
  [--skip=<skip>...] [--xunit-output=<xunit-output>]
  [--enable-testable-imports|disable-testable-imports]
  [--enable-code-coverage|disable-code-coverage]
  [--traits=<traits>] [--enable-all-traits]
  [--disable-default-traits] [--version] [--help]

SEE ALSO: doc:SwiftBuild, doc:SwiftRun, doc:SwiftPackageCommands

  • term --package-path=<package-path>:

Specify the package path to operate on (default current directory). This changes the working directory before any other operation.

  • term --cache-path=<cache-path>:

Specify the shared cache directory path.

  • term --config-path=<config-path>:

Specify the shared configuration directory path.

  • term --security-path=<security-path>:

Specify the shared security directory path.

  • term --scratch-path=<scratch-path>:

Specify a custom scratch directory path. (default .build)

  • term --swift-sdks-path=<swift-sdks-path>:

Path to the directory containing installed Swift SDKs.

  • term --toolset=<toolset>:

Specify a toolset JSON file to use when building for the target platform. Use the option multiple times to specify more than one toolset. Toolsets will be merged in the order they're specified into a single final toolset for the current build.

  • term --pkg-config-path=<pkg-config-path>:

Specify alternative path to search for pkg-config .pc files. Use the option multiple times to specify more than one path.

  • term --enable-dependency-cache|disable-dependency-cache:

Use a shared cache when fetching dependencies.

  • term --enable-build-manifest-caching|disable-build-manifest-caching:

  • term --manifest-cache=<manifest-cache>:

Caching mode of Package.swift manifests. Valid values are: (shared: shared cache, local: package's build directory, none: disabled)

  • term --enable-experimental-prebuilts|disable-experimental-prebuilts:

Whether to use prebuilt swift-syntax libraries for macros.

  • term --verbose:

Increase verbosity to include informational output.

  • term --very-verbose|vv:

Increase verbosity to include debug output.

  • term --quiet:

Decrease verbosity to only include error output.

  • term --color-diagnostics|no-color-diagnostics:

Enables or disables color diagnostics when printing to a TTY. By default, color diagnostics are enabled when connected to a TTY and disabled otherwise.

  • term --disable-sandbox:

Disable using the sandbox when executing subprocesses.

  • term --netrc:

Use netrc file even in cases where other credential stores are preferred.

  • term --enable-netrc|disable-netrc:

Load credentials from a netrc file.

  • term --netrc-file=<netrc-file>:

Specify the netrc file path.

  • term --enable-keychain|disable-keychain:

Search credentials in macOS keychain.

  • term --resolver-fingerprint-checking=<resolver-fingerprint-checking>:

  • term --resolver-signing-entity-checking=<resolver-signing-entity-checking>:

  • term --enable-signature-validation|disable-signature-validation:

Validate signature of a signed package release downloaded from registry.

  • term --enable-prefetching|disable-prefetching:

  • term --force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file:

Only use versions from the Package.resolved file and fail resolution if it is out-of-date.

  • term --skip-update:

Skip updating dependencies from their remote during a resolution.

  • term --disable-scm-to-registry-transformation:

Disable source control to registry transformation.

  • term --use-registry-identity-for-scm:

Look up source control dependencies in the registry and use their registry identity when possible to help deduplicate across the two origins.

  • term --replace-scm-with-registry:

Look up source control dependencies in the registry and use the registry to retrieve them instead of source control when possible.

  • term --default-registry-url=<default-registry-url>:

Default registry URL to use, instead of the registries.json configuration file.

  • term --configuration=<configuration>:

Build with configuration

  • term --=<Xcc>:

Pass flag through to all C compiler invocations.

  • term --=<Xswiftc>:

Pass flag through to all Swift compiler invocations.

  • term --=<Xlinker>:

Pass flag through to all linker invocations.

  • term --=<Xcxx>:

Pass flag through to all C++ compiler invocations.

  • term --triple=<triple>:

  • term --sdk=<sdk>:

  • term --toolchain=<toolchain>:

  • term --swift-sdk=<swift-sdk>:

Filter for selecting a specific Swift SDK to build with.

  • term --sanitize=<sanitize>:

Turn on runtime checks for erroneous behavior, possible values: address, thread, undefined, scudo.

  • term --auto-index-store|enable-index-store|disable-index-store:

Enable or disable indexing-while-building feature.

  • term --enable-parseable-module-interfaces:

  • term --jobs=<jobs>:

The number of jobs to spawn in parallel during the build process.

  • term --use-integrated-swift-driver:

  • term --explicit-target-dependency-import-check=<explicit-target-dependency-import-check>:

A flag that indicates this build should check whether targets only import their explicitly-declared dependencies.

  • term --build-system=<build-system>:

  • term --=<debug-info-format>:

The Debug Information Format to use.

  • term --enable-dead-strip|disable-dead-strip:

Disable/enable dead code stripping by the linker.

  • term --disable-local-rpath:

Disable adding $ORIGIN/@loader_path to the rpath by default.

  • term --skip-build:

Skip building the test target.

  • term --enable-xctest|disable-xctest:

Enable support for XCTest.

  • term --enable-swift-testing|disable-swift-testing:

Enable support for Swift Testing.

  • term --attachments-path=<attachments-path>:

Path where attachments should be written (Swift Testing only). This path must be an existing directory the current user can write to. If not specified, any attachments created during testing are discarded.

  • term --parallel|no-parallel:

Run the tests in parallel.

  • term --num-workers=<num-workers>:

Number of tests to execute in parallel.

  • term --list-tests:

Lists test methods in specifier format.

  • term --show-codecov-path|show-code-coverage-path|show-coverage-path:

Print the path of the exported code coverage JSON file.

  • term --specifier=<specifier>:

  • term --filter=<filter>:

Run test cases that match a regular expression, Format: '<test-target>.<test-case>' or '<test-target>.<test-case>/<test>'.

  • term --skip=<skip>:

Skip test cases that match a regular expression, Example: '--skip PerformanceTests'.

  • term --xunit-output=<xunit-output>:

Path where the xUnit xml file should be generated.

  • term --enable-testable-imports|disable-testable-imports:

Enable or disable testable imports. Enabled by default.

  • term --enable-code-coverage|disable-code-coverage:

Enable code coverage.

  • term --traits=<traits>:

Enables the passed traits of the package. Multiple traits can be specified by providing a comma separated list e.g. --traits Trait1,Trait2. When enabling specific traits the defaults traits need to explictily enabled as well by passing defaults to this command.

  • term --enable-all-traits:

Enables all traits of the package.

  • term --disable-default-traits:

Disables all default traits of the package.

  • term --version:

Show the version.

  • term --help:

Show help information.

swift.test.list

Lists test methods in specifier format

test list [--package-path=<package-path>] [--cache-path=<cache-path>] [--config-path=<config-path>] [--security-path=<security-path>] [--scratch-path=<scratch-path>]     [--swift-sdks-path=<swift-sdks-path>] [--toolset=<toolset>...] [--pkg-config-path=<pkg-config-path>...]   [--enable-dependency-cache|disable-dependency-cache]  [--enable-build-manifest-caching|disable-build-manifest-caching] [--manifest-cache=<manifest-cache>] [--enable-experimental-prebuilts|disable-experimental-prebuilts] [--verbose] [--very-verbose|vv] [--quiet] [--color-diagnostics|no-color-diagnostics] [--disable-sandbox] [--netrc] [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>] [--enable-keychain|disable-keychain] [--resolver-fingerprint-checking=<resolver-fingerprint-checking>] [--resolver-signing-entity-checking=<resolver-signing-entity-checking>] [--enable-signature-validation|disable-signature-validation] [--enable-prefetching|disable-prefetching] [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file] [--skip-update] [--disable-scm-to-registry-transformation] [--use-registry-identity-for-scm] [--replace-scm-with-registry]  [--default-registry-url=<default-registry-url>] [--configuration=<configuration>] [--=<Xcc>...] [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]    [--triple=<triple>] [--sdk=<sdk>] [--toolchain=<toolchain>]   [--swift-sdk=<swift-sdk>] [--sanitize=<sanitize>...] [--auto-index-store|enable-index-store|disable-index-store]   [--enable-parseable-module-interfaces] [--jobs=<jobs>] [--use-integrated-swift-driver] [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>] [--build-system=<build-system>] [--=<debug-info-format>]      [--enable-dead-strip|disable-dead-strip] [--disable-local-rpath] [--skip-build]  [--enable-xctest|disable-xctest] [--enable-swift-testing|disable-swift-testing]         [--attachments-path=<attachments-path>] [--traits=<traits>] [--enable-all-traits] [--disable-default-traits]  [--version] [--help]
  • term --package-path=<package-path>:

Specify the package path to operate on (default current directory). This changes the working directory before any other operation.

  • term --cache-path=<cache-path>:

Specify the shared cache directory path.

  • term --config-path=<config-path>:

Specify the shared configuration directory path.

  • term --security-path=<security-path>:

Specify the shared security directory path.

  • term --scratch-path=<scratch-path>:

Specify a custom scratch directory path. (default .build)

  • term --swift-sdks-path=<swift-sdks-path>:

Path to the directory containing installed Swift SDKs.

  • term --toolset=<toolset>:

Specify a toolset JSON file to use when building for the target platform. Use the option multiple times to specify more than one toolset. Toolsets will be merged in the order they're specified into a single final toolset for the current build.

  • term --pkg-config-path=<pkg-config-path>:

Specify alternative path to search for pkg-config .pc files. Use the option multiple times to specify more than one path.

  • term --enable-dependency-cache|disable-dependency-cache:

Use a shared cache when fetching dependencies.

  • term --enable-build-manifest-caching|disable-build-manifest-caching:

  • term --manifest-cache=<manifest-cache>:

Caching mode of Package.swift manifests. Valid values are: (shared: shared cache, local: package's build directory, none: disabled)

  • term --enable-experimental-prebuilts|disable-experimental-prebuilts:

Whether to use prebuilt swift-syntax libraries for macros.

  • term --verbose:

Increase verbosity to include informational output.

  • term --very-verbose|vv:

Increase verbosity to include debug output.

  • term --quiet:

Decrease verbosity to only include error output.

  • term --color-diagnostics|no-color-diagnostics:

Enables or disables color diagnostics when printing to a TTY. By default, color diagnostics are enabled when connected to a TTY and disabled otherwise.

  • term --disable-sandbox:

Disable using the sandbox when executing subprocesses.

  • term --netrc:

Use netrc file even in cases where other credential stores are preferred.

  • term --enable-netrc|disable-netrc:

Load credentials from a netrc file.

  • term --netrc-file=<netrc-file>:

Specify the netrc file path.

  • term --enable-keychain|disable-keychain:

Search credentials in macOS keychain.

  • term --resolver-fingerprint-checking=<resolver-fingerprint-checking>:

  • term --resolver-signing-entity-checking=<resolver-signing-entity-checking>:

  • term --enable-signature-validation|disable-signature-validation:

Validate signature of a signed package release downloaded from registry.

  • term --enable-prefetching|disable-prefetching:

  • term --force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file:

Only use versions from the Package.resolved file and fail resolution if it is out-of-date.

  • term --skip-update:

Skip updating dependencies from their remote during a resolution.

  • term --disable-scm-to-registry-transformation:

Disable source control to registry transformation.

  • term --use-registry-identity-for-scm:

Look up source control dependencies in the registry and use their registry identity when possible to help deduplicate across the two origins.

  • term --replace-scm-with-registry:

Look up source control dependencies in the registry and use the registry to retrieve them instead of source control when possible.

  • term --default-registry-url=<default-registry-url>:

Default registry URL to use, instead of the registries.json configuration file.

  • term --configuration=<configuration>:

Build with configuration

  • term --=<Xcc>:

Pass flag through to all C compiler invocations.

  • term --=<Xswiftc>:

Pass flag through to all Swift compiler invocations.

  • term --=<Xlinker>:

Pass flag through to all linker invocations.

  • term --=<Xcxx>:

Pass flag through to all C++ compiler invocations.

  • term --triple=<triple>:

  • term --sdk=<sdk>:

  • term --toolchain=<toolchain>:

  • term --swift-sdk=<swift-sdk>:

Filter for selecting a specific Swift SDK to build with.

  • term --sanitize=<sanitize>:

Turn on runtime checks for erroneous behavior, possible values: address, thread, undefined, scudo.

  • term --auto-index-store|enable-index-store|disable-index-store:

Enable or disable indexing-while-building feature.

  • term --enable-parseable-module-interfaces:

  • term --jobs=<jobs>:

The number of jobs to spawn in parallel during the build process.

  • term --use-integrated-swift-driver:

  • term --explicit-target-dependency-import-check=<explicit-target-dependency-import-check>:

A flag that indicates this build should check whether targets only import their explicitly-declared dependencies.

  • term --build-system=<build-system>:

  • term --=<debug-info-format>:

The Debug Information Format to use.

  • term --enable-dead-strip|disable-dead-strip:

Disable/enable dead code stripping by the linker.

  • term --disable-local-rpath:

Disable adding $ORIGIN/@loader_path to the rpath by default.

  • term --skip-build:

Skip building the test target.

  • term --enable-xctest|disable-xctest:

Enable support for XCTest.

  • term --enable-swift-testing|disable-swift-testing:

Enable support for Swift Testing.

  • term --attachments-path=<attachments-path>:

Path where attachments should be written (Swift Testing only). This path must be an existing directory the current user can write to. If not specified, any attachments created during testing are discarded.

  • term --traits=<traits>:

Enables the passed traits of the package. Multiple traits can be specified by providing a comma separated list e.g. --traits Trait1,Trait2. When enabling specific traits the defaults traits need to explictily enabled as well by passing defaults to this command.

  • term --enable-all-traits:

Enables all traits of the package.

  • term --disable-default-traits:

Disables all default traits of the package.

  • term --version:

Show the version.

  • term --help:

Show help information.

swift.test.last

test last [--package-path=<package-path>] [--cache-path=<cache-path>] [--config-path=<config-path>] [--security-path=<security-path>] [--scratch-path=<scratch-path>]     [--swift-sdks-path=<swift-sdks-path>] [--toolset=<toolset>...] [--pkg-config-path=<pkg-config-path>...]   [--enable-dependency-cache|disable-dependency-cache]  [--enable-build-manifest-caching|disable-build-manifest-caching] [--manifest-cache=<manifest-cache>] [--enable-experimental-prebuilts|disable-experimental-prebuilts] [--verbose] [--very-verbose|vv] [--quiet] [--color-diagnostics|no-color-diagnostics] [--disable-sandbox] [--netrc] [--enable-netrc|disable-netrc] [--netrc-file=<netrc-file>] [--enable-keychain|disable-keychain] [--resolver-fingerprint-checking=<resolver-fingerprint-checking>] [--resolver-signing-entity-checking=<resolver-signing-entity-checking>] [--enable-signature-validation|disable-signature-validation] [--enable-prefetching|disable-prefetching] [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file] [--skip-update] [--disable-scm-to-registry-transformation] [--use-registry-identity-for-scm] [--replace-scm-with-registry]  [--default-registry-url=<default-registry-url>] [--configuration=<configuration>] [--=<Xcc>...] [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]    [--triple=<triple>] [--sdk=<sdk>] [--toolchain=<toolchain>]   [--swift-sdk=<swift-sdk>] [--sanitize=<sanitize>...] [--auto-index-store|enable-index-store|disable-index-store]   [--enable-parseable-module-interfaces] [--jobs=<jobs>] [--use-integrated-swift-driver] [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>] [--build-system=<build-system>] [--=<debug-info-format>]      [--enable-dead-strip|disable-dead-strip] [--disable-local-rpath] [--version] [--help]
  • term --package-path=<package-path>:

Specify the package path to operate on (default current directory). This changes the working directory before any other operation.

  • term --cache-path=<cache-path>:

Specify the shared cache directory path.

  • term --config-path=<config-path>:

Specify the shared configuration directory path.

  • term --security-path=<security-path>:

Specify the shared security directory path.

  • term --scratch-path=<scratch-path>:

Specify a custom scratch directory path. (default .build)

  • term --swift-sdks-path=<swift-sdks-path>:

Path to the directory containing installed Swift SDKs.

  • term --toolset=<toolset>:

Specify a toolset JSON file to use when building for the target platform. Use the option multiple times to specify more than one toolset. Toolsets will be merged in the order they're specified into a single final toolset for the current build.

  • term --pkg-config-path=<pkg-config-path>:

Specify alternative path to search for pkg-config .pc files. Use the option multiple times to specify more than one path.

  • term --enable-dependency-cache|disable-dependency-cache:

Use a shared cache when fetching dependencies.

  • term --enable-build-manifest-caching|disable-build-manifest-caching:

  • term --manifest-cache=<manifest-cache>:

Caching mode of Package.swift manifests. Valid values are: (shared: shared cache, local: package's build directory, none: disabled)

  • term --enable-experimental-prebuilts|disable-experimental-prebuilts:

Whether to use prebuilt swift-syntax libraries for macros.

  • term --verbose:

Increase verbosity to include informational output.

  • term --very-verbose|vv:

Increase verbosity to include debug output.

  • term --quiet:

Decrease verbosity to only include error output.

  • term --color-diagnostics|no-color-diagnostics:

Enables or disables color diagnostics when printing to a TTY. By default, color diagnostics are enabled when connected to a TTY and disabled otherwise.

  • term --disable-sandbox:

Disable using the sandbox when executing subprocesses.

  • term --netrc:

Use netrc file even in cases where other credential stores are preferred.

  • term --enable-netrc|disable-netrc:

Load credentials from a netrc file.

  • term --netrc-file=<netrc-file>:

Specify the netrc file path.

  • term --enable-keychain|disable-keychain:

Search credentials in macOS keychain.

  • term --resolver-fingerprint-checking=<resolver-fingerprint-checking>:

  • term --resolver-signing-entity-checking=<resolver-signing-entity-checking>:

  • term --enable-signature-validation|disable-signature-validation:

Validate signature of a signed package release downloaded from registry.

  • term --enable-prefetching|disable-prefetching:

  • term --force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file:

Only use versions from the Package.resolved file and fail resolution if it is out-of-date.

  • term --skip-update:

Skip updating dependencies from their remote during a resolution.

  • term --disable-scm-to-registry-transformation:

Disable source control to registry transformation.

  • term --use-registry-identity-for-scm:

Look up source control dependencies in the registry and use their registry identity when possible to help deduplicate across the two origins.

  • term --replace-scm-with-registry:

Look up source control dependencies in the registry and use the registry to retrieve them instead of source control when possible.

  • term --default-registry-url=<default-registry-url>:

Default registry URL to use, instead of the registries.json configuration file.

  • term --configuration=<configuration>:

Build with configuration

  • term --=<Xcc>:

Pass flag through to all C compiler invocations.

  • term --=<Xswiftc>:

Pass flag through to all Swift compiler invocations.

  • term --=<Xlinker>:

Pass flag through to all linker invocations.

  • term --=<Xcxx>:

Pass flag through to all C++ compiler invocations.

  • term --triple=<triple>:

  • term --sdk=<sdk>:

  • term --toolchain=<toolchain>:

  • term --swift-sdk=<swift-sdk>:

Filter for selecting a specific Swift SDK to build with.

  • term --sanitize=<sanitize>:

Turn on runtime checks for erroneous behavior, possible values: address, thread, undefined, scudo.

  • term --auto-index-store|enable-index-store|disable-index-store:

Enable or disable indexing-while-building feature.

  • term --enable-parseable-module-interfaces:

  • term --jobs=<jobs>:

The number of jobs to spawn in parallel during the build process.

  • term --use-integrated-swift-driver:

  • term --explicit-target-dependency-import-check=<explicit-target-dependency-import-check>:

A flag that indicates this build should check whether targets only import their explicitly-declared dependencies.

  • term --build-system=<build-system>:

  • term --=<debug-info-format>:

The Debug Information Format to use.

  • term --enable-dead-strip|disable-dead-strip:

Disable/enable dead code stripping by the linker.

  • term --disable-local-rpath:

Disable adding $ORIGIN/@loader_path to the rpath by default.

  • term --version:

Show the version.

  • term --help:

Show help information.