{"id":15038359,"url":"https://github.com/fromkk/lunch","last_synced_at":"2025-08-05T06:11:57.906Z","repository":{"id":63910214,"uuid":"100027588","full_name":"fromkk/Lunch","owner":"fromkk","description":"Lunch is helper of UI Test with Swift.","archived":false,"fork":false,"pushed_at":"2019-07-18T23:09:10.000Z","size":60,"stargazers_count":55,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-26T06:34:13.830Z","etag":null,"topics":["ios","swift","swift-4","ui-testing","ui-tests"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fromkk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-11T12:06:58.000Z","updated_at":"2021-11-17T06:33:16.000Z","dependencies_parsed_at":"2022-11-29T07:14:33.566Z","dependency_job_id":null,"html_url":"https://github.com/fromkk/Lunch","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/fromkk/Lunch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fromkk%2FLunch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fromkk%2FLunch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fromkk%2FLunch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fromkk%2FLunch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fromkk","download_url":"https://codeload.github.com/fromkk/Lunch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fromkk%2FLunch/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268844819,"owners_count":24316058,"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-08-05T02:00:12.334Z","response_time":2576,"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":["ios","swift","swift-4","ui-testing","ui-tests"],"created_at":"2024-09-24T20:38:10.727Z","updated_at":"2025-08-05T06:11:57.850Z","avatar_url":"https://github.com/fromkk.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://app.bitrise.io/app/f867ecf1d4e7e2b0/status.svg?token=ojd97UYMck4Wj2LREpRTiQ)](https://app.bitrise.io/app/f867ecf1d4e7e2b0)\n\n# Lunch\n\n\u003cimg src=\"https://user-images.githubusercontent.com/322930/31062950-9f8bf88c-a769-11e7-962a-2f228c4b2de7.png\" width=\"480\" height=\"auto\"\u003e\n\nLunch is helper of UI Test with Swift.\n\n## Requirements\n\n- Swift 4.0 or later\n- iOS 9 or later\n\n## Installation\n\n### Carthage\n\n- Insert `github \"fromkk/Lunch\"` to your `Cartfile` .\n- Run `carthage update`\n- Link your app with `Lunch.framework` in `Carthage/Build`\n- Link your UI test target with `LunchTest.framework` in `Carthage/Build`\n\n## Usage\n\nIn App target adopt protocol `Creatable`.\n\n```swift\nimport Lunch\n\nstruct Creator: Creatable {\n    func create\u003cT\u003e(_ identifier: String, userInfo: [AnyHashable : Any]?) -\u003e T? {\n        switch identifier {\n        case \"LunchViewController\":\n            return self.lunchViewController() as? T\n        default:\n            return nil\n        }\n    }\n}\n\nextension Creatable {\n    func lunchViewController() -\u003e LunchViewController {\n        let storyboard = UIStoryboard(name: \"Main\", bundle: Bundle.main)\n        return storyboard.instantiateInitialViewController() as! LunchViewController\n    }\n}\n\n```\n\n```swift\n// AppDelegate.swift\nimport Lunch\n\nlet creator = Creator()\nlet rootViewController: UIViewController\n#if DEBUG\nif let viewController: UIViewController = Launcher(with: creator).launch() {\n    rootViewController = viewController\n} else {\n    rootViewController = creator.lunchViewController()\n}\n#else\nrootViewController = creator.lunchViewController()\n#endif\nwindow?.rootViewController = rootViewController\n```\n\n\u003e NOTE: If you want change rootViewController after `Run` Xcode, set `LAUNCH_VIEW_CONTROLLER` key and viewController name to value in `Environment Variables` of your scheme.\n\nIn UI Test target.\n\n1 Add component and adopt protocol `PageObjectsRepresentable`.\n\n```swift\nimport XCTest\nimport LunchTest\n\nstruct LunchViewControllerPage: PageObjectsRepresentable {\n    var app: XCUIApplication\n    init(app: XCUIApplication) {\n        self.app = app\n    }\n\n    var lunchLabel: XCUIElement {\n        return self.app.staticTexts[\"lunchLabel\"]\n    }\n}\n```\n\n2 Add your tests and adopt protocol `ViewControllerTestable`\n\n```swift\nimport XCTest\nimport LunchTest\n\nclass LunchViewControllerTests: XCTestCase, ViewControllerTestable {\n\n    var viewControllerName: String {\n        return \"LunchViewController\"\n    }\n\n    override func setUp() {\n        super.setUp()\n\n        continueAfterFailure = false\n    }\n\n    func testLunchLabel() {\n        let launcher = Launcher(targetViewController: self)\n        let app = launcher.launch()\n\n        let page = LunchViewControllerPage(app: app)\n        XCTAssertTrue(page.lunchLabel.exists)\n        XCTAssertEqual(page.lunchLabel.label, \"Lunch\")\n    }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffromkk%2Flunch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffromkk%2Flunch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffromkk%2Flunch/lists"}