Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gh-unit/gh-unit
DEPRECATED Test Framework for Objective-C
https://github.com/gh-unit/gh-unit
Last synced: about 1 month ago
JSON representation
DEPRECATED Test Framework for Objective-C
- Host: GitHub
- URL: https://github.com/gh-unit/gh-unit
- Owner: gh-unit
- License: other
- Archived: true
- Created: 2009-01-21T04:42:01.000Z (almost 16 years ago)
- Default Branch: master
- Last Pushed: 2016-08-09T17:01:13.000Z (about 8 years ago)
- Last Synced: 2024-04-24T14:15:37.143Z (6 months ago)
- Language: Objective-C
- Homepage:
- Size: 65.6 MB
- Stars: 1,863
- Watchers: 77
- Forks: 310
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - gh-unit - Test Framework for Objective-C. (Testing / TDD / BDD)
- awesome-ios-star - gh-unit - Test Framework for Objective-C. (Testing / TDD / BDD)
README
# GHUnit [](https://github.com/gh-unit/gh-unit) [](https://travis-ci.org/gh-unit/gh-unit) [](http://gh-unit.github.io/gh-unit/) [](http://gh-unit.github.io/gh-unit/) [](http://opensource.org/licenses/MIT)
## GHUnit is deprecated and not actively maintained! Use `XCTest` instead.
GHUnit is a test framework for Mac OS X and iOS.
It can be used standalone or with other testing frameworks like SenTestingKit or GTM.
If you need support for asynchronous tests you might want to check out [GRUnit](https://github.com/gabriel/GRUnit) which is a recent fork of this project.
## Features
- Run tests, breakpoint and interact directly with the Xcode Debugger.
- Run from the command line or via a Makefile.
- Run tests in parallel.
- Allow testing of UI components.
- Capture and display test metrics.
- Search and filter tests by keywords.
- View logging by test case.
- Show stack traces and useful debugging information.
- Include as a framework in your projects
- Determine whether views have changed (UI verification)
- Quickly approve and record view changes
- View image diff to see where views have changed
## Install (iOS)
### Install the GHUnit gem
```xml
$ gem install ghunit
```
### Install the Tests target
This will edit your ProjectName.xcodeproj file and create a Tests target, scheme, and a sample test file.
```xml
$ ghunit install -n ProjectName
```
### Add the Tests target to your Podfile
Create a new file named `Podfile` in the directory that contains the your `.xcodeproj` file, or edit it if it already exists.
```ruby
# Podfile
platform :ios, '6.0'
target :Tests do
pod 'GHUnit', '~> 0.5.9'
end
```
Install your project's pods. CocoaPods will then download and configure the required libraries for your project:
```xml
$ pod install
```
Note: If you don't have a Tests target in your project, you will get an error: "[!] Unable to find a target named Tests". If you named your test target something different, such as "ProjectTests" then the Podfile target line should look like: `target :ProjectTests do` instead.
You should use the `.xcworkspace` file to work on your project:
```xml
$ open ProjectName.xcworkspace
```
### Install Command Line
```xml
$ ghunit install_cli -n ProjectName
```
Install ios-sim using homebrew:
```xml
$ brew install ios-sim
```
Now you can run tests from the command line:
```xml
$ ghunit run -n ProjectName
```
### Add a test
To generate a test in your test target with name SampleTest:
```xml
$ ghunit add -n ProjectName -f SampleTest
```
## Install (From Source)
### iOS
```bash
cd Project-iOS && make
```
Add the `GHUnitIOS.framework` to your project
### OS X
```bash
cd Project-MacOSX && make
```
Add the `GHUnit.framework` to your project
## Documentation
- [How to install, create and run tests](http://gh-unit.github.io/gh-unit/docs/index.html)
- [Online documentation](http://gh-unit.github.io/gh-unit/)
- [Google Group (Deprecated - Use Github Issues instead)](http://groups.google.com/group/ghunit)
## iOS
## Mac OS X
