Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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
- Host: GitHub
- URL: https://github.com/JohnSundell/TestDrive
- Owner: JohnSundell
- License: mit
- Created: 2017-04-27T21:25:39.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-11-23T23:46:45.000Z (about 4 years ago)
- Last Synced: 2024-11-21T15:43:43.423Z (21 days ago)
- Topics: cocoapods, playground, prototyping, swift, xcode
- Language: Swift
- Size: 2.43 MB
- Stars: 1,590
- Watchers: 26
- Forks: 37
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome - TestDrive - Quickly try out any Swift pod or framework in a playground (xcode)
- awesome - TestDrive - Quickly try out any Swift pod or framework in a playground (xcode)
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*