The Swift Helpers package provides miscellaneous helpers, including extensions and custom types. The helpers are organized into modules listed below. See the documentation or browse the source files for more information on usage or implementation details.

• Bindings: NSKeyValueBindingCreation informal protocol unbind helper.
• Controllers: NSTreeController properties for getting the topmost selection.
• Input: EventMonitor wrapper for NSEvent’s app monitoring methods.
• Menu: NSMenuItem convenience initializer, label item constructor.
• Touch bar: NSTouchBar items property, AlertStyleGroupTouchBarItem class.
• Views: NSBrowser, NSImage, NSResponder, NSTableView, NSView extensions, ModalView class.

• CALayer, CAMediaTiming extensions.

• NSManagedObjectContext, NSManagedObject extensions.

• CGFloat, CGSize extensions.

• dumpOutput(_:name:indent:maxDepth:maxItems:) returning a dump as a string.
• Stopwatch and SplitStopwatch for measuring elapsed and lap times.
• CallCounter for counting the number or balance of calls.
• ThreadCounter for counting and listing concurrent code threads.
• Thread number getter.

• ExitCodeProtocol, ExitCodeProvidingError protocols.
• exit(_:) overloads for terminating with exit codes.

• Collections: IndexPath node inspection methods.
• Data: creating and inspecting Data using set bit indices.
• Operations: OperationQueue and BlockOperation helpers.
• Processes: Process shell script initializer, runUntilExit() asynchronous wrapper.
• Scheduling: Timer convenience constructor.
• Preferences: UserDefault, UserDefaultRawRepresented, and UserDefaultJSONEncoded property wrappers.
• Resources: Bundle information helpers.
• Strings and text: CharacterSet scalars getter.
• URLs and URIs:
  • URLComponents and URL helpers for normalizing URLs according to RFC 3986;
  • URLComponents and URL helpers for validating and deriving a base URL according to RFC 3986;
  • URL helpers for relativizing URLs, stem and filename components getters, and others;
  • URL conformance to Comparable;
  • URIReferenceKind enumeration;
  • URLBookmark structure;
  • HierarchicalPath structure for path components comparison, normalization, and manipulation;
  • FilenameComponents structure for containing directory, stem, and extension manipulation.
• URL loading system: HTTPURLResponse status helpers.

• Strings and text:
  • NSRegularExpression match operator, searching and replacing helpers;
  • NSTextCheckingResult range, capture group, and line number helpers;
  • String helpers for escaping NSRegularExpression pattern and template characters.

• ExtendedLogger protocol and implementations for logging a location in source code.
• LegacyLogger structure resembling Logger for earlier versions of deployment targets.
• String filePoint() static method returning a string reference to a location in source code.

• print(_:separator:terminator:to:) overloads for writing into a file handle or the output stream of the given kind.
• BufferedOutput class for buffering output streams, accompanied by the BufferedOutputProviding protocol and BufferedOutputCollector class.
• Process helpers for getting flattened or buffered output.
• OutputStreamKind supporting enumeration.
• FileHandle conformance to TextOutputStream.

• Strings and text:
  • Regex match operator;
  • String Unicode scalar initializer, truncation, and quoted path helpers;
  • StringProtocol helpers for changing case, padding, and trimming;
  • Unicode.Scalar character initializer.
• Collections:
  • Collection helper for transforming an empty collection to nil, and a helper for joining optional strings;
  • KeyValuePairs formatting helper for monospaced output;
  • Sequence compacted method;
  • Set initializer for strings with a separator.

• Atomic property wrappers.

Add the package dependency using its URL:

https://github.com/processed-bits/swift-helpers

Add the package-level dependency on the Swift Helpers package:

dependencies: [
	.package(url: "https://github.com/processed-bits/swift-helpers", from: "3.0.0"),
]

Add target-level dependencies on the required libraries:

dependencies: [
	.product(name: "AppKitHelpers", package: "SwiftHelpers"),
	.product(name: "CoreAnimationHelpers", package: "SwiftHelpers"),
	.product(name: "CoreDataHelpers", package: "SwiftHelpers"),
	.product(name: "CoreGraphicsHelpers", package: "SwiftHelpers"),
	.product(name: "DebuggingHelpers", package: "SwiftHelpers"),
	.product(name: "ExitCodeHelpers", package: "SwiftHelpers"),
	.product(name: "FoundationHelpers", package: "SwiftHelpers"),
	.product(name: "FoundationLegacyHelpers", package: "SwiftHelpers"),
	.product(name: "LoggingHelpers", package: "SwiftHelpers"),
	.product(name: "OutputHelpers", package: "SwiftHelpers"),
	.product(name: "StandardLibraryHelpers", package: "SwiftHelpers"),
	.product(name: "SynchronizationHelpers", package: "SwiftHelpers"),
]

Documentation is available:

• In Xcode, use Build Documentation (⌃⇧⌘D) from the Product menu.
• Online at Swift Package Index.
• As documentation archives, see the ‘DocC Plugin Documentation Archive’ section below.

Add a package-level dependency on the DocC plugin:

dependencies: [
	.package(url: "https://github.com/swiftlang/swift-docc-plugin", from: "1.3.0"),
],

Generate documentation archives, then open them with Xcode to import:

swift package generate-documentation

This package follows the evolution of the Swift language, its cross-platform packages, and aims to support the latest versions of Swift on all Apple platforms and Linux. Compatibility with older Swift versions is not guaranteed, but a reasonable effort is made to support them.

See CHANGELOG.md.

Copyright © 2022-2025 Stanislav Lomachinskiy. Licensed under the MIT License.