scaling(dimensionsBy:) tests

Author: KyNorthstar

Sources/RectangleTools/Synthesized Conveniences/scaled.swift

@@ -308,6 +308,9 @@ public enum ScaleMethod {
 
 
     /// Discard the aspect ratio, and simply set the size to be the same as the parent's
+    ///
+    /// - When scaling direction is `.down`, then this might result in zero, two, or all four sides touching or passing parent sides.
+    /// - When scaling direction is `.upOrDown`, then all four sides will **always** touch parent sides.
     case stretch
 }
 
@@ -441,7 +444,7 @@ where Length: MultiplicativeArithmetic,
     ///    - direction:  _optional_ - Which direction to scale this rectangle. Defaults to `.down`
     ///
     /// - Returns: A scaled version of this rectangle, relative to the given parent
-    func scalingEdges(by multiplier: Length, direction: ScaleDirection = .down) -> Self {
+    func scaling(dimensionsBy multiplier: Length, direction: ScaleDirection = .down) -> Self {
         scaled(
             within: self * multiplier,
             method: .stretch,
@@ -490,7 +493,7 @@ where Length: MultiplicativeArithmetic,
     ///    - direction:  _optional_ - Which direction to scale this rectangle. Defaults to `.down`
     ///
     /// - Returns: A scaled version of this rectangle, relative to the given parent
-    func scalingEdges(by multiplier: Length, direction: ScaleDirection = .down) -> Self {
+    func scaling(dimensionsBy multiplier: Length, direction: ScaleDirection = .down) -> Self {
         scaled(
             within: Self(origin: .zero, size: size * multiplier)
                 .centered(within: self),

Tests/RectangleToolsTests/Testing convenience functions.swift

@@ -10,6 +10,8 @@ import RectangleTools
 
 
 
+// MARK: - Semi-equality
+
 infix operator &&= : AssignmentPrecedence
 infix operator ≈≈ : ComparisonPrecedence
 
@@ -57,3 +59,32 @@ where Value: DualTwoDimensional,
        lhs.firstDimensionPair ≈≈ rhs.firstDimensionPair
     && lhs.secondDimensionPair ≈≈ rhs.secondDimensionPair
 }
+
+
+
+// MARK: - Randomization
+
+
+
+extension CGFloat {
+    static func random() -> Self {
+        random(in: -1024...1024)
+    }
+}
+
+
+
+extension CGPoint {
+    static func random() -> Self {
+        .init(x: .random(), y: .random())
+    }
+}
+
+
+
+// MARK: - Enumerations
+
+enum AspectRatioExpectation {
+    case sameAsOriginal
+    case sameAsParent
+}