Skip to content

Commit

Permalink
Add README
Browse files Browse the repository at this point in the history
  • Loading branch information
jeffh committed Feb 27, 2016
1 parent 8f6c1a2 commit cceab41
Showing 1 changed file with 90 additions and 0 deletions.
90 changes: 90 additions & 0 deletions README.md
@@ -0,0 +1,90 @@
Snorlax
=======

The ultimate lazy library. Can cause a thread to sleep for a random amount of
time.


This looks useless, what is this really?
----------------------------------------

Snorlax is a good citizen in the Swift ecosystem. It's a reference
implementation to support as many different platforms as possible.

Snorlax currently supports the following platforms:

- Mac OS X
- iOS
- tvOS
- watchOS
- Linux

Using the following Package Managers:

- [Cocoapods](https://cocoapods.org/)
- [Carthage](https://github.com/Carthage/Carthage)
- [Swift Package Manager](https://swift.org/package-manager/)
- Adding as an Xcode Subproject

Can I try installing it?
========================

Sure, use your favorite package manager. Please note the two different versions:

- Odd minor versions (eg - `0.1.0`) require no dependencies. The latest one is `0.1.0`.
- Even minor versions (eg - `0.2.0`) has dependencies. The latest one is `0.2.0`.

Cocoapods
---------

Add Snorlax to your pod file and run `pod install`:

```ruby
# Cocoapods
pod 'Snorlax', '~> 0.1.0'
```

Carthage
--------

Add Snorlax to your `Cartfile` (package dependency) or `Cartfile.private`
(development dependency):

```
github "jeffh/Snorlax" ~> 0.1.0
```

Swift Package Manager
---------------------

Add to your `Package.swift` dependencies:

```swift
import PackageDescription

let package = Package(
// ... your project details
dependencies: [
// As a required dependency
.Package(url: "ssh://git@github.com/jeffh/Snorlax.git", majorVersion: 0)
],
testDependencise: [
// As a test dependency
.Package(url: "ssh://git@github.com/jeffh/Snorlax.git", majorVersion: 0)
]
)
```

Manually as an Xcode Subproject
-------------------------------

TODO


Contributions
=============

See
[CONTRIBUTING](https://github.com/jeffh/Snorlax/blob/master/CONTRIBUTING.md).
Documentation improvements and translations are welcomed!

0 comments on commit cceab41

Please sign in to comment.