Improve constraint convenience methods

Sources/Layout/Swift/Array.swift

@@ -14,31 +14,35 @@ extension Array where Element == NSLayoutConstraint {
     @preconcurrency
     @MainActor
     @discardableResult
-    public func activate() -> [NSLayoutConstraint] {
+    public func activate() -> Self {
         NSLayoutConstraint.activate(self)
         return self
     }
 
     @preconcurrency
     @MainActor
     @discardableResult
-    public func deactivate() -> [NSLayoutConstraint] {
+    public func deactivate() -> Self {
         NSLayoutConstraint.deactivate(self)
         return self
     }
 
     @preconcurrency
     @MainActor
-    public func withPriority(
-        _ priority: UILayoutPriority
-    ) -> [NSLayoutConstraint] {
+    public func require() -> Self {
+        withPriority(.required)
+    }
+
+    @preconcurrency
+    @MainActor
+    public func withPriority(_ priority: UILayoutPriority) -> Self {
         prioritize(priority)
         return self
     }
 
     @preconcurrency
     @MainActor
     public func prioritize(_ priority: UILayoutPriority) {
-        forEach { $0.priority = priority }
+        forEach { $0.prioritize(priority) }
     }
 }

Sources/Layout/UIKit/NSLayoutConstraint.swift

@@ -48,17 +48,16 @@ extension NSLayoutConstraint {
         return self
     }
 
-    public func withConstant(_ constant: CGFloat) -> NSLayoutConstraint {
-        self.constant = constant
-        return self
+    public func require() -> NSLayoutConstraint {
+        withPriority(.required)
     }
 
     public func withPriority(_ priority: UILayoutPriority) -> NSLayoutConstraint {
-        self.priority = priority
+        prioritize(priority)
         return self
     }
 
-    public func require() -> NSLayoutConstraint {
-        withPriority(.required)
+    public func prioritize(_ priority: UILayoutPriority) {
+        self.priority = priority
     }
 }

Tests/LayoutTests/Swift/ArrayTests.swift

@@ -65,6 +65,44 @@ final class ArrayTests: XCTestCase {
         expect(deactivatedConstraints) == constraints
     }
 
+    func testRequire() {
+
+        // GIVEN
+
+        let view: UIView = .init()
+        let constraint1: NSLayoutConstraint = .init(
+            item: view,
+            attribute: .height,
+            relatedBy: .equal,
+            toItem: nil,
+            attribute: .notAnAttribute,
+            multiplier: 1,
+            constant: 0
+        )
+        let constraint2: NSLayoutConstraint = .init(
+            item: view,
+            attribute: .width,
+            relatedBy: .equal,
+            toItem: nil,
+            attribute: .notAnAttribute,
+            multiplier: 1,
+            constant: 0
+        )
+        constraint1.priority = .high
+        constraint2.priority = .high
+        let constraints: [NSLayoutConstraint] = [constraint1, constraint2]
+
+        // WHEN
+
+        let requiredConstraints: [NSLayoutConstraint] = constraints.require()
+
+        // THEN
+
+        expect(constraint1.priority) == .required
+        expect(constraint2.priority) == .required
+        expect(requiredConstraints) == constraints
+    }
+
     func testWithPriority() {
 
         // GIVEN

Tests/LayoutTests/UIKit/NSLayoutConstraintTests.swift

@@ -108,23 +108,24 @@ final class NSLayoutConstraintTests: XCTestCase {
         }
     }
 
-    func testWithConstant() {
+    func testRequire() {
 
         // GIVEN
 
         let constraint: NSLayoutConstraint = .init()
+        constraint.priority = .high
 
         // THEN
 
-        expect(constraint.constant) == 0
+        expect(constraint.priority) == .high
 
         // WHEN
 
-        _ = constraint.withConstant(5)
+        _ = constraint.require()
 
         // THEN
 
-        expect(constraint.constant) == 5
+        expect(constraint.priority) == .required
     }
 
     func testWithPriority() {
@@ -146,23 +147,22 @@ final class NSLayoutConstraintTests: XCTestCase {
         expect(constraint.priority) == .high
     }
 
-    func testRequiredPriority() {
+    func testPrioritize() {
 
         // GIVEN
 
         let constraint: NSLayoutConstraint = .init()
-        constraint.priority = .high
 
         // THEN
 
-        expect(constraint.priority) == .high
+        expect(constraint.priority) == .required
 
         // WHEN
 
-        _ = constraint.require()
+        constraint.prioritize(.high)
 
         // THEN
 
-        expect(constraint.priority) == .required
+        expect(constraint.priority) == .high
     }
 }