SetKit

About

SetKit is a powerful and intuitive Swift library designed to streamline the process of configuring and customizing UIKit elements in a declarative and concise manner. With this library, you can create beautiful and complex user interfaces with ease, improving the readability and maintainability of your code.

Key Features:

• Declarative Syntax: SetKit allows you to define and configure UIKit elements using a clean and expressive declarative syntax. Instead of writing lengthy imperative code, you can simply describe what you want, and the library takes care of the rest.
• Intuitive API: The library provides an intuitive API for setting properties such as fonts, colors, and animations. You can specify these properties in a clear and structured way, making your code more self-explanatory.
• Reusable Components: Create reusable UI components by defining them declaratively. This promotes code reusability and modularity, as you can encapsulate complex UI elements within easily shareable components.
• Supports UIKit Elements: You can use SetKit with various UIKit elements, including labels, buttons, text views, image views, and more. It seamlessly integrates with your existing UIKit-based projects.
• Effortless Constraint Management: SetKit simplifies the process of creating and managing layout constraints, allowing you to define UI element positioning and sizing with ease. Whether you're specifying autolayout rules or leveraging the power of SnapKit, SetKit streamlines constraint handling for a seamless and responsive UI.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

iOS 13.0+ Xcode 11.0+ Swift 5.0+

Installation

SetKit is available through CocoaPods. To install it, simply add the following line to your Podfile:

• Basic version: This is the basic version of SetKit, offering a declarative approach for customizing UIKit elements.

target '<Your Target Name>' do
    pod 'SetKit/Base', '~> 1.0.0'
end

• SnapKit version: This is the enhanced version of SetKit, harnessing the power of SnapKit to provide a feature-rich, declarative approach for customizing UIKit elements with advanced constraint management.

target '<Your Target Name>' do
    pod 'SetKit/SnappySetKit', '~> 1.0.0'
end

Then, run the following command:

$ pod install

Code example

import SetKit

final class ViewController: UIViewController {
  
  private let circleContainer = UIView()
  private let titleLabel = UILabel()
  private let nextButton = UIButton()
  
  override func viewDidLoad() {
    super.viewDidLoad()
    setupUI()
  }
  
  override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    circleContainer.set
      .corners(.circle)
  }
    
  private func setupUI() {
    view.set
      .backgroundColor(.white)
      // instead of using `.subview(of: view)` each time you can go with this:
      .subviews(circleContainer, titleLabel, nextButton)
      
    circleContainer.set
      .subview(of: view)
      // If SnappySetKit version is installed:
      .constraints { make in
        make.center.equalToSuperview()
        make.size.equalTo(40)
      }
      .backgroundColor(.systemBlue)
    
    titleLabel.set
      .subview(of: view)
      // If SnappySetKit version is installed:
      .constraints { make in
        make.top.equalToSuperview().offset(10)
        make.horizontalEdges.equalToSuperview().inset(10)
      }
      .opaque(false)
      .text("Foo")
      .textColor(.white)
      .font(.systemFont(ofSize: 10))
      .multiline()
    
    nextButton.set
      .subview(of: view)
      // If SnappySetKit version is installed:
      .constraints { make in
        make.bottom.equalToSuperview().offset(-10)
        make.width.equalTo(view.snp.width).multipliedBy(0.7)
      }
      .backgroundColor(.systemBlue)
      .corners(.roundedRect(12))
      .title("Done")
      .titleColor(.green)
      .titleLabelProperties { set in
        set
          .font(.systemFont(ofSize: 10, weight: .semibold))
      }
      .tap(self, action: #selector(buttonTapped))
  }
  
  @objc private func buttonTapped() {
    // do smth
  }
}

Custom extensions

You can extend PropertySetter to make generic UI elements like this:

extension PropertySetter where Base: UILabel {
  
  @discardableResult
  func personInfoLabelStyle(info: String) -> Self {
    base.set
      .text(info)
      .font(.systemFont(ofSize: 15))
      .textColor(.systemBlue)
      .borderWidth(1)
      .borderColor(.systemBlue)
      .alpha(0.7)
    return self
  }
  
}

And then use it like any other PropertySetter:

...
    override func viewDidLoad() {
        super.viewDidLoad()
        nameLabel.set
          .personInfoLabelStyle(info: "Alex")
    }
...

Author

camel-cased, [email protected]

License

SetKit is available under the MIT license. See the LICENSE file for more info.