Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/JohnSundell/TestDrive

Quickly try out any Swift pod or framework in a playground
https://github.com/JohnSundell/TestDrive

cocoapods playground prototyping swift xcode

Last synced: 17 days ago
JSON representation

Quickly try out any Swift pod or framework in a playground

Awesome Lists containing this project

README

        

# Test Drive ๐Ÿš˜
[![Swift 4.1](https://img.shields.io/badge/swift-4.1-orange.svg?style=flat)](#)
[![Marathon](https://img.shields.io/badge/marathon-compatible-brightgreen.svg?style=flat)](https://github.com/johnsundell/marathon)
[![SPM](https://img.shields.io/badge/spm-compatible-brightgreen.svg?style=flat)](https://github.com/apple/swift-package-manager)
[![@johnsundell](https://img.shields.io/badge/[email protected]?style=flat)](https://twitter.com/johnsundell)

With Test Drive, you can quickly try out **any** Swift pod or framework in a playground. Simply run `testdrive` followed by the name of a pod, or the URL to a Git repository, and you will have a playground generated for you in no time!



**Features**

- [X] Quickly try out a pod/framework without having to modify your project.
- [X] Try out multiple pods/frameworks at once - ideal when comparing similar ones.
- [X] Supports iOS, macOS & tvOS.

## Usage

๐Ÿš— Take a pod for a test drive:
```
$ testdrive Unbox
```

๐Ÿš™ Take a framework from a Git URL for a test drive:
```
$ testdrive [email protected]:johnsundell/files.git
```

๐Ÿš• Take multiple pods at once for a test drive:
```
$ testdrive Unbox Wrap
```

๐ŸŽ Take a test drive on a specific platform (iOS is the default):
```
$ testdrive Unbox -p tvOS
```

๐Ÿš“ Use a specific version or branch for your test drive (the latest version is used by default):
```
$ testdrive Unbox -v 2.3.0
$ testdrive Unbox -v swift3
$ testdrive Wrap --master
```

## Installation

The easiest way to install Test Drive is using [Marathon](https://github.com/johnsundell/marathon):

```
$ marathon install johnsundell/testdrive
```

You can also install it using the Swift Package Manager:

```
$ git clone https://github.com/JohnSundell/TestDrive.git
$ cd TestDrive
$ swift build -c release
$ cp -f .build/release/TestDrive /usr/local/bin/testdrive
```

## Issues + support

I spend almost all of my available time building tools, content and learning materials for the Swift community โ€” all of which are available to everyone, for free. However, since Iโ€™m just one person, I do have to prioritize what I spend my time on โ€” and one thing Iโ€™m currently not able to offer is 1:1 support for open source projects. Thatโ€™s why this repository has Issues disabled. Itโ€™s not because I donโ€™t want to help, I really do, Iโ€™m just simply not able to.

So before you start using this tool, I recommend that you spend a few minutes familiarizing yourself with its internals (itโ€™s all normal Swift code), so that youโ€™ll be able to self-service on any issues or edge cases you might encounter.

Thanks for understanding, and I hope youโ€™ll enjoy TestDrive!

*โ€” John*