CypherPoet/UnitIntervalPropertyWrapper
A Swift Property Wrapper for automatically clamping floating-point values within a closed range of [0,1].
Installation
Xcode Projects
Select File -> Swift Packages -> Add Package Dependency and enter https://github.com/CypherPoet/UnitIntervalPropertyWrapper.
Swift Package Manager Projects
You can add UnitIntervalPropertyWrapper as a package dependency in your Package.swift file:
let package = Package(
//...
dependencies: [
.package(
url: "https://github.com/CypherPoet/UnitIntervalPropertyWrapper",
.upToNextMinor(from: "0.1.0")
),
],
//...
)From there, refer to UnitIntervalPropertyWrapper as a "target dependency" in any of your package's targets that need it.
targets: [
.target(
name: "YourLibrary",
dependencies: [
"UnitIntervalPropertyWrapper",
],
...
),
...
]Then simply import UnitIntervalPropertyWrapper wherever youβd like to use it.
Usage
Basic Usage Example:
import UnitIntervalPropertyWrapper
struct AwesomePhoto {
@UnitInterval
public var opacity: Double
@UnitInterval
public var animationProgress: Double = 0.0
}
var photo = AwesomePhoto(opacity: 100)
photo.opacity // 1.0
photo.animationProgress // 0.0
photo.animationProgress = -2.2
photo.animationProgress // 0.0Also, feel free to use this project's Xcode Playground to explore things further.
Contributing
Contributions to UnitIntervalPropertyWrapper are most welcome. Check out some of the issue templates for more info.
π» Developing
Requirements
- Xcode 12.5+ (Recommended)
π Generating Documentation
Documentation is generated by Jazzy. Installation instructions can be found here, and as soon as you have it set up, docs can be generated simply by running jazzy from the command line.
π Note that this will only generate the docs folder for you to view locally. This folder is being ignored by git, as an action exists to automatically generate docs at the root level and serve them on the project's gh-pages branch.
π· License
UnitIntervalPropertyWrapper is available under the MIT license. See the LICENSE file for more info.
Package Metadata
Repository: CypherPoet/UnitIntervalPropertyWrapper
Homepage: https://cypherpoet.github.io/swift-unit-interval-property-wrapper/
Stars: 1
Forks: 0
Open issues: 0
Default branch: main
Primary language: swift
License: MIT
Topics: input-validation, property-wrappers, swift, swift-input-validation, swift-package-manager, swift-packages, swift-property-wrapper-packages, swift-property-wrappers, swift-world-domination, unit-intervals
README: README.md