Merge pull request #343 from TouchInstinct/feature/swiftui_previews

feat: extensions for SwiftUI previews
2023-02-21 09:04:31 +03:00 · 2023-02-21 09:04:31 +03:00 · 3a321a7fbf
parent 30c5b72b26 275afb655f
commit 3a321a7fbf
28 changed files with 234 additions and 22 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,5 +1,11 @@
 # Changelog

+### 1.35.0
+
+- **Added**: `TIDeveloperUtils` framework, that contains different utils for development
+- **Added**: `UIView` and `UIViewController` extensions for showing SwiftUI previews
+- **Added**: `DashedBoundsLayer` for debugging views' frames visually
+
 ### 1.34.0

 - **Added**: `BaseListItemView` for displaying three views horizontally
--- a/LeadKit.podspec
+++ b/LeadKit.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name            = "LeadKit"
-  s.version         = "1.34.0"
+  s.version         = "1.35.0"
  s.summary         = "iOS framework with a bunch of tools for rapid development"
  s.homepage        = "https://github.com/TouchInstinct/LeadKit"
  s.license         = "Apache License, Version 2.0"
--- a/Package.swift
+++ b/Package.swift
@ -22,6 +22,7 @@ let package = Package(
    .library(name: "TIKeychainUtils", targets: ["TIKeychainUtils"]),
    .library(name: "TITableKitUtils", targets: ["TITableKitUtils"]),
    .library(name: "TILogging", targets: ["TILogging"]),
+    .library(name: "TIDeveloperUtils", targets: ["TIDeveloperUtils"]),

    // MARK: - Networking

@ -67,6 +68,7 @@ let package = Package(
    .target(name: "TIKeychainUtils", dependencies: ["TIFoundationUtils", "KeychainAccess"], path: "TIKeychainUtils/Sources"),
    .target(name: "TITableKitUtils", dependencies: ["TIUIElements", "TableKit"], path: "TITableKitUtils/Sources"),
    .target(name: "TILogging", dependencies: ["TIUIElements", "TISwiftUtils", "TIUIKitCore"], path: "TILogging/Sources"),
+    .target(name: "TIDeveloperUtils", dependencies: [], path: "TIDeveloperUtils/Sources"),

    // MARK: - Networking
    .target(name: "TINetworking", dependencies: ["TIFoundationUtils", "Alamofire"], path: "TINetworking/Sources"),
--- a/TIAppleMapUtils/TIAppleMapUtils.podspec
+++ b/TIAppleMapUtils/TIAppleMapUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIAppleMapUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for map objects clustering and interacting using Apple MapKit.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIAuth/TIAuth.podspec
+++ b/TIAuth/TIAuth.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIAuth'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Login, registration, confirmation and other related actions'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIDeveloperUtils/Sources/DashedBoundsLayer/DashedBoundLayer.swift
+++ b/TIDeveloperUtils/Sources/DashedBoundsLayer/DashedBoundLayer.swift
@ -0,0 +1,100 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import UIKit
+
+open class DashedBoundsLayer: CAShapeLayer {
+
+    public static var predefinedColors: [UIColor] {
+        [.red, .green, .blue, .brown, .gray, .yellow, .magenta, .black, .orange, .purple, .cyan]
+    }
+
+    private var viewBoundsObservation: NSKeyValueObservation?
+
+    public var dashColor: UIColor = predefinedColors.randomElement() ?? .black
+
+    // MARK: - Open methods
+
+    open func configure(on view: UIView) {
+        fillColor = UIColor.clear.cgColor
+        strokeColor = dashColor.cgColor
+        lineWidth = 1
+        lineDashPattern = [4.0, 2.0]
+
+        updateGeometry(from: view)
+
+        view.layer.addSublayer(self)
+
+        viewBoundsObservation = view.observe(\.bounds, options: [.new]) { [weak self] view, _ in
+            self?.updateGeometry(from: view)
+        }
+    }
+
+    open func updateGeometry(from view: UIView) {
+        frame = view.bounds
+        path = UIBezierPath(rect: view.bounds).cgPath
+    }
+}
+
+// MARK: - UIView + DashedBoundsLayer
+
+public extension UIView {
+
+    @discardableResult
+    func debugBoundsVisually(debugSubviews: Bool = true) -> UIView {
+        disableBoundsVisuallyDebug()
+
+        if debugSubviews {
+            for subview in subviews {
+                subview.debugBoundsVisually(debugSubviews: debugSubviews)
+            }
+        }
+
+        let dashedLayer = DashedBoundsLayer()
+        dashedLayer.configure(on: self)
+
+        return self
+    }
+
+    func disableBoundsVisuallyDebug() {
+        for sublayer in layer.sublayers ?? [] {
+            if sublayer is DashedBoundsLayer {
+                sublayer.removeFromSuperlayer()
+            }
+        }
+
+        for subview in subviews {
+            subview.disableBoundsVisuallyDebug()
+        }
+    }
+}
+
+// MARK: - UIViewController + DashedBoundsLayer
+
+public extension UIViewController {
+
+    @discardableResult
+    func debugBoundsVisually(debugSubviews: Bool = true) -> UIViewController {
+        view.debugBoundsVisually(debugSubviews: debugSubviews)
+        return self
+    }
+}
--- a/TIDeveloperUtils/Sources/Previews/UIView+Previews.swift
+++ b/TIDeveloperUtils/Sources/Previews/UIView+Previews.swift
@ -0,0 +1,43 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import SwiftUI
+import UIKit
+
+@available(iOS 13, *)
+public extension UIView {
+    private struct Preview: UIViewRepresentable {
+        let view: UIView
+
+        func makeUIView(context: Context) -> UIView {
+            view
+        }
+
+        func updateUIView(_ uiView: UIView, context: Context) {
+            //
+        }
+    }
+
+    func showPreview() -> some View {
+        Preview(view: self)
+    }
+}
--- a/TIDeveloperUtils/Sources/Previews/UIViewController+Previews.swift
+++ b/TIDeveloperUtils/Sources/Previews/UIViewController+Previews.swift
@ -0,0 +1,44 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import SwiftUI
+import UIKit
+
+@available(iOS 13, *)
+public extension UIViewController {
+
+    private struct Preview: UIViewControllerRepresentable {
+        let viewController: UIViewController
+
+        func makeUIViewController(context: Context) -> UIViewController {
+            viewController
+        }
+
+        func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
+            //
+        }
+    }
+
+    func showPreview() -> some View {
+        Preview(viewController: self)
+    }
+}
--- a/TIDeveloperUtils/TIDeveloperUtils.podspec
+++ b/TIDeveloperUtils/TIDeveloperUtils.podspec
@ -0,0 +1,16 @@
+Pod::Spec.new do |s|
+  s.name             = 'TIDeveloperUtils'
+  s.version          = '1.35.0'
+  s.summary          = 'Universal web view API'
+  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
+  s.license          = { :type => 'MIT', :file => 'LICENSE' }
+  s.author           = { 'petropavel13' => 'ivan.smolin@touchin.ru',
+                         'castlele' => 'nikita.semenov@touchin.ru' }
+  s.source           = { :git => 'https://github.com/TouchInstinct/LeadKit.git', :tag => s.version.to_s }
+
+  s.ios.deployment_target = '11.0'
+  s.swift_versions = ['5.3']
+
+  s.source_files = s.name + '/Sources/**/*'
+
+end
--- a/TIEcommerce/TIEcommerce.podspec
+++ b/TIEcommerce/TIEcommerce.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIEcommerce'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Cart, products, promocodes, bonuses and other related actions'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIFoundationUtils/TIFoundationUtils.podspec
+++ b/TIFoundationUtils/TIFoundationUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIFoundationUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for Foundation framework classes.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIGoogleMapUtils/TIGoogleMapUtils.podspec
+++ b/TIGoogleMapUtils/TIGoogleMapUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIGoogleMapUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for map objects clustering and interacting using Google Maps SDK.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIKeychainUtils/TIKeychainUtils.podspec
+++ b/TIKeychainUtils/TIKeychainUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIKeychainUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for Keychain classes.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TILogging/TILogging.podspec
+++ b/TILogging/TILogging.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TILogging'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Logging API'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIMapUtils/TIMapUtils.podspec
+++ b/TIMapUtils/TIMapUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIMapUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for map objects clustering and interacting.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIMoyaNetworking/TIMoyaNetworking.podspec
+++ b/TIMoyaNetworking/TIMoyaNetworking.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIMoyaNetworking'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Moya + Swagger network service.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TINetworking/TINetworking.podspec
+++ b/TINetworking/TINetworking.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TINetworking'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Swagger-frendly networking layer helpers.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TINetworkingCache/TINetworkingCache.podspec
+++ b/TINetworkingCache/TINetworkingCache.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TINetworkingCache'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Caching results of EndpointRequests.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIPagination/TIPagination.podspec
+++ b/TIPagination/TIPagination.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIPagination'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Generic pagination component.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TISwiftUICore/TISwiftUICore.podspec
+++ b/TISwiftUICore/TISwiftUICore.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TISwiftUICore'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Core UI elements: protocols, views and helpers.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TISwiftUtils/TISwiftUtils.podspec
+++ b/TISwiftUtils/TISwiftUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TISwiftUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Bunch of useful helpers for Swift development.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TITableKitUtils/TITableKitUtils.podspec
+++ b/TITableKitUtils/TITableKitUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TITableKitUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for TableKit classes.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TITransitions/TITransitions.podspec
+++ b/TITransitions/TITransitions.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TITransitions'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of custom transitions to present controller. '
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIUIElements/TIUIElements.podspec
+++ b/TIUIElements/TIUIElements.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIUIElements'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Bunch of useful protocols and views.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIUIKitCore/TIUIKitCore.podspec
+++ b/TIUIKitCore/TIUIKitCore.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIUIKitCore'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Core UI elements: protocols, views and helpers.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIWebView/TIWebView.podspec
+++ b/TIWebView/TIWebView.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIWebView'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Universal web view API'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/TIYandexMapUtils/TIYandexMapUtils.podspec
+++ b/TIYandexMapUtils/TIYandexMapUtils.podspec
@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
  s.name             = 'TIYandexMapUtils'
-  s.version          = '1.34.0'
+  s.version          = '1.35.0'
  s.summary          = 'Set of helpers for map objects clustering and interacting using Yandex Maps SDK.'
  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
--- a/project-scripts/push_to_podspecs.sh
+++ b/project-scripts/push_to_podspecs.sh
@ -23,7 +23,8 @@ ORDERED_PODSPECS="../TISwiftUtils/TISwiftUtils.podspec
 ../TIGoogleMapUtils/TIGoogleMapUtils.podspec
 ../TIYandexMapUtils/TIYandexMapUtils.podspec
 ../TIEcommerce/TIEcommerce.podspec
-../TIWebView/TIWebView.podspec"
+../TIWebView/TIWebView.podspec
+../TIDeveloperUtils/TIDeveloperUtils.podspec"

 for podspec_path in ${ORDERED_PODSPECS}; do
    bundle exec pod repo push git@github.com:TouchInstinct/Podspecs ${podspec_path} --allow-warnings