{"id":31241643,"url":"https://github.com/arraypress/swift-email-validator","last_synced_at":"2025-09-23T00:13:22.853Z","repository":{"id":306674365,"uuid":"1026723093","full_name":"arraypress/swift-email-validator","owner":"arraypress","description":"A simple, robust email validation library for Swift, inspired by WordPress's battle-tested validation logic. Designed to be lightweight, fast, and RFC-compliant while providing convenient Swift-native APIs.","archived":false,"fork":false,"pushed_at":"2025-08-19T20:21:21.000Z","size":25,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-01T17:34:24.031Z","etag":null,"topics":["email-validation","ios","ios-swift","macos","swift","swift-libraries","swift-library","swift-package-manager"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arraypress.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-26T13:30:06.000Z","updated_at":"2025-09-01T13:54:20.000Z","dependencies_parsed_at":"2025-07-27T02:15:20.693Z","dependency_job_id":"d3b5d757-42a3-485c-9693-c1556ed34a0d","html_url":"https://github.com/arraypress/swift-email-validator","commit_stats":null,"previous_names":["arraypress/swift-email-validator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/arraypress/swift-email-validator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arraypress%2Fswift-email-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arraypress%2Fswift-email-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arraypress%2Fswift-email-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arraypress%2Fswift-email-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arraypress","download_url":"https://codeload.github.com/arraypress/swift-email-validator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arraypress%2Fswift-email-validator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276493615,"owners_count":25652212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-22T02:00:08.972Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email-validation","ios","ios-swift","macos","swift","swift-libraries","swift-library","swift-package-manager"],"created_at":"2025-09-23T00:13:21.412Z","updated_at":"2025-09-23T00:13:22.825Z","avatar_url":"https://github.com/arraypress.png","language":"Swift","readme":"# Swift Email Validator\n\nA simple, robust email validation library for Swift, inspired by WordPress's battle-tested validation logic. Designed to be lightweight, fast, and RFC-compliant while providing convenient Swift-native APIs.\n\n## Features\n\n- ✅ **RFC 5321/5322 compliant** validation\n- ✅ **WordPress-inspired** logic (handles billions of emails)\n- ✅ **Zero dependencies** - pure Swift\n- ✅ **Comprehensive provider detection** - recognizes major email providers\n- ✅ **Swift-native APIs** - feels natural in Swift code\n- ✅ **High performance** - optimized for speed\n- ✅ **Extensive test coverage** - 20+ test cases covering edge cases\n\n## Installation\n\n### Swift Package Manager\n\nAdd EmailValidator to your project using Xcode:\n\n1. File → Add Package Dependencies\n2. Enter: `https://github.com/arraypress/swift-email-validator`\n3. Select your desired version\n\nOr add to your `Package.swift`:\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/arraypress/swift-email-validator\", from: \"1.0.0\")\n]\n```\n\n## Quick Start\n\n```swift\nimport EmailValidator\n\n// Basic validation\n\"user@example.com\".isEmail // true\n\"invalid-email\".isEmail    // false\n\n// Get normalized email (lowercased domain)\n\"User@EXAMPLE.COM\".normalizedEmail // \"User@example.com\"\n\n// Parse email components\n\"user@example.com\".emailLocalPart // \"user\"\n\"user@example.com\".emailDomain    // \"example.com\"\n\n// Provider detection\n\"user@gmail.com\".emailProvider          // \"Gmail\"\n\"user@gmail.com\".isPersonalEmailProvider // true\n\"user@company.com\".isPersonalEmailProvider // false\n```\n\n## Core APIs\n\n### String Extensions\n\n#### `isEmail: Bool`\nValidates if the string is a properly formatted email address.\n\n```swift\n\"test@example.com\".isEmail  // true\n\"invalid\".isEmail           // false\n```\n\n#### `normalizedEmail: String?`\nReturns a normalized version with lowercased domain, or nil if invalid.\n\n```swift\n\"User@EXAMPLE.COM\".normalizedEmail // \"User@example.com\"\n\"invalid\".normalizedEmail          // nil\n```\n\n#### `emailLocalPart: String?`\nExtracts the username portion (before @).\n\n```swift\n\"user.name@example.com\".emailLocalPart // \"user.name\"\n```\n\n#### `emailDomain: String?`\nExtracts the domain portion (after @).\n\n```swift\n\"user@sub.example.com\".emailDomain // \"sub.example.com\"\n```\n\n#### `emailProvider: String?`\nDetects known email providers.\n\n```swift\n\"user@gmail.com\".emailProvider    // \"Gmail\"\n\"user@yahoo.com\".emailProvider    // \"Yahoo\"\n\"user@company.com\".emailProvider  // nil\n```\n\n#### `isPersonalEmailProvider: Bool`\nChecks if the email is from a recognized personal email provider.\n\n```swift\n\"user@gmail.com\".isPersonalEmailProvider    // true\n\"user@company.com\".isPersonalEmailProvider  // false\n```\n\n### Array Extensions\n\n#### `validEmails: [String]`\nFilters array to only valid email addresses.\n\n```swift\nlet emails = [\"valid@example.com\", \"invalid\", \"another@test.org\"]\nemails.validEmails // [\"valid@example.com\", \"another@test.org\"]\n```\n\n#### `normalizedEmails: [String]`\nReturns normalized versions of all valid emails.\n\n```swift\nlet emails = [\"User@EXAMPLE.COM\", \"invalid\", \"test@DOMAIN.ORG\"]\nemails.normalizedEmails // [\"User@example.com\", \"test@domain.org\"]\n```\n\n#### `validEmailsIfAny: [String]?`\nGet valid emails if any exist, nil otherwise.\n\n```swift\nlet emails = [\"valid@example.com\", \"invalid\", \"another@test.org\"]\nif let validEmails = emails.validEmailsIfAny {\n    print(\"Found \\(validEmails.count) valid emails\")\n} else {\n    print(\"No valid emails found\")\n}\n```\n\n#### `normalizedEmailsIfAny: [String]?`\nGet normalized emails if any exist, nil otherwise.\n\n```swift\nlet emails = [\"User@EXAMPLE.COM\", \"invalid\", \"test@DOMAIN.ORG\"]\nif let normalized = emails.normalizedEmailsIfAny {\n    print(\"Normalized emails: \\(normalized)\")\n    // Result: [\"User@example.com\", \"test@domain.org\"]\n} else {\n    print(\"No valid emails to normalize\")\n}\n```\n\n#### `hasValidEmails: Bool`\nCheck if the collection contains any valid emails.\n\n```swift\nlet emails = [\"valid@example.com\", \"invalid\", \"another@test.org\"]\nif emails.hasValidEmails {\n    print(\"Processing valid emails...\")\n    processEmails(emails.validEmails)\n}\n```\n\n### Collection Extensions\n\n#### `validEmailCount: Int`\nCounts valid email addresses in the collection.\n\n```swift\n[\"valid@example.com\", \"invalid\", \"another@test.org\"].validEmailCount // 2\n```\n\n## Supported Email Providers\n\nEmailValidator recognizes these major providers:\n\n### Google\n- Gmail (gmail.com, googlemail.com)\n\n### Microsoft\n- Outlook (outlook.com + regional variants, hotmail.com + regional variants, live.com + regional variants, msn.com)\n\n### Yahoo\n- Yahoo (yahoo.com, yahoo.co.uk, yahoo.ca, yahoo.de, yahoo.fr, yahoo.com.au, and more)\n\n### Apple\n- iCloud (icloud.com, me.com, mac.com)\n\n### Privacy-Focused\n- ProtonMail (protonmail.com, proton.me)\n- Tutanota (tutanota.com, tutanota.de)\n- Hey (hey.com)\n\n### Other Major Providers\n- AOL (aol.com + regional variants)\n- Yandex (yandex.com, yandex.ru)\n- Mail.Ru (mail.ru)\n\n### European Providers\n- GMX (gmx.de, gmx.com, gmx.net)\n- Web.de (web.de)\n- Orange (orange.fr, wanadoo.fr)\n- Free (free.fr)\n- La Poste (laposte.net)\n\n### Asian Providers\n- NetEase (163.com, 126.com)\n- QQ Mail (qq.com)\n- Naver (naver.com)\n- Daum (daum.net)\n\n### Business-Oriented\n- Zoho (zoho.com, zoho.eu)\n\n## Examples\n\n### Form Validation\n\n```swift\nfunc validateEmailField(_ email: String) -\u003e String? {\n    guard email.isEmail else {\n        return \"Please enter a valid email address\"\n    }\n    return nil\n}\n```\n\n### User Registration\n\n```swift\nfunc processSignup(email: String) {\n    guard let normalizedEmail = email.normalizedEmail else {\n        showError(\"Invalid email address\")\n        return\n    }\n    \n    if normalizedEmail.isPersonalEmailProvider {\n        // Personal email - different onboarding flow\n        showPersonalOnboarding()\n    } else {\n        // Business email - enterprise features\n        showBusinessOnboarding()\n    }\n    \n    // Store normalized email\n    user.email = normalizedEmail\n}\n```\n\n### Bulk Email Processing\n\n```swift\nfunc processEmailList(_ emails: [String]) {\n    let validEmails = emails.validEmails\n    let normalizedEmails = emails.normalizedEmails\n    \n    print(\"Found \\(emails.validEmailCount) valid emails out of \\(emails.count)\")\n    \n    // Process each email\n    for email in validEmails {\n        if let provider = email.emailProvider {\n            print(\"Email from \\(provider): \\(email)\")\n        }\n    }\n}\n```\n\n### Email Analytics\n\n```swift\nfunc analyzeEmailSignups(_ emails: [String]) {\n    let validEmails = emails.validEmails\n    let personalCount = validEmails.filter(\\.isPersonalEmailProvider).count\n    let businessCount = validEmails.count - personalCount\n    \n    print(\"Personal emails: \\(personalCount)\")\n    print(\"Business emails: \\(businessCount)\")\n    \n    // Group by provider\n    let grouped = Dictionary(grouping: validEmails) { $0.emailProvider ?? \"Other\" }\n    for (provider, emails) in grouped {\n        print(\"\\(provider): \\(emails.count) emails\")\n    }\n}\n```\n\n### Optional Handling\n\n```swift\nfunc processEmails(_ emails: [String]) {\n    // Use optional variants for cleaner code\n    if let validEmails = emails.validEmailsIfAny {\n        print(\"Processing \\(validEmails.count) valid emails\")\n        \n        if let normalized = emails.normalizedEmailsIfAny {\n            // Work with normalized emails\n            sendBulkEmail(to: normalized)\n        }\n    } else {\n        print(\"No valid emails to process\")\n    }\n    \n    // Or use boolean check\n    if emails.hasValidEmails {\n        print(\"Found valid emails, proceeding...\")\n    }\n}\n```\n\n## Performance\n\nEmailValidator is optimized for performance:\n\n- **Individual validation**: ~0.007ms per email\n- **Bulk operations**: ~0.001ms per email in arrays\n- **Zero allocations** for failed validations\n- **Lazy evaluation** in collection operations\n\n## Validation Rules\n\nEmailValidator follows RFC 5321/5322 standards with these key rules:\n\n### Email Structure\n- Must contain exactly one @ symbol\n- Local part (before @) max 64 characters\n- Domain part (after @) max 253 characters\n- Total email max 254 characters\n- Minimum 6 characters total\n\n### Local Part Rules\n- No leading or trailing dots\n- No consecutive dots\n- ASCII characters only\n- Allows: letters, numbers, and `!#$%\u0026'*+-/=?^_`{|}~.`\n\n### Domain Rules\n- At least two parts separated by dots\n- Each part max 63 characters\n- No leading/trailing hyphens in domain parts\n- Top-level domain must be at least 2 letters\n- ASCII letters, numbers, and hyphens only\n\n## Requirements\n\n- iOS 13.0+ / macOS 10.15+ / tvOS 13.0+ / watchOS 6.0+\n- Swift 5.5+\n- Xcode 13.0+\n\n## Contributing\n\nWe welcome contributions! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Add tests for new functionality\n4. Ensure all tests pass\n5. Submit a pull request\n\n## License\n\nEmailValidator is available under the MIT license. See LICENSE for details.\n\n## Credits\n\nValidation logic inspired by WordPress's `is_email()` function, adapted for Swift with modern APIs and comprehensive provider detection.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farraypress%2Fswift-email-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farraypress%2Fswift-email-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farraypress%2Fswift-email-validator/lists"}