feat: add contains substring validation rule

Author: ns-vasilev

README.md

@@ -309,6 +309,7 @@ struct RegistrationView: View {
 | `EmailValidationRule` | Validates email format | `EmailValidationRule(error: "Please enter a valid email")` |
 | `CharactersValidationRule` | Validates that a string contains only characters from the allowed CharacterSet | `CharactersValidationRule(characterSet: .letters, error: "Invalid characters")` |
 | `NilValidationRule` | Validates that value is nil | `NilValidationRule(error: "Value must be nil")`
+| `ContainsValidationRule` | Validates that a string contains a specific substring | `ContainsValidationRule(substring: "@", error: "Must contain @")`
 
 ## Custom Validators
 

Sources/ValidatorCore/Classes/Rules/ContainsValidationRule.swift

@@ -0,0 +1,43 @@
+//
+// Validator
+// Copyright © 2025 Space Code. All rights reserved.
+//
+
+/// Validates that a string contains a specific substring.
+///
+/// # Example:
+/// ```swift
+/// let rule = ContainsValidationRule(substring: "@", error: "Must contain @")
+/// rule.validate(input: "user@example.com") // true
+/// ```
+public struct ContainsValidationRule: IValidationRule {
+    // MARK: Types
+
+    public typealias Input = String
+
+    // MARK: Properties
+
+    /// The substring that the input must contain.
+    public let substring: String
+
+    /// The validation error.
+    public let error: IValidationError
+
+    // MARK: Initialization
+
+    /// Creates a validation rule that checks whether the input contains a required substring.
+    ///
+    /// - Parameters:
+    ///   - substring: The string the input must contain.
+    ///   - error: The validation error associated with failed validation.
+    public init(substring: String, error: IValidationError) {
+        self.substring = substring
+        self.error = error
+    }
+
+    // MARK: IValidationRule
+
+    public func validate(input: String) -> Bool {
+        input.contains(substring)
+    }
+}

Sources/ValidatorCore/Validator.docc/Overview.md

@@ -31,6 +31,7 @@ ValidatorCore contains all core validation rules, utilities, and mechanisms for
 - ``RegexValidationRule``
 - ``SuffixValidationRule``
 - ``URLValidationRule``
+- ``ContainsValidationRule``
 
 ### Articles
 

Tests/ValidatorCoreTests/UnitTests/Rules/ContainsValidationRuleTests.swift

@@ -0,0 +1,73 @@
+//
+// Validator
+// Copyright © 2025 Space Code. All rights reserved.
+//
+
+@testable import ValidatorCore
+import XCTest
+
+// MARK: - ContainsValidationRuleTests
+
+final class ContainsValidationRuleTests: XCTestCase {
+    // MARK: Properties
+
+    private var sut: ContainsValidationRule!
+
+    // MARK: XCTestCase
+
+    override func setUp() {
+        super.setUp()
+        sut = ContainsValidationRule(substring: "@", error: String.error)
+    }
+
+    override func tearDown() {
+        sut = nil
+        super.tearDown()
+    }
+
+    // MARK: Tests
+
+    func test_thatContainsValidationRuleSetsProperties() {
+        // then
+        XCTAssertEqual(sut.substring, "@")
+        XCTAssertEqual(sut.error.message, .error)
+    }
+
+    func test_thatRuleReturnsTrue_whenInputContainsSubstring() {
+        // when
+        let result = sut.validate(input: "user@example.com")
+
+        // then
+        XCTAssertTrue(result)
+    }
+
+    func test_thatRuleReturnsFalse_whenInputDoesNotContainSubstring() {
+        // when
+        let result = sut.validate(input: "userexample.com")
+
+        // then
+        XCTAssertFalse(result)
+    }
+
+    func test_thatRuleReturnsFalse_whenInputIsEmpty() {
+        // when
+        let result = sut.validate(input: "")
+
+        // then
+        XCTAssertFalse(result)
+    }
+
+    func test_thatRuleReturnsTrue_whenSubstringAppearsMultipleTimes() {
+        // when
+        let result = sut.validate(input: "@user@domain.com")
+
+        // then
+        XCTAssertTrue(result)
+    }
+}
+
+// MARK: - Constants
+
+private extension String {
+    static let error = "Must contain @"
+}