All Projects → PGSSoft → Automate

PGSSoft / Automate

Licence: mit
Swift framework containing a set of helpful XCTest extensions for writing UI automation tests

Programming Languages

swift
15916 projects

Projects that are alternatives of or similar to Automate

Quiz App
A repository reflecting the progress made on the "How to Build iOS Apps with Swift, TDD & Clean Architecture" YouTube series, by Caio & Mike.
Stars: ✭ 230 (-5.74%)
Mutual labels:  swift-framework, xctest
Bookstore Ios
 Sample iOS App - A collection of examples and patterns for Unit Testing, UI Testing, handling Result/Optionals, writing documentation, and more. Details in README.
Stars: ✭ 147 (-39.75%)
Mutual labels:  swift-framework, xctest
AutoMate-AppBuddy
iOS UI automation tests helper framework, designed to work with the AutoMate
Stars: ✭ 31 (-87.3%)
Mutual labels:  swift-framework, xctest
Xctestwd
A Swift implementation of WebDriver server for iOS that runs on Simulator/iOS devices.
Stars: ✭ 195 (-20.08%)
Mutual labels:  automation, xctest
Shell Novice
The Unix Shell
Stars: ✭ 234 (-4.1%)
Mutual labels:  automation
Perfect
Server-side Swift. The Perfect core toolset and framework for Swift Developers. (For mobile back-end development, website and API development, and more…)
Stars: ✭ 13,890 (+5592.62%)
Mutual labels:  swift-framework
Espurna
Home automation firmware for ESP8266-based devices
Stars: ✭ 2,650 (+986.07%)
Mutual labels:  automation
Automation Scripts
Repo for creating awesome automation scripts to make my panda lazier
Stars: ✭ 223 (-8.61%)
Mutual labels:  automation
Ary
Ary 是一个集成类工具,主要用于调用各种安全工具,从而形成便捷的一键式渗透。
Stars: ✭ 241 (-1.23%)
Mutual labels:  automation
Docker Compose Usenet
Docker-powered usenet pipeline
Stars: ✭ 240 (-1.64%)
Mutual labels:  automation
Optivideoeditor For Ios
Native Video editor : Video trim, Audio, Video merge, Slow and fast motion, Video transition, Text and image, Filters, etc...
Stars: ✭ 234 (-4.1%)
Mutual labels:  swift-framework
Aquaman
A pure-Swift library for nested display of horizontal and vertical scrolling views
Stars: ✭ 228 (-6.56%)
Mutual labels:  swift-framework
Go Expect
an expect-like golang library to automate control of terminal or console based programs.
Stars: ✭ 236 (-3.28%)
Mutual labels:  automation
Automagica
AI-powered Smart Robotic Process Automation 🤖
Stars: ✭ 2,610 (+969.67%)
Mutual labels:  automation
Igel
a delightful machine learning tool that allows you to train, test, and use models without writing code
Stars: ✭ 2,956 (+1111.48%)
Mutual labels:  automation
Chirp
Interface to manage and centralize Google Alert information
Stars: ✭ 227 (-6.97%)
Mutual labels:  automation
Metrics
📊 An infographics generator with 30+ plugins and 200+ options to display stats about your GitHub account and render them as SVG, Markdown, PDF or JSON!
Stars: ✭ 4,621 (+1793.85%)
Mutual labels:  automation
Screenshotsnanny
Android library helps take screenshots for publishing on Google Play Store.
Stars: ✭ 237 (-2.87%)
Mutual labels:  automation
Cdp4j
cdp4j - Chrome DevTools Protocol for Java
Stars: ✭ 232 (-4.92%)
Mutual labels:  automation
Grizzly
A cross-platform browser fuzzing framework
Stars: ✭ 234 (-4.1%)
Mutual labels:  automation
AutoMate, made by PGS Software

AutoMateAppBuddyTemplatesModelGenie

AutoMate

AutoMate is a Swift framework containing a set of helpful XCTest extensions for writing UI automation tests. It provides strongly typed, extensible wrapper around launch arguments and environment variables, which can be used for language, locale and keyboard type configuration on the device. With the AutoMate-AppBuddy it can also disable animations in the application and manage events, reminders and contacts.

Swift 5 Travis CocoaPods Compatible Documentation Carthage Compatible SwiftPM Compatible Platform License

AutoMate

Installation

There are three convinient ways to install AutoMate:

  • using CocoaPods with Podfile:

     pod 'AutoMate'
    
  • using Carthage and add a line to Cartfile.private:

     github "PGSSoft/AutoMate"
    

    Cartfile.private should be used because AutoMate framework will be used by UI Tests target only not by the tested application.

  • using Swift Package Manager, either via Xcode or in Package.swift:

     .package(url: "https://github.com/PGSSoft/AutoMate", from: "1.8.0"),
    

Usage

Full documentation is available at https://pgssoft.github.io/AutoMate/.

  1. Create a new UI test case class.

  2. Import AutoMate framework to UI tests files:

    import AutoMate
    
  3. Use TestLauncher in the setup() method to configure application settings and launch the application:

    let app = XCUIApplication()
    TestLauncher(options: [
        SystemLanguages([.English, .German]),
        SystemLocale(language: .English, country: .Canada),
        SoftwareKeyboards([.EnglishCanada, .GermanGermany])
    ]).configure(app).launch()
    
  4. Use AutoMate's extensions in your tests. For example:

    func testSomething() {
        let app = XCUIApplication()
        let button = app.button.element
    
        // helper for waiting until element is visible
        waitForVisibleElement(button, timeout: 20)
        button.tap()
    
        // isVisible - helper to check that element both exists and is hittable
        XCTAssertFalse(button.isVisible)
    }
    

Features (or ToDo)

  • [x] Set keyboards
  • [x] Set locale
  • [x] Set languages
  • [x] Custom arguments
  • [x] Custom keyboards, locales and languages
  • [x] XCTest extensions
  • [x] Added CoreData launch arguments
  • [x] Disable UIView animations (with AutoMate-AppBuddy)
  • [x] Strong-typed helpers: locators, page object templates (with AutoMate-Templates)
  • [x] Base XCTestCase template (with AutoMate-Templates)
  • [x] Most permissions alerts (like: LocationWhenInUseAlert, CalendarAlert, PhotosAlert) (with AutoMate-ModelGenie)
  • [x] Managing events, reminders and contacts (with AutoMate-AppBuddy)
  • [x] Companion library for the application (AutoMate-AppBuddy)
  • [x] Improve launch options type safety
  • [x] Smart coordinates
  • [x] Check if application is running in UI test environment (with AutoMate-AppBuddy)
  • [ ] Stubbing network requests
  • [ ] Stubbing contacts, events and reminders
  • [ ] Taking screenshots
  • [ ] Clearing application data
  • [ ] Stubbing notifications

Example application

Repository contains example application under AutoMateExample directory. Structure of the application is simple, but the project contains extensive suite of UI tests to showcase capabilities of the library.

Development

Full documentation is available at https://pgssoft.github.io/AutoMate/.

If you want to provide your custom launch argument or launch environment you have to implement LaunchOption protocol or one of its extensions, such as LaunchArgumentWithSingleValue:

enum CustomParameter: String, LaunchArgumentWithSingleValue, LaunchArgumentValue {
    var key: String {
        return "AppParameter"
    }
    case value1
    case value2
}

Then, you can pass it to the TestBuilder:

let launcher = TestLauncher(options: [
    CustomParameter.value1
])

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/PGSSoft/AutoMate.

License

The project is available as open source under the terms of the MIT License.

About

The project maintained by software development agency PGS Software. See our other open-source projects or contact us to develop your product.

Follow us

Twitter URL
Twitter Follow

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].