Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/khoi-backyard/SwiftlyExt

SwiftlyExt is a collection of useful extensions for Swift 3 standard classes and types 🚀
https://github.com/khoi-backyard/SwiftlyExt

carthage cocoadocs cocoapods extension extensions functional functional-programming swift swift-3 swift-framework swift-library swift-package-manager swift3 xcode

Last synced: 3 months ago
JSON representation

SwiftlyExt is a collection of useful extensions for Swift 3 standard classes and types 🚀

Host: GitHub
URL: https://github.com/khoi-backyard/SwiftlyExt
Owner: khoi-backyard
License: mit
Created: 2016-09-20T09:29:44.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2017-03-15T07:36:20.000Z (over 7 years ago)
Last Synced: 2024-07-29T01:35:40.120Z (3 months ago)
Topics: carthage, cocoadocs, cocoapods, extension, extensions, functional, functional-programming, swift, swift-3, swift-framework, swift-library, swift-package-manager, swift3, xcode
Language: Swift
Homepage: http://cocoadocs.org/docsets/SwiftlyExt/
Size: 130 KB
Stars: 31
Watchers: 3
Forks: 3
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-macOS - SwiftlyExt - SwiftlyExt is a set of useful extensions for Swift 3 standard classes and types. 🔶 (Uncategorized / Uncategorized)

README

        ![](Logo/logo.png)

[![Build Status](https://travis-ci.org/khoiln/SwiftlyExt.svg?branch=master)](https://travis-ci.org/khoiln/SwiftlyExt)

[![codecov](https://codecov.io/gh/khoiln/SwiftlyExt/branch/master/graph/badge.svg)](https://codecov.io/gh/khoiln/SwiftlyExt)

[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/SwiftlyExt.svg)](https://img.shields.io/cocoapods/v/SwiftlyExt.svg)

[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

![Swift 3.0.x](https://img.shields.io/badge/Swift-3.0.x-orange.svg)

[![Platform](https://img.shields.io/cocoapods/p/SwiftlyExt.svg?style=flat)](http://cocoadocs.org/docsets/SwiftlyExt)

[![MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)

SwiftlyExt is a library that extends certain Swift standard types and classes using extension feature in the Swift language.

- [Requirements](#requirements)

- [Installation](#installation)

- [Documentation via CocoaDocs](http://cocoadocs.org/docsets/SwiftlyExt/)

- [FAQ](#faq)

- [License](#license)

## Requirements

- iOS 9.0+ / macOS 10.11+ / tvOS 9.0+ / watchOS 2.0+

- Xcode 8.0+

- Swift 3.0+

## Installation

### CocoaPods

[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:

```bash

$ gem install cocoapods

```

> CocoaPods 1.1.0+ is required to build SwiftlyExt.

To integrate SwiftlyExt into your Xcode project using CocoaPods, specify it in your `Podfile`:

```ruby

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '10.0'

use_frameworks!

target '' do

    pod 'SwiftlyExt', '~> 1.3'

end

```

Then, run the following command:

```bash

$ pod install

```

### Carthage

[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with [Homebrew](http://brew.sh/) using the following command:

```bash

$ brew update

$ brew install carthage

```

To integrate SwiftlyExt into your Xcode project using Carthage, specify it in your `Cartfile`:

```ogdl

github "khoiln/SwiftlyExt" ~> 1.3

```

Run `carthage update` to build the framework and drag the built `SwiftlyExt.framework` into your Xcode project. U

### Swift Package Manager

Adding SwiftlyExt as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift` file.

```swift

dependencies: [

    .Package(url: "https://github.com/khoiln/SwiftlyExt.git", majorVersion: 1)

]

```

Note that the [Swift Package Manager](https://swift.org/package-manager/) is still in early design and development, but SwiftlyExt does support its use on supported platforms.

## Usage

There are many handy usages of `SwiftlyExt`, head over [CocoaDocs](http://cocoadocs.org/docsets/SwiftlyExt/) for the comprehensive documentation.

We'll try to list some of the cool examples here.

### Array Extensions

```swift

[😀,🤡,❤️,💋].sample() // Return a random element

// => 💋

[😀,🤡,❤️,💋].sampleSize(2) // Return n random elements

// => [🤡, 💋]

[1, 2, 3, 4, 5].dropWhile { $0 < 3 } //Drop elements that passes the predicate from the beginning to end

// => [3, 4, 5]

[1, 2, 3, 4, 5].dropWhile { $0 < 3 }.some {$0 % 2 == 0} //And YES you can use method chaining too 👍

// => true

[0, 11, 28, 10].every { $0 % 2 == 0 } //Check if all elements in the array passed the condition

// => false

[0, 11, 28, 10].some { $0 % 2 != 0 } //Check if one of the element passes the condition

// => true

[1, 2, 3, 4, 5].findLastIndex {$0 % 2 == 0} //Find index of the last number which predicate return true for.

// => 3 

[1, 2, 3, 4, 5].groupBy { $0 % 2 == 0 ? "even" : "odd"} //Group common elements from an array to a dictionary of [Hashable : [Element]]

// => ["even": [2,4], "odd": [1,3,5]]

// Any many more....

```

### Date Extensions

```swift

let now = Date()

let tmr = now.date(byAddingDays: 1)

             .date(byAddingMinutes: 20) // You could also add year, month... and other time units

now.isBefore(tmr) 

// => true

now?.toString(format: "dd/MM/yyyy HH:mm:ss") // Return the string representation for a date.

// => "03/15/2017 14:34:22"

tmr.year == 2017 // Access time unit properties

tmr.hour == 14

tmr.minute == 54

```

### String Extensions

```swift

"John Doe".initials // Return the initials of the String

// => "JD"

"[email protected]".isEmail // Email validation

// => true

"
💯
".between("", "") // Find the string between two string

// => "💯" 

"01/01/1970 00:34:22".date(format: "dd/MM/yyyy HH:mm:ss") // Return a date from current string

// => Date("01/01/1970 00:34:22")

"https://github.com/Swiftly".base64Encoded // Return base64encoded string

// => "aHR0cHM6Ly9naXRodWIuY29tL1N3aWZ0bHk="

"\n\n\n Swiftly    ".trimmed.reversed // Trim newline and spaces and reverse the string

// => "yltfiwS"

"Swiftly\t\nString\nTest".urlEncoded // URL Encoded

// => "Swiftly%09%0AString%0ATest"

"https%3A%2F%2Fgithub.com%2Fkhoiln%2FSwiftlyEXT".urlDecoded // URL Decoded

// => "https://github.com/khoiln/SwiftlyEXT"

// Any many more....

```

### Int Extensions

```swift

1.upTo(3) { print($0) } 

// print 1, 2, 3

5.times { print("🐶") } // Run a block n times

// print 🐶 5 times

1234.digits() // Convert integer to array of digits

// => [1,2,3,4]

201.isIn(range: 200..<300) // Test whether a int is in a range

// => true

// And many more

```

## How to contribute

Any help or feedback is highly appreciated. Please refer to the [contributing guidelines](https://github.com/khoiln/SwiftlyExt/blob/master/CONTRIBUTING.md) for more information.

## License

SwiftyExt is released under the MIT license. See [LICENSE](https://github.com/khoiln/SwiftlyExt/blob/master/LICENSE) for details.