Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/marty-suzuki/DuctTape

πŸ“¦ KeyPath dynamicMemberLookup based syntax sugar for Swift.
https://github.com/marty-suzuki/DuctTape

carthage cocoapods ios keypath-dynamicmemberlookup macos swift swift-package-manager syntax-sugar tvos watchos

Last synced: 3 days ago
JSON representation

πŸ“¦ KeyPath dynamicMemberLookup based syntax sugar for Swift.

Awesome Lists containing this project

README

        

# DuctTape


CI Status
Pod
CarthageSwiftPM


Swift5
Platform
License

πŸ“¦ KeyPath dynamicMemberLookup based syntax sugar for Swift.

```swift
let label: UILabel = UILabel().ductTape
.numberOfLines(0)
.textColor(.red)
.text("Hello, World!!")
```

Above is same as below definition.

```swift
let label: UILabel = {
let label = UILabel()
label.numberOfLines = 0
label.textColor = .red
label.text = "Hello, World!!"
return label
}()
```

## Usage

NSObject already has been compatible with DuctTape, so you can access `.ductTape` property like below.

```swift
let builder: Builder = UIView().ductTape
```

If you access `.ductTape`, it returns `Builder` that provides setter of properties via KeyPath dynamicMemberLookup.

```swift
let view: UIView = UIView().ductTape
.backgroundColor(.red)
.translatesAutoresizingMaskIntoConstraints(false)
```

#### How to access methods

If you want to access methods of object which is building, `func reinforce(_ handler: (Base) -> Void) Builder` enable to access methods.

```swift
let collectionView: UICollectionView = UICollectionView().ductTape
.backgroundColor(.red)
.reinforce { collectionView in
collectionView.register(UITableViewCell.self, forCellWithReuseIdentifier: "Cell")
}
```

`Builder` has `func reinforce(_ t1: T1, ..., handler: (Base) -> Void) Builder` methods.
In additional usage, be able to access outside object with `func reinforce` if passing objects as arguments.

```swift
lazy var collectionView: UICollectionView = UICollectionView().ductTape
.translatesAutoresizingMaskIntoConstraints(false)
.reinforce(view) { collectionView, view in
view.addSubview(collectionView)
NSLayoutConstraint.activate([
view.topAnchor.constraint(equalTo: collectionView.topAnchor),
view.leadingAnchor.constraint(equalTo: collectionView.leadingAnchor),
view.trailingAnchor.constraint(equalTo: collectionView.trailingAnchor),
view.bottomAnchor.constraint(equalTo: collectionView.bottomAnchor)
])
}
```

#### How to use DuctTape with self-implemented classes

There are two ways to use DuctTape.

1. Use DuctTapeCompatible

```swift
class Dog: DuctTapeCompatible {
var name: String
}

let dog: Dog = Dog().ductTape
.name("Copernicus")
```

2. Use Builder directly

```swift
class Dog {
var name: String
}

let dog: Dog = Builder(Dog())
.name("Copernicus")
```

#### Sample Code

```swift
class ViewController: UIViewController {

let flowLayout: UICollectionViewFlowLayout = UICollectionViewFlowLayout()
.ductTape
.minimumLineSpacing(10)
.minimumInteritemSpacing(10)
.itemSize(CGSize(width: 100, height: 100))
.scrollDirection(.vertical)

lazy var collectionView: UICollectionView = UICollectionView(frame: .zero,
collectionViewLayout: flowLayout)
.ductTape
.dataSource(self)
.delegate(self)
.translatesAutoresizingMaskIntoConstraints(false)
.reinforce {
$0.register(UICollectionViewCell.self, forCellWithReuseIdentifier: "Cell")
}

override func viewDidLoad() {
super.viewDidLoad()

view.addSubview(collectionView)
NSLayoutConstraint.activate([
view.topAnchor.constraint(equalTo: collectionView.topAnchor),
view.leadingAnchor.constraint(equalTo: collectionView.leadingAnchor),
view.trailingAnchor.constraint(equalTo: collectionView.trailingAnchor),
view.bottomAnchor.constraint(equalTo: collectionView.bottomAnchor)
])
}
}
```

## Requirement

- Xcode 11
- macOS 10.10
- iOS 9.0
- tvOS 10.0
- watchOS 3.0

## Installation

#### CocoaPods

DuctTape is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your `Podfile`:

```ruby
pod "DuctTape"
```

#### Carthage

If you’re using [Carthage](https://github.com/Carthage/Carthage), simply add
DuctTape to your `Cartfile`:

```
github "marty-suzuki/DuctTape"
```

#### Swift Package Manager

Simply add the following line to your `Package.swift`:

```
.package(url: "https://github.com/marty-suzuki/DuctTape.git", from: "version")
```

## License

DuctTape is released under the MIT License.