mirror of
https://github.com/mas-cli/mas
synced 2024-11-26 05:20:18 +00:00
Merge pull request #169 from tonyarnold/carthage
Use Carthage rather than CocoaPods to manage dependencies
This commit is contained in:
commit
49a17840ee
1199 changed files with 113974 additions and 218 deletions
2
.github/config.yml
vendored
Normal file
2
.github/config.yml
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
todo:
|
||||||
|
exclude: "^Carthage/"
|
1
Brewfile
Normal file
1
Brewfile
Normal file
|
@ -0,0 +1 @@
|
||||||
|
brew "carthage"
|
2
Cartfile
Normal file
2
Cartfile
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
github "Carthage/Commandant"
|
||||||
|
github "antitypical/Result"
|
2
Cartfile.private
Normal file
2
Cartfile.private
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
github "Quick/Quick"
|
||||||
|
github "Quick/Nimble"
|
4
Cartfile.resolved
Normal file
4
Cartfile.resolved
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
github "Carthage/Commandant" "0.15.0"
|
||||||
|
github "Quick/Nimble" "v7.3.0"
|
||||||
|
github "Quick/Quick" "v1.3.1"
|
||||||
|
github "antitypical/Result" "4.0.0"
|
24
Carthage/Checkouts/Commandant/.gitignore
vendored
Normal file
24
Carthage/Checkouts/Commandant/.gitignore
vendored
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
# Xcode
|
||||||
|
#
|
||||||
|
.DS_Store
|
||||||
|
build/
|
||||||
|
*.pbxuser
|
||||||
|
!default.pbxuser
|
||||||
|
*.mode1v3
|
||||||
|
!default.mode1v3
|
||||||
|
*.mode2v3
|
||||||
|
!default.mode2v3
|
||||||
|
*.perspectivev3
|
||||||
|
!default.perspectivev3
|
||||||
|
xcuserdata
|
||||||
|
*.xccheckout
|
||||||
|
*.moved-aside
|
||||||
|
DerivedData
|
||||||
|
*.hmap
|
||||||
|
*.ipa
|
||||||
|
*.xcuserstate
|
||||||
|
*.xcscmblueprint
|
||||||
|
|
||||||
|
Carthage/Build
|
||||||
|
Packages/
|
||||||
|
.build/
|
12
Carthage/Checkouts/Commandant/.gitmodules
vendored
Normal file
12
Carthage/Checkouts/Commandant/.gitmodules
vendored
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
[submodule "Carthage/Checkouts/Nimble"]
|
||||||
|
path = Carthage/Checkouts/Nimble
|
||||||
|
url = https://github.com/Quick/Nimble.git
|
||||||
|
[submodule "Carthage/Checkouts/Quick"]
|
||||||
|
path = Carthage/Checkouts/Quick
|
||||||
|
url = https://github.com/Quick/Quick.git
|
||||||
|
[submodule "Carthage/Checkouts/xcconfigs"]
|
||||||
|
path = Carthage/Checkouts/xcconfigs
|
||||||
|
url = https://github.com/jspahrsummers/xcconfigs.git
|
||||||
|
[submodule "Carthage/Checkouts/Result"]
|
||||||
|
path = Carthage/Checkouts/Result
|
||||||
|
url = https://github.com/antitypical/Result.git
|
1
Carthage/Checkouts/Commandant/.swift-version
vendored
Normal file
1
Carthage/Checkouts/Commandant/.swift-version
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
4.1.2
|
86
Carthage/Checkouts/Commandant/.travis.yml
vendored
Normal file
86
Carthage/Checkouts/Commandant/.travis.yml
vendored
Normal file
|
@ -0,0 +1,86 @@
|
||||||
|
aliases:
|
||||||
|
- &xcode
|
||||||
|
script: set -o pipefail && xcodebuild -workspace "$TRAVIS_XCODE_WORKSPACE" -scheme "$TRAVIS_XCODE_SCHEME" test | xcpretty
|
||||||
|
xcode_workspace: Commandant.xcworkspace
|
||||||
|
xcode_scheme: Commandant
|
||||||
|
os: osx
|
||||||
|
language: objective-c
|
||||||
|
- &cocoapods
|
||||||
|
script:
|
||||||
|
- rm .swift-version
|
||||||
|
- pod repo update master
|
||||||
|
- pod lib lint --verbose
|
||||||
|
os: osx
|
||||||
|
language: objective-c
|
||||||
|
env: JOB=CocoaPods
|
||||||
|
- &swiftpm
|
||||||
|
script:
|
||||||
|
- swift --version
|
||||||
|
- swift build
|
||||||
|
- swift test
|
||||||
|
git:
|
||||||
|
submodules: false
|
||||||
|
- &swiftpm_darwin
|
||||||
|
<<: *swiftpm
|
||||||
|
os: osx
|
||||||
|
language: objective-c
|
||||||
|
env: JOB=SPM
|
||||||
|
- &swiftpm_linux
|
||||||
|
<<: *swiftpm
|
||||||
|
sudo: required
|
||||||
|
dist: trusty
|
||||||
|
language: generic
|
||||||
|
install:
|
||||||
|
- eval "$(curl -sL https://gist.githubusercontent.com/kylef/5c0475ff02b7c7671d2a/raw/02090c7ede5a637b76e6df1710e83cd0bbe7dcdf/swiftenv-install.sh)"
|
||||||
|
|
||||||
|
branches:
|
||||||
|
only:
|
||||||
|
- master
|
||||||
|
|
||||||
|
matrix:
|
||||||
|
include:
|
||||||
|
- <<: *xcode
|
||||||
|
osx_image: xcode9.2
|
||||||
|
env: JOB=Xcode9.2
|
||||||
|
- <<: *xcode
|
||||||
|
osx_image: xcode9.4
|
||||||
|
env: JOB=Xcode9.4
|
||||||
|
- <<: *cocoapods
|
||||||
|
osx_image: xcode9.4
|
||||||
|
- <<: *swiftpm_darwin
|
||||||
|
osx_image: xcode9.2
|
||||||
|
- <<: *swiftpm_darwin
|
||||||
|
osx_image: xcode9.4
|
||||||
|
- <<: *swiftpm_linux
|
||||||
|
env:
|
||||||
|
- JOB=Linux
|
||||||
|
- SWIFT_VERSION=4.0.3
|
||||||
|
- <<: *swiftpm_linux
|
||||||
|
env:
|
||||||
|
- JOB=Linux
|
||||||
|
- <<: *swiftpm_linux
|
||||||
|
env:
|
||||||
|
- JOB=Linux
|
||||||
|
- SWIFT_VERSION=4.2-DEVELOPMENT-SNAPSHOT-2018-07-05-a
|
||||||
|
|
||||||
|
notifications:
|
||||||
|
email: false
|
||||||
|
slack:
|
||||||
|
secure: DBDJCDEfXVb4g1/vziIYpjwCE5dh75SwBGZAcqbk6wOl6KFS9lA+fk/PtAbuXAEkRNr5qv56aQ+NPRnjSdqmhKB9bwywxUI7LA1JlvxAk6HUya0XWLLH0dvkRJG1o6QWiOnZ79gjWvl/VuN/YH9X7SgwdTTA4xush8ogP+ku8YE=
|
||||||
|
|
||||||
|
before_deploy:
|
||||||
|
- brew update
|
||||||
|
- brew outdated carthage || brew upgrade carthage
|
||||||
|
- carthage build --no-skip-current --platform mac
|
||||||
|
- carthage archive Commandant
|
||||||
|
|
||||||
|
deploy:
|
||||||
|
provider: releases
|
||||||
|
api_key:
|
||||||
|
secure: C5x9Hj0fip8nfrke4AhGNDsmpQsjiB/Mbu6yKwW0MFn46cys64uPajKMDmwcK0512h4eW1HxkmKkaiqfv42gN3Qq+iDmmC7+DNSXgZQ/bj2h5O/t85L6Y+JQGhqbZ6XwAoEcyzFvmkbczR+Xtd0RwQR4WUhqIRElmlCfHe20ST8=
|
||||||
|
file: Commandant.framework.zip
|
||||||
|
skip_cleanup: true
|
||||||
|
on:
|
||||||
|
repo: Carthage/Commandant
|
||||||
|
tags: true
|
||||||
|
condition: $JOB = Xcode9.4
|
17
Carthage/Checkouts/Commandant/CONTRIBUTING.md
vendored
Normal file
17
Carthage/Checkouts/Commandant/CONTRIBUTING.md
vendored
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
We love that you’re interested in contributing!
|
||||||
|
|
||||||
|
Please file issues or submit pull requests for anything you’d like to see! We just have a couple of guidelines to make things easier for everyone involved.
|
||||||
|
|
||||||
|
## Prefer pull requests
|
||||||
|
|
||||||
|
If you know exactly how to implement the feature being suggested or fix the bug being reported, please open a pull request instead of an issue. Pull requests are easier than patches or inline code blocks for discussing and merging the changes.
|
||||||
|
|
||||||
|
If you can’t make the change yourself, please open an issue after making sure that one isn’t already logged.
|
||||||
|
|
||||||
|
## Code style
|
||||||
|
|
||||||
|
If you’re interested in contributing code, please have a look at our [style guide](https://github.com/github/swift-style-guide), which we try to match fairly closely.
|
||||||
|
|
||||||
|
If you have a case that is not covered in the style guide, simply do your best to match the style of the surrounding code.
|
||||||
|
|
||||||
|
**Thanks for contributing! :boom::camel:**
|
1
Carthage/Checkouts/Commandant/Cartfile
vendored
Normal file
1
Carthage/Checkouts/Commandant/Cartfile
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
github "antitypical/Result" ~> 4.0
|
3
Carthage/Checkouts/Commandant/Cartfile.private
vendored
Normal file
3
Carthage/Checkouts/Commandant/Cartfile.private
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
github "jspahrsummers/xcconfigs" ~> 0.9
|
||||||
|
github "Quick/Quick" ~> 1.3
|
||||||
|
github "Quick/Nimble" ~> 7.1.2
|
4
Carthage/Checkouts/Commandant/Cartfile.resolved
vendored
Normal file
4
Carthage/Checkouts/Commandant/Cartfile.resolved
vendored
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
github "Quick/Nimble" "v7.1.2"
|
||||||
|
github "Quick/Quick" "v1.3.0"
|
||||||
|
github "antitypical/Result" "4.0.0"
|
||||||
|
github "jspahrsummers/xcconfigs" "0.9"
|
36
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.github/ISSUE_TEMPLATE
vendored
Normal file
36
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.github/ISSUE_TEMPLATE
vendored
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
- [ ] I have read [CONTRIBUTING](https://github.com/Quick/Nimble/blob/master/CONTRIBUTING.md) and have done my best to follow them.
|
||||||
|
|
||||||
|
### What did you do?
|
||||||
|
|
||||||
|
Please replace this with what you did.
|
||||||
|
|
||||||
|
### What did you expect to happen?
|
||||||
|
|
||||||
|
Please replace this with what you expected to happen.
|
||||||
|
|
||||||
|
### What actually happened instead?
|
||||||
|
|
||||||
|
Please replace this with what happened instead.
|
||||||
|
|
||||||
|
### Environment
|
||||||
|
|
||||||
|
List the software versions you're using:
|
||||||
|
|
||||||
|
- Quick: *?.?.?*
|
||||||
|
- Nimble: *?.?.?*
|
||||||
|
- Xcode Version: *?.? (????)* (Open Xcode; In menubar: Xcode > About Xcode)
|
||||||
|
- Swift Version: *?.?* (Open Xcode Preferences; Components > Toolchains. If none, use `Xcode Default`.)
|
||||||
|
|
||||||
|
Please also mention which package manager you used and its version. Delete the
|
||||||
|
other package managers in this list:
|
||||||
|
|
||||||
|
- Cocoapods: *?.?.?* (Use `pod --version` in Terminal)
|
||||||
|
- Carthage: *?.?* (Use `carthage version` in Terminal)
|
||||||
|
- Swift Package Manager *?.?.? (swiftpm-???)* (Use `swift build --version` in Terminal)
|
||||||
|
|
||||||
|
### Project that demonstrates the issue
|
||||||
|
|
||||||
|
Please link to a project we can download that reproduces the issue. Feel free
|
||||||
|
to delete this section if it's not relevant to the issue (eg - feature request).
|
||||||
|
|
||||||
|
The project should be [short, self-contained, and correct example](http://sscce.org/).
|
14
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.github/PULL_REQUEST_TEMPLATE
vendored
Normal file
14
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.github/PULL_REQUEST_TEMPLATE
vendored
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
The PR should summarize what was changed and why. Here are some questions to
|
||||||
|
help you if you're not sure:
|
||||||
|
|
||||||
|
- What behavior was changed?
|
||||||
|
- What code was refactored / updated to support this change?
|
||||||
|
- What issues are related to this PR? Or why was this change introduced?
|
||||||
|
|
||||||
|
Checklist - While not every PR needs it, new features should consider this list:
|
||||||
|
|
||||||
|
- [ ] Does this have tests?
|
||||||
|
- [ ] Does this have documentation?
|
||||||
|
- [ ] Does this break the public API (Requires major version bump)?
|
||||||
|
- [ ] Is this a new feature (Requires minor version bump)?
|
||||||
|
|
29
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.gitignore
vendored
Normal file
29
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.gitignore
vendored
Normal file
|
@ -0,0 +1,29 @@
|
||||||
|
.DS_Store
|
||||||
|
**/xcuserdata/*
|
||||||
|
**/*.xccheckout
|
||||||
|
**/*.xcscmblueprint
|
||||||
|
build/
|
||||||
|
.idea
|
||||||
|
DerivedData/
|
||||||
|
Nimble.framework.zip
|
||||||
|
|
||||||
|
# Carthage
|
||||||
|
#
|
||||||
|
# Add this line if you want to avoid checking in source code from Carthage dependencies.
|
||||||
|
# Carthage/Checkouts
|
||||||
|
Carthage/Checkouts/**/*.*
|
||||||
|
Carthage/Checkouts/**/Cart*
|
||||||
|
Carthage/Checkouts/**/Tests
|
||||||
|
!Carthage/Checkouts/**/LICENSE.*
|
||||||
|
!Carthage/Checkouts/**/*.md
|
||||||
|
!Carthage/Checkouts/**/*.swift
|
||||||
|
!Carthage/Checkouts/**/*.h
|
||||||
|
!Carthage/Checkouts/**/*.m
|
||||||
|
!Carthage/Checkouts/**/*.c
|
||||||
|
Carthage/Build
|
||||||
|
|
||||||
|
# Swift Package Manager
|
||||||
|
#
|
||||||
|
# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
|
||||||
|
# Packages/
|
||||||
|
.build/
|
2
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.hound.yml
vendored
Normal file
2
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.hound.yml
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
swift:
|
||||||
|
config_file: .swiftlint.yml
|
1
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.swift-version
vendored
Normal file
1
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.swift-version
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
3.0
|
19
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.swiftlint.yml
vendored
Normal file
19
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.swiftlint.yml
vendored
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
disabled_rules:
|
||||||
|
- todo
|
||||||
|
- variable_name
|
||||||
|
- force_try
|
||||||
|
- force_cast
|
||||||
|
|
||||||
|
included:
|
||||||
|
- Sources
|
||||||
|
- Tests
|
||||||
|
|
||||||
|
excluded:
|
||||||
|
- Carthage/Checkouts
|
||||||
|
|
||||||
|
trailing_comma:
|
||||||
|
mandatory_comma: true
|
||||||
|
|
||||||
|
line_length:
|
||||||
|
ignores_comments: true
|
||||||
|
ignores_function_declarations: true
|
39
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.travis.yml
vendored
Normal file
39
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/.travis.yml
vendored
Normal file
|
@ -0,0 +1,39 @@
|
||||||
|
osx_image: xcode8.3
|
||||||
|
language: generic
|
||||||
|
matrix:
|
||||||
|
include:
|
||||||
|
- os: osx
|
||||||
|
sudo: required
|
||||||
|
env: TYPE=podspec
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=ios NIMBLE_RUNTIME_IOS_SDK_VERSION=10.0
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=tvos NIMBLE_RUNTIME_TVOS_SDK_VERSION=10.0
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=macos
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=macos
|
||||||
|
osx_image: xcode9
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=swiftpm
|
||||||
|
- os: osx
|
||||||
|
env: TYPE=swiftpm
|
||||||
|
osx_image: xcode9
|
||||||
|
- os: linux
|
||||||
|
dist: trusty
|
||||||
|
sudo: required
|
||||||
|
env: TYPE=swiftpm
|
||||||
|
install:
|
||||||
|
- eval "$(curl -sL https://gist.githubusercontent.com/kylef/5c0475ff02b7c7671d2a/raw/9f442512a46d7a2af7b850d65a7e9bd31edfb09b/swiftenv-install.sh)"
|
||||||
|
- os: linux
|
||||||
|
dist: trusty
|
||||||
|
sudo: required
|
||||||
|
env:
|
||||||
|
- TYPE=swiftpm
|
||||||
|
- SWIFT_VERSION=4.0.2
|
||||||
|
install:
|
||||||
|
- eval "$(curl -sL https://gist.githubusercontent.com/kylef/5c0475ff02b7c7671d2a/raw/9f442512a46d7a2af7b850d65a7e9bd31edfb09b/swiftenv-install.sh)"
|
||||||
|
install:
|
||||||
|
- if [[ "$TYPE" == "podspec" ]]; then sudo gem install bundler; bundle install; fi
|
||||||
|
script:
|
||||||
|
- ./test $TYPE
|
120
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/CONTRIBUTING.md
vendored
Normal file
120
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/CONTRIBUTING.md
vendored
Normal file
|
@ -0,0 +1,120 @@
|
||||||
|
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
||||||
|
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
||||||
|
|
||||||
|
- [Welcome to Nimble!](#welcome-to-nimble!)
|
||||||
|
- [Reporting Bugs](#reporting-bugs)
|
||||||
|
- [Building the Project](#building-the-project)
|
||||||
|
- [Pull Requests](#pull-requests)
|
||||||
|
- [Style Conventions](#style-conventions)
|
||||||
|
- [Core Members](#core-members)
|
||||||
|
- [Code of Conduct](#code-of-conduct)
|
||||||
|
|
||||||
|
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
||||||
|
|
||||||
|
# Welcome to Nimble!
|
||||||
|
|
||||||
|
We're building a testing framework for a new generation of Swift and
|
||||||
|
Objective-C developers.
|
||||||
|
|
||||||
|
Nimble should be easy to use and easy to maintain. Let's keep things
|
||||||
|
simple and well-tested.
|
||||||
|
|
||||||
|
**tl;dr:** If you've added a file to the project, make sure it's
|
||||||
|
included in both the OS X and iOS targets.
|
||||||
|
|
||||||
|
## Reporting Bugs
|
||||||
|
|
||||||
|
Nothing is off-limits. If you're having a problem, we want to hear about
|
||||||
|
it.
|
||||||
|
|
||||||
|
- See a crash? File an issue.
|
||||||
|
- Code isn't compiling, but you don't know why? Sounds like you should
|
||||||
|
submit a new issue, bud.
|
||||||
|
- Went to the kitchen, only to forget why you went in the first place?
|
||||||
|
Better submit an issue.
|
||||||
|
|
||||||
|
Be sure to include in your issue:
|
||||||
|
|
||||||
|
- Your Xcode version (eg - Xcode 7.0.1 7A1001)
|
||||||
|
- Your version of Nimble (eg - v2.0.0 or git sha `20a3f3b4e63cc8d97c92c4164bf36f2a2c9a6e1b`)
|
||||||
|
- What are the steps to reproduce this issue?
|
||||||
|
- What platform are you using? (eg - OS X, iOS, watchOS, tvOS)
|
||||||
|
- If the problem is on a UI Testing Bundle, Unit Testing Bundle, or some other target configuration
|
||||||
|
- Are you using carthage or cocoapods?
|
||||||
|
|
||||||
|
## Building the Project
|
||||||
|
|
||||||
|
- Use `Nimble.xcodeproj` to work on Nimble.
|
||||||
|
|
||||||
|
## Running the Swift Package Manager tests
|
||||||
|
|
||||||
|
1. Install `swiftenv` by running a line from the build script (`.travis.yml`):
|
||||||
|
|
||||||
|
eval "$(curl -sL https://gist.githubusercontent.com/kylef/5c0475ff02b7c7671d2a/raw/02090c7ede5a637b76e6df1710e83cd0bbe7dcdf/swiftenv-install.sh)"
|
||||||
|
|
||||||
|
2. Run `./test swiftpm`
|
||||||
|
|
||||||
|
## Pull Requests
|
||||||
|
|
||||||
|
- Nothing is trivial. Submit pull requests for anything: typos,
|
||||||
|
whitespace, you name it.
|
||||||
|
- Not all pull requests will be merged, but all will be acknowledged. If
|
||||||
|
no one has provided feedback on your request, ping one of the owners
|
||||||
|
by name.
|
||||||
|
- Make sure your pull request includes any necessary updates to the
|
||||||
|
README or other documentation.
|
||||||
|
- Be sure the unit tests for both the OS X and iOS targets of Nimble
|
||||||
|
before submitting your pull request. You can run all the OS X & iOS unit
|
||||||
|
tests using `./test`.
|
||||||
|
- If you've added a file to the project, make sure it's included in both
|
||||||
|
the OS X and iOS targets.
|
||||||
|
- The `master` branch will always support the stable Xcode version. Other
|
||||||
|
branches will point to their corresponding versions they support.
|
||||||
|
- If you're making a configuration change, make sure to edit both the xcode
|
||||||
|
project and the podspec file.
|
||||||
|
|
||||||
|
### Style Conventions
|
||||||
|
|
||||||
|
- Indent using 4 spaces.
|
||||||
|
- Keep lines 100 characters or shorter. Break long statements into
|
||||||
|
shorter ones over multiple lines.
|
||||||
|
- In Objective-C, use `#pragma mark -` to mark public, internal,
|
||||||
|
protocol, and superclass methods.
|
||||||
|
|
||||||
|
## Core Members
|
||||||
|
|
||||||
|
If a few of your pull requests have been merged, and you'd like a
|
||||||
|
controlling stake in the project, file an issue asking for write access
|
||||||
|
to the repository.
|
||||||
|
|
||||||
|
### Code of Conduct
|
||||||
|
|
||||||
|
Your conduct as a core member is your own responsibility, but here are
|
||||||
|
some "ground rules":
|
||||||
|
|
||||||
|
- Feel free to push whatever you want to master, and (if you have
|
||||||
|
ownership permissions) to create any repositories you'd like.
|
||||||
|
|
||||||
|
Ideally, however, all changes should be submitted as GitHub pull
|
||||||
|
requests. No one should merge their own pull request, unless no
|
||||||
|
other core members respond for at least a few days.
|
||||||
|
|
||||||
|
If you'd like to create a new repository, it'd be nice if you created
|
||||||
|
a GitHub issue and gathered some feedback first.
|
||||||
|
|
||||||
|
- It'd be awesome if you could review, provide feedback on, and close
|
||||||
|
issues or pull requests submitted to the project. Please provide kind,
|
||||||
|
constructive feedback. Please don't be sarcastic or snarky.
|
||||||
|
|
||||||
|
### Creating a Release
|
||||||
|
|
||||||
|
The process is relatively straight forward, but here's is a useful checklist for tagging:
|
||||||
|
|
||||||
|
- Look at changes from the previously tagged release and write release notes: `git log v0.4.0...HEAD`
|
||||||
|
- Run the release script: `./script/release A.B.C release-notes-file`
|
||||||
|
- The script will prompt you to create a new [GitHub release](https://github.com/Quick/Nimble/releases).
|
||||||
|
- Use the same release notes you created for the tag, but tweak up formatting for GitHub.
|
||||||
|
- Update [Quick](https://github.com/Quick/Quick)
|
||||||
|
- Update Quick's submodule reference to the newly released Nimble version
|
||||||
|
- Update Nimble version in `README.md` and Documentation in [Quick](https://github.com/Quick/Quick) if it's not a patch version update.
|
||||||
|
- Announce!
|
1
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Cartfile.private
vendored
Normal file
1
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Cartfile.private
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
github "mattgallagher/CwlPreconditionTesting" "cb7ab89273cfd0725a7a2f865cc6fc560a9b9083"
|
2
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Cartfile.resolved
vendored
Normal file
2
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Cartfile.resolved
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
github "mattgallagher/CwlCatchException" "b14c111e9b33cd142bd4bc75c482cfd5c3490923"
|
||||||
|
github "mattgallagher/CwlPreconditionTesting" "cb7ab89273cfd0725a7a2f865cc6fc560a9b9083"
|
|
@ -0,0 +1,13 @@
|
||||||
|
Copyright © 2017 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
|
||||||
|
Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
purpose with or without fee is hereby granted, provided that the above
|
||||||
|
copyright notice and this permission notice appear in all copies.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
@ -0,0 +1,9 @@
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "CwlCatchException",
|
||||||
|
targets: [
|
||||||
|
Target(name: "CwlCatchException", dependencies: ["CwlCatchExceptionSupport"]),
|
||||||
|
Target(name: "CwlCatchExceptionSupport")
|
||||||
|
]
|
||||||
|
)
|
|
@ -0,0 +1,46 @@
|
||||||
|
# CwlCatchException
|
||||||
|
A simple Swift wrapper around an Objective-C `@try`/`@catch` statement that selectively catches Objective-C exceptions by `NSException` subtype, rethrowing if any caught exception is not the expected subtype.
|
||||||
|
|
||||||
|
Look at [CwlCatchExceptionTests.swift](https://github.com/mattgallagher/CwlCatchException/blob/master/CwlCatchExceptionTests/CwlCatchExceptionTests.swift?ts=4) for syntax.
|
||||||
|
|
||||||
|
## Adding to your project
|
||||||
|
|
||||||
|
This project can be used by direct inclusion in your projects or through any of the Swift Package Manager, CocoaPods or Carthage.
|
||||||
|
|
||||||
|
Minimum requirements are iOS 8 or macOS 10.9.
|
||||||
|
|
||||||
|
### Manual inclusion
|
||||||
|
|
||||||
|
1. In a subdirectory of your project's directory, run `git clone https://github.com/mattgallagher/CwlCatchException.git`
|
||||||
|
2. Drag the "CwlCatchException.xcodeproj" file from the Finder into your own project's file tree in Xcode
|
||||||
|
3. Add the "CwlCatchException.framework" from the "Products" folder of the CwlCatchException project's file tree to the "Copy Files (Frameworks)" build phases of any target that you want to include this module.
|
||||||
|
|
||||||
|
That third step is a little tricky if you're unfamiliar with Xcode but it involves:
|
||||||
|
|
||||||
|
a. click on your project in the file tree
|
||||||
|
b. click on the target to whih you want to add this module
|
||||||
|
c. select the "Build Phases" tab
|
||||||
|
d. if you don't already have a "Copy File" build phase with a "Destination: Frameworks", add one using the "+" button in the top left of the tab
|
||||||
|
e. click the "+" within the "Copy File (Frameworks)" phase and from the list that appears, select the "CwlCatchException.framework" (if there are multiple frameworks with the same name, look for the one that appears *above* the corresponding macOS or iOS CwlCatchException testing target).
|
||||||
|
|
||||||
|
### Swift Package Manager
|
||||||
|
|
||||||
|
Add the following to the `dependencies` array in your "Package.swift" file:
|
||||||
|
|
||||||
|
.Package(url: "https://github.com/mattgallagher/CwlCatchException.git", majorVersion: 1),
|
||||||
|
|
||||||
|
Or, if you're using the `swift-tools-version:4.0` package manager, add the following to the `dependencies` array in your "Package.swift" file:
|
||||||
|
|
||||||
|
.package(url: "https://github.com/mattgallagher/CwlCatchException.git", majorVersion: 1)
|
||||||
|
|
||||||
|
### CocoaPods
|
||||||
|
|
||||||
|
Add the following to your target in your "Podfile":
|
||||||
|
|
||||||
|
pod 'CwlCatchException', :git => 'https://github.com/mattgallagher/CwlCatchException.git'
|
||||||
|
|
||||||
|
### Carthage
|
||||||
|
|
||||||
|
Add the following line to your Cartfile:
|
||||||
|
|
||||||
|
git "https://github.com/mattgallagher/CwlCatchException.git" "master"
|
|
@ -0,0 +1,35 @@
|
||||||
|
//
|
||||||
|
// CwlCatchException.swift
|
||||||
|
// CwlAssertionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if SWIFT_PACKAGE
|
||||||
|
import CwlCatchExceptionSupport
|
||||||
|
#endif
|
||||||
|
|
||||||
|
private func catchReturnTypeConverter<T: NSException>(_ type: T.Type, block: () -> Void) -> T? {
|
||||||
|
return catchExceptionOfKind(type, block) as? T
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NSException {
|
||||||
|
public static func catchException(in block: () -> Void) -> Self? {
|
||||||
|
return catchReturnTypeConverter(self, block: block)
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,37 @@
|
||||||
|
//
|
||||||
|
// CwlCatchException.m
|
||||||
|
// CwlAssertionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#import "CwlCatchException.h"
|
||||||
|
|
||||||
|
#if !SWIFT_PACKAGE && NON_SWIFT_PACKAGE
|
||||||
|
__attribute__((visibility("hidden")))
|
||||||
|
#endif
|
||||||
|
NSException* catchExceptionOfKind(Class __nonnull type, __attribute__((noescape)) void (^ __nonnull inBlock)(void)) {
|
||||||
|
@try {
|
||||||
|
inBlock();
|
||||||
|
} @catch (NSException *exception) {
|
||||||
|
if ([exception isKindOfClass:type]) {
|
||||||
|
return exception;
|
||||||
|
} else {
|
||||||
|
@throw;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return nil;
|
||||||
|
}
|
|
@ -0,0 +1,32 @@
|
||||||
|
//
|
||||||
|
// CwlCatchException.h
|
||||||
|
// CwlCatchException
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#import <Foundation/Foundation.h>
|
||||||
|
|
||||||
|
//! Project version number for CwlCatchException.
|
||||||
|
FOUNDATION_EXPORT double CwlCatchExceptionVersionNumber;
|
||||||
|
|
||||||
|
//! Project version string for CwlCatchException.
|
||||||
|
FOUNDATION_EXPORT const unsigned char CwlCatchExceptionVersionString[];
|
||||||
|
|
||||||
|
#if !SWIFT_PACKAGE && NON_SWIFT_PACKAGE
|
||||||
|
__attribute__((visibility("hidden")))
|
||||||
|
#endif
|
||||||
|
NSException* __nullable catchExceptionOfKind(Class __nonnull type, __attribute__((noescape)) void (^ __nonnull inBlock)(void));
|
|
@ -0,0 +1,15 @@
|
||||||
|
ISC License
|
||||||
|
|
||||||
|
Copyright © 2017 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
|
||||||
|
Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
purpose with or without fee is hereby granted, provided that the above
|
||||||
|
copyright notice and this permission notice appear in all copies.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
@ -0,0 +1,19 @@
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "CwlPreconditionTesting",
|
||||||
|
targets: [
|
||||||
|
Target(name: "CwlPreconditionTesting", dependencies: [
|
||||||
|
"CwlMachBadInstructionHandler"
|
||||||
|
]),
|
||||||
|
Target(name: "CwlMachBadInstructionHandler")
|
||||||
|
],
|
||||||
|
dependencies: [
|
||||||
|
.Package(url: "https://github.com/mattgallagher/CwlCatchException.git", Version(1, 0, 2, prereleaseIdentifiers: ["beta", "3"])),
|
||||||
|
],
|
||||||
|
exclude: [
|
||||||
|
"Sources/CwlPreconditionTesting/Mach/CwlPreconditionTesting.h",
|
||||||
|
"Sources/CwlPreconditionTesting/Posix/CwlPreconditionTesting.h",
|
||||||
|
"Sources/CwlPreconditionTesting/CwlCatchBadInstructionPosix.swift",
|
||||||
|
]
|
||||||
|
)
|
|
@ -0,0 +1,73 @@
|
||||||
|
# CwlPreconditionTesting
|
||||||
|
|
||||||
|
A Mach exception handler, written in Swift and Objective-C, that allows `EXC_BAD_INSTRUCTION` (as raised by Swift's `assertionFailure`/`preconditionFailure`/`fatalError`) to be caught and tested.
|
||||||
|
|
||||||
|
NOTE: the iOS code runs in the simulator *only*. It is for logic testing and cannot be deployed to the device due to the Mach exception API being private on iOS.
|
||||||
|
|
||||||
|
For an extended discussion of this code, please see the Cocoa with Love article:
|
||||||
|
|
||||||
|
[Partial functions in Swift, Part 2: Catching precondition failures](http://cocoawithlove.com/blog/2016/02/02/partial-functions-part-two-catching-precondition-failures.html)
|
||||||
|
|
||||||
|
## Adding to your project
|
||||||
|
|
||||||
|
This project can be used by manual inclusion in your projects or through any of the Swift Package Manager, CocoaPods or Carthage.
|
||||||
|
|
||||||
|
Minimum requirements are iOS 8 (simulator-only) or macOS 10.9. The project includes tvOS 9 and POSIX targets but these aren't regularly tested.
|
||||||
|
|
||||||
|
### Manual inclusion
|
||||||
|
|
||||||
|
1. In a subdirectory of your project's directory, run `git clone https://github.com/mattgallagher/CwlPreconditionTesting.git`
|
||||||
|
2. Drag the "CwlPreconditionTesting.xcodeproj" file from the Finder into your own project's file tree in Xcode
|
||||||
|
3. Add the "CwlPreconditionTesting.framework" from the "Products" folder of the CwlPreconditionTesting project's file tree to the "Copy Files (Frameworks)" build phases of any target that you want to include this module.
|
||||||
|
4. Drag the "CwlCatchException.framework" from the "Dependencies" group (within the CwlPreconditionTesting project's file tree) onto the same "Copy Files (Frameworks)" build phase (this item may be red but that shouldn't be a problem).
|
||||||
|
|
||||||
|
That third step is a little tricky if you're unfamiliar with Xcode but it involves:
|
||||||
|
|
||||||
|
a. click on your project in the file tree
|
||||||
|
b. click on the target to whih you want to add this module
|
||||||
|
c. select the "Build Phases" tab
|
||||||
|
d. if you don't already have a "Copy File" build phase with a "Destination: Frameworks", add one using the "+" button in the top left of the tab
|
||||||
|
e. click the "+" within the "Copy File (Frameworks)" phase and from the list that appears, select the "CwlPreconditionTesting.framework" (if there are multiple frameworks with the same name, look for the one that appears *above* the corresponding macOS or iOS CwlPreconditionTesting testing target).
|
||||||
|
|
||||||
|
When building using this approach, the "FetchDependencies" target will use the Swift Package Manager to download the "CwlCatchException" project from github. The download is stored in the "Build intermediates" directory for your project. Normally, you can ignore its existence but if you get any errors from the "FetchDependencies" target, you might need to clean the build folder (Hold "Option" key while selecting "Product" → "Clean Build Folder..." from the Xcode menubar).
|
||||||
|
|
||||||
|
You can use the "Package.swift" to manage the behavior of the Swift Package Manager or if you want to download dependencies manually (instead of using this behind-the-scenes use of the Swift package manager), you should delete the "FetchDependencies" target and replace the "CwlCatchException" targets with alternatives that build the dependencies in accordance with your manual download.
|
||||||
|
|
||||||
|
### Swift Package Manager
|
||||||
|
|
||||||
|
Add the following to the `dependencies` array in your "Package.swift" file:
|
||||||
|
|
||||||
|
.Package(url: "https://github.com/mattgallagher/CwlPreconditionTesting.git", majorVersion: 1),
|
||||||
|
|
||||||
|
Or, if you're using the `swift-tools-version:4.0` package manager, add the following to the `dependencies` array in your "Package.swift" file:
|
||||||
|
|
||||||
|
.package(url: "https://github.com/mattgallagher/CwlPreconditionTesting.git", majorVersion: 1)
|
||||||
|
|
||||||
|
### CocoaPods
|
||||||
|
|
||||||
|
Add the following lines to your target in your "Podfile":
|
||||||
|
|
||||||
|
pod 'CwlPreconditionTesting', :git => 'https://github.com/mattgallagher/CwlPreconditionTesting.git'
|
||||||
|
pod 'CwlCatchException', :git => 'https://github.com/mattgallagher/CwlCatchException.git'
|
||||||
|
|
||||||
|
### Carthage
|
||||||
|
|
||||||
|
Add the following line to your Cartfile:
|
||||||
|
|
||||||
|
git "https://github.com/mattgallagher/CwlPreconditionTesting.git" "master"
|
||||||
|
|
||||||
|
## Using POSIX signals and setjmp/longjmp
|
||||||
|
|
||||||
|
For comparison or for anyone running this code on a platform without Mach exceptions or the Objective-C runtime, I've added a proof-of-concept implementation of `catchBadInstruction` that uses a POSIX SIGILL `sigaction` and `setjmp`/`longjmp` to perform the throw.
|
||||||
|
|
||||||
|
In Xcode, you can simply select the CwlPreconditionTesting_POSIX target (instead of the OSX or iOS targets). If you're building without Xcode: all you need is the CwlCatchBadInstructionPOSIX.swift file (compared to the Mach exception handler, the code is tiny doesn't have any weird Objective-C/MiG file dependencies).
|
||||||
|
|
||||||
|
**Warning No. 1**: on OS X, this approach can't be used when lldb is attached since lldb's Mach exception handler blocks the SIGILL from ever occurring (I've disabled the "Debug Executable" setting for the tests in Xcode - re-enable it to witness the problem).
|
||||||
|
|
||||||
|
**Warning No. 2**: if you're switching between the CwlPreconditionTesting_OSX and CwlPreconditionTesting_POSIX targets, Xcode (as of Xcode 7.2.1) will not detect the change and will not remove the old framework correctly so you'll need to *clean your project* otherwise the old framework will hang around.
|
||||||
|
|
||||||
|
Additional problems in decreasing severity include:
|
||||||
|
|
||||||
|
* the signal handler is whole process (rather than correctly scoped to the thread where the "catch" occurs)
|
||||||
|
* the signal handler doesn't deal with re-entrancy whereas the mach exception handler remains deterministic in the face of multiple fatal errors
|
||||||
|
* the signal handler overwrites the "[red zone](https://en.wikipedia.org/wiki/Red_zone_(computing))" which is technically frowned upon in signal handlers (although unlikely to cause problems here)
|
|
@ -0,0 +1,50 @@
|
||||||
|
//
|
||||||
|
// CwlMachBadExceptionHandler.m
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#if defined(__x86_64__)
|
||||||
|
|
||||||
|
#import "mach_excServer.h"
|
||||||
|
#import "CwlMachBadInstructionHandler.h"
|
||||||
|
|
||||||
|
@protocol BadInstructionReply <NSObject>
|
||||||
|
+(NSNumber *)receiveReply:(NSValue *)value;
|
||||||
|
@end
|
||||||
|
|
||||||
|
/// A basic function that receives callbacks from mach_exc_server and relays them to the Swift implemented BadInstructionException.catch_mach_exception_raise_state.
|
||||||
|
kern_return_t catch_mach_exception_raise_state(mach_port_t exception_port, exception_type_t exception, const mach_exception_data_t code, mach_msg_type_number_t codeCnt, int *flavor, const thread_state_t old_state, mach_msg_type_number_t old_stateCnt, thread_state_t new_state, mach_msg_type_number_t *new_stateCnt) {
|
||||||
|
bad_instruction_exception_reply_t reply = { exception_port, exception, code, codeCnt, flavor, old_state, old_stateCnt, new_state, new_stateCnt };
|
||||||
|
Class badInstructionClass = NSClassFromString(@"BadInstructionException");
|
||||||
|
NSValue *value = [NSValue valueWithBytes: &reply objCType: @encode(bad_instruction_exception_reply_t)];
|
||||||
|
return [[badInstructionClass performSelector: @selector(receiveReply:) withObject: value] intValue];
|
||||||
|
}
|
||||||
|
|
||||||
|
// The mach port should be configured so that this function is never used.
|
||||||
|
kern_return_t catch_mach_exception_raise(mach_port_t exception_port, mach_port_t thread, mach_port_t task, exception_type_t exception, mach_exception_data_t code, mach_msg_type_number_t codeCnt) {
|
||||||
|
assert(false);
|
||||||
|
return KERN_FAILURE;
|
||||||
|
}
|
||||||
|
|
||||||
|
// The mach port should be configured so that this function is never used.
|
||||||
|
kern_return_t catch_mach_exception_raise_state_identity(mach_port_t exception_port, mach_port_t thread, mach_port_t task, exception_type_t exception, mach_exception_data_t code, mach_msg_type_number_t codeCnt, int *flavor, thread_state_t old_state, mach_msg_type_number_t old_stateCnt, thread_state_t new_state, mach_msg_type_number_t *new_stateCnt) {
|
||||||
|
assert(false);
|
||||||
|
return KERN_FAILURE;
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,70 @@
|
||||||
|
//
|
||||||
|
// CwlMachBadInstructionHandler.h
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#import <Foundation/Foundation.h>
|
||||||
|
#import <mach/mach.h>
|
||||||
|
|
||||||
|
NS_ASSUME_NONNULL_BEGIN
|
||||||
|
|
||||||
|
extern boolean_t mach_exc_server(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP);
|
||||||
|
|
||||||
|
// The request_mach_exception_raise_t struct is passed to mach_msg which assumes its exact layout. To avoid problems with different layouts, we keep the definition in C rather than Swift.
|
||||||
|
typedef struct
|
||||||
|
{
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
/* start of the kernel processed data */
|
||||||
|
mach_msg_body_t msgh_body;
|
||||||
|
mach_msg_port_descriptor_t thread;
|
||||||
|
mach_msg_port_descriptor_t task;
|
||||||
|
/* end of the kernel processed data */
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
natural_t old_state[224];
|
||||||
|
} request_mach_exception_raise_t;
|
||||||
|
|
||||||
|
// The reply_mach_exception_raise_state_t struct is passed to mach_msg which assumes its exact layout. To avoid problems with different layouts, we keep the definition in C rather than Swift.
|
||||||
|
typedef struct
|
||||||
|
{
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
kern_return_t RetCode;
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t new_stateCnt;
|
||||||
|
natural_t new_state[224];
|
||||||
|
} reply_mach_exception_raise_state_t;
|
||||||
|
|
||||||
|
typedef struct
|
||||||
|
{
|
||||||
|
mach_port_t exception_port;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_exception_data_type_t const * _Nullable code;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int32_t * _Nullable flavor;
|
||||||
|
natural_t const * _Nullable old_state;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
thread_state_t _Nullable new_state;
|
||||||
|
mach_msg_type_number_t * _Nullable new_stateCnt;
|
||||||
|
} bad_instruction_exception_reply_t;
|
||||||
|
|
||||||
|
NS_ASSUME_NONNULL_END
|
|
@ -0,0 +1,537 @@
|
||||||
|
/*
|
||||||
|
* IDENTIFICATION:
|
||||||
|
* stub generated Sun Jan 29 19:05:29 2017
|
||||||
|
* with a MiG generated by bootstrap_cmds-96.20.2
|
||||||
|
* OPTIONS:
|
||||||
|
*/
|
||||||
|
|
||||||
|
#if defined(__x86_64__)
|
||||||
|
|
||||||
|
/* Module mach_exc */
|
||||||
|
|
||||||
|
#define __MIG_check__Request__mach_exc_subsystem__ 1
|
||||||
|
|
||||||
|
#include "mach_excServer.h"
|
||||||
|
|
||||||
|
#ifndef mig_internal
|
||||||
|
#define mig_internal static __inline__
|
||||||
|
#endif /* mig_internal */
|
||||||
|
|
||||||
|
#ifndef mig_external
|
||||||
|
#define mig_external
|
||||||
|
#endif /* mig_external */
|
||||||
|
|
||||||
|
#if !defined(__MigTypeCheck) && defined(TypeCheck)
|
||||||
|
#define __MigTypeCheck TypeCheck /* Legacy setting */
|
||||||
|
#endif /* !defined(__MigTypeCheck) */
|
||||||
|
|
||||||
|
#if !defined(__MigKernelSpecificCode) && defined(_MIG_KERNEL_SPECIFIC_CODE_)
|
||||||
|
#define __MigKernelSpecificCode _MIG_KERNEL_SPECIFIC_CODE_ /* Legacy setting */
|
||||||
|
#endif /* !defined(__MigKernelSpecificCode) */
|
||||||
|
|
||||||
|
#ifndef LimitCheck
|
||||||
|
#define LimitCheck 0
|
||||||
|
#endif /* LimitCheck */
|
||||||
|
|
||||||
|
#ifndef min
|
||||||
|
#define min(a,b) ( ((a) < (b))? (a): (b) )
|
||||||
|
#endif /* min */
|
||||||
|
|
||||||
|
#if !defined(_WALIGN_)
|
||||||
|
#define _WALIGN_(x) (((x) + 3) & ~3)
|
||||||
|
#endif /* !defined(_WALIGN_) */
|
||||||
|
|
||||||
|
#if !defined(_WALIGNSZ_)
|
||||||
|
#define _WALIGNSZ_(x) _WALIGN_(sizeof(x))
|
||||||
|
#endif /* !defined(_WALIGNSZ_) */
|
||||||
|
|
||||||
|
#ifndef UseStaticTemplates
|
||||||
|
#define UseStaticTemplates 0
|
||||||
|
#endif /* UseStaticTemplates */
|
||||||
|
|
||||||
|
#ifndef __DeclareRcvRpc
|
||||||
|
#define __DeclareRcvRpc(_NUM_, _NAME_)
|
||||||
|
#endif /* __DeclareRcvRpc */
|
||||||
|
|
||||||
|
#ifndef __BeforeRcvRpc
|
||||||
|
#define __BeforeRcvRpc(_NUM_, _NAME_)
|
||||||
|
#endif /* __BeforeRcvRpc */
|
||||||
|
|
||||||
|
#ifndef __AfterRcvRpc
|
||||||
|
#define __AfterRcvRpc(_NUM_, _NAME_)
|
||||||
|
#endif /* __AfterRcvRpc */
|
||||||
|
|
||||||
|
#ifndef __DeclareRcvSimple
|
||||||
|
#define __DeclareRcvSimple(_NUM_, _NAME_)
|
||||||
|
#endif /* __DeclareRcvSimple */
|
||||||
|
|
||||||
|
#ifndef __BeforeRcvSimple
|
||||||
|
#define __BeforeRcvSimple(_NUM_, _NAME_)
|
||||||
|
#endif /* __BeforeRcvSimple */
|
||||||
|
|
||||||
|
#ifndef __AfterRcvSimple
|
||||||
|
#define __AfterRcvSimple(_NUM_, _NAME_)
|
||||||
|
#endif /* __AfterRcvSimple */
|
||||||
|
|
||||||
|
#define novalue void
|
||||||
|
|
||||||
|
#define msgh_request_port msgh_local_port
|
||||||
|
#define MACH_MSGH_BITS_REQUEST(bits) MACH_MSGH_BITS_LOCAL(bits)
|
||||||
|
#define msgh_reply_port msgh_remote_port
|
||||||
|
#define MACH_MSGH_BITS_REPLY(bits) MACH_MSGH_BITS_REMOTE(bits)
|
||||||
|
|
||||||
|
#define MIG_RETURN_ERROR(X, code) {\
|
||||||
|
((mig_reply_error_t *)X)->RetCode = code;\
|
||||||
|
((mig_reply_error_t *)X)->NDR = NDR_record;\
|
||||||
|
return;\
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Forward Declarations */
|
||||||
|
|
||||||
|
|
||||||
|
mig_internal novalue _Xmach_exception_raise
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP);
|
||||||
|
|
||||||
|
mig_internal novalue _Xmach_exception_raise_state
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP);
|
||||||
|
|
||||||
|
mig_internal novalue _Xmach_exception_raise_state_identity
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP);
|
||||||
|
|
||||||
|
|
||||||
|
#if ( __MigTypeCheck )
|
||||||
|
#if __MIG_check__Request__mach_exc_subsystem__
|
||||||
|
#if !defined(__MIG_check__Request__mach_exception_raise_t__defined)
|
||||||
|
#define __MIG_check__Request__mach_exception_raise_t__defined
|
||||||
|
|
||||||
|
mig_internal kern_return_t __MIG_check__Request__mach_exception_raise_t(__attribute__((__unused__)) __Request__mach_exception_raise_t *In0P)
|
||||||
|
{
|
||||||
|
|
||||||
|
typedef __Request__mach_exception_raise_t __Request;
|
||||||
|
#if __MigTypeCheck
|
||||||
|
unsigned int msgh_size;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
msgh_size = In0P->Head.msgh_size;
|
||||||
|
if (!(In0P->Head.msgh_bits & MACH_MSGH_BITS_COMPLEX) ||
|
||||||
|
(In0P->msgh_body.msgh_descriptor_count != 2) ||
|
||||||
|
(msgh_size < (mach_msg_size_t)(sizeof(__Request) - 16)) || (msgh_size > (mach_msg_size_t)sizeof(__Request)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if (In0P->thread.type != MACH_MSG_PORT_DESCRIPTOR ||
|
||||||
|
In0P->thread.disposition != 17)
|
||||||
|
return MIG_TYPE_ERROR;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if (In0P->task.type != MACH_MSG_PORT_DESCRIPTOR ||
|
||||||
|
In0P->task.disposition != 17)
|
||||||
|
return MIG_TYPE_ERROR;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if defined(__NDR_convert__int_rep__Request__mach_exception_raise_t__codeCnt__defined)
|
||||||
|
if (In0P->NDR.int_rep != NDR_record.int_rep)
|
||||||
|
__NDR_convert__int_rep__Request__mach_exception_raise_t__codeCnt(&In0P->codeCnt, In0P->NDR.int_rep);
|
||||||
|
#endif /* __NDR_convert__int_rep__Request__mach_exception_raise_t__codeCnt__defined */
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if ( In0P->codeCnt > 2 )
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
if (((msgh_size - (mach_msg_size_t)(sizeof(__Request) - 16)) / 8 < In0P->codeCnt) ||
|
||||||
|
(msgh_size != (mach_msg_size_t)(sizeof(__Request) - 16) + (8 * In0P->codeCnt)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
return MACH_MSG_SUCCESS;
|
||||||
|
}
|
||||||
|
#endif /* !defined(__MIG_check__Request__mach_exception_raise_t__defined) */
|
||||||
|
#endif /* __MIG_check__Request__mach_exc_subsystem__ */
|
||||||
|
#endif /* ( __MigTypeCheck ) */
|
||||||
|
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise */
|
||||||
|
mig_internal novalue _Xmach_exception_raise
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP)
|
||||||
|
{
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
/* start of the kernel processed data */
|
||||||
|
mach_msg_body_t msgh_body;
|
||||||
|
mach_msg_port_descriptor_t thread;
|
||||||
|
mach_msg_port_descriptor_t task;
|
||||||
|
/* end of the kernel processed data */
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
mach_msg_trailer_t trailer;
|
||||||
|
} Request __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
typedef __Request__mach_exception_raise_t __Request;
|
||||||
|
typedef __Reply__mach_exception_raise_t Reply __attribute__((unused));
|
||||||
|
|
||||||
|
/*
|
||||||
|
* typedef struct {
|
||||||
|
* mach_msg_header_t Head;
|
||||||
|
* NDR_record_t NDR;
|
||||||
|
* kern_return_t RetCode;
|
||||||
|
* } mig_reply_error_t;
|
||||||
|
*/
|
||||||
|
|
||||||
|
Request *In0P = (Request *) InHeadP;
|
||||||
|
Reply *OutP = (Reply *) OutHeadP;
|
||||||
|
#ifdef __MIG_check__Request__mach_exception_raise_t__defined
|
||||||
|
kern_return_t check_result;
|
||||||
|
#endif /* __MIG_check__Request__mach_exception_raise_t__defined */
|
||||||
|
|
||||||
|
__DeclareRcvRpc(2405, "mach_exception_raise")
|
||||||
|
__BeforeRcvRpc(2405, "mach_exception_raise")
|
||||||
|
|
||||||
|
#if defined(__MIG_check__Request__mach_exception_raise_t__defined)
|
||||||
|
check_result = __MIG_check__Request__mach_exception_raise_t((__Request *)In0P);
|
||||||
|
if (check_result != MACH_MSG_SUCCESS)
|
||||||
|
{ MIG_RETURN_ERROR(OutP, check_result); }
|
||||||
|
#endif /* defined(__MIG_check__Request__mach_exception_raise_t__defined) */
|
||||||
|
|
||||||
|
OutP->RetCode = catch_mach_exception_raise(In0P->Head.msgh_request_port, In0P->thread.name, In0P->task.name, In0P->exception, In0P->code, In0P->codeCnt);
|
||||||
|
|
||||||
|
OutP->NDR = NDR_record;
|
||||||
|
|
||||||
|
|
||||||
|
__AfterRcvRpc(2405, "mach_exception_raise")
|
||||||
|
}
|
||||||
|
|
||||||
|
#if ( __MigTypeCheck )
|
||||||
|
#if __MIG_check__Request__mach_exc_subsystem__
|
||||||
|
#if !defined(__MIG_check__Request__mach_exception_raise_state_t__defined)
|
||||||
|
#define __MIG_check__Request__mach_exception_raise_state_t__defined
|
||||||
|
|
||||||
|
mig_internal kern_return_t __MIG_check__Request__mach_exception_raise_state_t(__attribute__((__unused__)) __Request__mach_exception_raise_state_t *In0P, __attribute__((__unused__)) __Request__mach_exception_raise_state_t **In1PP)
|
||||||
|
{
|
||||||
|
|
||||||
|
typedef __Request__mach_exception_raise_state_t __Request;
|
||||||
|
__Request *In1P;
|
||||||
|
#if __MigTypeCheck
|
||||||
|
unsigned int msgh_size;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
unsigned int msgh_size_delta;
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
msgh_size = In0P->Head.msgh_size;
|
||||||
|
if ((In0P->Head.msgh_bits & MACH_MSGH_BITS_COMPLEX) ||
|
||||||
|
(msgh_size < (mach_msg_size_t)(sizeof(__Request) - 912)) || (msgh_size > (mach_msg_size_t)sizeof(__Request)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if defined(__NDR_convert__int_rep__Request__mach_exception_raise_state_t__codeCnt__defined)
|
||||||
|
if (In0P->NDR.int_rep != NDR_record.int_rep)
|
||||||
|
__NDR_convert__int_rep__Request__mach_exception_raise_state_t__codeCnt(&In0P->codeCnt, In0P->NDR.int_rep);
|
||||||
|
#endif /* __NDR_convert__int_rep__Request__mach_exception_raise_state_t__codeCnt__defined */
|
||||||
|
msgh_size_delta = (8 * In0P->codeCnt);
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if ( In0P->codeCnt > 2 )
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
if (((msgh_size - (mach_msg_size_t)(sizeof(__Request) - 912)) / 8 < In0P->codeCnt) ||
|
||||||
|
(msgh_size < (mach_msg_size_t)(sizeof(__Request) - 912) + (8 * In0P->codeCnt)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
msgh_size -= msgh_size_delta;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
*In1PP = In1P = (__Request *) ((pointer_t) In0P + msgh_size_delta - 16);
|
||||||
|
|
||||||
|
#if defined(__NDR_convert__int_rep__Request__mach_exception_raise_state_t__old_stateCnt__defined)
|
||||||
|
if (In0P->NDR.int_rep != NDR_record.int_rep)
|
||||||
|
__NDR_convert__int_rep__Request__mach_exception_raise_state_t__old_stateCnt(&In1P->old_stateCnt, In1P->NDR.int_rep);
|
||||||
|
#endif /* __NDR_convert__int_rep__Request__mach_exception_raise_state_t__old_stateCnt__defined */
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if ( In1P->old_stateCnt > 224 )
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
if (((msgh_size - (mach_msg_size_t)(sizeof(__Request) - 912)) / 4 < In1P->old_stateCnt) ||
|
||||||
|
(msgh_size != (mach_msg_size_t)(sizeof(__Request) - 912) + (4 * In1P->old_stateCnt)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
return MACH_MSG_SUCCESS;
|
||||||
|
}
|
||||||
|
#endif /* !defined(__MIG_check__Request__mach_exception_raise_state_t__defined) */
|
||||||
|
#endif /* __MIG_check__Request__mach_exc_subsystem__ */
|
||||||
|
#endif /* ( __MigTypeCheck ) */
|
||||||
|
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise_state */
|
||||||
|
mig_internal novalue _Xmach_exception_raise_state
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP)
|
||||||
|
{
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
natural_t old_state[224];
|
||||||
|
mach_msg_trailer_t trailer;
|
||||||
|
} Request __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
typedef __Request__mach_exception_raise_state_t __Request;
|
||||||
|
typedef __Reply__mach_exception_raise_state_t Reply __attribute__((unused));
|
||||||
|
|
||||||
|
/*
|
||||||
|
* typedef struct {
|
||||||
|
* mach_msg_header_t Head;
|
||||||
|
* NDR_record_t NDR;
|
||||||
|
* kern_return_t RetCode;
|
||||||
|
* } mig_reply_error_t;
|
||||||
|
*/
|
||||||
|
|
||||||
|
Request *In0P = (Request *) InHeadP;
|
||||||
|
Request *In1P;
|
||||||
|
Reply *OutP = (Reply *) OutHeadP;
|
||||||
|
#ifdef __MIG_check__Request__mach_exception_raise_state_t__defined
|
||||||
|
kern_return_t check_result;
|
||||||
|
#endif /* __MIG_check__Request__mach_exception_raise_state_t__defined */
|
||||||
|
|
||||||
|
__DeclareRcvRpc(2406, "mach_exception_raise_state")
|
||||||
|
__BeforeRcvRpc(2406, "mach_exception_raise_state")
|
||||||
|
|
||||||
|
#if defined(__MIG_check__Request__mach_exception_raise_state_t__defined)
|
||||||
|
check_result = __MIG_check__Request__mach_exception_raise_state_t((__Request *)In0P, (__Request **)&In1P);
|
||||||
|
if (check_result != MACH_MSG_SUCCESS)
|
||||||
|
{ MIG_RETURN_ERROR(OutP, check_result); }
|
||||||
|
#endif /* defined(__MIG_check__Request__mach_exception_raise_state_t__defined) */
|
||||||
|
|
||||||
|
OutP->new_stateCnt = 224;
|
||||||
|
|
||||||
|
OutP->RetCode = catch_mach_exception_raise_state(In0P->Head.msgh_request_port, In0P->exception, In0P->code, In0P->codeCnt, &In1P->flavor, In1P->old_state, In1P->old_stateCnt, OutP->new_state, &OutP->new_stateCnt);
|
||||||
|
if (OutP->RetCode != KERN_SUCCESS) {
|
||||||
|
MIG_RETURN_ERROR(OutP, OutP->RetCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
OutP->NDR = NDR_record;
|
||||||
|
|
||||||
|
|
||||||
|
OutP->flavor = In1P->flavor;
|
||||||
|
OutP->Head.msgh_size = (mach_msg_size_t)(sizeof(Reply) - 896) + (((4 * OutP->new_stateCnt)));
|
||||||
|
|
||||||
|
__AfterRcvRpc(2406, "mach_exception_raise_state")
|
||||||
|
}
|
||||||
|
|
||||||
|
#if ( __MigTypeCheck )
|
||||||
|
#if __MIG_check__Request__mach_exc_subsystem__
|
||||||
|
#if !defined(__MIG_check__Request__mach_exception_raise_state_identity_t__defined)
|
||||||
|
#define __MIG_check__Request__mach_exception_raise_state_identity_t__defined
|
||||||
|
|
||||||
|
mig_internal kern_return_t __MIG_check__Request__mach_exception_raise_state_identity_t(__attribute__((__unused__)) __Request__mach_exception_raise_state_identity_t *In0P, __attribute__((__unused__)) __Request__mach_exception_raise_state_identity_t **In1PP)
|
||||||
|
{
|
||||||
|
|
||||||
|
typedef __Request__mach_exception_raise_state_identity_t __Request;
|
||||||
|
__Request *In1P;
|
||||||
|
#if __MigTypeCheck
|
||||||
|
unsigned int msgh_size;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
unsigned int msgh_size_delta;
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
msgh_size = In0P->Head.msgh_size;
|
||||||
|
if (!(In0P->Head.msgh_bits & MACH_MSGH_BITS_COMPLEX) ||
|
||||||
|
(In0P->msgh_body.msgh_descriptor_count != 2) ||
|
||||||
|
(msgh_size < (mach_msg_size_t)(sizeof(__Request) - 912)) || (msgh_size > (mach_msg_size_t)sizeof(__Request)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if (In0P->thread.type != MACH_MSG_PORT_DESCRIPTOR ||
|
||||||
|
In0P->thread.disposition != 17)
|
||||||
|
return MIG_TYPE_ERROR;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if (In0P->task.type != MACH_MSG_PORT_DESCRIPTOR ||
|
||||||
|
In0P->task.disposition != 17)
|
||||||
|
return MIG_TYPE_ERROR;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
#if defined(__NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__codeCnt__defined)
|
||||||
|
if (In0P->NDR.int_rep != NDR_record.int_rep)
|
||||||
|
__NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__codeCnt(&In0P->codeCnt, In0P->NDR.int_rep);
|
||||||
|
#endif /* __NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__codeCnt__defined */
|
||||||
|
msgh_size_delta = (8 * In0P->codeCnt);
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if ( In0P->codeCnt > 2 )
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
if (((msgh_size - (mach_msg_size_t)(sizeof(__Request) - 912)) / 8 < In0P->codeCnt) ||
|
||||||
|
(msgh_size < (mach_msg_size_t)(sizeof(__Request) - 912) + (8 * In0P->codeCnt)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
msgh_size -= msgh_size_delta;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
*In1PP = In1P = (__Request *) ((pointer_t) In0P + msgh_size_delta - 16);
|
||||||
|
|
||||||
|
#if defined(__NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__old_stateCnt__defined)
|
||||||
|
if (In0P->NDR.int_rep != NDR_record.int_rep)
|
||||||
|
__NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__old_stateCnt(&In1P->old_stateCnt, In1P->NDR.int_rep);
|
||||||
|
#endif /* __NDR_convert__int_rep__Request__mach_exception_raise_state_identity_t__old_stateCnt__defined */
|
||||||
|
#if __MigTypeCheck
|
||||||
|
if ( In1P->old_stateCnt > 224 )
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
if (((msgh_size - (mach_msg_size_t)(sizeof(__Request) - 912)) / 4 < In1P->old_stateCnt) ||
|
||||||
|
(msgh_size != (mach_msg_size_t)(sizeof(__Request) - 912) + (4 * In1P->old_stateCnt)))
|
||||||
|
return MIG_BAD_ARGUMENTS;
|
||||||
|
#endif /* __MigTypeCheck */
|
||||||
|
|
||||||
|
return MACH_MSG_SUCCESS;
|
||||||
|
}
|
||||||
|
#endif /* !defined(__MIG_check__Request__mach_exception_raise_state_identity_t__defined) */
|
||||||
|
#endif /* __MIG_check__Request__mach_exc_subsystem__ */
|
||||||
|
#endif /* ( __MigTypeCheck ) */
|
||||||
|
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise_state_identity */
|
||||||
|
mig_internal novalue _Xmach_exception_raise_state_identity
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP)
|
||||||
|
{
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
/* start of the kernel processed data */
|
||||||
|
mach_msg_body_t msgh_body;
|
||||||
|
mach_msg_port_descriptor_t thread;
|
||||||
|
mach_msg_port_descriptor_t task;
|
||||||
|
/* end of the kernel processed data */
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
natural_t old_state[224];
|
||||||
|
mach_msg_trailer_t trailer;
|
||||||
|
} Request __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
typedef __Request__mach_exception_raise_state_identity_t __Request;
|
||||||
|
typedef __Reply__mach_exception_raise_state_identity_t Reply __attribute__((unused));
|
||||||
|
|
||||||
|
/*
|
||||||
|
* typedef struct {
|
||||||
|
* mach_msg_header_t Head;
|
||||||
|
* NDR_record_t NDR;
|
||||||
|
* kern_return_t RetCode;
|
||||||
|
* } mig_reply_error_t;
|
||||||
|
*/
|
||||||
|
|
||||||
|
Request *In0P = (Request *) InHeadP;
|
||||||
|
Request *In1P;
|
||||||
|
Reply *OutP = (Reply *) OutHeadP;
|
||||||
|
#ifdef __MIG_check__Request__mach_exception_raise_state_identity_t__defined
|
||||||
|
kern_return_t check_result;
|
||||||
|
#endif /* __MIG_check__Request__mach_exception_raise_state_identity_t__defined */
|
||||||
|
|
||||||
|
__DeclareRcvRpc(2407, "mach_exception_raise_state_identity")
|
||||||
|
__BeforeRcvRpc(2407, "mach_exception_raise_state_identity")
|
||||||
|
|
||||||
|
#if defined(__MIG_check__Request__mach_exception_raise_state_identity_t__defined)
|
||||||
|
check_result = __MIG_check__Request__mach_exception_raise_state_identity_t((__Request *)In0P, (__Request **)&In1P);
|
||||||
|
if (check_result != MACH_MSG_SUCCESS)
|
||||||
|
{ MIG_RETURN_ERROR(OutP, check_result); }
|
||||||
|
#endif /* defined(__MIG_check__Request__mach_exception_raise_state_identity_t__defined) */
|
||||||
|
|
||||||
|
OutP->new_stateCnt = 224;
|
||||||
|
|
||||||
|
OutP->RetCode = catch_mach_exception_raise_state_identity(In0P->Head.msgh_request_port, In0P->thread.name, In0P->task.name, In0P->exception, In0P->code, In0P->codeCnt, &In1P->flavor, In1P->old_state, In1P->old_stateCnt, OutP->new_state, &OutP->new_stateCnt);
|
||||||
|
if (OutP->RetCode != KERN_SUCCESS) {
|
||||||
|
MIG_RETURN_ERROR(OutP, OutP->RetCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
OutP->NDR = NDR_record;
|
||||||
|
|
||||||
|
|
||||||
|
OutP->flavor = In1P->flavor;
|
||||||
|
OutP->Head.msgh_size = (mach_msg_size_t)(sizeof(Reply) - 896) + (((4 * OutP->new_stateCnt)));
|
||||||
|
|
||||||
|
__AfterRcvRpc(2407, "mach_exception_raise_state_identity")
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/* Description of this subsystem, for use in direct RPC */
|
||||||
|
const struct catch_mach_exc_subsystem catch_mach_exc_subsystem = {
|
||||||
|
mach_exc_server_routine,
|
||||||
|
2405,
|
||||||
|
2408,
|
||||||
|
(mach_msg_size_t)sizeof(union __ReplyUnion__catch_mach_exc_subsystem),
|
||||||
|
(vm_address_t)0,
|
||||||
|
{
|
||||||
|
{ (mig_impl_routine_t) 0,
|
||||||
|
(mig_stub_routine_t) _Xmach_exception_raise, 6, 0, (routine_arg_descriptor_t)0, (mach_msg_size_t)sizeof(__Reply__mach_exception_raise_t)},
|
||||||
|
{ (mig_impl_routine_t) 0,
|
||||||
|
(mig_stub_routine_t) _Xmach_exception_raise_state, 9, 0, (routine_arg_descriptor_t)0, (mach_msg_size_t)sizeof(__Reply__mach_exception_raise_state_t)},
|
||||||
|
{ (mig_impl_routine_t) 0,
|
||||||
|
(mig_stub_routine_t) _Xmach_exception_raise_state_identity, 11, 0, (routine_arg_descriptor_t)0, (mach_msg_size_t)sizeof(__Reply__mach_exception_raise_state_identity_t)},
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
mig_external boolean_t mach_exc_server
|
||||||
|
(mach_msg_header_t *InHeadP, mach_msg_header_t *OutHeadP)
|
||||||
|
{
|
||||||
|
/*
|
||||||
|
* typedef struct {
|
||||||
|
* mach_msg_header_t Head;
|
||||||
|
* NDR_record_t NDR;
|
||||||
|
* kern_return_t RetCode;
|
||||||
|
* } mig_reply_error_t;
|
||||||
|
*/
|
||||||
|
|
||||||
|
register mig_routine_t routine;
|
||||||
|
|
||||||
|
OutHeadP->msgh_bits = MACH_MSGH_BITS(MACH_MSGH_BITS_REPLY(InHeadP->msgh_bits), 0);
|
||||||
|
OutHeadP->msgh_remote_port = InHeadP->msgh_reply_port;
|
||||||
|
/* Minimal size: routine() will update it if different */
|
||||||
|
OutHeadP->msgh_size = (mach_msg_size_t)sizeof(mig_reply_error_t);
|
||||||
|
OutHeadP->msgh_local_port = MACH_PORT_NULL;
|
||||||
|
OutHeadP->msgh_id = InHeadP->msgh_id + 100;
|
||||||
|
OutHeadP->msgh_reserved = 0;
|
||||||
|
|
||||||
|
if ((InHeadP->msgh_id > 2407) || (InHeadP->msgh_id < 2405) ||
|
||||||
|
((routine = catch_mach_exc_subsystem.routine[InHeadP->msgh_id - 2405].stub_routine) == 0)) {
|
||||||
|
((mig_reply_error_t *)OutHeadP)->NDR = NDR_record;
|
||||||
|
((mig_reply_error_t *)OutHeadP)->RetCode = MIG_BAD_ID;
|
||||||
|
return FALSE;
|
||||||
|
}
|
||||||
|
(*routine) (InHeadP, OutHeadP);
|
||||||
|
return TRUE;
|
||||||
|
}
|
||||||
|
|
||||||
|
mig_external mig_routine_t mach_exc_server_routine
|
||||||
|
(mach_msg_header_t *InHeadP)
|
||||||
|
{
|
||||||
|
register int msgh_id;
|
||||||
|
|
||||||
|
msgh_id = InHeadP->msgh_id - 2405;
|
||||||
|
|
||||||
|
if ((msgh_id > 2) || (msgh_id < 0))
|
||||||
|
return 0;
|
||||||
|
|
||||||
|
return catch_mach_exc_subsystem.routine[msgh_id].stub_routine;
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,321 @@
|
||||||
|
#ifndef _mach_exc_server_
|
||||||
|
#define _mach_exc_server_
|
||||||
|
|
||||||
|
/* Module mach_exc */
|
||||||
|
|
||||||
|
#include <string.h>
|
||||||
|
#include <mach/ndr.h>
|
||||||
|
#include <mach/boolean.h>
|
||||||
|
#include <mach/kern_return.h>
|
||||||
|
#include <mach/notify.h>
|
||||||
|
#include <mach/mach_types.h>
|
||||||
|
#include <mach/message.h>
|
||||||
|
#include <mach/mig_errors.h>
|
||||||
|
#include <mach/port.h>
|
||||||
|
|
||||||
|
/* BEGIN VOUCHER CODE */
|
||||||
|
|
||||||
|
#ifndef KERNEL
|
||||||
|
#if defined(__has_include)
|
||||||
|
#if __has_include(<mach/mig_voucher_support.h>)
|
||||||
|
#ifndef USING_VOUCHERS
|
||||||
|
#define USING_VOUCHERS
|
||||||
|
#endif
|
||||||
|
#ifndef __VOUCHER_FORWARD_TYPE_DECLS__
|
||||||
|
#define __VOUCHER_FORWARD_TYPE_DECLS__
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
extern boolean_t voucher_mach_msg_set(mach_msg_header_t *msg) __attribute__((weak_import));
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
#endif // __VOUCHER_FORWARD_TYPE_DECLS__
|
||||||
|
#endif // __has_include(<mach/mach_voucher_types.h>)
|
||||||
|
#endif // __has_include
|
||||||
|
#endif // !KERNEL
|
||||||
|
|
||||||
|
/* END VOUCHER CODE */
|
||||||
|
|
||||||
|
|
||||||
|
/* BEGIN MIG_STRNCPY_ZEROFILL CODE */
|
||||||
|
|
||||||
|
#if defined(__has_include)
|
||||||
|
#if __has_include(<mach/mig_strncpy_zerofill_support.h>)
|
||||||
|
#ifndef USING_MIG_STRNCPY_ZEROFILL
|
||||||
|
#define USING_MIG_STRNCPY_ZEROFILL
|
||||||
|
#endif
|
||||||
|
#ifndef __MIG_STRNCPY_ZEROFILL_FORWARD_TYPE_DECLS__
|
||||||
|
#define __MIG_STRNCPY_ZEROFILL_FORWARD_TYPE_DECLS__
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
extern int mig_strncpy_zerofill(char *dest, const char *src, int len) __attribute__((weak_import));
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
#endif /* __MIG_STRNCPY_ZEROFILL_FORWARD_TYPE_DECLS__ */
|
||||||
|
#endif /* __has_include(<mach/mig_strncpy_zerofill_support.h>) */
|
||||||
|
#endif /* __has_include */
|
||||||
|
|
||||||
|
/* END MIG_STRNCPY_ZEROFILL CODE */
|
||||||
|
|
||||||
|
|
||||||
|
#ifdef AUTOTEST
|
||||||
|
#ifndef FUNCTION_PTR_T
|
||||||
|
#define FUNCTION_PTR_T
|
||||||
|
typedef void (*function_ptr_t)(mach_port_t, char *, mach_msg_type_number_t);
|
||||||
|
typedef struct {
|
||||||
|
char *name;
|
||||||
|
function_ptr_t function;
|
||||||
|
} function_table_entry;
|
||||||
|
typedef function_table_entry *function_table_t;
|
||||||
|
#endif /* FUNCTION_PTR_T */
|
||||||
|
#endif /* AUTOTEST */
|
||||||
|
|
||||||
|
#ifndef mach_exc_MSG_COUNT
|
||||||
|
#define mach_exc_MSG_COUNT 3
|
||||||
|
#endif /* mach_exc_MSG_COUNT */
|
||||||
|
|
||||||
|
#include <mach/std_types.h>
|
||||||
|
#include <mach/mig.h>
|
||||||
|
#include <mach/mig.h>
|
||||||
|
#include <mach/mach_types.h>
|
||||||
|
|
||||||
|
#ifdef __BeforeMigServerHeader
|
||||||
|
__BeforeMigServerHeader
|
||||||
|
#endif /* __BeforeMigServerHeader */
|
||||||
|
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise */
|
||||||
|
#ifdef mig_external
|
||||||
|
mig_external
|
||||||
|
#else
|
||||||
|
extern
|
||||||
|
#endif /* mig_external */
|
||||||
|
kern_return_t catch_mach_exception_raise
|
||||||
|
(
|
||||||
|
mach_port_t exception_port,
|
||||||
|
mach_port_t thread,
|
||||||
|
mach_port_t task,
|
||||||
|
exception_type_t exception,
|
||||||
|
mach_exception_data_t code,
|
||||||
|
mach_msg_type_number_t codeCnt
|
||||||
|
);
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise_state */
|
||||||
|
#ifdef mig_external
|
||||||
|
mig_external
|
||||||
|
#else
|
||||||
|
extern
|
||||||
|
#endif /* mig_external */
|
||||||
|
kern_return_t catch_mach_exception_raise_state
|
||||||
|
(
|
||||||
|
mach_port_t exception_port,
|
||||||
|
exception_type_t exception,
|
||||||
|
const mach_exception_data_t code,
|
||||||
|
mach_msg_type_number_t codeCnt,
|
||||||
|
int *flavor,
|
||||||
|
const thread_state_t old_state,
|
||||||
|
mach_msg_type_number_t old_stateCnt,
|
||||||
|
thread_state_t new_state,
|
||||||
|
mach_msg_type_number_t *new_stateCnt
|
||||||
|
);
|
||||||
|
|
||||||
|
/* Routine mach_exception_raise_state_identity */
|
||||||
|
#ifdef mig_external
|
||||||
|
mig_external
|
||||||
|
#else
|
||||||
|
extern
|
||||||
|
#endif /* mig_external */
|
||||||
|
kern_return_t catch_mach_exception_raise_state_identity
|
||||||
|
(
|
||||||
|
mach_port_t exception_port,
|
||||||
|
mach_port_t thread,
|
||||||
|
mach_port_t task,
|
||||||
|
exception_type_t exception,
|
||||||
|
mach_exception_data_t code,
|
||||||
|
mach_msg_type_number_t codeCnt,
|
||||||
|
int *flavor,
|
||||||
|
thread_state_t old_state,
|
||||||
|
mach_msg_type_number_t old_stateCnt,
|
||||||
|
thread_state_t new_state,
|
||||||
|
mach_msg_type_number_t *new_stateCnt
|
||||||
|
);
|
||||||
|
|
||||||
|
#ifdef mig_external
|
||||||
|
mig_external
|
||||||
|
#else
|
||||||
|
extern
|
||||||
|
#endif /* mig_external */
|
||||||
|
boolean_t mach_exc_server(
|
||||||
|
mach_msg_header_t *InHeadP,
|
||||||
|
mach_msg_header_t *OutHeadP);
|
||||||
|
|
||||||
|
#ifdef mig_external
|
||||||
|
mig_external
|
||||||
|
#else
|
||||||
|
extern
|
||||||
|
#endif /* mig_external */
|
||||||
|
mig_routine_t mach_exc_server_routine(
|
||||||
|
mach_msg_header_t *InHeadP);
|
||||||
|
|
||||||
|
|
||||||
|
/* Description of this subsystem, for use in direct RPC */
|
||||||
|
extern const struct catch_mach_exc_subsystem {
|
||||||
|
mig_server_routine_t server; /* Server routine */
|
||||||
|
mach_msg_id_t start; /* Min routine number */
|
||||||
|
mach_msg_id_t end; /* Max routine number + 1 */
|
||||||
|
unsigned int maxsize; /* Max msg size */
|
||||||
|
vm_address_t reserved; /* Reserved */
|
||||||
|
struct routine_descriptor /*Array of routine descriptors */
|
||||||
|
routine[3];
|
||||||
|
} catch_mach_exc_subsystem;
|
||||||
|
|
||||||
|
/* typedefs for all requests */
|
||||||
|
|
||||||
|
#ifndef __Request__mach_exc_subsystem__defined
|
||||||
|
#define __Request__mach_exc_subsystem__defined
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
/* start of the kernel processed data */
|
||||||
|
mach_msg_body_t msgh_body;
|
||||||
|
mach_msg_port_descriptor_t thread;
|
||||||
|
mach_msg_port_descriptor_t task;
|
||||||
|
/* end of the kernel processed data */
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
} __Request__mach_exception_raise_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
natural_t old_state[224];
|
||||||
|
} __Request__mach_exception_raise_state_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
/* start of the kernel processed data */
|
||||||
|
mach_msg_body_t msgh_body;
|
||||||
|
mach_msg_port_descriptor_t thread;
|
||||||
|
mach_msg_port_descriptor_t task;
|
||||||
|
/* end of the kernel processed data */
|
||||||
|
NDR_record_t NDR;
|
||||||
|
exception_type_t exception;
|
||||||
|
mach_msg_type_number_t codeCnt;
|
||||||
|
int64_t code[2];
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t old_stateCnt;
|
||||||
|
natural_t old_state[224];
|
||||||
|
} __Request__mach_exception_raise_state_identity_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
#endif /* !__Request__mach_exc_subsystem__defined */
|
||||||
|
|
||||||
|
|
||||||
|
/* union of all requests */
|
||||||
|
|
||||||
|
#ifndef __RequestUnion__catch_mach_exc_subsystem__defined
|
||||||
|
#define __RequestUnion__catch_mach_exc_subsystem__defined
|
||||||
|
union __RequestUnion__catch_mach_exc_subsystem {
|
||||||
|
__Request__mach_exception_raise_t Request_mach_exception_raise;
|
||||||
|
__Request__mach_exception_raise_state_t Request_mach_exception_raise_state;
|
||||||
|
__Request__mach_exception_raise_state_identity_t Request_mach_exception_raise_state_identity;
|
||||||
|
};
|
||||||
|
#endif /* __RequestUnion__catch_mach_exc_subsystem__defined */
|
||||||
|
/* typedefs for all replies */
|
||||||
|
|
||||||
|
#ifndef __Reply__mach_exc_subsystem__defined
|
||||||
|
#define __Reply__mach_exc_subsystem__defined
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
kern_return_t RetCode;
|
||||||
|
} __Reply__mach_exception_raise_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
kern_return_t RetCode;
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t new_stateCnt;
|
||||||
|
natural_t new_state[224];
|
||||||
|
} __Reply__mach_exception_raise_state_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack(4)
|
||||||
|
#endif
|
||||||
|
typedef struct {
|
||||||
|
mach_msg_header_t Head;
|
||||||
|
NDR_record_t NDR;
|
||||||
|
kern_return_t RetCode;
|
||||||
|
int flavor;
|
||||||
|
mach_msg_type_number_t new_stateCnt;
|
||||||
|
natural_t new_state[224];
|
||||||
|
} __Reply__mach_exception_raise_state_identity_t __attribute__((unused));
|
||||||
|
#ifdef __MigPackStructs
|
||||||
|
#pragma pack()
|
||||||
|
#endif
|
||||||
|
#endif /* !__Reply__mach_exc_subsystem__defined */
|
||||||
|
|
||||||
|
|
||||||
|
/* union of all replies */
|
||||||
|
|
||||||
|
#ifndef __ReplyUnion__catch_mach_exc_subsystem__defined
|
||||||
|
#define __ReplyUnion__catch_mach_exc_subsystem__defined
|
||||||
|
union __ReplyUnion__catch_mach_exc_subsystem {
|
||||||
|
__Reply__mach_exception_raise_t Reply_mach_exception_raise;
|
||||||
|
__Reply__mach_exception_raise_state_t Reply_mach_exception_raise_state;
|
||||||
|
__Reply__mach_exception_raise_state_identity_t Reply_mach_exception_raise_state_identity;
|
||||||
|
};
|
||||||
|
#endif /* __RequestUnion__catch_mach_exc_subsystem__defined */
|
||||||
|
|
||||||
|
#ifndef subsystem_to_name_map_mach_exc
|
||||||
|
#define subsystem_to_name_map_mach_exc \
|
||||||
|
{ "mach_exception_raise", 2405 },\
|
||||||
|
{ "mach_exception_raise_state", 2406 },\
|
||||||
|
{ "mach_exception_raise_state_identity", 2407 }
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __AfterMigServerHeader
|
||||||
|
__AfterMigServerHeader
|
||||||
|
#endif /* __AfterMigServerHeader */
|
||||||
|
|
||||||
|
#endif /* _mach_exc_server_ */
|
|
@ -0,0 +1,89 @@
|
||||||
|
//
|
||||||
|
// CwlBadInstructionException.swift
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if SWIFT_PACKAGE
|
||||||
|
import CwlMachBadInstructionHandler
|
||||||
|
#endif
|
||||||
|
|
||||||
|
private func raiseBadInstructionException() {
|
||||||
|
BadInstructionException().raise()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A simple NSException subclass. It's not required to subclass NSException (since the exception type is represented in the name) but this helps for identifying the exception through runtime type.
|
||||||
|
@objc(BadInstructionException)
|
||||||
|
public class BadInstructionException: NSException {
|
||||||
|
static var name: String = "com.cocoawithlove.BadInstruction"
|
||||||
|
|
||||||
|
init() {
|
||||||
|
super.init(name: NSExceptionName(rawValue: BadInstructionException.name), reason: nil, userInfo: nil)
|
||||||
|
}
|
||||||
|
|
||||||
|
required public init?(coder aDecoder: NSCoder) {
|
||||||
|
super.init(coder: aDecoder)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// An Objective-C callable function, invoked from the `mach_exc_server` callback function `catch_mach_exception_raise_state` to push the `raiseBadInstructionException` function onto the stack.
|
||||||
|
@objc(receiveReply:)
|
||||||
|
public class func receiveReply(_ value: NSValue) -> NSNumber {
|
||||||
|
#if arch(x86_64)
|
||||||
|
var reply = bad_instruction_exception_reply_t(exception_port: 0, exception: 0, code: nil, codeCnt: 0, flavor: nil, old_state: nil, old_stateCnt: 0, new_state: nil, new_stateCnt: nil)
|
||||||
|
withUnsafeMutablePointer(to: &reply) { value.getValue(UnsafeMutableRawPointer($0)) }
|
||||||
|
|
||||||
|
let old_state: UnsafePointer<natural_t> = reply.old_state!
|
||||||
|
let old_stateCnt: mach_msg_type_number_t = reply.old_stateCnt
|
||||||
|
let new_state: thread_state_t = reply.new_state!
|
||||||
|
let new_stateCnt: UnsafeMutablePointer<mach_msg_type_number_t> = reply.new_stateCnt!
|
||||||
|
|
||||||
|
// Make sure we've been given enough memory
|
||||||
|
if old_stateCnt != x86_THREAD_STATE64_COUNT || new_stateCnt.pointee < x86_THREAD_STATE64_COUNT {
|
||||||
|
return NSNumber(value: KERN_INVALID_ARGUMENT)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Read the old thread state
|
||||||
|
var state = old_state.withMemoryRebound(to: x86_thread_state64_t.self, capacity: 1) { return $0.pointee }
|
||||||
|
|
||||||
|
// 1. Decrement the stack pointer
|
||||||
|
state.__rsp -= __uint64_t(MemoryLayout<Int>.size)
|
||||||
|
|
||||||
|
// 2. Save the old Instruction Pointer to the stack.
|
||||||
|
if let pointer = UnsafeMutablePointer<__uint64_t>(bitPattern: UInt(state.__rsp)) {
|
||||||
|
pointer.pointee = state.__rip
|
||||||
|
} else {
|
||||||
|
return NSNumber(value: KERN_INVALID_ARGUMENT)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. Set the Instruction Pointer to the new function's address
|
||||||
|
var f: @convention(c) () -> Void = raiseBadInstructionException
|
||||||
|
withUnsafePointer(to: &f) {
|
||||||
|
state.__rip = $0.withMemoryRebound(to: __uint64_t.self, capacity: 1) { return $0.pointee }
|
||||||
|
}
|
||||||
|
|
||||||
|
// Write the new thread state
|
||||||
|
new_state.withMemoryRebound(to: x86_thread_state64_t.self, capacity: 1) { $0.pointee = state }
|
||||||
|
new_stateCnt.pointee = x86_THREAD_STATE64_COUNT
|
||||||
|
|
||||||
|
return NSNumber(value: KERN_SUCCESS)
|
||||||
|
#else
|
||||||
|
fatalError("Unavailable for this CPU architecture")
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,197 @@
|
||||||
|
//
|
||||||
|
// CwlCatchBadInstruction.swift
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if SWIFT_PACKAGE
|
||||||
|
import CwlMachBadInstructionHandler
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if arch(x86_64)
|
||||||
|
|
||||||
|
private enum PthreadError: Error { case code(Int32) }
|
||||||
|
private enum MachExcServer: Error { case code(kern_return_t) }
|
||||||
|
|
||||||
|
/// A quick function for converting Mach error results into Swift errors
|
||||||
|
private func kernCheck(_ f: () -> Int32) throws {
|
||||||
|
let r = f()
|
||||||
|
guard r == KERN_SUCCESS else {
|
||||||
|
throw NSError(domain: NSMachErrorDomain, code: Int(r), userInfo: nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension request_mach_exception_raise_t {
|
||||||
|
mutating func withMsgHeaderPointer<R>(in block: (UnsafeMutablePointer<mach_msg_header_t>) -> R) -> R {
|
||||||
|
return withUnsafeMutablePointer(to: &self) { p -> R in
|
||||||
|
return p.withMemoryRebound(to: mach_msg_header_t.self, capacity: 1) { ptr -> R in
|
||||||
|
return block(ptr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension reply_mach_exception_raise_state_t {
|
||||||
|
mutating func withMsgHeaderPointer<R>(in block: (UnsafeMutablePointer<mach_msg_header_t>) -> R) -> R {
|
||||||
|
return withUnsafeMutablePointer(to: &self) { p -> R in
|
||||||
|
return p.withMemoryRebound(to: mach_msg_header_t.self, capacity: 1) { ptr -> R in
|
||||||
|
return block(ptr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A structure used to store context associated with the Mach message port
|
||||||
|
private struct MachContext {
|
||||||
|
var masks = execTypesCountTuple<exception_mask_t>()
|
||||||
|
var count: mach_msg_type_number_t = 0
|
||||||
|
var ports = execTypesCountTuple<mach_port_t>()
|
||||||
|
var behaviors = execTypesCountTuple<exception_behavior_t>()
|
||||||
|
var flavors = execTypesCountTuple<thread_state_flavor_t>()
|
||||||
|
var currentExceptionPort: mach_port_t = 0
|
||||||
|
var handlerThread: pthread_t? = nil
|
||||||
|
|
||||||
|
static func internalMutablePointers<R>(_ m: UnsafeMutablePointer<execTypesCountTuple<exception_mask_t>>, _ c: UnsafeMutablePointer<mach_msg_type_number_t>, _ p: UnsafeMutablePointer<execTypesCountTuple<mach_port_t>>, _ b: UnsafeMutablePointer<execTypesCountTuple<exception_behavior_t>>, _ f: UnsafeMutablePointer<execTypesCountTuple<thread_state_flavor_t>>, _ block: (UnsafeMutablePointer<exception_mask_t>, UnsafeMutablePointer<mach_msg_type_number_t>, UnsafeMutablePointer<mach_port_t>, UnsafeMutablePointer<exception_behavior_t>, UnsafeMutablePointer<thread_state_flavor_t>) -> R) -> R {
|
||||||
|
return m.withMemoryRebound(to: exception_mask_t.self, capacity: 1) { masksPtr in
|
||||||
|
return c.withMemoryRebound(to: mach_msg_type_number_t.self, capacity: 1) { countPtr in
|
||||||
|
return p.withMemoryRebound(to: mach_port_t.self, capacity: 1) { portsPtr in
|
||||||
|
return b.withMemoryRebound(to: exception_behavior_t.self, capacity: 1) { behaviorsPtr in
|
||||||
|
return f.withMemoryRebound(to: thread_state_flavor_t.self, capacity: 1) { flavorsPtr in
|
||||||
|
return block(masksPtr, countPtr, portsPtr, behaviorsPtr, flavorsPtr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
mutating func withUnsafeMutablePointers<R>(in block: @escaping (UnsafeMutablePointer<exception_mask_t>, UnsafeMutablePointer<mach_msg_type_number_t>, UnsafeMutablePointer<mach_port_t>, UnsafeMutablePointer<exception_behavior_t>, UnsafeMutablePointer<thread_state_flavor_t>) -> R) -> R {
|
||||||
|
return MachContext.internalMutablePointers(&masks, &count, &ports, &behaviors, &flavors, block)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A function for receiving mach messages and parsing the first with mach_exc_server (and if any others are received, throwing them away).
|
||||||
|
private func machMessageHandler(_ arg: UnsafeMutableRawPointer) -> UnsafeMutableRawPointer? {
|
||||||
|
let context = arg.assumingMemoryBound(to: MachContext.self).pointee
|
||||||
|
var request = request_mach_exception_raise_t()
|
||||||
|
var reply = reply_mach_exception_raise_state_t()
|
||||||
|
|
||||||
|
var handledfirstException = false
|
||||||
|
repeat { do {
|
||||||
|
// Request the next mach message from the port
|
||||||
|
request.Head.msgh_local_port = context.currentExceptionPort
|
||||||
|
request.Head.msgh_size = UInt32(MemoryLayout<request_mach_exception_raise_t>.size)
|
||||||
|
let requestSize = request.Head.msgh_size
|
||||||
|
try kernCheck { request.withMsgHeaderPointer { requestPtr in
|
||||||
|
mach_msg(requestPtr, MACH_RCV_MSG | MACH_RCV_INTERRUPT, 0, requestSize, context.currentExceptionPort, 0, UInt32(MACH_PORT_NULL))
|
||||||
|
} }
|
||||||
|
|
||||||
|
// Prepare the reply structure
|
||||||
|
reply.Head.msgh_bits = MACH_MSGH_BITS(MACH_MSGH_BITS_REMOTE(request.Head.msgh_bits), 0)
|
||||||
|
reply.Head.msgh_local_port = UInt32(MACH_PORT_NULL)
|
||||||
|
reply.Head.msgh_remote_port = request.Head.msgh_remote_port
|
||||||
|
reply.Head.msgh_size = UInt32(MemoryLayout<reply_mach_exception_raise_state_t>.size)
|
||||||
|
reply.NDR = NDR_record
|
||||||
|
|
||||||
|
if !handledfirstException {
|
||||||
|
// Use the MiG generated server to invoke our handler for the request and fill in the rest of the reply structure
|
||||||
|
guard request.withMsgHeaderPointer(in: { requestPtr in reply.withMsgHeaderPointer { replyPtr in
|
||||||
|
mach_exc_server(requestPtr, replyPtr)
|
||||||
|
} }) != 0 else { throw MachExcServer.code(reply.RetCode) }
|
||||||
|
|
||||||
|
handledfirstException = true
|
||||||
|
} else {
|
||||||
|
// If multiple fatal errors occur, don't handle subsquent errors (let the program crash)
|
||||||
|
reply.RetCode = KERN_FAILURE
|
||||||
|
}
|
||||||
|
|
||||||
|
// Send the reply
|
||||||
|
let replySize = reply.Head.msgh_size
|
||||||
|
try kernCheck { reply.withMsgHeaderPointer { replyPtr in
|
||||||
|
mach_msg(replyPtr, MACH_SEND_MSG, replySize, 0, UInt32(MACH_PORT_NULL), 0, UInt32(MACH_PORT_NULL))
|
||||||
|
} }
|
||||||
|
} catch let error as NSError where (error.domain == NSMachErrorDomain && (error.code == Int(MACH_RCV_PORT_CHANGED) || error.code == Int(MACH_RCV_INVALID_NAME))) {
|
||||||
|
// Port was already closed before we started or closed while we were listening.
|
||||||
|
// This means the controlling thread shut down.
|
||||||
|
return nil
|
||||||
|
} catch {
|
||||||
|
// Should never be reached but this is testing code, don't try to recover, just abort
|
||||||
|
fatalError("Mach message error: \(error)")
|
||||||
|
} } while true
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Run the provided block. If a mach "BAD_INSTRUCTION" exception is raised, catch it and return a BadInstructionException (which captures stack information about the throw site, if desired). Otherwise return nil.
|
||||||
|
/// NOTE: This function is only intended for use in test harnesses – use in a distributed build is almost certainly a bad choice. If a "BAD_INSTRUCTION" exception is raised, the block will be exited before completion via Objective-C exception. The risks associated with an Objective-C exception apply here: most Swift/Objective-C functions are *not* exception-safe. Memory may be leaked and the program will not necessarily be left in a safe state.
|
||||||
|
/// - parameter block: a function without parameters that will be run
|
||||||
|
/// - returns: if an EXC_BAD_INSTRUCTION is raised during the execution of `block` then a BadInstructionException will be returned, otherwise `nil`.
|
||||||
|
public func catchBadInstruction(in block: () -> Void) -> BadInstructionException? {
|
||||||
|
var context = MachContext()
|
||||||
|
var result: BadInstructionException? = nil
|
||||||
|
do {
|
||||||
|
var handlerThread: pthread_t? = nil
|
||||||
|
defer {
|
||||||
|
// 8. Wait for the thread to terminate *if* we actually made it to the creation point
|
||||||
|
// The mach port should be destroyed *before* calling pthread_join to avoid a deadlock.
|
||||||
|
if handlerThread != nil {
|
||||||
|
pthread_join(handlerThread!, nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
try kernCheck {
|
||||||
|
// 1. Create the mach port
|
||||||
|
mach_port_allocate(mach_task_self_, MACH_PORT_RIGHT_RECEIVE, &context.currentExceptionPort)
|
||||||
|
}
|
||||||
|
defer {
|
||||||
|
// 7. Cleanup the mach port
|
||||||
|
mach_port_destroy(mach_task_self_, context.currentExceptionPort)
|
||||||
|
}
|
||||||
|
|
||||||
|
try kernCheck {
|
||||||
|
// 2. Configure the mach port
|
||||||
|
mach_port_insert_right(mach_task_self_, context.currentExceptionPort, context.currentExceptionPort, MACH_MSG_TYPE_MAKE_SEND)
|
||||||
|
}
|
||||||
|
|
||||||
|
let currentExceptionPtr = context.currentExceptionPort
|
||||||
|
try kernCheck { context.withUnsafeMutablePointers { masksPtr, countPtr, portsPtr, behaviorsPtr, flavorsPtr in
|
||||||
|
// 3. Apply the mach port as the handler for this thread
|
||||||
|
thread_swap_exception_ports(mach_thread_self(), EXC_MASK_BAD_INSTRUCTION, currentExceptionPtr, Int32(bitPattern: UInt32(EXCEPTION_STATE) | MACH_EXCEPTION_CODES), x86_THREAD_STATE64, masksPtr, countPtr, portsPtr, behaviorsPtr, flavorsPtr)
|
||||||
|
} }
|
||||||
|
|
||||||
|
defer { context.withUnsafeMutablePointers { masksPtr, countPtr, portsPtr, behaviorsPtr, flavorsPtr in
|
||||||
|
// 6. Unapply the mach port
|
||||||
|
_ = thread_swap_exception_ports(mach_thread_self(), EXC_MASK_BAD_INSTRUCTION, 0, EXCEPTION_DEFAULT, THREAD_STATE_NONE, masksPtr, countPtr, portsPtr, behaviorsPtr, flavorsPtr)
|
||||||
|
} }
|
||||||
|
|
||||||
|
try withUnsafeMutablePointer(to: &context) { c throws in
|
||||||
|
// 4. Create the thread
|
||||||
|
let e = pthread_create(&handlerThread, nil, machMessageHandler, c)
|
||||||
|
guard e == 0 else { throw PthreadError.code(e) }
|
||||||
|
|
||||||
|
// 5. Run the block
|
||||||
|
result = BadInstructionException.catchException(in: block)
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
// Should never be reached but this is testing code, don't try to recover, just abort
|
||||||
|
fatalError("Mach port error: \(error)")
|
||||||
|
}
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
|
@ -0,0 +1,108 @@
|
||||||
|
//
|
||||||
|
// CwlCatchBadInstructionPosix.swift
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 8/02/2016.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if arch(x86_64)
|
||||||
|
|
||||||
|
// This file is an alternative implementation to CwlCatchBadInstruction.swift that uses a SIGILL signal action and setenv/longjmp instead of a Mach exception handler and Objective-C exception raising.
|
||||||
|
//
|
||||||
|
// WARNING:
|
||||||
|
// This code is quick and dirty. It's a proof of concept for using a SIGILL handler and setjmp/longjmp where Mach exceptions and the Obj-C runtime aren't available. I ran the automated tests when I first wrote this code but I don't personally use it at all so by the time you're reading this comment, it probably broke and I didn't notice.
|
||||||
|
// Obvious limitations:
|
||||||
|
// * It doesn't work when debugging with lldb.
|
||||||
|
// * It doesn't scope correctly to the thread (it's global)
|
||||||
|
// * In violation of rules for signal handlers, it writes to the "red zone" on the stack
|
||||||
|
// * It isn't re-entrant
|
||||||
|
// * Plus all of the same caveats as the Mach exceptions version (doesn't play well with other handlers, probably leaks ARC memory, etc)
|
||||||
|
// Treat it like a loaded shotgun. Don't point it at your face.
|
||||||
|
|
||||||
|
// This function is called from the signal handler to shut down the thread and return 1 (indicating a SIGILL was received).
|
||||||
|
private func callThreadExit() {
|
||||||
|
pthread_exit(UnsafeMutableRawPointer(bitPattern: 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
// When called, this signal handler simulates a function call to `callThreadExit`
|
||||||
|
private func sigIllHandler(code: Int32, info: UnsafeMutablePointer<__siginfo>?, uap: UnsafeMutableRawPointer?) -> Void {
|
||||||
|
guard let context = uap?.assumingMemoryBound(to: ucontext64_t.self) else { return }
|
||||||
|
|
||||||
|
// 1. Decrement the stack pointer
|
||||||
|
context.pointee.uc_mcontext64.pointee.__ss.__rsp -= __uint64_t(MemoryLayout<Int>.size)
|
||||||
|
|
||||||
|
// 2. Save the old Instruction Pointer to the stack.
|
||||||
|
let rsp = context.pointee.uc_mcontext64.pointee.__ss.__rsp
|
||||||
|
if let ump = UnsafeMutablePointer<__uint64_t>(bitPattern: UInt(rsp)) {
|
||||||
|
ump.pointee = rsp
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. Set the Instruction Pointer to the new function's address
|
||||||
|
var f: @convention(c) () -> Void = callThreadExit
|
||||||
|
withUnsafePointer(to: &f) { $0.withMemoryRebound(to: __uint64_t.self, capacity: 1) { ptr in
|
||||||
|
context.pointee.uc_mcontext64.pointee.__ss.__rip = ptr.pointee
|
||||||
|
} }
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Without Mach exceptions or the Objective-C runtime, there's nothing to put in the exception object. It's really just a boolean – either a SIGILL was caught or not.
|
||||||
|
public class BadInstructionException {
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Run the provided block. If a POSIX SIGILL is received, handle it and return a BadInstructionException (which is just an empty object in this POSIX signal version). Otherwise return nil.
|
||||||
|
/// NOTE: This function is only intended for use in test harnesses – use in a distributed build is almost certainly a bad choice. If a SIGILL is received, the block will be interrupted using a C `longjmp`. The risks associated with abrupt jumps apply here: most Swift functions are *not* interrupt-safe. Memory may be leaked and the program will not necessarily be left in a safe state.
|
||||||
|
/// - parameter block: a function without parameters that will be run
|
||||||
|
/// - returns: if an SIGILL is raised during the execution of `block` then a BadInstructionException will be returned, otherwise `nil`.
|
||||||
|
public func catchBadInstruction(block: @escaping () -> Void) -> BadInstructionException? {
|
||||||
|
// Construct the signal action
|
||||||
|
var sigActionPrev = sigaction()
|
||||||
|
let action = __sigaction_u(__sa_sigaction: sigIllHandler)
|
||||||
|
var sigActionNew = sigaction(__sigaction_u: action, sa_mask: sigset_t(), sa_flags: SA_SIGINFO)
|
||||||
|
|
||||||
|
// Install the signal action
|
||||||
|
if sigaction(SIGILL, &sigActionNew, &sigActionPrev) != 0 {
|
||||||
|
fatalError("Sigaction error: \(errno)")
|
||||||
|
}
|
||||||
|
|
||||||
|
defer {
|
||||||
|
// Restore the previous signal action
|
||||||
|
if sigaction(SIGILL, &sigActionPrev, nil) != 0 {
|
||||||
|
fatalError("Sigaction error: \(errno)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
var b = block
|
||||||
|
let caught: Bool = withUnsafeMutablePointer(to: &b) { blockPtr in
|
||||||
|
// Run the block on its own thread
|
||||||
|
var handlerThread: pthread_t? = nil
|
||||||
|
let e = pthread_create(&handlerThread, nil, { arg in
|
||||||
|
(arg.assumingMemoryBound(to: (() -> Void).self).pointee)()
|
||||||
|
return nil
|
||||||
|
}, blockPtr)
|
||||||
|
precondition(e == 0, "Unable to create thread")
|
||||||
|
|
||||||
|
// Wait for completion and get the result. It will be either `nil` or bitPattern 1
|
||||||
|
var rawResult: UnsafeMutableRawPointer? = nil
|
||||||
|
let e2 = pthread_join(handlerThread!, &rawResult)
|
||||||
|
precondition(e2 == 0, "Thread join failed")
|
||||||
|
return Int(bitPattern: rawResult) != 0
|
||||||
|
}
|
||||||
|
|
||||||
|
return caught ? BadInstructionException() : nil
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,55 @@
|
||||||
|
//
|
||||||
|
// CwlDarwinDefinitions.swift
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
import Darwin
|
||||||
|
|
||||||
|
#if arch(x86_64)
|
||||||
|
|
||||||
|
// From /usr/include/mach/message.h
|
||||||
|
// #define MACH_MSG_TYPE_MAKE_SEND 20 /* Must hold receive right */
|
||||||
|
// #define MACH_MSGH_BITS_REMOTE(bits) \
|
||||||
|
// ((bits) & MACH_MSGH_BITS_REMOTE_MASK)
|
||||||
|
// #define MACH_MSGH_BITS(remote, local) /* legacy */ \
|
||||||
|
// ((remote) | ((local) << 8))
|
||||||
|
public let MACH_MSG_TYPE_MAKE_SEND: UInt32 = 20
|
||||||
|
public func MACH_MSGH_BITS_REMOTE(_ bits: UInt32) -> UInt32 { return bits & UInt32(MACH_MSGH_BITS_REMOTE_MASK) }
|
||||||
|
public func MACH_MSGH_BITS(_ remote: UInt32, _ local: UInt32) -> UInt32 { return ((remote) | ((local) << 8)) }
|
||||||
|
|
||||||
|
// From /usr/include/mach/exception_types.h
|
||||||
|
// #define EXC_BAD_INSTRUCTION 2 /* Instruction failed */
|
||||||
|
// #define EXC_MASK_BAD_INSTRUCTION (1 << EXC_BAD_INSTRUCTION)
|
||||||
|
public let EXC_BAD_INSTRUCTION: UInt32 = 2
|
||||||
|
public let EXC_MASK_BAD_INSTRUCTION: UInt32 = 1 << EXC_BAD_INSTRUCTION
|
||||||
|
|
||||||
|
// From /usr/include/mach/i386/thread_status.h
|
||||||
|
// #define x86_THREAD_STATE64_COUNT ((mach_msg_type_number_t) \
|
||||||
|
// ( sizeof (x86_thread_state64_t) / sizeof (int) ))
|
||||||
|
public let x86_THREAD_STATE64_COUNT = UInt32(MemoryLayout<x86_thread_state64_t>.size / MemoryLayout<Int32>.size)
|
||||||
|
|
||||||
|
public let EXC_TYPES_COUNT = 14
|
||||||
|
public struct execTypesCountTuple<T: ExpressibleByIntegerLiteral> {
|
||||||
|
// From /usr/include/mach/i386/exception.h
|
||||||
|
// #define EXC_TYPES_COUNT 14 /* incl. illegal exception 0 */
|
||||||
|
public var value: (T, T, T, T, T, T, T, T, T, T, T, T, T, T) = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
|
||||||
|
public init() {
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,30 @@
|
||||||
|
//
|
||||||
|
// CwlPreconditionTesting.h
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#import <Foundation/Foundation.h>
|
||||||
|
|
||||||
|
//! Project version number for CwlUtils.
|
||||||
|
FOUNDATION_EXPORT double CwlPreconditionTestingVersionNumber;
|
||||||
|
|
||||||
|
//! Project version string for CwlUtils.
|
||||||
|
FOUNDATION_EXPORT const unsigned char CwlAssertingTestingVersionString[];
|
||||||
|
|
||||||
|
#include "CwlMachBadInstructionHandler.h"
|
||||||
|
#include "CwlCatchException.h"
|
|
@ -0,0 +1,27 @@
|
||||||
|
//
|
||||||
|
// CwlPreconditionTesting.h
|
||||||
|
// CwlPreconditionTesting
|
||||||
|
//
|
||||||
|
// Created by Matt Gallagher on 2016/01/10.
|
||||||
|
// Copyright © 2016 Matt Gallagher ( http://cocoawithlove.com ). All rights reserved.
|
||||||
|
//
|
||||||
|
// Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
// purpose with or without fee is hereby granted, provided that the above
|
||||||
|
// copyright notice and this permission notice appear in all copies.
|
||||||
|
//
|
||||||
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||||
|
// IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
//
|
||||||
|
|
||||||
|
#import <Foundation/Foundation.h>
|
||||||
|
|
||||||
|
//! Project version number for CwlUtils.
|
||||||
|
FOUNDATION_EXPORT double CwlPreconditionTesting_POSIXVersionNumber;
|
||||||
|
|
||||||
|
//! Project version string for CwlUtils.
|
||||||
|
FOUNDATION_EXPORT const unsigned char CwlAssertingTesting_POSIXVersionString[];
|
3
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Dockerfile.test
vendored
Normal file
3
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Dockerfile.test
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
FROM swift:latest
|
||||||
|
COPY . .
|
||||||
|
CMD ./test swiftpm
|
4
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Gemfile
vendored
Normal file
4
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Gemfile
vendored
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
# A sample Gemfile
|
||||||
|
source "https://rubygems.org"
|
||||||
|
|
||||||
|
gem 'cocoapods', '1.5.0'
|
76
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Gemfile.lock
vendored
Normal file
76
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Gemfile.lock
vendored
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
GEM
|
||||||
|
remote: https://rubygems.org/
|
||||||
|
specs:
|
||||||
|
CFPropertyList (3.0.0)
|
||||||
|
activesupport (4.2.10)
|
||||||
|
i18n (~> 0.7)
|
||||||
|
minitest (~> 5.1)
|
||||||
|
thread_safe (~> 0.3, >= 0.3.4)
|
||||||
|
tzinfo (~> 1.1)
|
||||||
|
atomos (0.1.2)
|
||||||
|
claide (1.0.2)
|
||||||
|
cocoapods (1.5.0)
|
||||||
|
activesupport (>= 4.0.2, < 5)
|
||||||
|
claide (>= 1.0.2, < 2.0)
|
||||||
|
cocoapods-core (= 1.5.0)
|
||||||
|
cocoapods-deintegrate (>= 1.0.2, < 2.0)
|
||||||
|
cocoapods-downloader (>= 1.2.0, < 2.0)
|
||||||
|
cocoapods-plugins (>= 1.0.0, < 2.0)
|
||||||
|
cocoapods-search (>= 1.0.0, < 2.0)
|
||||||
|
cocoapods-stats (>= 1.0.0, < 2.0)
|
||||||
|
cocoapods-trunk (>= 1.3.0, < 2.0)
|
||||||
|
cocoapods-try (>= 1.1.0, < 2.0)
|
||||||
|
colored2 (~> 3.1)
|
||||||
|
escape (~> 0.0.4)
|
||||||
|
fourflusher (~> 2.0.1)
|
||||||
|
gh_inspector (~> 1.0)
|
||||||
|
molinillo (~> 0.6.5)
|
||||||
|
nap (~> 1.0)
|
||||||
|
ruby-macho (~> 1.1)
|
||||||
|
xcodeproj (>= 1.5.7, < 2.0)
|
||||||
|
cocoapods-core (1.5.0)
|
||||||
|
activesupport (>= 4.0.2, < 6)
|
||||||
|
fuzzy_match (~> 2.0.4)
|
||||||
|
nap (~> 1.0)
|
||||||
|
cocoapods-deintegrate (1.0.2)
|
||||||
|
cocoapods-downloader (1.2.0)
|
||||||
|
cocoapods-plugins (1.0.0)
|
||||||
|
nap
|
||||||
|
cocoapods-search (1.0.0)
|
||||||
|
cocoapods-stats (1.0.0)
|
||||||
|
cocoapods-trunk (1.3.0)
|
||||||
|
nap (>= 0.8, < 2.0)
|
||||||
|
netrc (~> 0.11)
|
||||||
|
cocoapods-try (1.1.0)
|
||||||
|
colored2 (3.1.2)
|
||||||
|
concurrent-ruby (1.0.5)
|
||||||
|
escape (0.0.4)
|
||||||
|
fourflusher (2.0.1)
|
||||||
|
fuzzy_match (2.0.4)
|
||||||
|
gh_inspector (1.1.3)
|
||||||
|
i18n (0.9.5)
|
||||||
|
concurrent-ruby (~> 1.0)
|
||||||
|
minitest (5.11.3)
|
||||||
|
molinillo (0.6.5)
|
||||||
|
nanaimo (0.2.5)
|
||||||
|
nap (1.1.0)
|
||||||
|
netrc (0.11.0)
|
||||||
|
ruby-macho (1.1.0)
|
||||||
|
thread_safe (0.3.6)
|
||||||
|
tzinfo (1.2.5)
|
||||||
|
thread_safe (~> 0.1)
|
||||||
|
xcodeproj (1.5.7)
|
||||||
|
CFPropertyList (>= 2.3.3, < 4.0)
|
||||||
|
atomos (~> 0.1.2)
|
||||||
|
claide (>= 1.0.2, < 2.0)
|
||||||
|
colored2 (~> 3.1)
|
||||||
|
nanaimo (~> 0.2.4)
|
||||||
|
|
||||||
|
PLATFORMS
|
||||||
|
ruby
|
||||||
|
|
||||||
|
DEPENDENCIES
|
||||||
|
cocoapods (= 1.5.0)
|
||||||
|
|
||||||
|
BUNDLED WITH
|
||||||
|
1.16.1
|
201
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/LICENSE
vendored
Normal file
201
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/LICENSE
vendored
Normal file
|
@ -0,0 +1,201 @@
|
||||||
|
Apache License
|
||||||
|
Version 2.0, January 2004
|
||||||
|
http://www.apache.org/licenses/
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
||||||
|
|
||||||
|
1. Definitions.
|
||||||
|
|
||||||
|
"License" shall mean the terms and conditions for use, reproduction,
|
||||||
|
and distribution as defined by Sections 1 through 9 of this document.
|
||||||
|
|
||||||
|
"Licensor" shall mean the copyright owner or entity authorized by
|
||||||
|
the copyright owner that is granting the License.
|
||||||
|
|
||||||
|
"Legal Entity" shall mean the union of the acting entity and all
|
||||||
|
other entities that control, are controlled by, or are under common
|
||||||
|
control with that entity. For the purposes of this definition,
|
||||||
|
"control" means (i) the power, direct or indirect, to cause the
|
||||||
|
direction or management of such entity, whether by contract or
|
||||||
|
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
||||||
|
outstanding shares, or (iii) beneficial ownership of such entity.
|
||||||
|
|
||||||
|
"You" (or "Your") shall mean an individual or Legal Entity
|
||||||
|
exercising permissions granted by this License.
|
||||||
|
|
||||||
|
"Source" form shall mean the preferred form for making modifications,
|
||||||
|
including but not limited to software source code, documentation
|
||||||
|
source, and configuration files.
|
||||||
|
|
||||||
|
"Object" form shall mean any form resulting from mechanical
|
||||||
|
transformation or translation of a Source form, including but
|
||||||
|
not limited to compiled object code, generated documentation,
|
||||||
|
and conversions to other media types.
|
||||||
|
|
||||||
|
"Work" shall mean the work of authorship, whether in Source or
|
||||||
|
Object form, made available under the License, as indicated by a
|
||||||
|
copyright notice that is included in or attached to the work
|
||||||
|
(an example is provided in the Appendix below).
|
||||||
|
|
||||||
|
"Derivative Works" shall mean any work, whether in Source or Object
|
||||||
|
form, that is based on (or derived from) the Work and for which the
|
||||||
|
editorial revisions, annotations, elaborations, or other modifications
|
||||||
|
represent, as a whole, an original work of authorship. For the purposes
|
||||||
|
of this License, Derivative Works shall not include works that remain
|
||||||
|
separable from, or merely link (or bind by name) to the interfaces of,
|
||||||
|
the Work and Derivative Works thereof.
|
||||||
|
|
||||||
|
"Contribution" shall mean any work of authorship, including
|
||||||
|
the original version of the Work and any modifications or additions
|
||||||
|
to that Work or Derivative Works thereof, that is intentionally
|
||||||
|
submitted to Licensor for inclusion in the Work by the copyright owner
|
||||||
|
or by an individual or Legal Entity authorized to submit on behalf of
|
||||||
|
the copyright owner. For the purposes of this definition, "submitted"
|
||||||
|
means any form of electronic, verbal, or written communication sent
|
||||||
|
to the Licensor or its representatives, including but not limited to
|
||||||
|
communication on electronic mailing lists, source code control systems,
|
||||||
|
and issue tracking systems that are managed by, or on behalf of, the
|
||||||
|
Licensor for the purpose of discussing and improving the Work, but
|
||||||
|
excluding communication that is conspicuously marked or otherwise
|
||||||
|
designated in writing by the copyright owner as "Not a Contribution."
|
||||||
|
|
||||||
|
"Contributor" shall mean Licensor and any individual or Legal Entity
|
||||||
|
on behalf of whom a Contribution has been received by Licensor and
|
||||||
|
subsequently incorporated within the Work.
|
||||||
|
|
||||||
|
2. Grant of Copyright License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
copyright license to reproduce, prepare Derivative Works of,
|
||||||
|
publicly display, publicly perform, sublicense, and distribute the
|
||||||
|
Work and such Derivative Works in Source or Object form.
|
||||||
|
|
||||||
|
3. Grant of Patent License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
(except as stated in this section) patent license to make, have made,
|
||||||
|
use, offer to sell, sell, import, and otherwise transfer the Work,
|
||||||
|
where such license applies only to those patent claims licensable
|
||||||
|
by such Contributor that are necessarily infringed by their
|
||||||
|
Contribution(s) alone or by combination of their Contribution(s)
|
||||||
|
with the Work to which such Contribution(s) was submitted. If You
|
||||||
|
institute patent litigation against any entity (including a
|
||||||
|
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
||||||
|
or a Contribution incorporated within the Work constitutes direct
|
||||||
|
or contributory patent infringement, then any patent licenses
|
||||||
|
granted to You under this License for that Work shall terminate
|
||||||
|
as of the date such litigation is filed.
|
||||||
|
|
||||||
|
4. Redistribution. You may reproduce and distribute copies of the
|
||||||
|
Work or Derivative Works thereof in any medium, with or without
|
||||||
|
modifications, and in Source or Object form, provided that You
|
||||||
|
meet the following conditions:
|
||||||
|
|
||||||
|
(a) You must give any other recipients of the Work or
|
||||||
|
Derivative Works a copy of this License; and
|
||||||
|
|
||||||
|
(b) You must cause any modified files to carry prominent notices
|
||||||
|
stating that You changed the files; and
|
||||||
|
|
||||||
|
(c) You must retain, in the Source form of any Derivative Works
|
||||||
|
that You distribute, all copyright, patent, trademark, and
|
||||||
|
attribution notices from the Source form of the Work,
|
||||||
|
excluding those notices that do not pertain to any part of
|
||||||
|
the Derivative Works; and
|
||||||
|
|
||||||
|
(d) If the Work includes a "NOTICE" text file as part of its
|
||||||
|
distribution, then any Derivative Works that You distribute must
|
||||||
|
include a readable copy of the attribution notices contained
|
||||||
|
within such NOTICE file, excluding those notices that do not
|
||||||
|
pertain to any part of the Derivative Works, in at least one
|
||||||
|
of the following places: within a NOTICE text file distributed
|
||||||
|
as part of the Derivative Works; within the Source form or
|
||||||
|
documentation, if provided along with the Derivative Works; or,
|
||||||
|
within a display generated by the Derivative Works, if and
|
||||||
|
wherever such third-party notices normally appear. The contents
|
||||||
|
of the NOTICE file are for informational purposes only and
|
||||||
|
do not modify the License. You may add Your own attribution
|
||||||
|
notices within Derivative Works that You distribute, alongside
|
||||||
|
or as an addendum to the NOTICE text from the Work, provided
|
||||||
|
that such additional attribution notices cannot be construed
|
||||||
|
as modifying the License.
|
||||||
|
|
||||||
|
You may add Your own copyright statement to Your modifications and
|
||||||
|
may provide additional or different license terms and conditions
|
||||||
|
for use, reproduction, or distribution of Your modifications, or
|
||||||
|
for any such Derivative Works as a whole, provided Your use,
|
||||||
|
reproduction, and distribution of the Work otherwise complies with
|
||||||
|
the conditions stated in this License.
|
||||||
|
|
||||||
|
5. Submission of Contributions. Unless You explicitly state otherwise,
|
||||||
|
any Contribution intentionally submitted for inclusion in the Work
|
||||||
|
by You to the Licensor shall be under the terms and conditions of
|
||||||
|
this License, without any additional terms or conditions.
|
||||||
|
Notwithstanding the above, nothing herein shall supersede or modify
|
||||||
|
the terms of any separate license agreement you may have executed
|
||||||
|
with Licensor regarding such Contributions.
|
||||||
|
|
||||||
|
6. Trademarks. This License does not grant permission to use the trade
|
||||||
|
names, trademarks, service marks, or product names of the Licensor,
|
||||||
|
except as required for reasonable and customary use in describing the
|
||||||
|
origin of the Work and reproducing the content of the NOTICE file.
|
||||||
|
|
||||||
|
7. Disclaimer of Warranty. Unless required by applicable law or
|
||||||
|
agreed to in writing, Licensor provides the Work (and each
|
||||||
|
Contributor provides its Contributions) on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||||||
|
implied, including, without limitation, any warranties or conditions
|
||||||
|
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE. You are solely responsible for determining the
|
||||||
|
appropriateness of using or redistributing the Work and assume any
|
||||||
|
risks associated with Your exercise of permissions under this License.
|
||||||
|
|
||||||
|
8. Limitation of Liability. In no event and under no legal theory,
|
||||||
|
whether in tort (including negligence), contract, or otherwise,
|
||||||
|
unless required by applicable law (such as deliberate and grossly
|
||||||
|
negligent acts) or agreed to in writing, shall any Contributor be
|
||||||
|
liable to You for damages, including any direct, indirect, special,
|
||||||
|
incidental, or consequential damages of any character arising as a
|
||||||
|
result of this License or out of the use or inability to use the
|
||||||
|
Work (including but not limited to damages for loss of goodwill,
|
||||||
|
work stoppage, computer failure or malfunction, or any and all
|
||||||
|
other commercial damages or losses), even if such Contributor
|
||||||
|
has been advised of the possibility of such damages.
|
||||||
|
|
||||||
|
9. Accepting Warranty or Additional Liability. While redistributing
|
||||||
|
the Work or Derivative Works thereof, You may choose to offer,
|
||||||
|
and charge a fee for, acceptance of support, warranty, indemnity,
|
||||||
|
or other liability obligations and/or rights consistent with this
|
||||||
|
License. However, in accepting such obligations, You may act only
|
||||||
|
on Your own behalf and on Your sole responsibility, not on behalf
|
||||||
|
of any other Contributor, and only if You agree to indemnify,
|
||||||
|
defend, and hold each Contributor harmless for any liability
|
||||||
|
incurred by, or claims asserted against, such Contributor by reason
|
||||||
|
of your accepting any such warranty or additional liability.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
APPENDIX: How to apply the Apache License to your work.
|
||||||
|
|
||||||
|
To apply the Apache License to your work, attach the following
|
||||||
|
boilerplate notice, with the fields enclosed by brackets "{}"
|
||||||
|
replaced with your own identifying information. (Don't include
|
||||||
|
the brackets!) The text should be enclosed in the appropriate
|
||||||
|
comment syntax for the file format. We also recommend that a
|
||||||
|
file or class name and description of purpose be included on the
|
||||||
|
same "printed page" as the copyright notice for easier
|
||||||
|
identification within third-party archives.
|
||||||
|
|
||||||
|
Copyright 2016 Quick Team
|
||||||
|
|
||||||
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
you may not use this file except in compliance with the License.
|
||||||
|
You may obtain a copy of the License at
|
||||||
|
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
See the License for the specific language governing permissions and
|
||||||
|
limitations under the License.
|
52
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.podspec
vendored
Normal file
52
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.podspec
vendored
Normal file
|
@ -0,0 +1,52 @@
|
||||||
|
Pod::Spec.new do |s|
|
||||||
|
s.name = "Nimble"
|
||||||
|
s.version = "7.1.2"
|
||||||
|
s.summary = "A Matcher Framework for Swift and Objective-C"
|
||||||
|
s.description = <<-DESC
|
||||||
|
Use Nimble to express the expected outcomes of Swift or Objective-C expressions. Inspired by Cedar.
|
||||||
|
DESC
|
||||||
|
s.homepage = "https://github.com/Quick/Nimble"
|
||||||
|
s.license = { :type => "Apache 2.0", :file => "LICENSE" }
|
||||||
|
s.author = "Quick Contributors"
|
||||||
|
s.ios.deployment_target = "8.0"
|
||||||
|
s.osx.deployment_target = "10.10"
|
||||||
|
s.tvos.deployment_target = "9.0"
|
||||||
|
s.source = { :git => "https://github.com/Quick/Nimble.git",
|
||||||
|
:tag => "v#{s.version}" }
|
||||||
|
|
||||||
|
s.source_files = [
|
||||||
|
"Sources/**/*.{swift,h,m,c}",
|
||||||
|
"Carthage/Checkouts/CwlCatchException/Sources/**/*.{swift,h,m,c}",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/**/*.{swift,h,m,c}",
|
||||||
|
]
|
||||||
|
|
||||||
|
s.osx.exclude_files = [
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/CwlCatchBadInstructionPosix.swift",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/Posix/CwlPreconditionTesting_POSIX.h",
|
||||||
|
]
|
||||||
|
s.ios.exclude_files = [
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/CwlCatchBadInstructionPosix.swift",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/Posix/CwlPreconditionTesting_POSIX.h",
|
||||||
|
]
|
||||||
|
s.tvos.exclude_files = [
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/Mach/CwlPreconditionTesting.h",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/CwlCatchBadInstruction.swift",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/CwlBadInstructionException.swift",
|
||||||
|
"Carthage/Checkouts/CwlPreconditionTesting/Sources/CwlPreconditionTesting/CwlDarwinDefinitions.swift",
|
||||||
|
"Carthage/Checkouts/CwlCatchException/Sources/CwlCatchException/CwlCatchException.swift",
|
||||||
|
"Carthage/Checkouts/CwlCatchException/Sources/CwlCatchExceptionSupport/CwlCatchException.m",
|
||||||
|
"Carthage/Checkouts/CwlCatchException/Sources/CwlCatchExceptionSupport/include/CwlCatchException.h",
|
||||||
|
]
|
||||||
|
|
||||||
|
s.exclude_files = "Sources/Nimble/Adapters/NonObjectiveC/*.swift"
|
||||||
|
s.weak_framework = "XCTest"
|
||||||
|
s.requires_arc = true
|
||||||
|
s.compiler_flags = '-DPRODUCT_NAME=Nimble/Nimble'
|
||||||
|
s.pod_target_xcconfig = {
|
||||||
|
'APPLICATION_EXTENSION_API_ONLY' => 'YES',
|
||||||
|
'ENABLE_BITCODE' => 'NO',
|
||||||
|
'OTHER_LDFLAGS' => '-weak-lswiftXCTest',
|
||||||
|
'OTHER_SWIFT_FLAGS' => '$(inherited) -suppress-warnings',
|
||||||
|
'FRAMEWORK_SEARCH_PATHS' => '$(inherited) "$(PLATFORM_DIR)/Developer/Library/Frameworks"',
|
||||||
|
}
|
||||||
|
end
|
2353
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.xcodeproj/project.pbxproj
vendored
Normal file
2353
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.xcodeproj/project.pbxproj
vendored
Normal file
File diff suppressed because it is too large
Load diff
7
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.xcodeproj/project.xcworkspace/contents.xcworkspacedata
generated
vendored
Normal file
7
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Nimble.xcodeproj/project.xcworkspace/contents.xcworkspacedata
generated
vendored
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<Workspace
|
||||||
|
version = "1.0">
|
||||||
|
<FileRef
|
||||||
|
location = "self:Nimble.xcodeproj">
|
||||||
|
</FileRef>
|
||||||
|
</Workspace>
|
|
@ -0,0 +1,82 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<Scheme
|
||||||
|
LastUpgradeVersion = "0930"
|
||||||
|
version = "2.0">
|
||||||
|
<BuildAction
|
||||||
|
parallelizeBuildables = "YES"
|
||||||
|
buildImplicitDependencies = "YES">
|
||||||
|
<BuildActionEntries>
|
||||||
|
<BuildActionEntry
|
||||||
|
buildForTesting = "YES"
|
||||||
|
buildForRunning = "YES"
|
||||||
|
buildForProfiling = "YES"
|
||||||
|
buildForArchiving = "YES"
|
||||||
|
buildForAnalyzing = "YES">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F1A74281940169200FFFC47"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-iOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</BuildActionEntry>
|
||||||
|
</BuildActionEntries>
|
||||||
|
</BuildAction>
|
||||||
|
<TestAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
|
||||||
|
selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES">
|
||||||
|
<Testables>
|
||||||
|
<TestableReference
|
||||||
|
skipped = "NO">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F1A74331940169200FFFC47"
|
||||||
|
BuildableName = "NimbleTests.xctest"
|
||||||
|
BlueprintName = "Nimble-iOSTests"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</TestableReference>
|
||||||
|
</Testables>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</TestAction>
|
||||||
|
<LaunchAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = ""
|
||||||
|
selectedLauncherIdentifier = "Xcode.IDEFoundation.Launcher.PosixSpawn"
|
||||||
|
launchStyle = "0"
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
ignoresPersistentStateOnLaunch = "NO"
|
||||||
|
debugDocumentVersioning = "YES"
|
||||||
|
debugXPCServices = "NO"
|
||||||
|
debugServiceExtension = "internal"
|
||||||
|
allowLocationSimulation = "YES">
|
||||||
|
<MacroExpansion>
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F1A74281940169200FFFC47"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-iOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</MacroExpansion>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</LaunchAction>
|
||||||
|
<ProfileAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES"
|
||||||
|
savedToolIdentifier = ""
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
debugDocumentVersioning = "YES">
|
||||||
|
</ProfileAction>
|
||||||
|
<AnalyzeAction
|
||||||
|
buildConfiguration = "Debug">
|
||||||
|
</AnalyzeAction>
|
||||||
|
<ArchiveAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
revealArchiveInOrganizer = "YES">
|
||||||
|
</ArchiveAction>
|
||||||
|
</Scheme>
|
|
@ -0,0 +1,82 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<Scheme
|
||||||
|
LastUpgradeVersion = "0930"
|
||||||
|
version = "2.0">
|
||||||
|
<BuildAction
|
||||||
|
parallelizeBuildables = "YES"
|
||||||
|
buildImplicitDependencies = "YES">
|
||||||
|
<BuildActionEntries>
|
||||||
|
<BuildActionEntry
|
||||||
|
buildForTesting = "YES"
|
||||||
|
buildForRunning = "YES"
|
||||||
|
buildForProfiling = "YES"
|
||||||
|
buildForArchiving = "YES"
|
||||||
|
buildForAnalyzing = "YES">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F925EAC195C0D6300ED456B"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-macOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</BuildActionEntry>
|
||||||
|
</BuildActionEntries>
|
||||||
|
</BuildAction>
|
||||||
|
<TestAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
|
||||||
|
selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES">
|
||||||
|
<Testables>
|
||||||
|
<TestableReference
|
||||||
|
skipped = "NO">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F925EB6195C0D6300ED456B"
|
||||||
|
BuildableName = "NimbleTests.xctest"
|
||||||
|
BlueprintName = "Nimble-macOSTests"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</TestableReference>
|
||||||
|
</Testables>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</TestAction>
|
||||||
|
<LaunchAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = ""
|
||||||
|
selectedLauncherIdentifier = "Xcode.IDEFoundation.Launcher.PosixSpawn"
|
||||||
|
launchStyle = "0"
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
ignoresPersistentStateOnLaunch = "NO"
|
||||||
|
debugDocumentVersioning = "YES"
|
||||||
|
debugXPCServices = "NO"
|
||||||
|
debugServiceExtension = "internal"
|
||||||
|
allowLocationSimulation = "YES">
|
||||||
|
<MacroExpansion>
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F925EAC195C0D6300ED456B"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-macOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</MacroExpansion>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</LaunchAction>
|
||||||
|
<ProfileAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES"
|
||||||
|
savedToolIdentifier = ""
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
debugDocumentVersioning = "YES">
|
||||||
|
</ProfileAction>
|
||||||
|
<AnalyzeAction
|
||||||
|
buildConfiguration = "Debug">
|
||||||
|
</AnalyzeAction>
|
||||||
|
<ArchiveAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
revealArchiveInOrganizer = "YES">
|
||||||
|
</ArchiveAction>
|
||||||
|
</Scheme>
|
|
@ -0,0 +1,99 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<Scheme
|
||||||
|
LastUpgradeVersion = "0930"
|
||||||
|
version = "1.3">
|
||||||
|
<BuildAction
|
||||||
|
parallelizeBuildables = "YES"
|
||||||
|
buildImplicitDependencies = "YES">
|
||||||
|
<BuildActionEntries>
|
||||||
|
<BuildActionEntry
|
||||||
|
buildForTesting = "YES"
|
||||||
|
buildForRunning = "YES"
|
||||||
|
buildForProfiling = "YES"
|
||||||
|
buildForArchiving = "YES"
|
||||||
|
buildForAnalyzing = "YES">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F5DF1541BDCA0CE00C3A531"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-tvOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</BuildActionEntry>
|
||||||
|
</BuildActionEntries>
|
||||||
|
</BuildAction>
|
||||||
|
<TestAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = ""
|
||||||
|
selectedLauncherIdentifier = "Xcode.IDEFoundation.Launcher.PosixSpawn"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES">
|
||||||
|
<Testables>
|
||||||
|
<TestableReference
|
||||||
|
skipped = "NO">
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F5DF15D1BDCA0CE00C3A531"
|
||||||
|
BuildableName = "NimbleTests.xctest"
|
||||||
|
BlueprintName = "Nimble-tvOSTests"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</TestableReference>
|
||||||
|
</Testables>
|
||||||
|
<MacroExpansion>
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F5DF1541BDCA0CE00C3A531"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-tvOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</MacroExpansion>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</TestAction>
|
||||||
|
<LaunchAction
|
||||||
|
buildConfiguration = "Debug"
|
||||||
|
selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
|
||||||
|
selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
|
||||||
|
launchStyle = "0"
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
ignoresPersistentStateOnLaunch = "NO"
|
||||||
|
debugDocumentVersioning = "YES"
|
||||||
|
debugServiceExtension = "internal"
|
||||||
|
allowLocationSimulation = "YES">
|
||||||
|
<MacroExpansion>
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F5DF1541BDCA0CE00C3A531"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-tvOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</MacroExpansion>
|
||||||
|
<AdditionalOptions>
|
||||||
|
</AdditionalOptions>
|
||||||
|
</LaunchAction>
|
||||||
|
<ProfileAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
shouldUseLaunchSchemeArgsEnv = "YES"
|
||||||
|
savedToolIdentifier = ""
|
||||||
|
useCustomWorkingDirectory = "NO"
|
||||||
|
debugDocumentVersioning = "YES">
|
||||||
|
<MacroExpansion>
|
||||||
|
<BuildableReference
|
||||||
|
BuildableIdentifier = "primary"
|
||||||
|
BlueprintIdentifier = "1F5DF1541BDCA0CE00C3A531"
|
||||||
|
BuildableName = "Nimble.framework"
|
||||||
|
BlueprintName = "Nimble-tvOS"
|
||||||
|
ReferencedContainer = "container:Nimble.xcodeproj">
|
||||||
|
</BuildableReference>
|
||||||
|
</MacroExpansion>
|
||||||
|
</ProfileAction>
|
||||||
|
<AnalyzeAction
|
||||||
|
buildConfiguration = "Debug">
|
||||||
|
</AnalyzeAction>
|
||||||
|
<ArchiveAction
|
||||||
|
buildConfiguration = "Release"
|
||||||
|
revealArchiveInOrganizer = "YES">
|
||||||
|
</ArchiveAction>
|
||||||
|
</Scheme>
|
11
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Package.swift
vendored
Normal file
11
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Package.swift
vendored
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
// swift-tools-version:3.0
|
||||||
|
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "Nimble",
|
||||||
|
exclude: [
|
||||||
|
"Sources/NimbleObjectiveC",
|
||||||
|
"Tests/NimbleTests/objc",
|
||||||
|
]
|
||||||
|
)
|
22
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Package@swift-4.swift
vendored
Normal file
22
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Package@swift-4.swift
vendored
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
// swift-tools-version:4.0
|
||||||
|
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "Nimble",
|
||||||
|
products: [
|
||||||
|
.library(name: "Nimble", targets: ["Nimble"]),
|
||||||
|
],
|
||||||
|
targets: [
|
||||||
|
.target(
|
||||||
|
name: "Nimble",
|
||||||
|
dependencies: []
|
||||||
|
),
|
||||||
|
.testTarget(
|
||||||
|
name: "NimbleTests",
|
||||||
|
dependencies: ["Nimble"],
|
||||||
|
exclude: ["objc"]
|
||||||
|
),
|
||||||
|
],
|
||||||
|
swiftLanguageVersions: [4]
|
||||||
|
)
|
1764
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/README.md
vendored
Normal file
1764
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/README.md
vendored
Normal file
File diff suppressed because it is too large
Load diff
|
@ -0,0 +1,17 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// Protocol for the assertion handler that Nimble uses for all expectations.
|
||||||
|
public protocol AssertionHandler {
|
||||||
|
func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Global backing interface for assertions that Nimble creates.
|
||||||
|
/// Defaults to a private test handler that passes through to XCTest.
|
||||||
|
///
|
||||||
|
/// If XCTest is not available, you must assign your own assertion handler
|
||||||
|
/// before using any matchers, otherwise Nimble will abort the program.
|
||||||
|
///
|
||||||
|
/// @see AssertionHandler
|
||||||
|
public var NimbleAssertionHandler: AssertionHandler = { () -> AssertionHandler in
|
||||||
|
return isXCTestAvailable() ? NimbleXCTestHandler() : NimbleXCTestUnavailableHandler()
|
||||||
|
}()
|
|
@ -0,0 +1,19 @@
|
||||||
|
/// AssertionDispatcher allows multiple AssertionHandlers to receive
|
||||||
|
/// assertion messages.
|
||||||
|
///
|
||||||
|
/// @warning Does not fully dispatch if one of the handlers raises an exception.
|
||||||
|
/// This is possible with XCTest-based assertion handlers.
|
||||||
|
///
|
||||||
|
public class AssertionDispatcher: AssertionHandler {
|
||||||
|
let handlers: [AssertionHandler]
|
||||||
|
|
||||||
|
public init(handlers: [AssertionHandler]) {
|
||||||
|
self.handlers = handlers
|
||||||
|
}
|
||||||
|
|
||||||
|
public func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation) {
|
||||||
|
for handler in handlers {
|
||||||
|
handler.assert(assertion, message: message, location: location)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,100 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A data structure that stores information about an assertion when
|
||||||
|
/// AssertionRecorder is set as the Nimble assertion handler.
|
||||||
|
///
|
||||||
|
/// @see AssertionRecorder
|
||||||
|
/// @see AssertionHandler
|
||||||
|
public struct AssertionRecord: CustomStringConvertible {
|
||||||
|
/// Whether the assertion succeeded or failed
|
||||||
|
public let success: Bool
|
||||||
|
/// The failure message the assertion would display on failure.
|
||||||
|
public let message: FailureMessage
|
||||||
|
/// The source location the expectation occurred on.
|
||||||
|
public let location: SourceLocation
|
||||||
|
|
||||||
|
public var description: String {
|
||||||
|
return "AssertionRecord { success=\(success), message='\(message.stringValue)', location=\(location) }"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// An AssertionHandler that silently records assertions that Nimble makes.
|
||||||
|
/// This is useful for testing failure messages for matchers.
|
||||||
|
///
|
||||||
|
/// @see AssertionHandler
|
||||||
|
public class AssertionRecorder: AssertionHandler {
|
||||||
|
/// All the assertions that were captured by this recorder
|
||||||
|
public var assertions = [AssertionRecord]()
|
||||||
|
|
||||||
|
public init() {}
|
||||||
|
|
||||||
|
public func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation) {
|
||||||
|
assertions.append(
|
||||||
|
AssertionRecord(
|
||||||
|
success: assertion,
|
||||||
|
message: message,
|
||||||
|
location: location))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Allows you to temporarily replace the current Nimble assertion handler with
|
||||||
|
/// the one provided for the scope of the closure.
|
||||||
|
///
|
||||||
|
/// Once the closure finishes, then the original Nimble assertion handler is restored.
|
||||||
|
///
|
||||||
|
/// @see AssertionHandler
|
||||||
|
public func withAssertionHandler(_ tempAssertionHandler: AssertionHandler, closure: () throws -> Void) {
|
||||||
|
let environment = NimbleEnvironment.activeInstance
|
||||||
|
let oldRecorder = environment.assertionHandler
|
||||||
|
let capturer = NMBExceptionCapture(handler: nil, finally: ({
|
||||||
|
environment.assertionHandler = oldRecorder
|
||||||
|
}))
|
||||||
|
environment.assertionHandler = tempAssertionHandler
|
||||||
|
capturer.tryBlock {
|
||||||
|
try! closure()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Captures expectations that occur in the given closure. Note that all
|
||||||
|
/// expectations will still go through to the default Nimble handler.
|
||||||
|
///
|
||||||
|
/// This can be useful if you want to gather information about expectations
|
||||||
|
/// that occur within a closure.
|
||||||
|
///
|
||||||
|
/// @param silently expectations are no longer send to the default Nimble
|
||||||
|
/// assertion handler when this is true. Defaults to false.
|
||||||
|
///
|
||||||
|
/// @see gatherFailingExpectations
|
||||||
|
public func gatherExpectations(silently: Bool = false, closure: @escaping () -> Void) -> [AssertionRecord] {
|
||||||
|
let previousRecorder = NimbleEnvironment.activeInstance.assertionHandler
|
||||||
|
let recorder = AssertionRecorder()
|
||||||
|
let handlers: [AssertionHandler]
|
||||||
|
|
||||||
|
if silently {
|
||||||
|
handlers = [recorder]
|
||||||
|
} else {
|
||||||
|
handlers = [recorder, previousRecorder]
|
||||||
|
}
|
||||||
|
|
||||||
|
let dispatcher = AssertionDispatcher(handlers: handlers)
|
||||||
|
withAssertionHandler(dispatcher, closure: closure)
|
||||||
|
return recorder.assertions
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Captures failed expectations that occur in the given closure. Note that all
|
||||||
|
/// expectations will still go through to the default Nimble handler.
|
||||||
|
///
|
||||||
|
/// This can be useful if you want to gather information about failed
|
||||||
|
/// expectations that occur within a closure.
|
||||||
|
///
|
||||||
|
/// @param silently expectations are no longer send to the default Nimble
|
||||||
|
/// assertion handler when this is true. Defaults to false.
|
||||||
|
///
|
||||||
|
/// @see gatherExpectations
|
||||||
|
/// @see raiseException source for an example use case.
|
||||||
|
public func gatherFailingExpectations(silently: Bool = false, closure: @escaping () -> Void) -> [AssertionRecord] {
|
||||||
|
let assertions = gatherExpectations(silently: silently, closure: closure)
|
||||||
|
return assertions.filter { assertion in
|
||||||
|
!assertion.success
|
||||||
|
}
|
||||||
|
}
|
187
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Adapters/NMBExpectation.swift
vendored
Normal file
187
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Adapters/NMBExpectation.swift
vendored
Normal file
|
@ -0,0 +1,187 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if (os(macOS) || os(iOS) || os(tvOS) || os(watchOS)) && !SWIFT_PACKAGE
|
||||||
|
|
||||||
|
private func from(objcPredicate: NMBPredicate) -> Predicate<NSObject> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
let result = objcPredicate.satisfies(({ try! actualExpression.evaluate() }),
|
||||||
|
location: actualExpression.location)
|
||||||
|
return result.toSwift()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal struct ObjCMatcherWrapper: Matcher {
|
||||||
|
let matcher: NMBMatcher
|
||||||
|
|
||||||
|
func matches(_ actualExpression: Expression<NSObject>, failureMessage: FailureMessage) -> Bool {
|
||||||
|
return matcher.matches(
|
||||||
|
({ try! actualExpression.evaluate() }),
|
||||||
|
failureMessage: failureMessage,
|
||||||
|
location: actualExpression.location)
|
||||||
|
}
|
||||||
|
|
||||||
|
func doesNotMatch(_ actualExpression: Expression<NSObject>, failureMessage: FailureMessage) -> Bool {
|
||||||
|
return matcher.doesNotMatch(
|
||||||
|
({ try! actualExpression.evaluate() }),
|
||||||
|
failureMessage: failureMessage,
|
||||||
|
location: actualExpression.location)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Equivalent to Expectation, but for Nimble's Objective-C interface
|
||||||
|
public class NMBExpectation: NSObject {
|
||||||
|
internal let _actualBlock: () -> NSObject?
|
||||||
|
internal var _negative: Bool
|
||||||
|
internal let _file: FileString
|
||||||
|
internal let _line: UInt
|
||||||
|
internal var _timeout: TimeInterval = 1.0
|
||||||
|
|
||||||
|
@objc public init(actualBlock: @escaping () -> NSObject?, negative: Bool, file: FileString, line: UInt) {
|
||||||
|
self._actualBlock = actualBlock
|
||||||
|
self._negative = negative
|
||||||
|
self._file = file
|
||||||
|
self._line = line
|
||||||
|
}
|
||||||
|
|
||||||
|
private var expectValue: Expectation<NSObject> {
|
||||||
|
return expect(_file, line: _line) {
|
||||||
|
self._actualBlock() as NSObject?
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var withTimeout: (TimeInterval) -> NMBExpectation {
|
||||||
|
return ({ timeout in self._timeout = timeout
|
||||||
|
return self
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var to: (NMBMatcher) -> Void {
|
||||||
|
return ({ matcher in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.to(from(objcPredicate: pred))
|
||||||
|
} else {
|
||||||
|
self.expectValue.to(ObjCMatcherWrapper(matcher: matcher))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toWithDescription: (NMBMatcher, String) -> Void {
|
||||||
|
return ({ matcher, description in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.to(from(objcPredicate: pred), description: description)
|
||||||
|
} else {
|
||||||
|
self.expectValue.to(ObjCMatcherWrapper(matcher: matcher), description: description)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toNot: (NMBMatcher) -> Void {
|
||||||
|
return ({ matcher in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toNot(from(objcPredicate: pred))
|
||||||
|
} else {
|
||||||
|
self.expectValue.toNot(ObjCMatcherWrapper(matcher: matcher))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toNotWithDescription: (NMBMatcher, String) -> Void {
|
||||||
|
return ({ matcher, description in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toNot(from(objcPredicate: pred), description: description)
|
||||||
|
} else {
|
||||||
|
self.expectValue.toNot(ObjCMatcherWrapper(matcher: matcher), description: description)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var notTo: (NMBMatcher) -> Void { return toNot }
|
||||||
|
|
||||||
|
@objc public var notToWithDescription: (NMBMatcher, String) -> Void { return toNotWithDescription }
|
||||||
|
|
||||||
|
@objc public var toEventually: (NMBMatcher) -> Void {
|
||||||
|
return ({ matcher in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toEventually(
|
||||||
|
from(objcPredicate: pred),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: nil
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
self.expectValue.toEventually(
|
||||||
|
ObjCMatcherWrapper(matcher: matcher),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: nil
|
||||||
|
)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toEventuallyWithDescription: (NMBMatcher, String) -> Void {
|
||||||
|
return ({ matcher, description in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toEventually(
|
||||||
|
from(objcPredicate: pred),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
self.expectValue.toEventually(
|
||||||
|
ObjCMatcherWrapper(matcher: matcher),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toEventuallyNot: (NMBMatcher) -> Void {
|
||||||
|
return ({ matcher in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toEventuallyNot(
|
||||||
|
from(objcPredicate: pred),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: nil
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
self.expectValue.toEventuallyNot(
|
||||||
|
ObjCMatcherWrapper(matcher: matcher),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: nil
|
||||||
|
)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toEventuallyNotWithDescription: (NMBMatcher, String) -> Void {
|
||||||
|
return ({ matcher, description in
|
||||||
|
if let pred = matcher as? NMBPredicate {
|
||||||
|
self.expectValue.toEventuallyNot(
|
||||||
|
from(objcPredicate: pred),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
self.expectValue.toEventuallyNot(
|
||||||
|
ObjCMatcherWrapper(matcher: matcher),
|
||||||
|
timeout: self._timeout,
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toNotEventually: (NMBMatcher) -> Void {
|
||||||
|
return toEventuallyNot
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var toNotEventuallyWithDescription: (NMBMatcher, String) -> Void {
|
||||||
|
return toEventuallyNotWithDescription
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public class func failWithMessage(_ message: String, file: FileString, line: UInt) {
|
||||||
|
fail(message, location: SourceLocation(file: file, line: line))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,83 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
|
||||||
|
// swiftlint:disable line_length
|
||||||
|
public typealias MatcherBlock = (_ actualExpression: Expression<NSObject>, _ failureMessage: FailureMessage) -> Bool
|
||||||
|
public typealias FullMatcherBlock = (_ actualExpression: Expression<NSObject>, _ failureMessage: FailureMessage, _ shouldNotMatch: Bool) -> Bool
|
||||||
|
// swiftlint:enable line_length
|
||||||
|
|
||||||
|
public class NMBObjCMatcher: NSObject, NMBMatcher {
|
||||||
|
let _match: MatcherBlock
|
||||||
|
let _doesNotMatch: MatcherBlock
|
||||||
|
let canMatchNil: Bool
|
||||||
|
|
||||||
|
public init(canMatchNil: Bool, matcher: @escaping MatcherBlock, notMatcher: @escaping MatcherBlock) {
|
||||||
|
self.canMatchNil = canMatchNil
|
||||||
|
self._match = matcher
|
||||||
|
self._doesNotMatch = notMatcher
|
||||||
|
}
|
||||||
|
|
||||||
|
public convenience init(matcher: @escaping MatcherBlock) {
|
||||||
|
self.init(canMatchNil: true, matcher: matcher)
|
||||||
|
}
|
||||||
|
|
||||||
|
public convenience init(canMatchNil: Bool, matcher: @escaping MatcherBlock) {
|
||||||
|
self.init(canMatchNil: canMatchNil, matcher: matcher, notMatcher: ({ actualExpression, failureMessage in
|
||||||
|
return !matcher(actualExpression, failureMessage)
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
public convenience init(matcher: @escaping FullMatcherBlock) {
|
||||||
|
self.init(canMatchNil: true, matcher: matcher)
|
||||||
|
}
|
||||||
|
|
||||||
|
public convenience init(canMatchNil: Bool, matcher: @escaping FullMatcherBlock) {
|
||||||
|
self.init(canMatchNil: canMatchNil, matcher: ({ actualExpression, failureMessage in
|
||||||
|
return matcher(actualExpression, failureMessage, false)
|
||||||
|
}), notMatcher: ({ actualExpression, failureMessage in
|
||||||
|
return matcher(actualExpression, failureMessage, true)
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
private func canMatch(_ actualExpression: Expression<NSObject>, failureMessage: FailureMessage) -> Bool {
|
||||||
|
do {
|
||||||
|
if !canMatchNil {
|
||||||
|
if try actualExpression.evaluate() == nil {
|
||||||
|
failureMessage.postfixActual = " (use beNil() to match nils)"
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch let error {
|
||||||
|
failureMessage.actualValue = "an unexpected error thrown: \(error)"
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
public func matches(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let expr = Expression(expression: actualBlock, location: location)
|
||||||
|
let result = _match(
|
||||||
|
expr,
|
||||||
|
failureMessage)
|
||||||
|
if self.canMatch(Expression(expression: actualBlock, location: location), failureMessage: failureMessage) {
|
||||||
|
return result
|
||||||
|
} else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public func doesNotMatch(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let expr = Expression(expression: actualBlock, location: location)
|
||||||
|
let result = _doesNotMatch(
|
||||||
|
expr,
|
||||||
|
failureMessage)
|
||||||
|
if self.canMatch(Expression(expression: actualBlock, location: location), failureMessage: failureMessage) {
|
||||||
|
return result
|
||||||
|
} else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,45 @@
|
||||||
|
import Dispatch
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// "Global" state of Nimble is stored here. Only DSL functions should access / be aware of this
|
||||||
|
/// class' existence
|
||||||
|
internal class NimbleEnvironment {
|
||||||
|
static var activeInstance: NimbleEnvironment {
|
||||||
|
get {
|
||||||
|
let env = Thread.current.threadDictionary["NimbleEnvironment"]
|
||||||
|
if let env = env as? NimbleEnvironment {
|
||||||
|
return env
|
||||||
|
} else {
|
||||||
|
let newEnv = NimbleEnvironment()
|
||||||
|
self.activeInstance = newEnv
|
||||||
|
return newEnv
|
||||||
|
}
|
||||||
|
}
|
||||||
|
set {
|
||||||
|
Thread.current.threadDictionary["NimbleEnvironment"] = newValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO: eventually migrate the global to this environment value
|
||||||
|
var assertionHandler: AssertionHandler {
|
||||||
|
get { return NimbleAssertionHandler }
|
||||||
|
set { NimbleAssertionHandler = newValue }
|
||||||
|
}
|
||||||
|
|
||||||
|
var suppressTVOSAssertionWarning: Bool = false
|
||||||
|
var awaiter: Awaiter
|
||||||
|
|
||||||
|
init() {
|
||||||
|
let timeoutQueue: DispatchQueue
|
||||||
|
if #available(OSX 10.10, *) {
|
||||||
|
timeoutQueue = DispatchQueue.global(qos: .userInitiated)
|
||||||
|
} else {
|
||||||
|
timeoutQueue = DispatchQueue.global(priority: .high)
|
||||||
|
}
|
||||||
|
|
||||||
|
awaiter = Awaiter(
|
||||||
|
waitLock: AssertionWaitLock(),
|
||||||
|
asyncQueue: .main,
|
||||||
|
timeoutQueue: timeoutQueue)
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,81 @@
|
||||||
|
import Foundation
|
||||||
|
import XCTest
|
||||||
|
|
||||||
|
/// Default handler for Nimble. This assertion handler passes failures along to
|
||||||
|
/// XCTest.
|
||||||
|
public class NimbleXCTestHandler: AssertionHandler {
|
||||||
|
public func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation) {
|
||||||
|
if !assertion {
|
||||||
|
recordFailure("\(message.stringValue)\n", location: location)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Alternative handler for Nimble. This assertion handler passes failures along
|
||||||
|
/// to XCTest by attempting to reduce the failure message size.
|
||||||
|
public class NimbleShortXCTestHandler: AssertionHandler {
|
||||||
|
public func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation) {
|
||||||
|
if !assertion {
|
||||||
|
let msg: String
|
||||||
|
if let actual = message.actualValue {
|
||||||
|
msg = "got: \(actual) \(message.postfixActual)"
|
||||||
|
} else {
|
||||||
|
msg = "expected \(message.to) \(message.postfixMessage)"
|
||||||
|
}
|
||||||
|
recordFailure("\(msg)\n", location: location)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Fallback handler in case XCTest is unavailable. This assertion handler will abort
|
||||||
|
/// the program if it is invoked.
|
||||||
|
class NimbleXCTestUnavailableHandler: AssertionHandler {
|
||||||
|
func assert(_ assertion: Bool, message: FailureMessage, location: SourceLocation) {
|
||||||
|
fatalError("XCTest is not available and no custom assertion handler was configured. Aborting.")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !SWIFT_PACKAGE
|
||||||
|
/// Helper class providing access to the currently executing XCTestCase instance, if any
|
||||||
|
@objc final internal class CurrentTestCaseTracker: NSObject, XCTestObservation {
|
||||||
|
@objc static let sharedInstance = CurrentTestCaseTracker()
|
||||||
|
|
||||||
|
private(set) var currentTestCase: XCTestCase?
|
||||||
|
|
||||||
|
@objc func testCaseWillStart(_ testCase: XCTestCase) {
|
||||||
|
currentTestCase = testCase
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc func testCaseDidFinish(_ testCase: XCTestCase) {
|
||||||
|
currentTestCase = nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
func isXCTestAvailable() -> Bool {
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
// XCTest is weakly linked and so may not be present
|
||||||
|
return NSClassFromString("XCTestCase") != nil
|
||||||
|
#else
|
||||||
|
return true
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
|
private func recordFailure(_ message: String, location: SourceLocation) {
|
||||||
|
#if SWIFT_PACKAGE
|
||||||
|
XCTFail("\(message)", file: location.file, line: location.line)
|
||||||
|
#else
|
||||||
|
if let testCase = CurrentTestCaseTracker.sharedInstance.currentTestCase {
|
||||||
|
#if swift(>=4)
|
||||||
|
let line = Int(location.line)
|
||||||
|
#else
|
||||||
|
let line = location.line
|
||||||
|
#endif
|
||||||
|
testCase.recordFailure(withDescription: message, inFile: location.file, atLine: line, expected: true)
|
||||||
|
} else {
|
||||||
|
let msg = "Attempted to report a test failure to XCTest while no test case was running. " +
|
||||||
|
"The failure was:\n\"\(message)\"\nIt occurred at: \(location.file):\(location.line)"
|
||||||
|
NSException(name: .internalInconsistencyException, reason: msg, userInfo: nil).raise()
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
}
|
|
@ -0,0 +1,31 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
#if !(os(macOS) || os(iOS) || os(tvOS) || os(watchOS))
|
||||||
|
// swift-corelibs-foundation doesn't provide NSException at all, so provide a dummy
|
||||||
|
class NSException {}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
// NOTE: This file is not intended to be included in the Xcode project. It
|
||||||
|
// is picked up by the Swift Package Manager during its build process.
|
||||||
|
|
||||||
|
/// A dummy reimplementation of the `NMBExceptionCapture` class to serve
|
||||||
|
/// as a stand-in for build and runtime environments that don't support
|
||||||
|
/// Objective C.
|
||||||
|
internal class ExceptionCapture {
|
||||||
|
let finally: (() -> Void)?
|
||||||
|
|
||||||
|
init(handler: ((NSException) -> Void)?, finally: (() -> Void)?) {
|
||||||
|
self.finally = finally
|
||||||
|
}
|
||||||
|
|
||||||
|
func tryBlock(_ unsafeBlock: (() -> Void)) {
|
||||||
|
// We have no way of handling Objective C exceptions in Swift,
|
||||||
|
// so we just go ahead and run the unsafeBlock as-is
|
||||||
|
unsafeBlock()
|
||||||
|
|
||||||
|
finally?()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compatibility with the actual Objective-C implementation
|
||||||
|
typealias NMBExceptionCapture = ExceptionCapture
|
116
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/DSL+Wait.swift
vendored
Normal file
116
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/DSL+Wait.swift
vendored
Normal file
|
@ -0,0 +1,116 @@
|
||||||
|
import Dispatch
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
private enum ErrorResult {
|
||||||
|
case exception(NSException)
|
||||||
|
case error(Error)
|
||||||
|
case none
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Only classes, protocols, methods, properties, and subscript declarations can be
|
||||||
|
/// bridges to Objective-C via the @objc keyword. This class encapsulates callback-style
|
||||||
|
/// asynchronous waiting logic so that it may be called from Objective-C and Swift.
|
||||||
|
internal class NMBWait: NSObject {
|
||||||
|
// About these kind of lines, `@objc` attributes are only required for Objective-C
|
||||||
|
// support, so that should be conditional on Darwin platforms and normal Xcode builds
|
||||||
|
// (non-SwiftPM builds).
|
||||||
|
#if (os(macOS) || os(iOS) || os(tvOS) || os(watchOS)) && !SWIFT_PACKAGE
|
||||||
|
@objc
|
||||||
|
internal class func until(
|
||||||
|
timeout: TimeInterval,
|
||||||
|
file: FileString = #file,
|
||||||
|
line: UInt = #line,
|
||||||
|
action: @escaping (@escaping () -> Void) -> Void) {
|
||||||
|
return throwableUntil(timeout: timeout, file: file, line: line) { done in
|
||||||
|
action(done)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
internal class func until(
|
||||||
|
timeout: TimeInterval,
|
||||||
|
file: FileString = #file,
|
||||||
|
line: UInt = #line,
|
||||||
|
action: @escaping (@escaping () -> Void) -> Void) {
|
||||||
|
return throwableUntil(timeout: timeout, file: file, line: line) { done in
|
||||||
|
action(done)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
// Using a throwable closure makes this method not objc compatible.
|
||||||
|
internal class func throwableUntil(
|
||||||
|
timeout: TimeInterval,
|
||||||
|
file: FileString = #file,
|
||||||
|
line: UInt = #line,
|
||||||
|
action: @escaping (@escaping () -> Void) throws -> Void) {
|
||||||
|
let awaiter = NimbleEnvironment.activeInstance.awaiter
|
||||||
|
let leeway = timeout / 2.0
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
let result = awaiter.performBlock(file: file, line: line) { (done: @escaping (ErrorResult) -> Void) throws -> Void in
|
||||||
|
DispatchQueue.main.async {
|
||||||
|
let capture = NMBExceptionCapture(
|
||||||
|
handler: ({ exception in
|
||||||
|
done(.exception(exception))
|
||||||
|
}),
|
||||||
|
finally: ({ })
|
||||||
|
)
|
||||||
|
capture.tryBlock {
|
||||||
|
do {
|
||||||
|
try action {
|
||||||
|
done(.none)
|
||||||
|
}
|
||||||
|
} catch let e {
|
||||||
|
done(.error(e))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}.timeout(timeout, forcefullyAbortTimeout: leeway).wait("waitUntil(...)", file: file, line: line)
|
||||||
|
|
||||||
|
switch result {
|
||||||
|
case .incomplete: internalError("Reached .incomplete state for waitUntil(...).")
|
||||||
|
case .blockedRunLoop:
|
||||||
|
fail(blockedRunLoopErrorMessageFor("-waitUntil()", leeway: leeway),
|
||||||
|
file: file, line: line)
|
||||||
|
case .timedOut:
|
||||||
|
let pluralize = (timeout == 1 ? "" : "s")
|
||||||
|
fail("Waited more than \(timeout) second\(pluralize)", file: file, line: line)
|
||||||
|
case let .raisedException(exception):
|
||||||
|
fail("Unexpected exception raised: \(exception)")
|
||||||
|
case let .errorThrown(error):
|
||||||
|
fail("Unexpected error thrown: \(error)")
|
||||||
|
case .completed(.exception(let exception)):
|
||||||
|
fail("Unexpected exception raised: \(exception)")
|
||||||
|
case .completed(.error(let error)):
|
||||||
|
fail("Unexpected error thrown: \(error)")
|
||||||
|
case .completed(.none): // success
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if (os(macOS) || os(iOS) || os(tvOS) || os(watchOS)) && !SWIFT_PACKAGE
|
||||||
|
@objc(untilFile:line:action:)
|
||||||
|
internal class func until(_ file: FileString = #file, line: UInt = #line, action: @escaping (() -> Void) -> Void) {
|
||||||
|
until(timeout: 1, file: file, line: line, action: action)
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
internal class func until(_ file: FileString = #file, line: UInt = #line, action: @escaping (() -> Void) -> Void) {
|
||||||
|
until(timeout: 1, file: file, line: line, action: action)
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func blockedRunLoopErrorMessageFor(_ fnName: String, leeway: TimeInterval) -> String {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
return "\(fnName) timed out but was unable to run the timeout handler because the main thread is unresponsive (\(leeway) seconds is allow after the wait times out). Conditions that may cause this include processing blocking IO on the main thread, calls to sleep(), deadlocks, and synchronous IPC. Nimble forcefully stopped run loop which may cause future failures in test run."
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Wait asynchronously until the done closure is called or the timeout has been reached.
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// Call the done() closure to indicate the waiting has completed.
|
||||||
|
///
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func waitUntil(timeout: TimeInterval = AsyncDefaults.Timeout, file: FileString = #file, line: UInt = #line, action: @escaping (@escaping () -> Void) -> Void) {
|
||||||
|
NMBWait.until(timeout: timeout, file: file, line: line, action: action)
|
||||||
|
}
|
64
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/DSL.swift
vendored
Normal file
64
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/DSL.swift
vendored
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// Make an expectation on a given actual value. The value given is lazily evaluated.
|
||||||
|
public func expect<T>(_ expression: @autoclosure @escaping () throws -> T?, file: FileString = #file, line: UInt = #line) -> Expectation<T> {
|
||||||
|
return Expectation(
|
||||||
|
expression: Expression(
|
||||||
|
expression: expression,
|
||||||
|
location: SourceLocation(file: file, line: line),
|
||||||
|
isClosure: true))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Make an expectation on a given actual value. The closure is lazily invoked.
|
||||||
|
public func expect<T>(_ file: FileString = #file, line: UInt = #line, expression: @escaping () throws -> T?) -> Expectation<T> {
|
||||||
|
return Expectation(
|
||||||
|
expression: Expression(
|
||||||
|
expression: expression,
|
||||||
|
location: SourceLocation(file: file, line: line),
|
||||||
|
isClosure: true))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Always fails the test with a message and a specified location.
|
||||||
|
public func fail(_ message: String, location: SourceLocation) {
|
||||||
|
let handler = NimbleEnvironment.activeInstance.assertionHandler
|
||||||
|
handler.assert(false, message: FailureMessage(stringValue: message), location: location)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Always fails the test with a message.
|
||||||
|
public func fail(_ message: String, file: FileString = #file, line: UInt = #line) {
|
||||||
|
fail(message, location: SourceLocation(file: file, line: line))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Always fails the test.
|
||||||
|
public func fail(_ file: FileString = #file, line: UInt = #line) {
|
||||||
|
fail("fail() always fails", file: file, line: line)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Like Swift's precondition(), but raises NSExceptions instead of sigaborts
|
||||||
|
internal func nimblePrecondition(
|
||||||
|
_ expr: @autoclosure() -> Bool,
|
||||||
|
_ name: @autoclosure() -> String,
|
||||||
|
_ message: @autoclosure() -> String,
|
||||||
|
file: StaticString = #file,
|
||||||
|
line: UInt = #line) {
|
||||||
|
let result = expr()
|
||||||
|
if !result {
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
let e = NSException(
|
||||||
|
name: NSExceptionName(name()),
|
||||||
|
reason: message(),
|
||||||
|
userInfo: nil)
|
||||||
|
e.raise()
|
||||||
|
#else
|
||||||
|
preconditionFailure("\(name()) - \(message())", file: file, line: line)
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func internalError(_ msg: String, file: FileString = #file, line: UInt = #line) -> Never {
|
||||||
|
fatalError(
|
||||||
|
"Nimble Bug Found: \(msg) at \(file):\(line).\n" +
|
||||||
|
"Please file a bug to Nimble: https://github.com/Quick/Nimble/issues with the " +
|
||||||
|
"code snippet that caused this error."
|
||||||
|
)
|
||||||
|
}
|
132
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Expectation.swift
vendored
Normal file
132
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Expectation.swift
vendored
Normal file
|
@ -0,0 +1,132 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
// Deprecated
|
||||||
|
internal func expressionMatches<T, U>(_ expression: Expression<T>, matcher: U, to: String, description: String?) -> (Bool, FailureMessage)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
let msg = FailureMessage()
|
||||||
|
msg.userDescription = description
|
||||||
|
msg.to = to
|
||||||
|
do {
|
||||||
|
let pass = try matcher.matches(expression, failureMessage: msg)
|
||||||
|
if msg.actualValue == "" {
|
||||||
|
msg.actualValue = "<\(stringify(try expression.evaluate()))>"
|
||||||
|
}
|
||||||
|
return (pass, msg)
|
||||||
|
} catch let error {
|
||||||
|
msg.stringValue = "unexpected error thrown: <\(error)>"
|
||||||
|
return (false, msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Deprecated
|
||||||
|
internal func expressionDoesNotMatch<T, U>(_ expression: Expression<T>, matcher: U, toNot: String, description: String?) -> (Bool, FailureMessage)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
let msg = FailureMessage()
|
||||||
|
msg.userDescription = description
|
||||||
|
msg.to = toNot
|
||||||
|
do {
|
||||||
|
let pass = try matcher.doesNotMatch(expression, failureMessage: msg)
|
||||||
|
if msg.actualValue == "" {
|
||||||
|
msg.actualValue = "<\(stringify(try expression.evaluate()))>"
|
||||||
|
}
|
||||||
|
return (pass, msg)
|
||||||
|
} catch let error {
|
||||||
|
msg.stringValue = "unexpected error thrown: <\(error)>"
|
||||||
|
return (false, msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func execute<T>(_ expression: Expression<T>, _ style: ExpectationStyle, _ predicate: Predicate<T>, to: String, description: String?, captureExceptions: Bool = true) -> (Bool, FailureMessage) {
|
||||||
|
func run() -> (Bool, FailureMessage) {
|
||||||
|
let msg = FailureMessage()
|
||||||
|
msg.userDescription = description
|
||||||
|
msg.to = to
|
||||||
|
do {
|
||||||
|
let result = try predicate.satisfies(expression)
|
||||||
|
result.message.update(failureMessage: msg)
|
||||||
|
if msg.actualValue == "" {
|
||||||
|
msg.actualValue = "<\(stringify(try expression.evaluate()))>"
|
||||||
|
}
|
||||||
|
return (result.toBoolean(expectation: style), msg)
|
||||||
|
} catch let error {
|
||||||
|
msg.stringValue = "unexpected error thrown: <\(error)>"
|
||||||
|
return (false, msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
var result: (Bool, FailureMessage) = (false, FailureMessage())
|
||||||
|
if captureExceptions {
|
||||||
|
let capture = NMBExceptionCapture(handler: ({ exception -> Void in
|
||||||
|
let msg = FailureMessage()
|
||||||
|
msg.stringValue = "unexpected exception raised: \(exception)"
|
||||||
|
result = (false, msg)
|
||||||
|
}), finally: nil)
|
||||||
|
capture.tryBlock {
|
||||||
|
result = run()
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
result = run()
|
||||||
|
}
|
||||||
|
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
|
||||||
|
public struct Expectation<T> {
|
||||||
|
|
||||||
|
public let expression: Expression<T>
|
||||||
|
|
||||||
|
public func verify(_ pass: Bool, _ message: FailureMessage) {
|
||||||
|
let handler = NimbleEnvironment.activeInstance.assertionHandler
|
||||||
|
handler.assert(pass, message: message, location: expression.location)
|
||||||
|
}
|
||||||
|
|
||||||
|
////////////////// OLD API /////////////////////
|
||||||
|
|
||||||
|
/// DEPRECATED: Tests the actual value using a matcher to match.
|
||||||
|
public func to<U>(_ matcher: U, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
let (pass, msg) = expressionMatches(expression, matcher: matcher, to: "to", description: description)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// DEPRECATED: Tests the actual value using a matcher to not match.
|
||||||
|
public func toNot<U>(_ matcher: U, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
let (pass, msg) = expressionDoesNotMatch(expression, matcher: matcher, toNot: "to not", description: description)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// DEPRECATED: Tests the actual value using a matcher to not match.
|
||||||
|
///
|
||||||
|
/// Alias to toNot().
|
||||||
|
public func notTo<U>(_ matcher: U, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
toNot(matcher, description: description)
|
||||||
|
}
|
||||||
|
|
||||||
|
////////////////// NEW API /////////////////////
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to match.
|
||||||
|
public func to(_ predicate: Predicate<T>, description: String? = nil) {
|
||||||
|
let (pass, msg) = execute(expression, .toMatch, predicate, to: "to", description: description)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match.
|
||||||
|
public func toNot(_ predicate: Predicate<T>, description: String? = nil) {
|
||||||
|
let (pass, msg) = execute(expression, .toNotMatch, predicate, to: "to not", description: description)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match.
|
||||||
|
///
|
||||||
|
/// Alias to toNot().
|
||||||
|
public func notTo(_ predicate: Predicate<T>, description: String? = nil) {
|
||||||
|
toNot(predicate, description: description)
|
||||||
|
}
|
||||||
|
|
||||||
|
// see:
|
||||||
|
// - AsyncMatcherWrapper for extension
|
||||||
|
// - NMBExpectation for Objective-C interface
|
||||||
|
}
|
262
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/ExpectationMessage.swift
vendored
Normal file
262
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/ExpectationMessage.swift
vendored
Normal file
|
@ -0,0 +1,262 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
public indirect enum ExpectationMessage {
|
||||||
|
// --- Primary Expectations ---
|
||||||
|
/// includes actual value in output ("expected to <message>, got <actual>")
|
||||||
|
case expectedActualValueTo(/* message: */ String)
|
||||||
|
/// uses a custom actual value string in output ("expected to <message>, got <actual>")
|
||||||
|
case expectedCustomValueTo(/* message: */ String, /* actual: */ String)
|
||||||
|
/// excludes actual value in output ("expected to <message>")
|
||||||
|
case expectedTo(/* message: */ String)
|
||||||
|
/// allows any free-form message ("<message>")
|
||||||
|
case fail(/* message: */ String)
|
||||||
|
|
||||||
|
// --- Composite Expectations ---
|
||||||
|
// Generally, you'll want the methods, appended(message:) and appended(details:) instead.
|
||||||
|
|
||||||
|
/// Not Fully Implemented Yet.
|
||||||
|
case prepends(/* Prepended Message */ String, ExpectationMessage)
|
||||||
|
|
||||||
|
/// appends after an existing message ("<expectation> (use beNil() to match nils)")
|
||||||
|
case appends(ExpectationMessage, /* Appended Message */ String)
|
||||||
|
|
||||||
|
/// provides long-form multi-line explainations ("<expectation>\n\n<string>")
|
||||||
|
case details(ExpectationMessage, String)
|
||||||
|
|
||||||
|
internal var sampleMessage: String {
|
||||||
|
let asStr = toString(actual: "<ACTUAL>", expected: "expected", to: "to")
|
||||||
|
let asFailureMessage = FailureMessage()
|
||||||
|
update(failureMessage: asFailureMessage)
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
return "(toString(actual:expected:to:) -> \(asStr) || update(failureMessage:) -> \(asFailureMessage.stringValue))"
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the smallest message after the "expected to" string that summarizes the error.
|
||||||
|
///
|
||||||
|
/// Returns the message part from ExpectationMessage, ignoring all .appends and .details.
|
||||||
|
public var expectedMessage: String {
|
||||||
|
switch self {
|
||||||
|
case let .fail(msg):
|
||||||
|
return msg
|
||||||
|
case let .expectedTo(msg):
|
||||||
|
return msg
|
||||||
|
case let .expectedActualValueTo(msg):
|
||||||
|
return msg
|
||||||
|
case let .expectedCustomValueTo(msg, _):
|
||||||
|
return msg
|
||||||
|
case let .prepends(_, expectation):
|
||||||
|
return expectation.expectedMessage
|
||||||
|
case let .appends(expectation, msg):
|
||||||
|
return "\(expectation.expectedMessage)\(msg)"
|
||||||
|
case let .details(expectation, _):
|
||||||
|
return expectation.expectedMessage
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Appends a message after the primary expectation message
|
||||||
|
public func appended(message: String) -> ExpectationMessage {
|
||||||
|
switch self {
|
||||||
|
case .fail, .expectedTo, .expectedActualValueTo, .expectedCustomValueTo, .appends, .prepends:
|
||||||
|
return .appends(self, message)
|
||||||
|
case let .details(expectation, msg):
|
||||||
|
return .details(expectation.appended(message: message), msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Appends a message hinting to use beNil() for when the actual value given was nil.
|
||||||
|
public func appendedBeNilHint() -> ExpectationMessage {
|
||||||
|
return appended(message: " (use beNil() to match nils)")
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Appends a detailed (aka - multiline) message after the primary expectation message
|
||||||
|
/// Detailed messages will be placed after .appended(message:) calls.
|
||||||
|
public func appended(details: String) -> ExpectationMessage {
|
||||||
|
return .details(self, details)
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func visitLeafs(_ f: (ExpectationMessage) -> ExpectationMessage) -> ExpectationMessage {
|
||||||
|
switch self {
|
||||||
|
case .fail, .expectedTo, .expectedActualValueTo, .expectedCustomValueTo:
|
||||||
|
return f(self)
|
||||||
|
case let .prepends(msg, expectation):
|
||||||
|
return .prepends(msg, expectation.visitLeafs(f))
|
||||||
|
case let .appends(expectation, msg):
|
||||||
|
return .appends(expectation.visitLeafs(f), msg)
|
||||||
|
case let .details(expectation, msg):
|
||||||
|
return .details(expectation.visitLeafs(f), msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Replaces a primary expectation with one returned by f. Preserves all composite expectations
|
||||||
|
/// that were built upon it (aka - all appended(message:) and appended(details:).
|
||||||
|
public func replacedExpectation(_ f: @escaping (ExpectationMessage) -> ExpectationMessage) -> ExpectationMessage {
|
||||||
|
func walk(_ msg: ExpectationMessage) -> ExpectationMessage {
|
||||||
|
switch msg {
|
||||||
|
case .fail, .expectedTo, .expectedActualValueTo, .expectedCustomValueTo:
|
||||||
|
return f(msg)
|
||||||
|
default:
|
||||||
|
return msg
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return visitLeafs(walk)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Wraps a primary expectation with text before and after it.
|
||||||
|
/// Alias to prepended(message: before).appended(message: after)
|
||||||
|
public func wrappedExpectation(before: String, after: String) -> ExpectationMessage {
|
||||||
|
return prepended(expectation: before).appended(message: after)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Prepends a message by modifying the primary expectation
|
||||||
|
public func prepended(expectation message: String) -> ExpectationMessage {
|
||||||
|
func walk(_ msg: ExpectationMessage) -> ExpectationMessage {
|
||||||
|
switch msg {
|
||||||
|
case let .expectedTo(msg):
|
||||||
|
return .expectedTo(message + msg)
|
||||||
|
case let .expectedActualValueTo(msg):
|
||||||
|
return .expectedActualValueTo(message + msg)
|
||||||
|
case let .expectedCustomValueTo(msg, actual):
|
||||||
|
return .expectedCustomValueTo(message + msg, actual)
|
||||||
|
default:
|
||||||
|
return msg.visitLeafs(walk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return visitLeafs(walk)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO: test & verify correct behavior
|
||||||
|
internal func prepended(message: String) -> ExpectationMessage {
|
||||||
|
return .prepends(message, self)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts the tree of ExpectationMessages into a final built string.
|
||||||
|
public func toString(actual: String, expected: String = "expected", to: String = "to") -> String {
|
||||||
|
switch self {
|
||||||
|
case let .fail(msg):
|
||||||
|
return msg
|
||||||
|
case let .expectedTo(msg):
|
||||||
|
return "\(expected) \(to) \(msg)"
|
||||||
|
case let .expectedActualValueTo(msg):
|
||||||
|
return "\(expected) \(to) \(msg), got \(actual)"
|
||||||
|
case let .expectedCustomValueTo(msg, actual):
|
||||||
|
return "\(expected) \(to) \(msg), got \(actual)"
|
||||||
|
case let .prepends(msg, expectation):
|
||||||
|
return "\(msg)\(expectation.toString(actual: actual, expected: expected, to: to))"
|
||||||
|
case let .appends(expectation, msg):
|
||||||
|
return "\(expectation.toString(actual: actual, expected: expected, to: to))\(msg)"
|
||||||
|
case let .details(expectation, msg):
|
||||||
|
return "\(expectation.toString(actual: actual, expected: expected, to: to))\n\n\(msg)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Backwards compatibility: converts ExpectationMessage tree to FailureMessage
|
||||||
|
internal func update(failureMessage: FailureMessage) {
|
||||||
|
switch self {
|
||||||
|
case let .fail(msg):
|
||||||
|
failureMessage.stringValue = msg
|
||||||
|
case let .expectedTo(msg):
|
||||||
|
failureMessage.actualValue = nil
|
||||||
|
failureMessage.postfixMessage = msg
|
||||||
|
case let .expectedActualValueTo(msg):
|
||||||
|
failureMessage.postfixMessage = msg
|
||||||
|
case let .expectedCustomValueTo(msg, actual):
|
||||||
|
failureMessage.postfixMessage = msg
|
||||||
|
failureMessage.actualValue = actual
|
||||||
|
case let .prepends(msg, expectation):
|
||||||
|
expectation.update(failureMessage: failureMessage)
|
||||||
|
if let desc = failureMessage.userDescription {
|
||||||
|
failureMessage.userDescription = "\(msg)\(desc)"
|
||||||
|
} else {
|
||||||
|
failureMessage.userDescription = msg
|
||||||
|
}
|
||||||
|
case let .appends(expectation, msg):
|
||||||
|
expectation.update(failureMessage: failureMessage)
|
||||||
|
failureMessage.appendMessage(msg)
|
||||||
|
case let .details(expectation, msg):
|
||||||
|
expectation.update(failureMessage: failureMessage)
|
||||||
|
failureMessage.appendDetails(msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension FailureMessage {
|
||||||
|
internal func toExpectationMessage() -> ExpectationMessage {
|
||||||
|
let defaultMsg = FailureMessage()
|
||||||
|
if expected != defaultMsg.expected || _stringValueOverride != nil {
|
||||||
|
return .fail(stringValue)
|
||||||
|
}
|
||||||
|
|
||||||
|
var msg: ExpectationMessage = .fail(userDescription ?? "")
|
||||||
|
if actualValue != "" && actualValue != nil {
|
||||||
|
msg = .expectedCustomValueTo(postfixMessage, actualValue ?? "")
|
||||||
|
} else if postfixMessage != defaultMsg.postfixMessage {
|
||||||
|
if actualValue == nil {
|
||||||
|
msg = .expectedTo(postfixMessage)
|
||||||
|
} else {
|
||||||
|
msg = .expectedActualValueTo(postfixMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if postfixActual != defaultMsg.postfixActual {
|
||||||
|
msg = .appends(msg, postfixActual)
|
||||||
|
}
|
||||||
|
if let m = extendedMessage {
|
||||||
|
msg = .details(msg, m)
|
||||||
|
}
|
||||||
|
return msg
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
|
||||||
|
public class NMBExpectationMessage: NSObject {
|
||||||
|
private let msg: ExpectationMessage
|
||||||
|
|
||||||
|
internal init(swift msg: ExpectationMessage) {
|
||||||
|
self.msg = msg
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(expectedTo message: String) {
|
||||||
|
self.msg = .expectedTo(message)
|
||||||
|
}
|
||||||
|
public init(expectedActualValueTo message: String) {
|
||||||
|
self.msg = .expectedActualValueTo(message)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(expectedActualValueTo message: String, customActualValue actual: String) {
|
||||||
|
self.msg = .expectedCustomValueTo(message, actual)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(fail message: String) {
|
||||||
|
self.msg = .fail(message)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(prepend message: String, child: NMBExpectationMessage) {
|
||||||
|
self.msg = .prepends(message, child.msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(appendedMessage message: String, child: NMBExpectationMessage) {
|
||||||
|
self.msg = .appends(child.msg, message)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(prependedMessage message: String, child: NMBExpectationMessage) {
|
||||||
|
self.msg = .prepends(message, child.msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(details message: String, child: NMBExpectationMessage) {
|
||||||
|
self.msg = .details(child.msg, message)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func appendedBeNilHint() -> NMBExpectationMessage {
|
||||||
|
return NMBExpectationMessage(swift: msg.appendedBeNilHint())
|
||||||
|
}
|
||||||
|
|
||||||
|
public func toSwift() -> ExpectationMessage { return self.msg }
|
||||||
|
}
|
||||||
|
|
||||||
|
extension ExpectationMessage {
|
||||||
|
func toObjectiveC() -> NMBExpectationMessage {
|
||||||
|
return NMBExpectationMessage(swift: self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
99
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Expression.swift
vendored
Normal file
99
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Expression.swift
vendored
Normal file
|
@ -0,0 +1,99 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
// Memoizes the given closure, only calling the passed
|
||||||
|
// closure once; even if repeat calls to the returned closure
|
||||||
|
internal func memoizedClosure<T>(_ closure: @escaping () throws -> T) -> (Bool) throws -> T {
|
||||||
|
var cache: T?
|
||||||
|
return ({ withoutCaching in
|
||||||
|
if withoutCaching || cache == nil {
|
||||||
|
cache = try closure()
|
||||||
|
}
|
||||||
|
return cache!
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Expression represents the closure of the value inside expect(...).
|
||||||
|
/// Expressions are memoized by default. This makes them safe to call
|
||||||
|
/// evaluate() multiple times without causing a re-evaluation of the underlying
|
||||||
|
/// closure.
|
||||||
|
///
|
||||||
|
/// @warning Since the closure can be any code, Objective-C code may choose
|
||||||
|
/// to raise an exception. Currently, Expression does not memoize
|
||||||
|
/// exception raising.
|
||||||
|
///
|
||||||
|
/// This provides a common consumable API for matchers to utilize to allow
|
||||||
|
/// Nimble to change internals to how the captured closure is managed.
|
||||||
|
public struct Expression<T> {
|
||||||
|
internal let _expression: (Bool) throws -> T?
|
||||||
|
internal let _withoutCaching: Bool
|
||||||
|
public let location: SourceLocation
|
||||||
|
public let isClosure: Bool
|
||||||
|
|
||||||
|
/// Creates a new expression struct. Normally, expect(...) will manage this
|
||||||
|
/// creation process. The expression is memoized.
|
||||||
|
///
|
||||||
|
/// @param expression The closure that produces a given value.
|
||||||
|
/// @param location The source location that this closure originates from.
|
||||||
|
/// @param isClosure A bool indicating if the captured expression is a
|
||||||
|
/// closure or internally produced closure. Some matchers
|
||||||
|
/// may require closures. For example, toEventually()
|
||||||
|
/// requires an explicit closure. This gives Nimble
|
||||||
|
/// flexibility if @autoclosure behavior changes between
|
||||||
|
/// Swift versions. Nimble internals always sets this true.
|
||||||
|
public init(expression: @escaping () throws -> T?, location: SourceLocation, isClosure: Bool = true) {
|
||||||
|
self._expression = memoizedClosure(expression)
|
||||||
|
self.location = location
|
||||||
|
self._withoutCaching = false
|
||||||
|
self.isClosure = isClosure
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates a new expression struct. Normally, expect(...) will manage this
|
||||||
|
/// creation process.
|
||||||
|
///
|
||||||
|
/// @param expression The closure that produces a given value.
|
||||||
|
/// @param location The source location that this closure originates from.
|
||||||
|
/// @param withoutCaching Indicates if the struct should memoize the given
|
||||||
|
/// closure's result. Subsequent evaluate() calls will
|
||||||
|
/// not call the given closure if this is true.
|
||||||
|
/// @param isClosure A bool indicating if the captured expression is a
|
||||||
|
/// closure or internally produced closure. Some matchers
|
||||||
|
/// may require closures. For example, toEventually()
|
||||||
|
/// requires an explicit closure. This gives Nimble
|
||||||
|
/// flexibility if @autoclosure behavior changes between
|
||||||
|
/// Swift versions. Nimble internals always sets this true.
|
||||||
|
public init(memoizedExpression: @escaping (Bool) throws -> T?, location: SourceLocation, withoutCaching: Bool, isClosure: Bool = true) {
|
||||||
|
self._expression = memoizedExpression
|
||||||
|
self.location = location
|
||||||
|
self._withoutCaching = withoutCaching
|
||||||
|
self.isClosure = isClosure
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a new Expression from the given expression. Identical to a map()
|
||||||
|
/// on this type. This should be used only to typecast the Expression's
|
||||||
|
/// closure value.
|
||||||
|
///
|
||||||
|
/// The returned expression will preserve location and isClosure.
|
||||||
|
///
|
||||||
|
/// @param block The block that can cast the current Expression value to a
|
||||||
|
/// new type.
|
||||||
|
public func cast<U>(_ block: @escaping (T?) throws -> U?) -> Expression<U> {
|
||||||
|
return Expression<U>(
|
||||||
|
expression: ({ try block(self.evaluate()) }),
|
||||||
|
location: self.location,
|
||||||
|
isClosure: self.isClosure
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func evaluate() throws -> T? {
|
||||||
|
return try self._expression(_withoutCaching)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func withoutCaching() -> Expression<T> {
|
||||||
|
return Expression(
|
||||||
|
memoizedExpression: self._expression,
|
||||||
|
location: location,
|
||||||
|
withoutCaching: true,
|
||||||
|
isClosure: isClosure
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
92
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/FailureMessage.swift
vendored
Normal file
92
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/FailureMessage.swift
vendored
Normal file
|
@ -0,0 +1,92 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// Encapsulates the failure message that matchers can report to the end user.
|
||||||
|
///
|
||||||
|
/// This is shared state between Nimble and matchers that mutate this value.
|
||||||
|
public class FailureMessage: NSObject {
|
||||||
|
public var expected: String = "expected"
|
||||||
|
public var actualValue: String? = "" // empty string -> use default; nil -> exclude
|
||||||
|
public var to: String = "to"
|
||||||
|
public var postfixMessage: String = "match"
|
||||||
|
public var postfixActual: String = ""
|
||||||
|
/// An optional message that will be appended as a new line and provides additional details
|
||||||
|
/// about the failure. This message will only be visible in the issue navigator / in logs but
|
||||||
|
/// not directly in the source editor since only a single line is presented there.
|
||||||
|
public var extendedMessage: String?
|
||||||
|
public var userDescription: String?
|
||||||
|
|
||||||
|
public var stringValue: String {
|
||||||
|
get {
|
||||||
|
if let value = _stringValueOverride {
|
||||||
|
return value
|
||||||
|
} else {
|
||||||
|
return computeStringValue()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
set {
|
||||||
|
_stringValueOverride = newValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal var _stringValueOverride: String?
|
||||||
|
internal var hasOverriddenStringValue: Bool {
|
||||||
|
return _stringValueOverride != nil
|
||||||
|
}
|
||||||
|
|
||||||
|
public override init() {
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(stringValue: String) {
|
||||||
|
_stringValueOverride = stringValue
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func stripNewlines(_ str: String) -> String {
|
||||||
|
let whitespaces = CharacterSet.whitespacesAndNewlines
|
||||||
|
return str
|
||||||
|
.components(separatedBy: "\n")
|
||||||
|
.map { line in line.trimmingCharacters(in: whitespaces) }
|
||||||
|
.joined(separator: "")
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func computeStringValue() -> String {
|
||||||
|
var value = "\(expected) \(to) \(postfixMessage)"
|
||||||
|
if let actualValue = actualValue {
|
||||||
|
value = "\(expected) \(to) \(postfixMessage), got \(actualValue)\(postfixActual)"
|
||||||
|
}
|
||||||
|
value = stripNewlines(value)
|
||||||
|
|
||||||
|
if let extendedMessage = extendedMessage {
|
||||||
|
value += "\n\(stripNewlines(extendedMessage))"
|
||||||
|
}
|
||||||
|
|
||||||
|
if let userDescription = userDescription {
|
||||||
|
return "\(userDescription)\n\(value)"
|
||||||
|
}
|
||||||
|
|
||||||
|
return value
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func appendMessage(_ msg: String) {
|
||||||
|
if hasOverriddenStringValue {
|
||||||
|
stringValue += "\(msg)"
|
||||||
|
} else if actualValue != nil {
|
||||||
|
postfixActual += msg
|
||||||
|
} else {
|
||||||
|
postfixMessage += msg
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func appendDetails(_ msg: String) {
|
||||||
|
if hasOverriddenStringValue {
|
||||||
|
if let desc = userDescription {
|
||||||
|
stringValue = "\(desc)\n\(stringValue)"
|
||||||
|
}
|
||||||
|
stringValue += "\n\(msg)"
|
||||||
|
} else {
|
||||||
|
if let desc = userDescription {
|
||||||
|
userDescription = desc
|
||||||
|
}
|
||||||
|
extendedMessage = msg
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
28
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Info.plist
vendored
Normal file
28
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Info.plist
vendored
Normal file
|
@ -0,0 +1,28 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||||
|
<plist version="1.0">
|
||||||
|
<dict>
|
||||||
|
<key>CFBundleDevelopmentRegion</key>
|
||||||
|
<string>en</string>
|
||||||
|
<key>CFBundleExecutable</key>
|
||||||
|
<string>${EXECUTABLE_NAME}</string>
|
||||||
|
<key>CFBundleIdentifier</key>
|
||||||
|
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
|
||||||
|
<key>CFBundleInfoDictionaryVersion</key>
|
||||||
|
<string>6.0</string>
|
||||||
|
<key>CFBundleName</key>
|
||||||
|
<string>${PRODUCT_NAME}</string>
|
||||||
|
<key>CFBundlePackageType</key>
|
||||||
|
<string>FMWK</string>
|
||||||
|
<key>CFBundleShortVersionString</key>
|
||||||
|
<string>1.0</string>
|
||||||
|
<key>CFBundleSignature</key>
|
||||||
|
<string>????</string>
|
||||||
|
<key>CFBundleVersion</key>
|
||||||
|
<string>${CURRENT_PROJECT_VERSION}</string>
|
||||||
|
<key>NSHumanReadableCopyright</key>
|
||||||
|
<string>Copyright © 2014 Jeff Hui. All rights reserved.</string>
|
||||||
|
<key>NSPrincipalClass</key>
|
||||||
|
<string></string>
|
||||||
|
</dict>
|
||||||
|
</plist>
|
121
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/AllPass.swift
vendored
Normal file
121
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/AllPass.swift
vendored
Normal file
|
@ -0,0 +1,121 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
public func allPass<T, U>
|
||||||
|
(_ passFunc: @escaping (T?) throws -> Bool) -> Predicate<U>
|
||||||
|
where U: Sequence, T == U.Iterator.Element {
|
||||||
|
let matcher = Predicate.simpleNilable("pass a condition") { actualExpression in
|
||||||
|
return PredicateStatus(bool: try passFunc(try actualExpression.evaluate()))
|
||||||
|
}
|
||||||
|
return createPredicate(matcher)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func allPass<T, U>
|
||||||
|
(_ passName: String, _ passFunc: @escaping (T?) throws -> Bool) -> Predicate<U>
|
||||||
|
where U: Sequence, T == U.Iterator.Element {
|
||||||
|
let matcher = Predicate.simpleNilable(passName) { actualExpression in
|
||||||
|
return PredicateStatus(bool: try passFunc(try actualExpression.evaluate()))
|
||||||
|
}
|
||||||
|
return createPredicate(matcher)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func allPass<S, M>(_ elementMatcher: M) -> Predicate<S>
|
||||||
|
where S: Sequence, M: Matcher, S.Iterator.Element == M.ValueType {
|
||||||
|
return createPredicate(elementMatcher.predicate)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func allPass<S>(_ elementPredicate: Predicate<S.Iterator.Element>) -> Predicate<S>
|
||||||
|
where S: Sequence {
|
||||||
|
return createPredicate(elementPredicate)
|
||||||
|
}
|
||||||
|
|
||||||
|
private func createPredicate<S>(_ elementMatcher: Predicate<S.Iterator.Element>) -> Predicate<S>
|
||||||
|
where S: Sequence {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
guard let actualValue = try actualExpression.evaluate() else {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: .appends(.expectedTo("all pass"), " (use beNil() to match nils)")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
var failure: ExpectationMessage = .expectedTo("all pass")
|
||||||
|
for currentElement in actualValue {
|
||||||
|
let exp = Expression(
|
||||||
|
expression: {currentElement}, location: actualExpression.location)
|
||||||
|
let predicateResult = try elementMatcher.satisfies(exp)
|
||||||
|
if predicateResult.status == .matches {
|
||||||
|
failure = predicateResult.message.prepended(expectation: "all ")
|
||||||
|
} else {
|
||||||
|
failure = predicateResult.message
|
||||||
|
.replacedExpectation({ .expectedTo($0.expectedMessage) })
|
||||||
|
.wrappedExpectation(
|
||||||
|
before: "all ",
|
||||||
|
after: ", but failed first at element <\(stringify(currentElement))>"
|
||||||
|
+ " in <\(stringify(actualValue))>"
|
||||||
|
)
|
||||||
|
return PredicateResult(status: .doesNotMatch, message: failure)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
failure = failure.replacedExpectation({ expectation in
|
||||||
|
return .expectedTo(expectation.expectedMessage)
|
||||||
|
})
|
||||||
|
return PredicateResult(status: .matches, message: failure)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func allPassMatcher(_ matcher: NMBMatcher) -> NMBPredicate {
|
||||||
|
return NMBPredicate { actualExpression in
|
||||||
|
let location = actualExpression.location
|
||||||
|
let actualValue = try! actualExpression.evaluate()
|
||||||
|
var nsObjects = [NSObject]()
|
||||||
|
|
||||||
|
var collectionIsUsable = true
|
||||||
|
if let value = actualValue as? NSFastEnumeration {
|
||||||
|
var generator = NSFastEnumerationIterator(value)
|
||||||
|
while let obj = generator.next() {
|
||||||
|
if let nsObject = obj as? NSObject {
|
||||||
|
nsObjects.append(nsObject)
|
||||||
|
} else {
|
||||||
|
collectionIsUsable = false
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
collectionIsUsable = false
|
||||||
|
}
|
||||||
|
|
||||||
|
if !collectionIsUsable {
|
||||||
|
return NMBPredicateResult(
|
||||||
|
status: NMBPredicateStatus.fail,
|
||||||
|
message: NMBExpectationMessage(
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
fail: "allPass can only be used with types which implement NSFastEnumeration (NSArray, NSSet, ...), and whose elements subclass NSObject, got <\(actualValue?.description ?? "nil")>"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
let expr = Expression(expression: ({ nsObjects }), location: location)
|
||||||
|
let pred: Predicate<[NSObject]> = createPredicate(Predicate { expr in
|
||||||
|
if let predicate = matcher as? NMBPredicate {
|
||||||
|
return predicate.satisfies(({ try! expr.evaluate() }), location: expr.location).toSwift()
|
||||||
|
} else {
|
||||||
|
let failureMessage = FailureMessage()
|
||||||
|
let result = matcher.matches(
|
||||||
|
({ try! expr.evaluate() }),
|
||||||
|
failureMessage: failureMessage,
|
||||||
|
location: expr.location
|
||||||
|
)
|
||||||
|
let expectationMsg = failureMessage.toExpectationMessage()
|
||||||
|
return PredicateResult(
|
||||||
|
bool: result,
|
||||||
|
message: expectationMsg
|
||||||
|
)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
return try! pred.satisfies(expr).toObjectiveC()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,236 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// If you are running on a slower machine, it could be useful to increase the default timeout value
|
||||||
|
/// or slow down poll interval. Default timeout interval is 1, and poll interval is 0.01.
|
||||||
|
public struct AsyncDefaults {
|
||||||
|
public static var Timeout: TimeInterval = 1
|
||||||
|
public static var PollInterval: TimeInterval = 0.01
|
||||||
|
}
|
||||||
|
|
||||||
|
private func async<T>(style: ExpectationStyle, predicate: Predicate<T>, timeout: TimeInterval, poll: TimeInterval, fnName: String) -> Predicate<T> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
let uncachedExpression = actualExpression.withoutCaching()
|
||||||
|
let fnName = "expect(...).\(fnName)(...)"
|
||||||
|
var lastPredicateResult: PredicateResult?
|
||||||
|
let result = pollBlock(
|
||||||
|
pollInterval: poll,
|
||||||
|
timeoutInterval: timeout,
|
||||||
|
file: actualExpression.location.file,
|
||||||
|
line: actualExpression.location.line,
|
||||||
|
fnName: fnName) {
|
||||||
|
lastPredicateResult = try predicate.satisfies(uncachedExpression)
|
||||||
|
return lastPredicateResult!.toBoolean(expectation: style)
|
||||||
|
}
|
||||||
|
switch result {
|
||||||
|
case .completed: return lastPredicateResult!
|
||||||
|
case .timedOut: return PredicateResult(status: .fail, message: lastPredicateResult!.message)
|
||||||
|
case let .errorThrown(error):
|
||||||
|
return PredicateResult(status: .fail, message: .fail("unexpected error thrown: <\(error)>"))
|
||||||
|
case let .raisedException(exception):
|
||||||
|
return PredicateResult(status: .fail, message: .fail("unexpected exception raised: \(exception)"))
|
||||||
|
case .blockedRunLoop:
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
return PredicateResult(status: .fail, message: lastPredicateResult!.message.appended(message: " (timed out, but main thread was unresponsive)."))
|
||||||
|
case .incomplete:
|
||||||
|
internalError("Reached .incomplete state for toEventually(...).")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Deprecated
|
||||||
|
internal struct AsyncMatcherWrapper<T, U>: Matcher
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
let fullMatcher: U
|
||||||
|
let timeoutInterval: TimeInterval
|
||||||
|
let pollInterval: TimeInterval
|
||||||
|
|
||||||
|
init(fullMatcher: U, timeoutInterval: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval) {
|
||||||
|
self.fullMatcher = fullMatcher
|
||||||
|
self.timeoutInterval = timeoutInterval
|
||||||
|
self.pollInterval = pollInterval
|
||||||
|
}
|
||||||
|
|
||||||
|
func matches(_ actualExpression: Expression<T>, failureMessage: FailureMessage) -> Bool {
|
||||||
|
let uncachedExpression = actualExpression.withoutCaching()
|
||||||
|
let fnName = "expect(...).toEventually(...)"
|
||||||
|
let result = pollBlock(
|
||||||
|
pollInterval: pollInterval,
|
||||||
|
timeoutInterval: timeoutInterval,
|
||||||
|
file: actualExpression.location.file,
|
||||||
|
line: actualExpression.location.line,
|
||||||
|
fnName: fnName) {
|
||||||
|
try self.fullMatcher.matches(uncachedExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
switch result {
|
||||||
|
case let .completed(isSuccessful): return isSuccessful
|
||||||
|
case .timedOut: return false
|
||||||
|
case let .errorThrown(error):
|
||||||
|
failureMessage.stringValue = "an unexpected error thrown: <\(error)>"
|
||||||
|
return false
|
||||||
|
case let .raisedException(exception):
|
||||||
|
failureMessage.stringValue = "an unexpected exception thrown: <\(exception)>"
|
||||||
|
return false
|
||||||
|
case .blockedRunLoop:
|
||||||
|
failureMessage.postfixMessage += " (timed out, but main thread was unresponsive)."
|
||||||
|
return false
|
||||||
|
case .incomplete:
|
||||||
|
internalError("Reached .incomplete state for toEventually(...).")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func doesNotMatch(_ actualExpression: Expression<T>, failureMessage: FailureMessage) -> Bool {
|
||||||
|
let uncachedExpression = actualExpression.withoutCaching()
|
||||||
|
let result = pollBlock(
|
||||||
|
pollInterval: pollInterval,
|
||||||
|
timeoutInterval: timeoutInterval,
|
||||||
|
file: actualExpression.location.file,
|
||||||
|
line: actualExpression.location.line,
|
||||||
|
fnName: "expect(...).toEventuallyNot(...)") {
|
||||||
|
try self.fullMatcher.doesNotMatch(uncachedExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
switch result {
|
||||||
|
case let .completed(isSuccessful): return isSuccessful
|
||||||
|
case .timedOut: return false
|
||||||
|
case let .errorThrown(error):
|
||||||
|
failureMessage.stringValue = "an unexpected error thrown: <\(error)>"
|
||||||
|
return false
|
||||||
|
case let .raisedException(exception):
|
||||||
|
failureMessage.stringValue = "an unexpected exception thrown: <\(exception)>"
|
||||||
|
return false
|
||||||
|
case .blockedRunLoop:
|
||||||
|
failureMessage.postfixMessage += " (timed out, but main thread was unresponsive)."
|
||||||
|
return false
|
||||||
|
case .incomplete:
|
||||||
|
internalError("Reached .incomplete state for toEventuallyNot(...).")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private let toEventuallyRequiresClosureError = FailureMessage(
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
stringValue: "expect(...).toEventually(...) requires an explicit closure (eg - expect { ... }.toEventually(...) )\nSwift 1.2 @autoclosure behavior has changed in an incompatible way for Nimble to function"
|
||||||
|
)
|
||||||
|
|
||||||
|
extension Expectation {
|
||||||
|
/// Tests the actual value using a matcher to match by checking continuously
|
||||||
|
/// at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toEventually(_ predicate: Predicate<T>, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil) {
|
||||||
|
nimblePrecondition(expression.isClosure, "NimbleInternalError", toEventuallyRequiresClosureError.stringValue)
|
||||||
|
|
||||||
|
let (pass, msg) = execute(
|
||||||
|
expression,
|
||||||
|
.toMatch,
|
||||||
|
async(style: .toMatch, predicate: predicate, timeout: timeout, poll: pollInterval, fnName: "toEventually"),
|
||||||
|
to: "to eventually",
|
||||||
|
description: description,
|
||||||
|
captureExceptions: false
|
||||||
|
)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match by checking
|
||||||
|
/// continuously at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toEventuallyNot(_ predicate: Predicate<T>, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil) {
|
||||||
|
nimblePrecondition(expression.isClosure, "NimbleInternalError", toEventuallyRequiresClosureError.stringValue)
|
||||||
|
|
||||||
|
let (pass, msg) = execute(
|
||||||
|
expression,
|
||||||
|
.toNotMatch,
|
||||||
|
async(
|
||||||
|
style: .toNotMatch,
|
||||||
|
predicate: predicate,
|
||||||
|
timeout: timeout,
|
||||||
|
poll: pollInterval,
|
||||||
|
fnName: "toEventuallyNot"
|
||||||
|
),
|
||||||
|
to: "to eventually not",
|
||||||
|
description: description,
|
||||||
|
captureExceptions: false
|
||||||
|
)
|
||||||
|
verify(pass, msg)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match by checking
|
||||||
|
/// continuously at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// Alias of toEventuallyNot()
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toNotEventually(_ predicate: Predicate<T>, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil) {
|
||||||
|
return toEventuallyNot(predicate, timeout: timeout, pollInterval: pollInterval, description: description)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Deprecated
|
||||||
|
extension Expectation {
|
||||||
|
/// Tests the actual value using a matcher to match by checking continuously
|
||||||
|
/// at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toEventually<U>(_ matcher: U, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
if expression.isClosure {
|
||||||
|
let (pass, msg) = expressionMatches(
|
||||||
|
expression,
|
||||||
|
matcher: AsyncMatcherWrapper(
|
||||||
|
fullMatcher: matcher,
|
||||||
|
timeoutInterval: timeout,
|
||||||
|
pollInterval: pollInterval),
|
||||||
|
to: "to eventually",
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
verify(pass, msg)
|
||||||
|
} else {
|
||||||
|
verify(false, toEventuallyRequiresClosureError)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match by checking
|
||||||
|
/// continuously at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toEventuallyNot<U>(_ matcher: U, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
if expression.isClosure {
|
||||||
|
let (pass, msg) = expressionDoesNotMatch(
|
||||||
|
expression,
|
||||||
|
matcher: AsyncMatcherWrapper(
|
||||||
|
fullMatcher: matcher,
|
||||||
|
timeoutInterval: timeout,
|
||||||
|
pollInterval: pollInterval),
|
||||||
|
toNot: "to eventually not",
|
||||||
|
description: description
|
||||||
|
)
|
||||||
|
verify(pass, msg)
|
||||||
|
} else {
|
||||||
|
verify(false, toEventuallyRequiresClosureError)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Tests the actual value using a matcher to not match by checking
|
||||||
|
/// continuously at each pollInterval until the timeout is reached.
|
||||||
|
///
|
||||||
|
/// Alias of toEventuallyNot()
|
||||||
|
///
|
||||||
|
/// @discussion
|
||||||
|
/// This function manages the main run loop (`NSRunLoop.mainRunLoop()`) while this function
|
||||||
|
/// is executing. Any attempts to touch the run loop may cause non-deterministic behavior.
|
||||||
|
public func toNotEventually<U>(_ matcher: U, timeout: TimeInterval = AsyncDefaults.Timeout, pollInterval: TimeInterval = AsyncDefaults.PollInterval, description: String? = nil)
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
return toEventuallyNot(matcher, timeout: timeout, pollInterval: pollInterval, description: description)
|
||||||
|
}
|
||||||
|
}
|
68
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeAKindOf.swift
vendored
Normal file
68
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeAKindOf.swift
vendored
Normal file
|
@ -0,0 +1,68 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
private func matcherMessage<T>(forType expectedType: T.Type) -> String {
|
||||||
|
return "be a kind of \(String(describing: expectedType))"
|
||||||
|
}
|
||||||
|
private func matcherMessage(forClass expectedClass: AnyClass) -> String {
|
||||||
|
return "be a kind of \(String(describing: expectedClass))"
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is an instance of the given class.
|
||||||
|
public func beAKindOf<T>(_ expectedType: T.Type) -> Predicate<Any> {
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
let message: ExpectationMessage
|
||||||
|
|
||||||
|
let instance = try actualExpression.evaluate()
|
||||||
|
guard let validInstance = instance else {
|
||||||
|
message = .expectedCustomValueTo(matcherMessage(forType: expectedType), "<nil>")
|
||||||
|
return PredicateResult(status: .fail, message: message)
|
||||||
|
}
|
||||||
|
message = .expectedCustomValueTo(
|
||||||
|
"be a kind of \(String(describing: expectedType))",
|
||||||
|
"<\(String(describing: type(of: validInstance))) instance>"
|
||||||
|
)
|
||||||
|
|
||||||
|
return PredicateResult(
|
||||||
|
bool: validInstance is T,
|
||||||
|
message: message
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is an instance of the given class.
|
||||||
|
/// @see beAnInstanceOf if you want to match against the exact class
|
||||||
|
public func beAKindOf(_ expectedClass: AnyClass) -> Predicate<NSObject> {
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
let message: ExpectationMessage
|
||||||
|
let status: PredicateStatus
|
||||||
|
|
||||||
|
let instance = try actualExpression.evaluate()
|
||||||
|
if let validInstance = instance {
|
||||||
|
status = PredicateStatus(bool: instance != nil && instance!.isKind(of: expectedClass))
|
||||||
|
message = .expectedCustomValueTo(
|
||||||
|
matcherMessage(forClass: expectedClass),
|
||||||
|
"<\(String(describing: type(of: validInstance))) instance>"
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
status = .fail
|
||||||
|
message = .expectedCustomValueTo(
|
||||||
|
matcherMessage(forClass: expectedClass),
|
||||||
|
"<nil>"
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateResult(status: status, message: message)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beAKindOfMatcher(_ expected: AnyClass) -> NMBMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
return try! beAKindOf(expected).matches(actualExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,56 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is an _exact_ instance of the given class.
|
||||||
|
public func beAnInstanceOf<T>(_ expectedType: T.Type) -> Predicate<Any> {
|
||||||
|
let errorMessage = "be an instance of \(String(describing: expectedType))"
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
let instance = try actualExpression.evaluate()
|
||||||
|
guard let validInstance = instance else {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .doesNotMatch,
|
||||||
|
message: .expectedActualValueTo(errorMessage)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
let actualString = "<\(String(describing: type(of: validInstance))) instance>"
|
||||||
|
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: type(of: validInstance) == expectedType),
|
||||||
|
message: .expectedCustomValueTo(errorMessage, actualString)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is an instance of the given class.
|
||||||
|
/// @see beAKindOf if you want to match against subclasses
|
||||||
|
public func beAnInstanceOf(_ expectedClass: AnyClass) -> Predicate<NSObject> {
|
||||||
|
let errorMessage = "be an instance of \(String(describing: expectedClass))"
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
let instance = try actualExpression.evaluate()
|
||||||
|
let actualString: String
|
||||||
|
if let validInstance = instance {
|
||||||
|
actualString = "<\(String(describing: type(of: validInstance))) instance>"
|
||||||
|
} else {
|
||||||
|
actualString = "<nil>"
|
||||||
|
}
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
let matches = instance != nil && instance!.isMember(of: expectedClass)
|
||||||
|
#else
|
||||||
|
let matches = instance != nil && type(of: instance!) == expectedClass
|
||||||
|
#endif
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: matches),
|
||||||
|
message: .expectedCustomValueTo(errorMessage, actualString)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beAnInstanceOfMatcher(_ expected: AnyClass) -> NMBMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
return try! beAnInstanceOf(expected).matches(actualExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
126
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeCloseTo.swift
vendored
Normal file
126
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeCloseTo.swift
vendored
Normal file
|
@ -0,0 +1,126 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
public let DefaultDelta = 0.0001
|
||||||
|
|
||||||
|
internal func isCloseTo(_ actualValue: NMBDoubleConvertible?,
|
||||||
|
expectedValue: NMBDoubleConvertible,
|
||||||
|
delta: Double)
|
||||||
|
-> PredicateResult {
|
||||||
|
let errorMessage = "be close to <\(stringify(expectedValue))> (within \(stringify(delta)))"
|
||||||
|
return PredicateResult(
|
||||||
|
bool: actualValue != nil &&
|
||||||
|
abs(actualValue!.doubleValue - expectedValue.doubleValue) < delta,
|
||||||
|
message: .expectedCustomValueTo(errorMessage, "<\(stringify(actualValue))>")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is close to another. This is used for floating
|
||||||
|
/// point values which can have imprecise results when doing arithmetic on them.
|
||||||
|
///
|
||||||
|
/// @see equal
|
||||||
|
public func beCloseTo(_ expectedValue: Double, within delta: Double = DefaultDelta) -> Predicate<Double> {
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
return isCloseTo(try actualExpression.evaluate(), expectedValue: expectedValue, delta: delta)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is close to another. This is used for floating
|
||||||
|
/// point values which can have imprecise results when doing arithmetic on them.
|
||||||
|
///
|
||||||
|
/// @see equal
|
||||||
|
public func beCloseTo(_ expectedValue: NMBDoubleConvertible, within delta: Double = DefaultDelta) -> Predicate<NMBDoubleConvertible> {
|
||||||
|
return Predicate.define { actualExpression in
|
||||||
|
return isCloseTo(try actualExpression.evaluate(), expectedValue: expectedValue, delta: delta)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
public class NMBObjCBeCloseToMatcher: NSObject, NMBMatcher {
|
||||||
|
var _expected: NSNumber
|
||||||
|
var _delta: CDouble
|
||||||
|
init(expected: NSNumber, within: CDouble) {
|
||||||
|
_expected = expected
|
||||||
|
_delta = within
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public func matches(_ actualExpression: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let actualBlock: () -> NMBDoubleConvertible? = ({
|
||||||
|
return actualExpression() as? NMBDoubleConvertible
|
||||||
|
})
|
||||||
|
let expr = Expression(expression: actualBlock, location: location)
|
||||||
|
let matcher = beCloseTo(self._expected, within: self._delta)
|
||||||
|
return try! matcher.matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public func doesNotMatch(_ actualExpression: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let actualBlock: () -> NMBDoubleConvertible? = ({
|
||||||
|
return actualExpression() as? NMBDoubleConvertible
|
||||||
|
})
|
||||||
|
let expr = Expression(expression: actualBlock, location: location)
|
||||||
|
let matcher = beCloseTo(self._expected, within: self._delta)
|
||||||
|
return try! matcher.doesNotMatch(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var within: (CDouble) -> NMBObjCBeCloseToMatcher {
|
||||||
|
return ({ delta in
|
||||||
|
return NMBObjCBeCloseToMatcher(expected: self._expected, within: delta)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beCloseToMatcher(_ expected: NSNumber, within: CDouble) -> NMBObjCBeCloseToMatcher {
|
||||||
|
return NMBObjCBeCloseToMatcher(expected: expected, within: within)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
public func beCloseTo(_ expectedValues: [Double], within delta: Double = DefaultDelta) -> Predicate<[Double]> {
|
||||||
|
let errorMessage = "be close to <\(stringify(expectedValues))> (each within \(stringify(delta)))"
|
||||||
|
return Predicate.simple(errorMessage) { actualExpression in
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
if actual.count != expectedValues.count {
|
||||||
|
return .doesNotMatch
|
||||||
|
} else {
|
||||||
|
for (index, actualItem) in actual.enumerated() {
|
||||||
|
if fabs(actualItem - expectedValues[index]) > delta {
|
||||||
|
return .doesNotMatch
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return .matches
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return .doesNotMatch
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: - Operators
|
||||||
|
|
||||||
|
infix operator ≈ : ComparisonPrecedence
|
||||||
|
|
||||||
|
public func ≈(lhs: Expectation<[Double]>, rhs: [Double]) {
|
||||||
|
lhs.to(beCloseTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ≈(lhs: Expectation<NMBDoubleConvertible>, rhs: NMBDoubleConvertible) {
|
||||||
|
lhs.to(beCloseTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ≈(lhs: Expectation<NMBDoubleConvertible>, rhs: (expected: NMBDoubleConvertible, delta: Double)) {
|
||||||
|
lhs.to(beCloseTo(rhs.expected, within: rhs.delta))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func == (lhs: Expectation<NMBDoubleConvertible>, rhs: (expected: NMBDoubleConvertible, delta: Double)) {
|
||||||
|
lhs.to(beCloseTo(rhs.expected, within: rhs.delta))
|
||||||
|
}
|
||||||
|
|
||||||
|
// make this higher precedence than exponents so the Doubles either end aren't pulled in
|
||||||
|
// unexpectantly
|
||||||
|
precedencegroup PlusMinusOperatorPrecedence {
|
||||||
|
higherThan: BitwiseShiftPrecedence
|
||||||
|
}
|
||||||
|
|
||||||
|
infix operator ± : PlusMinusOperatorPrecedence
|
||||||
|
public func ±(lhs: NMBDoubleConvertible, rhs: Double) -> (expected: NMBDoubleConvertible, delta: Double) {
|
||||||
|
return (expected: lhs, delta: rhs)
|
||||||
|
}
|
95
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeEmpty.swift
vendored
Normal file
95
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeEmpty.swift
vendored
Normal file
|
@ -0,0 +1,95 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For strings, it is an empty string.
|
||||||
|
public func beEmpty<S: Sequence>() -> Predicate<S> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actualSeq = try actualExpression.evaluate()
|
||||||
|
if actualSeq == nil {
|
||||||
|
return .fail
|
||||||
|
}
|
||||||
|
var generator = actualSeq!.makeIterator()
|
||||||
|
return PredicateStatus(bool: generator.next() == nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For strings, it is an empty string.
|
||||||
|
public func beEmpty() -> Predicate<String> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actualString = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actualString == nil || NSString(string: actualString!).length == 0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For NSString instances, it is an empty string.
|
||||||
|
public func beEmpty() -> Predicate<NSString> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actualString = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actualString == nil || actualString!.length == 0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Without specific overrides, beEmpty() is ambiguous for NSDictionary, NSArray,
|
||||||
|
// etc, since they conform to Sequence as well as NMBCollection.
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For strings, it is an empty string.
|
||||||
|
public func beEmpty() -> Predicate<NSDictionary> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actualDictionary = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actualDictionary == nil || actualDictionary!.count == 0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For strings, it is an empty string.
|
||||||
|
public func beEmpty() -> Predicate<NSArray> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actualArray = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actualArray == nil || actualArray!.count == 0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when a value is "empty". For collections, this
|
||||||
|
/// means the are no items in that collection. For strings, it is an empty string.
|
||||||
|
public func beEmpty() -> Predicate<NMBCollection> {
|
||||||
|
return Predicate.simple("be empty") { actualExpression in
|
||||||
|
let actual = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actual == nil || actual!.count == 0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beEmptyMatcher() -> NMBPredicate {
|
||||||
|
return NMBPredicate { actualExpression in
|
||||||
|
let location = actualExpression.location
|
||||||
|
let actualValue = try! actualExpression.evaluate()
|
||||||
|
|
||||||
|
if let value = actualValue as? NMBCollection {
|
||||||
|
let expr = Expression(expression: ({ value as NMBCollection }), location: location)
|
||||||
|
return try! beEmpty().satisfies(expr).toObjectiveC()
|
||||||
|
} else if let value = actualValue as? NSString {
|
||||||
|
let expr = Expression(expression: ({ value as String }), location: location)
|
||||||
|
return try! beEmpty().satisfies(expr).toObjectiveC()
|
||||||
|
} else if let actualValue = actualValue {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
let badTypeErrorMsg = "be empty (only works for NSArrays, NSSets, NSIndexSets, NSDictionaries, NSHashTables, and NSStrings)"
|
||||||
|
return NMBPredicateResult(
|
||||||
|
status: NMBPredicateStatus.fail,
|
||||||
|
message: NMBExpectationMessage(
|
||||||
|
expectedActualValueTo: badTypeErrorMsg,
|
||||||
|
customActualValue: "\(String(describing: type(of: actualValue))) type"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return NMBPredicateResult(
|
||||||
|
status: NMBPredicateStatus.fail,
|
||||||
|
message: NMBExpectationMessage(expectedActualValueTo: "be empty").appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,42 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is greater than the expected value.
|
||||||
|
public func beGreaterThan<T: Comparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
let errorMessage = "be greater than <\(stringify(expectedValue))>"
|
||||||
|
return Predicate.simple(errorMessage) { actualExpression in
|
||||||
|
if let actual = try actualExpression.evaluate(), let expected = expectedValue {
|
||||||
|
return PredicateStatus(bool: actual > expected)
|
||||||
|
}
|
||||||
|
return .fail
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is greater than the expected value.
|
||||||
|
public func beGreaterThan(_ expectedValue: NMBComparable?) -> Predicate<NMBComparable> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be greater than <\(stringify(expectedValue))>"
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
let matches = actualValue != nil
|
||||||
|
&& actualValue!.NMB_compare(expectedValue) == ComparisonResult.orderedDescending
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ><T: Comparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beGreaterThan(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func > (lhs: Expectation<NMBComparable>, rhs: NMBComparable?) {
|
||||||
|
lhs.to(beGreaterThan(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beGreaterThanMatcher(_ expected: NMBComparable?) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBComparable }
|
||||||
|
return try! beGreaterThan(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,44 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is greater than
|
||||||
|
/// or equal to the expected value.
|
||||||
|
public func beGreaterThanOrEqualTo<T: Comparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be greater than or equal to <\(stringify(expectedValue))>"
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
if let actual = actualValue, let expected = expectedValue {
|
||||||
|
return actual >= expected
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is greater than
|
||||||
|
/// or equal to the expected value.
|
||||||
|
public func beGreaterThanOrEqualTo<T: NMBComparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be greater than or equal to <\(stringify(expectedValue))>"
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
let matches = actualValue != nil && actualValue!.NMB_compare(expectedValue) != ComparisonResult.orderedAscending
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func >=<T: Comparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beGreaterThanOrEqualTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func >=<T: NMBComparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beGreaterThanOrEqualTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beGreaterThanOrEqualToMatcher(_ expected: NMBComparable?) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBComparable }
|
||||||
|
return try! beGreaterThanOrEqualTo(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,46 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is the same instance
|
||||||
|
/// as the expected instance.
|
||||||
|
public func beIdenticalTo(_ expected: Any?) -> Predicate<Any> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
#if os(Linux)
|
||||||
|
let actual = try actualExpression.evaluate() as? AnyObject
|
||||||
|
#else
|
||||||
|
let actual = try actualExpression.evaluate() as AnyObject?
|
||||||
|
#endif
|
||||||
|
failureMessage.actualValue = "\(identityAsString(actual))"
|
||||||
|
failureMessage.postfixMessage = "be identical to \(identityAsString(expected))"
|
||||||
|
#if os(Linux)
|
||||||
|
return actual === (expected as? AnyObject) && actual !== nil
|
||||||
|
#else
|
||||||
|
return actual === (expected as AnyObject?) && actual !== nil
|
||||||
|
#endif
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func === (lhs: Expectation<Any>, rhs: Any?) {
|
||||||
|
lhs.to(beIdenticalTo(rhs))
|
||||||
|
}
|
||||||
|
public func !== (lhs: Expectation<Any>, rhs: Any?) {
|
||||||
|
lhs.toNot(beIdenticalTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is the same instance
|
||||||
|
/// as the expected instance.
|
||||||
|
///
|
||||||
|
/// Alias for "beIdenticalTo".
|
||||||
|
public func be(_ expected: Any?) -> Predicate<Any> {
|
||||||
|
return beIdenticalTo(expected)
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beIdenticalToMatcher(_ expected: NSObject?) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let aExpr = actualExpression.cast { $0 as Any? }
|
||||||
|
return try! beIdenticalTo(expected).matches(aExpr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
41
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeLessThan.swift
vendored
Normal file
41
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeLessThan.swift
vendored
Normal file
|
@ -0,0 +1,41 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is less than the expected value.
|
||||||
|
public func beLessThan<T: Comparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be less than <\(stringify(expectedValue))>"
|
||||||
|
if let actual = try actualExpression.evaluate(), let expected = expectedValue {
|
||||||
|
return actual < expected
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is less than the expected value.
|
||||||
|
public func beLessThan(_ expectedValue: NMBComparable?) -> Predicate<NMBComparable> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be less than <\(stringify(expectedValue))>"
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
let matches = actualValue != nil && actualValue!.NMB_compare(expectedValue) == ComparisonResult.orderedAscending
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func <<T: Comparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beLessThan(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func < (lhs: Expectation<NMBComparable>, rhs: NMBComparable?) {
|
||||||
|
lhs.to(beLessThan(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beLessThanMatcher(_ expected: NMBComparable?) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBComparable }
|
||||||
|
return try! beLessThan(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,42 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is less than
|
||||||
|
/// or equal to the expected value.
|
||||||
|
public func beLessThanOrEqualTo<T: Comparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be less than or equal to <\(stringify(expectedValue))>"
|
||||||
|
if let actual = try actualExpression.evaluate(), let expected = expectedValue {
|
||||||
|
return actual <= expected
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is less than
|
||||||
|
/// or equal to the expected value.
|
||||||
|
public func beLessThanOrEqualTo<T: NMBComparable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be less than or equal to <\(stringify(expectedValue))>"
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
return actualValue != nil && actualValue!.NMB_compare(expectedValue) != ComparisonResult.orderedDescending
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func <=<T: Comparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beLessThanOrEqualTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func <=<T: NMBComparable>(lhs: Expectation<T>, rhs: T) {
|
||||||
|
lhs.to(beLessThanOrEqualTo(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beLessThanOrEqualToMatcher(_ expected: NMBComparable?) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBComparable }
|
||||||
|
return try! beLessThanOrEqualTo(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
167
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeLogical.swift
vendored
Normal file
167
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeLogical.swift
vendored
Normal file
|
@ -0,0 +1,167 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
extension Int8: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).int8Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension UInt8: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).uint8Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Int16: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).int16Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension UInt16: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).uint16Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Int32: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).int32Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension UInt32: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).uint32Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Int64: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).int64Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension UInt64: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).uint64Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Float: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).floatValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Double: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).doubleValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Int: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).intValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension UInt: ExpressibleByBooleanLiteral {
|
||||||
|
public init(booleanLiteral value: Bool) {
|
||||||
|
self = NSNumber(value: value).uintValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func rename<T>(_ matcher: Predicate<T>, failureMessage message: ExpectationMessage) -> Predicate<T> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
let result = try matcher.satisfies(actualExpression)
|
||||||
|
return PredicateResult(status: result.status, message: message)
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: beTrue() / beFalse()
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is exactly true.
|
||||||
|
/// This matcher will not match against nils.
|
||||||
|
public func beTrue() -> Predicate<Bool> {
|
||||||
|
return rename(equal(true), failureMessage: .expectedActualValueTo("be true"))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is exactly false.
|
||||||
|
/// This matcher will not match against nils.
|
||||||
|
public func beFalse() -> Predicate<Bool> {
|
||||||
|
return rename(equal(false), failureMessage: .expectedActualValueTo("be false"))
|
||||||
|
}
|
||||||
|
|
||||||
|
// MARK: beTruthy() / beFalsy()
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is not logically false.
|
||||||
|
public func beTruthy<T: ExpressibleByBooleanLiteral & Equatable>() -> Predicate<T> {
|
||||||
|
return Predicate.simpleNilable("be truthy") { actualExpression in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
if let actualValue = actualValue {
|
||||||
|
// FIXME: This is a workaround to SR-2290.
|
||||||
|
// See:
|
||||||
|
// - https://bugs.swift.org/browse/SR-2290
|
||||||
|
// - https://github.com/norio-nomura/Nimble/pull/5#issuecomment-237835873
|
||||||
|
if let number = actualValue as? NSNumber {
|
||||||
|
return PredicateStatus(bool: number.boolValue == true)
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateStatus(bool: actualValue == (true as T))
|
||||||
|
}
|
||||||
|
return PredicateStatus(bool: actualValue != nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is logically false.
|
||||||
|
/// This matcher will match against nils.
|
||||||
|
public func beFalsy<T: ExpressibleByBooleanLiteral & Equatable>() -> Predicate<T> {
|
||||||
|
return Predicate.simpleNilable("be falsy") { actualExpression in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
if let actualValue = actualValue {
|
||||||
|
// FIXME: This is a workaround to SR-2290.
|
||||||
|
// See:
|
||||||
|
// - https://bugs.swift.org/browse/SR-2290
|
||||||
|
// - https://github.com/norio-nomura/Nimble/pull/5#issuecomment-237835873
|
||||||
|
if let number = actualValue as? NSNumber {
|
||||||
|
return PredicateStatus(bool: number.boolValue == false)
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateStatus(bool: actualValue == (false as T))
|
||||||
|
}
|
||||||
|
return PredicateStatus(bool: actualValue == nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beTruthyMatcher() -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { ($0 as? NSNumber)?.boolValue ?? false }
|
||||||
|
return try! beTruthy().matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public class func beFalsyMatcher() -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { ($0 as? NSNumber)?.boolValue ?? false }
|
||||||
|
return try! beFalsy().matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public class func beTrueMatcher() -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { ($0 as? NSNumber)?.boolValue ?? false }
|
||||||
|
return try! beTrue().matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public class func beFalseMatcher() -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let expr = actualExpression.cast { ($0 as? NSNumber)?.boolValue ?? false }
|
||||||
|
return try! beFalse().matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
19
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeNil.swift
vendored
Normal file
19
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeNil.swift
vendored
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is nil.
|
||||||
|
public func beNil<T>() -> Predicate<T> {
|
||||||
|
return Predicate.simpleNilable("be nil") { actualExpression in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
return PredicateStatus(bool: actualValue == nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beNilMatcher() -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher { actualExpression, failureMessage in
|
||||||
|
return try! beNil().matches(actualExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
18
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeVoid.swift
vendored
Normal file
18
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeVoid.swift
vendored
Normal file
|
@ -0,0 +1,18 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is Void.
|
||||||
|
public func beVoid() -> Predicate<()> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "be void"
|
||||||
|
let actualValue: ()? = try actualExpression.evaluate()
|
||||||
|
return actualValue != nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public func == (lhs: Expectation<()>, rhs: ()) {
|
||||||
|
lhs.to(beVoid())
|
||||||
|
}
|
||||||
|
|
||||||
|
public func != (lhs: Expectation<()>, rhs: ()) {
|
||||||
|
lhs.toNot(beVoid())
|
||||||
|
}
|
60
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeginWith.swift
vendored
Normal file
60
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/BeginWith.swift
vendored
Normal file
|
@ -0,0 +1,60 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual sequence's first element
|
||||||
|
/// is equal to the expected value.
|
||||||
|
public func beginWith<S: Sequence, T: Equatable>(_ startingElement: T) -> Predicate<S>
|
||||||
|
where S.Iterator.Element == T {
|
||||||
|
return Predicate.simple("begin with <\(startingElement)>") { actualExpression in
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
var actualGenerator = actualValue.makeIterator()
|
||||||
|
return PredicateStatus(bool: actualGenerator.next() == startingElement)
|
||||||
|
}
|
||||||
|
return .fail
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual collection's first element
|
||||||
|
/// is equal to the expected object.
|
||||||
|
public func beginWith(_ startingElement: Any) -> Predicate<NMBOrderedCollection> {
|
||||||
|
return Predicate.simple("begin with <\(startingElement)>") { actualExpression in
|
||||||
|
guard let collection = try actualExpression.evaluate() else { return .fail }
|
||||||
|
guard collection.count > 0 else { return .doesNotMatch }
|
||||||
|
#if os(Linux)
|
||||||
|
guard let collectionValue = collection.object(at: 0) as? NSObject else {
|
||||||
|
return .fail
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
let collectionValue = collection.object(at: 0) as AnyObject
|
||||||
|
#endif
|
||||||
|
return PredicateStatus(bool: collectionValue.isEqual(startingElement))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual string contains expected substring
|
||||||
|
/// where the expected substring's location is zero.
|
||||||
|
public func beginWith(_ startingSubstring: String) -> Predicate<String> {
|
||||||
|
return Predicate.simple("begin with <\(startingSubstring)>") { actualExpression in
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
let range = actual.range(of: startingSubstring)
|
||||||
|
return PredicateStatus(bool: range != nil && range!.lowerBound == actual.startIndex)
|
||||||
|
}
|
||||||
|
return .fail
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func beginWithMatcher(_ expected: Any) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let actual = try! actualExpression.evaluate()
|
||||||
|
if (actual as? String) != nil {
|
||||||
|
let expr = actualExpression.cast { $0 as? String }
|
||||||
|
return try! beginWith(expected as! String).matches(expr, failureMessage: failureMessage)
|
||||||
|
} else {
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBOrderedCollection }
|
||||||
|
return try! beginWith(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
95
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Contain.swift
vendored
Normal file
95
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Contain.swift
vendored
Normal file
|
@ -0,0 +1,95 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual sequence contains the expected value.
|
||||||
|
public func contain<S: Sequence, T: Equatable>(_ items: T...) -> Predicate<S>
|
||||||
|
where S.Iterator.Element == T {
|
||||||
|
return contain(items)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func contain<S: Sequence, T: Equatable>(_ items: [T]) -> Predicate<S>
|
||||||
|
where S.Iterator.Element == T {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(items))>"
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
return items.all {
|
||||||
|
return actual.contains($0)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual string contains the expected substring.
|
||||||
|
public func contain(_ substrings: String...) -> Predicate<String> {
|
||||||
|
return contain(substrings)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func contain(_ substrings: [String]) -> Predicate<String> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(substrings))>"
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
return substrings.all {
|
||||||
|
let range = actual.range(of: $0)
|
||||||
|
return range != nil && !range!.isEmpty
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual string contains the expected substring.
|
||||||
|
public func contain(_ substrings: NSString...) -> Predicate<NSString> {
|
||||||
|
return contain(substrings)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func contain(_ substrings: [NSString]) -> Predicate<NSString> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(substrings))>"
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
return substrings.all { actual.range(of: $0.description).length != 0 }
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual collection contains the expected object.
|
||||||
|
public func contain(_ items: Any?...) -> Predicate<NMBContainer> {
|
||||||
|
return contain(items)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func contain(_ items: [Any?]) -> Predicate<NMBContainer> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(items))>"
|
||||||
|
guard let actual = try actualExpression.evaluate() else { return false }
|
||||||
|
return items.all { item in
|
||||||
|
return item != nil && actual.contains(item!)
|
||||||
|
}
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func containMatcher(_ expected: [NSObject]) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let location = actualExpression.location
|
||||||
|
let actualValue = try! actualExpression.evaluate()
|
||||||
|
if let value = actualValue as? NMBContainer {
|
||||||
|
let expr = Expression(expression: ({ value as NMBContainer }), location: location)
|
||||||
|
|
||||||
|
// A straightforward cast on the array causes this to crash, so we have to cast the individual items
|
||||||
|
let expectedOptionals: [Any?] = expected.map({ $0 as Any? })
|
||||||
|
return try! contain(expectedOptionals).matches(expr, failureMessage: failureMessage)
|
||||||
|
} else if let value = actualValue as? NSString {
|
||||||
|
let expr = Expression(expression: ({ value as String }), location: location)
|
||||||
|
return try! contain(expected as! [String]).matches(expr, failureMessage: failureMessage)
|
||||||
|
} else if actualValue != nil {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(expected))> (only works for NSArrays, NSSets, NSHashTables, and NSStrings)"
|
||||||
|
} else {
|
||||||
|
failureMessage.postfixMessage = "contain <\(arrayAsString(expected))>"
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
|
@ -0,0 +1,60 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
public func containElementSatisfying<S: Sequence, T>(_ predicate: @escaping ((T) -> Bool), _ predicateDescription: String = "") -> Predicate<S> where S.Iterator.Element == T {
|
||||||
|
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.actualValue = nil
|
||||||
|
|
||||||
|
if predicateDescription == "" {
|
||||||
|
failureMessage.postfixMessage = "find object in collection that satisfies predicate"
|
||||||
|
} else {
|
||||||
|
failureMessage.postfixMessage = "find object in collection \(predicateDescription)"
|
||||||
|
}
|
||||||
|
|
||||||
|
if let sequence = try actualExpression.evaluate() {
|
||||||
|
for object in sequence {
|
||||||
|
if predicate(object) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func containElementSatisfyingMatcher(_ predicate: @escaping ((NSObject) -> Bool)) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let value = try! actualExpression.evaluate()
|
||||||
|
guard let enumeration = value as? NSFastEnumeration else {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
failureMessage.postfixMessage = "containElementSatisfying must be provided an NSFastEnumeration object"
|
||||||
|
failureMessage.actualValue = nil
|
||||||
|
failureMessage.expected = ""
|
||||||
|
failureMessage.to = ""
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
var iterator = NSFastEnumerationIterator(enumeration)
|
||||||
|
while let item = iterator.next() {
|
||||||
|
guard let object = item as? NSObject else {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if predicate(object) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
failureMessage.actualValue = nil
|
||||||
|
failureMessage.postfixMessage = ""
|
||||||
|
failureMessage.to = "to find object in collection that satisfies predicate"
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
72
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/EndWith.swift
vendored
Normal file
72
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/EndWith.swift
vendored
Normal file
|
@ -0,0 +1,72 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual sequence's last element
|
||||||
|
/// is equal to the expected value.
|
||||||
|
public func endWith<S: Sequence, T: Equatable>(_ endingElement: T) -> Predicate<S>
|
||||||
|
where S.Iterator.Element == T {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "end with <\(endingElement)>"
|
||||||
|
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
var actualGenerator = actualValue.makeIterator()
|
||||||
|
var lastItem: T?
|
||||||
|
var item: T?
|
||||||
|
repeat {
|
||||||
|
lastItem = item
|
||||||
|
item = actualGenerator.next()
|
||||||
|
} while(item != nil)
|
||||||
|
|
||||||
|
return lastItem == endingElement
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual collection's last element
|
||||||
|
/// is equal to the expected object.
|
||||||
|
public func endWith(_ endingElement: Any) -> Predicate<NMBOrderedCollection> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "end with <\(endingElement)>"
|
||||||
|
guard let collection = try actualExpression.evaluate() else { return false }
|
||||||
|
guard collection.count > 0 else { return false }
|
||||||
|
#if os(Linux)
|
||||||
|
guard let collectionValue = collection.object(at: collection.count - 1) as? NSObject else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
let collectionValue = collection.object(at: collection.count - 1) as AnyObject
|
||||||
|
#endif
|
||||||
|
|
||||||
|
return collectionValue.isEqual(endingElement)
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual string contains the expected substring
|
||||||
|
/// where the expected substring's location is the actual string's length minus the
|
||||||
|
/// expected substring's length.
|
||||||
|
public func endWith(_ endingSubstring: String) -> Predicate<String> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "end with <\(endingSubstring)>"
|
||||||
|
if let collection = try actualExpression.evaluate() {
|
||||||
|
return collection.hasSuffix(endingSubstring)
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func endWithMatcher(_ expected: Any) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let actual = try! actualExpression.evaluate()
|
||||||
|
if (actual as? String) != nil {
|
||||||
|
let expr = actualExpression.cast { $0 as? String }
|
||||||
|
return try! endWith(expected as! String).matches(expr, failureMessage: failureMessage)
|
||||||
|
} else {
|
||||||
|
let expr = actualExpression.cast { $0 as? NMBOrderedCollection }
|
||||||
|
return try! endWith(expected).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
220
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Equal.swift
vendored
Normal file
220
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Equal.swift
vendored
Normal file
|
@ -0,0 +1,220 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is equal to the expected value.
|
||||||
|
/// Values can support equal by supporting the Equatable protocol.
|
||||||
|
///
|
||||||
|
/// @see beCloseTo if you want to match imprecise types (eg - floats, doubles).
|
||||||
|
public func equal<T: Equatable>(_ expectedValue: T?) -> Predicate<T> {
|
||||||
|
return Predicate.define("equal <\(stringify(expectedValue))>") { actualExpression, msg in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
let matches = actualValue == expectedValue && expectedValue != nil
|
||||||
|
if expectedValue == nil || actualValue == nil {
|
||||||
|
if expectedValue == nil && actualValue != nil {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: msg.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return PredicateResult(status: .fail, message: msg)
|
||||||
|
}
|
||||||
|
return PredicateResult(status: PredicateStatus(bool: matches), message: msg)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value is equal to the expected value.
|
||||||
|
/// Values can support equal by supporting the Equatable protocol.
|
||||||
|
///
|
||||||
|
/// @see beCloseTo if you want to match imprecise types (eg - floats, doubles).
|
||||||
|
public func equal<T, C: Equatable>(_ expectedValue: [T: C]?) -> Predicate<[T: C]> {
|
||||||
|
return Predicate.define("equal <\(stringify(expectedValue))>") { actualExpression, msg in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
if expectedValue == nil || actualValue == nil {
|
||||||
|
if expectedValue == nil && actualValue != nil {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: msg.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return PredicateResult(status: .fail, message: msg)
|
||||||
|
}
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: expectedValue! == actualValue!),
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual collection is equal to the expected collection.
|
||||||
|
/// Items must implement the Equatable protocol.
|
||||||
|
public func equal<T: Equatable>(_ expectedValue: [T]?) -> Predicate<[T]> {
|
||||||
|
return Predicate.define("equal <\(stringify(expectedValue))>") { actualExpression, msg in
|
||||||
|
let actualValue = try actualExpression.evaluate()
|
||||||
|
if expectedValue == nil || actualValue == nil {
|
||||||
|
if expectedValue == nil && actualValue != nil {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: msg.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return PredicateResult(
|
||||||
|
bool: expectedValue! == actualValue!,
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher allowing comparison of collection with optional type
|
||||||
|
public func equal<T: Equatable>(_ expectedValue: [T?]) -> Predicate<[T?]> {
|
||||||
|
return Predicate.define("equal <\(stringify(expectedValue))>") { actualExpression, msg in
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
let doesNotMatch = PredicateResult(
|
||||||
|
status: .doesNotMatch,
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
|
||||||
|
if expectedValue.count != actualValue.count {
|
||||||
|
return doesNotMatch
|
||||||
|
}
|
||||||
|
|
||||||
|
for (index, item) in actualValue.enumerated() {
|
||||||
|
let otherItem = expectedValue[index]
|
||||||
|
if item == nil && otherItem == nil {
|
||||||
|
continue
|
||||||
|
} else if item == nil && otherItem != nil {
|
||||||
|
return doesNotMatch
|
||||||
|
} else if item != nil && otherItem == nil {
|
||||||
|
return doesNotMatch
|
||||||
|
} else if item! != otherItem! {
|
||||||
|
return doesNotMatch
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateResult(
|
||||||
|
status: .matches,
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: msg.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual set is equal to the expected set.
|
||||||
|
public func equal<T>(_ expectedValue: Set<T>?) -> Predicate<Set<T>> {
|
||||||
|
return equal(expectedValue, stringify: { stringify($0) })
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual set is equal to the expected set.
|
||||||
|
public func equal<T: Comparable>(_ expectedValue: Set<T>?) -> Predicate<Set<T>> {
|
||||||
|
return equal(expectedValue, stringify: {
|
||||||
|
if let set = $0 {
|
||||||
|
return stringify(Array(set).sorted { $0 < $1 })
|
||||||
|
} else {
|
||||||
|
return "nil"
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
private func equal<T>(_ expectedValue: Set<T>?, stringify: @escaping (Set<T>?) -> String) -> Predicate<Set<T>> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
var errorMessage: ExpectationMessage =
|
||||||
|
.expectedActualValueTo("equal <\(stringify(expectedValue))>")
|
||||||
|
|
||||||
|
if let expectedValue = expectedValue {
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
errorMessage = .expectedCustomValueTo(
|
||||||
|
"equal <\(stringify(expectedValue))>",
|
||||||
|
"<\(stringify(actualValue))>"
|
||||||
|
)
|
||||||
|
|
||||||
|
if expectedValue == actualValue {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .matches,
|
||||||
|
message: errorMessage
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
let missing = expectedValue.subtracting(actualValue)
|
||||||
|
if missing.count > 0 {
|
||||||
|
errorMessage = errorMessage.appended(message: ", missing <\(stringify(missing))>")
|
||||||
|
}
|
||||||
|
|
||||||
|
let extra = actualValue.subtracting(expectedValue)
|
||||||
|
if extra.count > 0 {
|
||||||
|
errorMessage = errorMessage.appended(message: ", extra <\(stringify(extra))>")
|
||||||
|
}
|
||||||
|
return PredicateResult(
|
||||||
|
status: .doesNotMatch,
|
||||||
|
message: errorMessage
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: errorMessage.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: errorMessage.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ==<T: Equatable>(lhs: Expectation<T>, rhs: T?) {
|
||||||
|
lhs.to(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func !=<T: Equatable>(lhs: Expectation<T>, rhs: T?) {
|
||||||
|
lhs.toNot(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ==<T: Equatable>(lhs: Expectation<[T]>, rhs: [T]?) {
|
||||||
|
lhs.to(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func !=<T: Equatable>(lhs: Expectation<[T]>, rhs: [T]?) {
|
||||||
|
lhs.toNot(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func == <T>(lhs: Expectation<Set<T>>, rhs: Set<T>?) {
|
||||||
|
lhs.to(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func != <T>(lhs: Expectation<Set<T>>, rhs: Set<T>?) {
|
||||||
|
lhs.toNot(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ==<T: Comparable>(lhs: Expectation<Set<T>>, rhs: Set<T>?) {
|
||||||
|
lhs.to(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func !=<T: Comparable>(lhs: Expectation<Set<T>>, rhs: Set<T>?) {
|
||||||
|
lhs.toNot(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func ==<T, C: Equatable>(lhs: Expectation<[T: C]>, rhs: [T: C]?) {
|
||||||
|
lhs.to(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func !=<T, C: Equatable>(lhs: Expectation<[T: C]>, rhs: [T: C]?) {
|
||||||
|
lhs.toNot(equal(rhs))
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func equalMatcher(_ expected: NSObject) -> NMBMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
return try! equal(expected).matches(actualExpression, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
59
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/HaveCount.swift
vendored
Normal file
59
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/HaveCount.swift
vendored
Normal file
|
@ -0,0 +1,59 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
// The `haveCount` matchers do not print the full string representation of the collection value,
|
||||||
|
// instead they only print the type name and the expected count. This makes it easier to understand
|
||||||
|
// the reason for failed expectations. See: https://github.com/Quick/Nimble/issues/308.
|
||||||
|
// The representation of the collection content is provided in a new line as an `extendedMessage`.
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual Collection's count equals
|
||||||
|
/// the expected value
|
||||||
|
public func haveCount<T: Collection>(_ expectedValue: T.IndexDistance) -> Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
failureMessage.postfixMessage = "have \(prettyCollectionType(actualValue)) with count \(stringify(expectedValue))"
|
||||||
|
let result = expectedValue == actualValue.count
|
||||||
|
failureMessage.actualValue = "\(actualValue.count)"
|
||||||
|
failureMessage.extendedMessage = "Actual Value: \(stringify(actualValue))"
|
||||||
|
return result
|
||||||
|
} else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual collection's count equals
|
||||||
|
/// the expected value
|
||||||
|
public func haveCount(_ expectedValue: Int) -> Predicate<NMBCollection> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
failureMessage.postfixMessage = "have \(prettyCollectionType(actualValue)) with count \(stringify(expectedValue))"
|
||||||
|
let result = expectedValue == actualValue.count
|
||||||
|
failureMessage.actualValue = "\(actualValue.count)"
|
||||||
|
failureMessage.extendedMessage = "Actual Value: \(stringify(actualValue))"
|
||||||
|
return result
|
||||||
|
} else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func haveCountMatcher(_ expected: NSNumber) -> NMBObjCMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let location = actualExpression.location
|
||||||
|
let actualValue = try! actualExpression.evaluate()
|
||||||
|
if let value = actualValue as? NMBCollection {
|
||||||
|
let expr = Expression(expression: ({ value as NMBCollection}), location: location)
|
||||||
|
return try! haveCount(expected.intValue).matches(expr, failureMessage: failureMessage)
|
||||||
|
} else if let actualValue = actualValue {
|
||||||
|
failureMessage.postfixMessage = "get type of NSArray, NSSet, NSDictionary, or NSHashTable"
|
||||||
|
failureMessage.actualValue = "\(String(describing: type(of: actualValue)))"
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
30
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Match.swift
vendored
Normal file
30
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Match.swift
vendored
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual string satisfies the regular expression
|
||||||
|
/// described by the expected string.
|
||||||
|
public func match(_ expectedValue: String?) -> Predicate<String> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
failureMessage.postfixMessage = "match <\(stringify(expectedValue))>"
|
||||||
|
|
||||||
|
if let actual = try actualExpression.evaluate() {
|
||||||
|
if let regexp = expectedValue {
|
||||||
|
return actual.range(of: regexp, options: .regularExpression) != nil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return false
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func matchMatcher(_ expected: NSString) -> NMBMatcher {
|
||||||
|
return NMBObjCMatcher(canMatchNil: false) { actualExpression, failureMessage in
|
||||||
|
let actual = actualExpression.cast { $0 as? String }
|
||||||
|
return try! match(expected.description).matches(actual, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
58
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/MatchError.swift
vendored
Normal file
58
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/MatchError.swift
vendored
Normal file
|
@ -0,0 +1,58 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual expression evaluates to an
|
||||||
|
/// error from the specified case.
|
||||||
|
///
|
||||||
|
/// Errors are tried to be compared by their implementation of Equatable,
|
||||||
|
/// otherwise they fallback to comparison by _domain and _code.
|
||||||
|
public func matchError<T: Error>(_ error: T) -> Predicate<Error> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
let actualError: Error? = try actualExpression.evaluate()
|
||||||
|
|
||||||
|
setFailureMessageForError(failureMessage, postfixMessageVerb: "match", actualError: actualError, error: error)
|
||||||
|
var matches = false
|
||||||
|
if let actualError = actualError, errorMatchesExpectedError(actualError, expectedError: error) {
|
||||||
|
matches = true
|
||||||
|
}
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual expression evaluates to an
|
||||||
|
/// error from the specified case.
|
||||||
|
///
|
||||||
|
/// Errors are tried to be compared by their implementation of Equatable,
|
||||||
|
/// otherwise they fallback to comparision by _domain and _code.
|
||||||
|
public func matchError<T: Error & Equatable>(_ error: T) -> Predicate<Error> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
let actualError: Error? = try actualExpression.evaluate()
|
||||||
|
|
||||||
|
setFailureMessageForError(failureMessage, postfixMessageVerb: "match", actualError: actualError, error: error)
|
||||||
|
|
||||||
|
var matches = false
|
||||||
|
if let actualError = actualError as? T, error == actualError {
|
||||||
|
matches = true
|
||||||
|
}
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual expression evaluates to an
|
||||||
|
/// error of the specified type
|
||||||
|
public func matchError<T: Error>(_ errorType: T.Type) -> Predicate<Error> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
let actualError: Error? = try actualExpression.evaluate()
|
||||||
|
|
||||||
|
setFailureMessageForError(
|
||||||
|
failureMessage,
|
||||||
|
postfixMessageVerb: "match",
|
||||||
|
actualError: actualError,
|
||||||
|
errorType: errorType
|
||||||
|
)
|
||||||
|
var matches = false
|
||||||
|
if actualError as? T != nil {
|
||||||
|
matches = true
|
||||||
|
}
|
||||||
|
return matches
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
|
@ -0,0 +1,85 @@
|
||||||
|
/// DEPRECATED: A convenience API to build matchers that don't need special negation
|
||||||
|
/// behavior. The toNot() behavior is the negation of to().
|
||||||
|
///
|
||||||
|
/// @see NonNilMatcherFunc if you prefer to have this matcher fail when nil
|
||||||
|
/// values are received in an expectation.
|
||||||
|
///
|
||||||
|
/// You may use this when implementing your own custom matchers.
|
||||||
|
///
|
||||||
|
/// Use the Matcher protocol instead of this type to accept custom matchers as
|
||||||
|
/// input parameters.
|
||||||
|
/// @see allPass for an example that uses accepts other matchers as input.
|
||||||
|
@available(*, deprecated, message: "Use to Predicate instead")
|
||||||
|
public struct MatcherFunc<T>: Matcher {
|
||||||
|
public let matcher: (Expression<T>, FailureMessage) throws -> Bool
|
||||||
|
|
||||||
|
public init(_ matcher: @escaping (Expression<T>, FailureMessage) throws -> Bool) {
|
||||||
|
self.matcher = matcher
|
||||||
|
}
|
||||||
|
|
||||||
|
public func matches(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
return try matcher(actualExpression, failureMessage)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func doesNotMatch(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
return try !matcher(actualExpression, failureMessage)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compatibility layer to new Matcher API. Converts an old-style matcher to a new one.
|
||||||
|
/// Note: You should definitely spend the time to convert to the new api as soon as possible
|
||||||
|
/// since this struct type is deprecated.
|
||||||
|
public var predicate: Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedMatcher(self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// DEPRECATED: A convenience API to build matchers that don't need special negation
|
||||||
|
/// behavior. The toNot() behavior is the negation of to().
|
||||||
|
///
|
||||||
|
/// Unlike MatcherFunc, this will always fail if an expectation contains nil.
|
||||||
|
/// This applies regardless of using to() or toNot().
|
||||||
|
///
|
||||||
|
/// You may use this when implementing your own custom matchers.
|
||||||
|
///
|
||||||
|
/// Use the Matcher protocol instead of this type to accept custom matchers as
|
||||||
|
/// input parameters.
|
||||||
|
/// @see allPass for an example that uses accepts other matchers as input.
|
||||||
|
@available(*, deprecated, message: "Use to Predicate instead")
|
||||||
|
public struct NonNilMatcherFunc<T>: Matcher {
|
||||||
|
public let matcher: (Expression<T>, FailureMessage) throws -> Bool
|
||||||
|
|
||||||
|
public init(_ matcher: @escaping (Expression<T>, FailureMessage) throws -> Bool) {
|
||||||
|
self.matcher = matcher
|
||||||
|
}
|
||||||
|
|
||||||
|
public func matches(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
let pass = try matcher(actualExpression, failureMessage)
|
||||||
|
if try attachNilErrorIfNeeded(actualExpression, failureMessage: failureMessage) {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
return pass
|
||||||
|
}
|
||||||
|
|
||||||
|
public func doesNotMatch(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
let pass = try !matcher(actualExpression, failureMessage)
|
||||||
|
if try attachNilErrorIfNeeded(actualExpression, failureMessage: failureMessage) {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
return pass
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func attachNilErrorIfNeeded(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
if try actualExpression.evaluate() == nil {
|
||||||
|
failureMessage.postfixActual = " (use beNil() to match nils)"
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compatibility layer to new Matcher API. Converts an old-style matcher to a new one.
|
||||||
|
/// Note: You should definitely spend the time to convert to the new api as soon as possible
|
||||||
|
/// since this struct type is deprecated.
|
||||||
|
public var predicate: Predicate<T> {
|
||||||
|
return Predicate.fromDeprecatedMatcher(self)
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,154 @@
|
||||||
|
import Foundation
|
||||||
|
// `CGFloat` is in Foundation (swift-corelibs-foundation) on Linux.
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
import CoreGraphics
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Implement this protocol to implement a custom matcher for Swift
|
||||||
|
@available(*, deprecated, message: "Use Predicate instead")
|
||||||
|
public protocol Matcher {
|
||||||
|
associatedtype ValueType
|
||||||
|
func matches(_ actualExpression: Expression<ValueType>, failureMessage: FailureMessage) throws -> Bool
|
||||||
|
func doesNotMatch(_ actualExpression: Expression<ValueType>, failureMessage: FailureMessage) throws -> Bool
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Matcher {
|
||||||
|
var predicate: Predicate<ValueType> {
|
||||||
|
return Predicate.fromDeprecatedMatcher(self)
|
||||||
|
}
|
||||||
|
|
||||||
|
var toClosure: (Expression<ValueType>, FailureMessage, Bool) throws -> Bool {
|
||||||
|
return ({ expr, msg, expectedResult in
|
||||||
|
if expectedResult {
|
||||||
|
return try self.matches(expr, failureMessage: msg)
|
||||||
|
} else {
|
||||||
|
return try self.doesNotMatch(expr, failureMessage: msg)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
/// Objective-C interface to the Swift variant of Matcher.
|
||||||
|
@objc public protocol NMBMatcher {
|
||||||
|
func matches(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool
|
||||||
|
func doesNotMatch(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Protocol for types that support contain() matcher.
|
||||||
|
public protocol NMBContainer {
|
||||||
|
func contains(_ anObject: Any) -> Bool
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
// FIXME: NSHashTable can not conform to NMBContainer since swift-DEVELOPMENT-SNAPSHOT-2016-04-25-a
|
||||||
|
//extension NSHashTable : NMBContainer {} // Corelibs Foundation does not include this class yet
|
||||||
|
#endif
|
||||||
|
|
||||||
|
extension NSArray: NMBContainer {}
|
||||||
|
extension NSSet: NMBContainer {}
|
||||||
|
|
||||||
|
/// Protocol for types that support only beEmpty(), haveCount() matchers
|
||||||
|
public protocol NMBCollection {
|
||||||
|
var count: Int { get }
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NSHashTable: NMBCollection {} // Corelibs Foundation does not include these classes yet
|
||||||
|
extension NSMapTable: NMBCollection {}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
extension NSSet: NMBCollection {}
|
||||||
|
extension NSIndexSet: NMBCollection {}
|
||||||
|
extension NSDictionary: NMBCollection {}
|
||||||
|
|
||||||
|
/// Protocol for types that support beginWith(), endWith(), beEmpty() matchers
|
||||||
|
public protocol NMBOrderedCollection: NMBCollection {
|
||||||
|
func object(at index: Int) -> Any
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NSArray: NMBOrderedCollection {}
|
||||||
|
|
||||||
|
public protocol NMBDoubleConvertible {
|
||||||
|
var doubleValue: CDouble { get }
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Double: NMBDoubleConvertible {
|
||||||
|
public var doubleValue: CDouble {
|
||||||
|
return self
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Float: NMBDoubleConvertible {
|
||||||
|
public var doubleValue: CDouble {
|
||||||
|
return CDouble(self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension CGFloat: NMBDoubleConvertible {
|
||||||
|
public var doubleValue: CDouble {
|
||||||
|
return CDouble(self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NSNumber: NMBDoubleConvertible {
|
||||||
|
}
|
||||||
|
|
||||||
|
private let dateFormatter: DateFormatter = {
|
||||||
|
let formatter = DateFormatter()
|
||||||
|
formatter.dateFormat = "yyyy-MM-dd HH:mm:ss.SSSS"
|
||||||
|
formatter.locale = Locale(identifier: "en_US_POSIX")
|
||||||
|
|
||||||
|
return formatter
|
||||||
|
}()
|
||||||
|
|
||||||
|
extension Date: NMBDoubleConvertible {
|
||||||
|
public var doubleValue: CDouble {
|
||||||
|
return self.timeIntervalSinceReferenceDate
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NSDate: NMBDoubleConvertible {
|
||||||
|
public var doubleValue: CDouble {
|
||||||
|
return self.timeIntervalSinceReferenceDate
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Date: TestOutputStringConvertible {
|
||||||
|
public var testDescription: String {
|
||||||
|
return dateFormatter.string(from: self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NSDate: TestOutputStringConvertible {
|
||||||
|
public var testDescription: String {
|
||||||
|
return dateFormatter.string(from: Date(timeIntervalSinceReferenceDate: self.timeIntervalSinceReferenceDate))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Protocol for types to support beLessThan(), beLessThanOrEqualTo(),
|
||||||
|
/// beGreaterThan(), beGreaterThanOrEqualTo(), and equal() matchers.
|
||||||
|
///
|
||||||
|
/// Types that conform to Swift's Comparable protocol will work implicitly too
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
@objc public protocol NMBComparable {
|
||||||
|
func NMB_compare(_ otherObject: NMBComparable!) -> ComparisonResult
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
// This should become obsolete once Corelibs Foundation adds Comparable conformance to NSNumber
|
||||||
|
public protocol NMBComparable {
|
||||||
|
func NMB_compare(_ otherObject: NMBComparable!) -> ComparisonResult
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
extension NSNumber: NMBComparable {
|
||||||
|
public func NMB_compare(_ otherObject: NMBComparable!) -> ComparisonResult {
|
||||||
|
return compare(otherObject as! NSNumber)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
extension NSString: NMBComparable {
|
||||||
|
public func NMB_compare(_ otherObject: NMBComparable!) -> ComparisonResult {
|
||||||
|
return compare(otherObject as! String)
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,96 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
// A workaround to SR-6419.
|
||||||
|
extension NotificationCenter {
|
||||||
|
#if !(os(macOS) || os(iOS) || os(tvOS) || os(watchOS))
|
||||||
|
#if swift(>=4.0)
|
||||||
|
#if swift(>=4.0.2)
|
||||||
|
#else
|
||||||
|
func addObserver(forName name: Notification.Name?, object obj: Any?, queue: OperationQueue?, using block: @escaping (Notification) -> Void) -> NSObjectProtocol {
|
||||||
|
return addObserver(forName: name, object: obj, queue: queue, usingBlock: block)
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
#elseif swift(>=3.2)
|
||||||
|
#if swift(>=3.2.2)
|
||||||
|
#else
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
func addObserver(forName name: Notification.Name?, object obj: Any?, queue: OperationQueue?, using block: @escaping (Notification) -> Void) -> NSObjectProtocol {
|
||||||
|
return addObserver(forName: name, object: obj, queue: queue, usingBlock: block)
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
#else
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
func addObserver(forName name: Notification.Name?, object obj: Any?, queue: OperationQueue?, using block: @escaping (Notification) -> Void) -> NSObjectProtocol {
|
||||||
|
return addObserver(forName: name, object: obj, queue: queue, usingBlock: block)
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
|
internal class NotificationCollector {
|
||||||
|
private(set) var observedNotifications: [Notification]
|
||||||
|
private let notificationCenter: NotificationCenter
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
private var token: AnyObject?
|
||||||
|
#else
|
||||||
|
private var token: NSObjectProtocol?
|
||||||
|
#endif
|
||||||
|
|
||||||
|
required init(notificationCenter: NotificationCenter) {
|
||||||
|
self.notificationCenter = notificationCenter
|
||||||
|
self.observedNotifications = []
|
||||||
|
}
|
||||||
|
|
||||||
|
func startObserving() {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
self.token = self.notificationCenter.addObserver(forName: nil, object: nil, queue: nil, using: { [weak self] n in
|
||||||
|
// linux-swift gets confused by .append(n)
|
||||||
|
self?.observedNotifications.append(n)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
deinit {
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
if let token = self.token {
|
||||||
|
self.notificationCenter.removeObserver(token)
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
if let token = self.token as? AnyObject {
|
||||||
|
self.notificationCenter.removeObserver(token)
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private let mainThread = pthread_self()
|
||||||
|
|
||||||
|
public func postNotifications<T>(
|
||||||
|
_ notificationsMatcher: T,
|
||||||
|
fromNotificationCenter center: NotificationCenter = .default)
|
||||||
|
-> Predicate<Any>
|
||||||
|
where T: Matcher, T.ValueType == [Notification]
|
||||||
|
{
|
||||||
|
_ = mainThread // Force lazy-loading of this value
|
||||||
|
let collector = NotificationCollector(notificationCenter: center)
|
||||||
|
collector.startObserving()
|
||||||
|
var once: Bool = false
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
let collectorNotificationsExpression = Expression(memoizedExpression: { _ in
|
||||||
|
return collector.observedNotifications
|
||||||
|
}, location: actualExpression.location, withoutCaching: true)
|
||||||
|
|
||||||
|
assert(pthread_equal(mainThread, pthread_self()) != 0, "Only expecting closure to be evaluated on main thread.")
|
||||||
|
if !once {
|
||||||
|
once = true
|
||||||
|
_ = try actualExpression.evaluate()
|
||||||
|
}
|
||||||
|
|
||||||
|
let match = try notificationsMatcher.matches(collectorNotificationsExpression, failureMessage: failureMessage)
|
||||||
|
if collector.observedNotifications.isEmpty {
|
||||||
|
failureMessage.actualValue = "no notifications"
|
||||||
|
} else {
|
||||||
|
failureMessage.actualValue = "<\(stringify(collector.observedNotifications))>"
|
||||||
|
}
|
||||||
|
return match
|
||||||
|
}
|
||||||
|
}
|
348
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Predicate.swift
vendored
Normal file
348
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/Predicate.swift
vendored
Normal file
|
@ -0,0 +1,348 @@
|
||||||
|
// New Matcher API
|
||||||
|
//
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Predicate is part of the new matcher API that provides assertions to expectations.
|
||||||
|
///
|
||||||
|
/// Given a code snippet:
|
||||||
|
///
|
||||||
|
/// expect(1).to(equal(2))
|
||||||
|
/// ^^^^^^^^
|
||||||
|
/// Called a "matcher"
|
||||||
|
///
|
||||||
|
/// A matcher consists of two parts a constructor function and the Predicate. The term Predicate
|
||||||
|
/// is used as a separate name from Matcher to help transition custom matchers to the new Nimble
|
||||||
|
/// matcher API.
|
||||||
|
///
|
||||||
|
/// The Predicate provide the heavy lifting on how to assert against a given value. Internally,
|
||||||
|
/// predicates are simple wrappers around closures to provide static type information and
|
||||||
|
/// allow composition and wrapping of existing behaviors.
|
||||||
|
public struct Predicate<T> {
|
||||||
|
fileprivate var matcher: (Expression<T>) throws -> PredicateResult
|
||||||
|
|
||||||
|
/// Constructs a predicate that knows how take a given value
|
||||||
|
public init(_ matcher: @escaping (Expression<T>) throws -> PredicateResult) {
|
||||||
|
self.matcher = matcher
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Uses a predicate on a given value to see if it passes the predicate.
|
||||||
|
///
|
||||||
|
/// @param expression The value to run the predicate's logic against
|
||||||
|
/// @returns A predicate result indicate passing or failing and an associated error message.
|
||||||
|
public func satisfies(_ expression: Expression<T>) throws -> PredicateResult {
|
||||||
|
return try matcher(expression)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Provides convenience helpers to defining predicates
|
||||||
|
extension Predicate {
|
||||||
|
/// Like Predicate() constructor, but automatically guard against nil (actual) values
|
||||||
|
public static func define(matcher: @escaping (Expression<T>) throws -> PredicateResult) -> Predicate<T> {
|
||||||
|
return Predicate<T> { actual in
|
||||||
|
return try matcher(actual)
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Defines a predicate with a default message that can be returned in the closure
|
||||||
|
/// Also ensures the predicate's actual value cannot pass with `nil` given.
|
||||||
|
public static func define(_ msg: String, matcher: @escaping (Expression<T>, ExpectationMessage) throws -> PredicateResult) -> Predicate<T> {
|
||||||
|
return Predicate<T> { actual in
|
||||||
|
return try matcher(actual, .expectedActualValueTo(msg))
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Defines a predicate with a default message that can be returned in the closure
|
||||||
|
/// Unlike `define`, this allows nil values to succeed if the given closure chooses to.
|
||||||
|
public static func defineNilable(_ msg: String, matcher: @escaping (Expression<T>, ExpectationMessage) throws -> PredicateResult) -> Predicate<T> {
|
||||||
|
return Predicate<T> { actual in
|
||||||
|
return try matcher(actual, .expectedActualValueTo(msg))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Predicate {
|
||||||
|
/// Provides a simple predicate definition that provides no control over the predefined
|
||||||
|
/// error message.
|
||||||
|
///
|
||||||
|
/// Also ensures the predicate's actual value cannot pass with `nil` given.
|
||||||
|
public static func simple(_ msg: String, matcher: @escaping (Expression<T>) throws -> PredicateStatus) -> Predicate<T> {
|
||||||
|
return Predicate<T> { actual in
|
||||||
|
return PredicateResult(status: try matcher(actual), message: .expectedActualValueTo(msg))
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Provides a simple predicate definition that provides no control over the predefined
|
||||||
|
/// error message.
|
||||||
|
///
|
||||||
|
/// Unlike `simple`, this allows nil values to succeed if the given closure chooses to.
|
||||||
|
public static func simpleNilable(_ msg: String, matcher: @escaping (Expression<T>) throws -> PredicateStatus) -> Predicate<T> {
|
||||||
|
return Predicate<T> { actual in
|
||||||
|
return PredicateResult(status: try matcher(actual), message: .expectedActualValueTo(msg))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The Expectation style intended for comparison to a PredicateStatus.
|
||||||
|
public enum ExpectationStyle {
|
||||||
|
case toMatch, toNotMatch
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The value that a Predicates return to describe if the given (actual) value matches the
|
||||||
|
/// predicate.
|
||||||
|
public struct PredicateResult {
|
||||||
|
/// Status indicates if the predicate matches, does not match, or fails.
|
||||||
|
public var status: PredicateStatus
|
||||||
|
/// The error message that can be displayed if it does not match
|
||||||
|
public var message: ExpectationMessage
|
||||||
|
|
||||||
|
/// Constructs a new PredicateResult with a given status and error message
|
||||||
|
public init(status: PredicateStatus, message: ExpectationMessage) {
|
||||||
|
self.status = status
|
||||||
|
self.message = message
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Shorthand to PredicateResult(status: PredicateStatus(bool: bool), message: message)
|
||||||
|
public init(bool: Bool, message: ExpectationMessage) {
|
||||||
|
self.status = PredicateStatus(bool: bool)
|
||||||
|
self.message = message
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts the result to a boolean based on what the expectation intended
|
||||||
|
public func toBoolean(expectation style: ExpectationStyle) -> Bool {
|
||||||
|
return status.toBoolean(expectation: style)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// PredicateStatus is a trinary that indicates if a Predicate matches a given value or not
|
||||||
|
public enum PredicateStatus {
|
||||||
|
/// Matches indicates if the predicate / matcher passes with the given value
|
||||||
|
///
|
||||||
|
/// For example, `equals(1)` returns `.matches` for `expect(1).to(equal(1))`.
|
||||||
|
case matches
|
||||||
|
/// DoesNotMatch indicates if the predicate / matcher fails with the given value, but *would*
|
||||||
|
/// succeed if the expectation was inverted.
|
||||||
|
///
|
||||||
|
/// For example, `equals(2)` returns `.doesNotMatch` for `expect(1).toNot(equal(2))`.
|
||||||
|
case doesNotMatch
|
||||||
|
/// Fail indicates the predicate will never satisfy with the given value in any case.
|
||||||
|
/// A perfect example is that most matchers fail whenever given `nil`.
|
||||||
|
///
|
||||||
|
/// Using `equal(1)` fails both `expect(nil).to(equal(1))` and `expect(nil).toNot(equal(1))`.
|
||||||
|
/// Note: Predicate's `requireNonNil` property will also provide this feature mostly for free.
|
||||||
|
/// Your predicate will still need to guard against nils, but error messaging will be
|
||||||
|
/// handled for you.
|
||||||
|
case fail
|
||||||
|
|
||||||
|
/// Converts a boolean to either .matches (if true) or .doesNotMatch (if false).
|
||||||
|
public init(bool matches: Bool) {
|
||||||
|
if matches {
|
||||||
|
self = .matches
|
||||||
|
} else {
|
||||||
|
self = .doesNotMatch
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private func shouldMatch() -> Bool {
|
||||||
|
switch self {
|
||||||
|
case .matches: return true
|
||||||
|
case .doesNotMatch, .fail: return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private func shouldNotMatch() -> Bool {
|
||||||
|
switch self {
|
||||||
|
case .doesNotMatch: return true
|
||||||
|
case .matches, .fail: return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts the PredicateStatus result to a boolean based on what the expectation intended
|
||||||
|
internal func toBoolean(expectation style: ExpectationStyle) -> Bool {
|
||||||
|
if style == .toMatch {
|
||||||
|
return shouldMatch()
|
||||||
|
} else {
|
||||||
|
return shouldNotMatch()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Backwards compatibility until Old Matcher API removal
|
||||||
|
extension Predicate: Matcher {
|
||||||
|
/// Compatibility layer for old Matcher API, deprecated
|
||||||
|
public static func fromDeprecatedFullClosure(_ matcher: @escaping (Expression<T>, FailureMessage, Bool) throws -> Bool) -> Predicate {
|
||||||
|
return Predicate { actual in
|
||||||
|
let failureMessage = FailureMessage()
|
||||||
|
let result = try matcher(actual, failureMessage, true)
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: result),
|
||||||
|
message: failureMessage.toExpectationMessage()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compatibility layer for old Matcher API, deprecated.
|
||||||
|
/// Emulates the MatcherFunc API
|
||||||
|
public static func fromDeprecatedClosure(_ matcher: @escaping (Expression<T>, FailureMessage) throws -> Bool) -> Predicate {
|
||||||
|
return Predicate { actual in
|
||||||
|
let failureMessage = FailureMessage()
|
||||||
|
let result = try matcher(actual, failureMessage)
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: result),
|
||||||
|
message: failureMessage.toExpectationMessage()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compatibility layer for old Matcher API, deprecated.
|
||||||
|
/// Same as calling .predicate on a MatcherFunc or NonNilMatcherFunc type.
|
||||||
|
public static func fromDeprecatedMatcher<M>(_ matcher: M) -> Predicate where M: Matcher, M.ValueType == T {
|
||||||
|
return self.fromDeprecatedFullClosure(matcher.toClosure)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deprecated Matcher API, use satisfies(_:_) instead
|
||||||
|
public func matches(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
let result = try satisfies(actualExpression)
|
||||||
|
result.message.update(failureMessage: failureMessage)
|
||||||
|
return result.toBoolean(expectation: .toMatch)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deprecated Matcher API, use satisfies(_:_) instead
|
||||||
|
public func doesNotMatch(_ actualExpression: Expression<T>, failureMessage: FailureMessage) throws -> Bool {
|
||||||
|
let result = try satisfies(actualExpression)
|
||||||
|
result.message.update(failureMessage: failureMessage)
|
||||||
|
return result.toBoolean(expectation: .toNotMatch)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension Predicate {
|
||||||
|
// Someday, make this public? Needs documentation
|
||||||
|
internal func after(f: @escaping (Expression<T>, PredicateResult) throws -> PredicateResult) -> Predicate<T> {
|
||||||
|
return Predicate { actual -> PredicateResult in
|
||||||
|
let result = try self.satisfies(actual)
|
||||||
|
return try f(actual, result)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a new Predicate based on the current one that always fails if nil is given as
|
||||||
|
/// the actual value.
|
||||||
|
///
|
||||||
|
/// This replaces `NonNilMatcherFunc`.
|
||||||
|
public var requireNonNil: Predicate<T> {
|
||||||
|
return after { actual, result in
|
||||||
|
if try actual.evaluate() == nil {
|
||||||
|
return PredicateResult(
|
||||||
|
status: .fail,
|
||||||
|
message: result.message.appendedBeNilHint()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
public typealias PredicateBlock = (_ actualExpression: Expression<NSObject>) -> NMBPredicateResult
|
||||||
|
|
||||||
|
public class NMBPredicate: NSObject {
|
||||||
|
private let predicate: PredicateBlock
|
||||||
|
|
||||||
|
public init(predicate: @escaping PredicateBlock) {
|
||||||
|
self.predicate = predicate
|
||||||
|
}
|
||||||
|
|
||||||
|
func satisfies(_ expression: @escaping () -> NSObject?, location: SourceLocation) -> NMBPredicateResult {
|
||||||
|
let expr = Expression(expression: expression, location: location)
|
||||||
|
return self.predicate(expr)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NMBPredicate: NMBMatcher {
|
||||||
|
public func matches(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let result = satisfies(actualBlock, location: location).toSwift()
|
||||||
|
result.message.update(failureMessage: failureMessage)
|
||||||
|
return result.status.toBoolean(expectation: .toMatch)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func doesNotMatch(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let result = satisfies(actualBlock, location: location).toSwift()
|
||||||
|
result.message.update(failureMessage: failureMessage)
|
||||||
|
return result.status.toBoolean(expectation: .toNotMatch)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
final public class NMBPredicateResult: NSObject {
|
||||||
|
public var status: NMBPredicateStatus
|
||||||
|
public var message: NMBExpectationMessage
|
||||||
|
|
||||||
|
public init(status: NMBPredicateStatus, message: NMBExpectationMessage) {
|
||||||
|
self.status = status
|
||||||
|
self.message = message
|
||||||
|
}
|
||||||
|
|
||||||
|
public init(bool success: Bool, message: NMBExpectationMessage) {
|
||||||
|
self.status = NMBPredicateStatus.from(bool: success)
|
||||||
|
self.message = message
|
||||||
|
}
|
||||||
|
|
||||||
|
public func toSwift() -> PredicateResult {
|
||||||
|
return PredicateResult(status: status.toSwift(),
|
||||||
|
message: message.toSwift())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension PredicateResult {
|
||||||
|
public func toObjectiveC() -> NMBPredicateResult {
|
||||||
|
return NMBPredicateResult(status: status.toObjectiveC(), message: message.toObjectiveC())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
final public class NMBPredicateStatus: NSObject {
|
||||||
|
private let status: Int
|
||||||
|
private init(status: Int) {
|
||||||
|
self.status = status
|
||||||
|
}
|
||||||
|
|
||||||
|
public static let matches: NMBPredicateStatus = NMBPredicateStatus(status: 0)
|
||||||
|
public static let doesNotMatch: NMBPredicateStatus = NMBPredicateStatus(status: 1)
|
||||||
|
public static let fail: NMBPredicateStatus = NMBPredicateStatus(status: 2)
|
||||||
|
|
||||||
|
public override var hashValue: Int { return self.status.hashValue }
|
||||||
|
|
||||||
|
public override func isEqual(_ object: Any?) -> Bool {
|
||||||
|
guard let otherPredicate = object as? NMBPredicateStatus else {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
return self.status == otherPredicate.status
|
||||||
|
}
|
||||||
|
|
||||||
|
public static func from(status: PredicateStatus) -> NMBPredicateStatus {
|
||||||
|
switch status {
|
||||||
|
case .matches: return self.matches
|
||||||
|
case .doesNotMatch: return self.doesNotMatch
|
||||||
|
case .fail: return self.fail
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static func from(bool success: Bool) -> NMBPredicateStatus {
|
||||||
|
return self.from(status: PredicateStatus(bool: success))
|
||||||
|
}
|
||||||
|
|
||||||
|
public func toSwift() -> PredicateStatus {
|
||||||
|
switch status {
|
||||||
|
case NMBPredicateStatus.matches.status: return .matches
|
||||||
|
case NMBPredicateStatus.doesNotMatch.status: return .doesNotMatch
|
||||||
|
case NMBPredicateStatus.fail.status: return .fail
|
||||||
|
default:
|
||||||
|
internalError("Unhandle status for NMBPredicateStatus")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension PredicateStatus {
|
||||||
|
public func toObjectiveC() -> NMBPredicateStatus {
|
||||||
|
return NMBPredicateStatus.from(status: self)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,198 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
// This matcher requires the Objective-C, and being built by Xcode rather than the Swift Package Manager
|
||||||
|
#if (os(macOS) || os(iOS) || os(tvOS) || os(watchOS)) && !SWIFT_PACKAGE
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual expression raises an
|
||||||
|
/// exception with the specified name, reason, and/or userInfo.
|
||||||
|
///
|
||||||
|
/// Alternatively, you can pass a closure to do any arbitrary custom matching
|
||||||
|
/// to the raised exception. The closure only gets called when an exception
|
||||||
|
/// is raised.
|
||||||
|
///
|
||||||
|
/// nil arguments indicates that the matcher should not attempt to match against
|
||||||
|
/// that parameter.
|
||||||
|
public func raiseException(
|
||||||
|
named: String? = nil,
|
||||||
|
reason: String? = nil,
|
||||||
|
userInfo: NSDictionary? = nil,
|
||||||
|
closure: ((NSException) -> Void)? = nil) -> Predicate<Any> {
|
||||||
|
return Predicate.fromDeprecatedClosure { actualExpression, failureMessage in
|
||||||
|
|
||||||
|
var exception: NSException?
|
||||||
|
let capture = NMBExceptionCapture(handler: ({ e in
|
||||||
|
exception = e
|
||||||
|
}), finally: nil)
|
||||||
|
|
||||||
|
capture.tryBlock {
|
||||||
|
_ = try! actualExpression.evaluate()
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
setFailureMessageForException(
|
||||||
|
failureMessage,
|
||||||
|
exception: exception,
|
||||||
|
named: named,
|
||||||
|
reason: reason,
|
||||||
|
userInfo: userInfo,
|
||||||
|
closure: closure
|
||||||
|
)
|
||||||
|
return exceptionMatchesNonNilFieldsOrClosure(
|
||||||
|
exception,
|
||||||
|
named: named,
|
||||||
|
reason: reason,
|
||||||
|
userInfo: userInfo,
|
||||||
|
closure: closure
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// swiftlint:disable:next function_parameter_count
|
||||||
|
internal func setFailureMessageForException(
|
||||||
|
_ failureMessage: FailureMessage,
|
||||||
|
exception: NSException?,
|
||||||
|
named: String?,
|
||||||
|
reason: String?,
|
||||||
|
userInfo: NSDictionary?,
|
||||||
|
closure: ((NSException) -> Void)?) {
|
||||||
|
failureMessage.postfixMessage = "raise exception"
|
||||||
|
|
||||||
|
if let named = named {
|
||||||
|
failureMessage.postfixMessage += " with name <\(named)>"
|
||||||
|
}
|
||||||
|
if let reason = reason {
|
||||||
|
failureMessage.postfixMessage += " with reason <\(reason)>"
|
||||||
|
}
|
||||||
|
if let userInfo = userInfo {
|
||||||
|
failureMessage.postfixMessage += " with userInfo <\(userInfo)>"
|
||||||
|
}
|
||||||
|
if closure != nil {
|
||||||
|
failureMessage.postfixMessage += " that satisfies block"
|
||||||
|
}
|
||||||
|
if named == nil && reason == nil && userInfo == nil && closure == nil {
|
||||||
|
failureMessage.postfixMessage = "raise any exception"
|
||||||
|
}
|
||||||
|
|
||||||
|
if let exception = exception {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
failureMessage.actualValue = "\(String(describing: type(of: exception))) { name=\(exception.name), reason='\(stringify(exception.reason))', userInfo=\(stringify(exception.userInfo)) }"
|
||||||
|
} else {
|
||||||
|
failureMessage.actualValue = "no exception"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func exceptionMatchesNonNilFieldsOrClosure(
|
||||||
|
_ exception: NSException?,
|
||||||
|
named: String?,
|
||||||
|
reason: String?,
|
||||||
|
userInfo: NSDictionary?,
|
||||||
|
closure: ((NSException) -> Void)?) -> Bool {
|
||||||
|
var matches = false
|
||||||
|
|
||||||
|
if let exception = exception {
|
||||||
|
matches = true
|
||||||
|
|
||||||
|
if let named = named, exception.name.rawValue != named {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
if reason != nil && exception.reason != reason {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
if let userInfo = userInfo, let exceptionUserInfo = exception.userInfo,
|
||||||
|
(exceptionUserInfo as NSDictionary) != userInfo {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
if let closure = closure {
|
||||||
|
let assertions = gatherFailingExpectations {
|
||||||
|
closure(exception)
|
||||||
|
}
|
||||||
|
let messages = assertions.map { $0.message }
|
||||||
|
if messages.count > 0 {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return matches
|
||||||
|
}
|
||||||
|
|
||||||
|
public class NMBObjCRaiseExceptionMatcher: NSObject, NMBMatcher {
|
||||||
|
internal var _name: String?
|
||||||
|
internal var _reason: String?
|
||||||
|
internal var _userInfo: NSDictionary?
|
||||||
|
internal var _block: ((NSException) -> Void)?
|
||||||
|
|
||||||
|
internal init(name: String?, reason: String?, userInfo: NSDictionary?, block: ((NSException) -> Void)?) {
|
||||||
|
_name = name
|
||||||
|
_reason = reason
|
||||||
|
_userInfo = userInfo
|
||||||
|
_block = block
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public func matches(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
let block: () -> Any? = ({ _ = actualBlock(); return nil })
|
||||||
|
let expr = Expression(expression: block, location: location)
|
||||||
|
|
||||||
|
return try! raiseException(
|
||||||
|
named: _name,
|
||||||
|
reason: _reason,
|
||||||
|
userInfo: _userInfo,
|
||||||
|
closure: _block
|
||||||
|
).matches(expr, failureMessage: failureMessage)
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public func doesNotMatch(_ actualBlock: @escaping () -> NSObject?, failureMessage: FailureMessage, location: SourceLocation) -> Bool {
|
||||||
|
return !matches(actualBlock, failureMessage: failureMessage, location: location)
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var named: (_ name: String) -> NMBObjCRaiseExceptionMatcher {
|
||||||
|
return ({ name in
|
||||||
|
return NMBObjCRaiseExceptionMatcher(
|
||||||
|
name: name,
|
||||||
|
reason: self._reason,
|
||||||
|
userInfo: self._userInfo,
|
||||||
|
block: self._block
|
||||||
|
)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var reason: (_ reason: String?) -> NMBObjCRaiseExceptionMatcher {
|
||||||
|
return ({ reason in
|
||||||
|
return NMBObjCRaiseExceptionMatcher(
|
||||||
|
name: self._name,
|
||||||
|
reason: reason,
|
||||||
|
userInfo: self._userInfo,
|
||||||
|
block: self._block
|
||||||
|
)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var userInfo: (_ userInfo: NSDictionary?) -> NMBObjCRaiseExceptionMatcher {
|
||||||
|
return ({ userInfo in
|
||||||
|
return NMBObjCRaiseExceptionMatcher(
|
||||||
|
name: self._name,
|
||||||
|
reason: self._reason,
|
||||||
|
userInfo: userInfo,
|
||||||
|
block: self._block
|
||||||
|
)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
@objc public var satisfyingBlock: (_ block: ((NSException) -> Void)?) -> NMBObjCRaiseExceptionMatcher {
|
||||||
|
return ({ block in
|
||||||
|
return NMBObjCRaiseExceptionMatcher(
|
||||||
|
name: self._name,
|
||||||
|
reason: self._reason,
|
||||||
|
userInfo: self._userInfo,
|
||||||
|
block: block
|
||||||
|
)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func raiseExceptionMatcher() -> NMBObjCRaiseExceptionMatcher {
|
||||||
|
return NMBObjCRaiseExceptionMatcher(name: nil, reason: nil, userInfo: nil, block: nil)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
101
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/SatisfyAllOf.swift
vendored
Normal file
101
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/SatisfyAllOf.swift
vendored
Normal file
|
@ -0,0 +1,101 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value matches with all of the matchers
|
||||||
|
/// provided in the variable list of matchers.
|
||||||
|
public func satisfyAllOf<T, U>(_ matchers: U...) -> Predicate<T>
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
return satisfyAllOf(matchers)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deprecated. Please use `satisfyAnyOf<T>(_) -> Predicate<T>` instead.
|
||||||
|
internal func satisfyAllOf<T, U>(_ matchers: [U]) -> Predicate<T>
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
return NonNilMatcherFunc<T> { actualExpression, failureMessage in
|
||||||
|
let postfixMessages = NSMutableArray()
|
||||||
|
var matches = true
|
||||||
|
for matcher in matchers {
|
||||||
|
if try matcher.doesNotMatch(actualExpression, failureMessage: failureMessage) {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
postfixMessages.add(NSString(string: "{\(failureMessage.postfixMessage)}"))
|
||||||
|
}
|
||||||
|
|
||||||
|
failureMessage.postfixMessage = "match all of: " + postfixMessages.componentsJoined(by: ", and ")
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
failureMessage.actualValue = "\(actualValue)"
|
||||||
|
}
|
||||||
|
|
||||||
|
return matches
|
||||||
|
}.predicate
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func satisfyAllOf<T>(_ predicates: [Predicate<T>]) -> Predicate<T> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
var postfixMessages = [String]()
|
||||||
|
var matches = true
|
||||||
|
for predicate in predicates {
|
||||||
|
let result = try predicate.satisfies(actualExpression)
|
||||||
|
if result.toBoolean(expectation: .toNotMatch) {
|
||||||
|
matches = false
|
||||||
|
}
|
||||||
|
postfixMessages.append("{\(result.message.expectedMessage)}")
|
||||||
|
}
|
||||||
|
|
||||||
|
var msg: ExpectationMessage
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
msg = .expectedCustomValueTo(
|
||||||
|
"match all of: " + postfixMessages.joined(separator: ", and "),
|
||||||
|
"\(actualValue)"
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
msg = .expectedActualValueTo(
|
||||||
|
"match all of: " + postfixMessages.joined(separator: ", and ")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateResult(
|
||||||
|
bool: matches,
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func && <T>(left: Predicate<T>, right: Predicate<T>) -> Predicate<T> {
|
||||||
|
return satisfyAllOf(left, right)
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func satisfyAllOfMatcher(_ matchers: [NMBMatcher]) -> NMBPredicate {
|
||||||
|
return NMBPredicate { actualExpression in
|
||||||
|
if matchers.isEmpty {
|
||||||
|
return NMBPredicateResult(
|
||||||
|
status: NMBPredicateStatus.fail,
|
||||||
|
message: NMBExpectationMessage(
|
||||||
|
fail: "satisfyAllOf must be called with at least one matcher"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
var elementEvaluators = [Predicate<NSObject>]()
|
||||||
|
for matcher in matchers {
|
||||||
|
let elementEvaluator = Predicate<NSObject> { expression in
|
||||||
|
if let predicate = matcher as? NMBPredicate {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
return predicate.satisfies({ try! expression.evaluate() }, location: actualExpression.location).toSwift()
|
||||||
|
} else {
|
||||||
|
let failureMessage = FailureMessage()
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
let success = matcher.matches({ try! expression.evaluate() }, failureMessage: failureMessage, location: actualExpression.location)
|
||||||
|
return PredicateResult(bool: success, message: failureMessage.toExpectationMessage())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
elementEvaluators.append(elementEvaluator)
|
||||||
|
}
|
||||||
|
|
||||||
|
return try! satisfyAllOf(elementEvaluators).satisfies(actualExpression).toObjectiveC()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
109
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/SatisfyAnyOf.swift
vendored
Normal file
109
Carthage/Checkouts/Commandant/Carthage/Checkouts/Nimble/Sources/Nimble/Matchers/SatisfyAnyOf.swift
vendored
Normal file
|
@ -0,0 +1,109 @@
|
||||||
|
import Foundation
|
||||||
|
|
||||||
|
/// A Nimble matcher that succeeds when the actual value matches with any of the matchers
|
||||||
|
/// provided in the variable list of matchers.
|
||||||
|
public func satisfyAnyOf<T, U>(_ matchers: U...) -> Predicate<T>
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
return satisfyAnyOf(matchers)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deprecated. Please use `satisfyAnyOf<T>(_) -> Predicate<T>` instead.
|
||||||
|
internal func satisfyAnyOf<T, U>(_ matchers: [U]) -> Predicate<T>
|
||||||
|
where U: Matcher, U.ValueType == T {
|
||||||
|
return NonNilMatcherFunc<T> { actualExpression, failureMessage in
|
||||||
|
let postfixMessages = NSMutableArray()
|
||||||
|
var matches = false
|
||||||
|
for matcher in matchers {
|
||||||
|
if try matcher.matches(actualExpression, failureMessage: failureMessage) {
|
||||||
|
matches = true
|
||||||
|
}
|
||||||
|
postfixMessages.add(NSString(string: "{\(failureMessage.postfixMessage)}"))
|
||||||
|
}
|
||||||
|
|
||||||
|
failureMessage.postfixMessage = "match one of: " + postfixMessages.componentsJoined(by: ", or ")
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
failureMessage.actualValue = "\(actualValue)"
|
||||||
|
}
|
||||||
|
|
||||||
|
return matches
|
||||||
|
}.predicate
|
||||||
|
}
|
||||||
|
|
||||||
|
internal func satisfyAnyOf<T>(_ predicates: [Predicate<T>]) -> Predicate<T> {
|
||||||
|
return Predicate { actualExpression in
|
||||||
|
var postfixMessages = [String]()
|
||||||
|
var matches = false
|
||||||
|
for predicate in predicates {
|
||||||
|
let result = try predicate.satisfies(actualExpression)
|
||||||
|
if result.toBoolean(expectation: .toMatch) {
|
||||||
|
matches = true
|
||||||
|
}
|
||||||
|
postfixMessages.append("{\(result.message.expectedMessage)}")
|
||||||
|
}
|
||||||
|
|
||||||
|
var msg: ExpectationMessage
|
||||||
|
if let actualValue = try actualExpression.evaluate() {
|
||||||
|
msg = .expectedCustomValueTo(
|
||||||
|
"match one of: " + postfixMessages.joined(separator: ", or "),
|
||||||
|
"\(actualValue)"
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
msg = .expectedActualValueTo(
|
||||||
|
"match one of: " + postfixMessages.joined(separator: ", or ")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return PredicateResult(
|
||||||
|
status: PredicateStatus(bool: matches),
|
||||||
|
message: msg
|
||||||
|
)
|
||||||
|
}.requireNonNil
|
||||||
|
}
|
||||||
|
|
||||||
|
public func || <T>(left: Predicate<T>, right: Predicate<T>) -> Predicate<T> {
|
||||||
|
return satisfyAnyOf(left, right)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func || <T>(left: NonNilMatcherFunc<T>, right: NonNilMatcherFunc<T>) -> Predicate<T> {
|
||||||
|
return satisfyAnyOf(left, right)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func || <T>(left: MatcherFunc<T>, right: MatcherFunc<T>) -> Predicate<T> {
|
||||||
|
return satisfyAnyOf(left, right)
|
||||||
|
}
|
||||||
|
|
||||||
|
#if os(macOS) || os(iOS) || os(tvOS) || os(watchOS)
|
||||||
|
extension NMBObjCMatcher {
|
||||||
|
@objc public class func satisfyAnyOfMatcher(_ matchers: [NMBMatcher]) -> NMBPredicate {
|
||||||
|
return NMBPredicate { actualExpression in
|
||||||
|
if matchers.isEmpty {
|
||||||
|
return NMBPredicateResult(
|
||||||
|
status: NMBPredicateStatus.fail,
|
||||||
|
message: NMBExpectationMessage(
|
||||||
|
fail: "satisfyAnyOf must be called with at least one matcher"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
var elementEvaluators = [Predicate<NSObject>]()
|
||||||
|
for matcher in matchers {
|
||||||
|
let elementEvaluator = Predicate<NSObject> { expression in
|
||||||
|
if let predicate = matcher as? NMBPredicate {
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
return predicate.satisfies({ try! expression.evaluate() }, location: actualExpression.location).toSwift()
|
||||||
|
} else {
|
||||||
|
let failureMessage = FailureMessage()
|
||||||
|
// swiftlint:disable:next line_length
|
||||||
|
let success = matcher.matches({ try! expression.evaluate() }, failureMessage: failureMessage, location: actualExpression.location)
|
||||||
|
return PredicateResult(bool: success, message: failureMessage.toExpectationMessage())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
elementEvaluators.append(elementEvaluator)
|
||||||
|
}
|
||||||
|
|
||||||
|
return try! satisfyAnyOf(elementEvaluators).satisfies(actualExpression).toObjectiveC()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue