Merge pull request #141 from mirego/wrap_content

Add `wrapContent()` methods

Author: lucdion

.gitignore

@@ -19,9 +19,10 @@ TestProjects/cocoapods/macos/PinLayout-macOS.xcworkspace/
 TestProjects/cocoapods/macos/Podfile.lock
 TestProjects/cocoapods/tvos/PinLayout-tvOS.xcworkspace/
 TestProjects/cocoapods/tvos/Podfile.lock
+
 TestProjects/carthage/ios/Cartfile.resolved
 TestProjects/carthage/ios/Carthage/
 
 TestProjects/swift-package-manager
 
-Example/PinLayoutExampleMacOS
+Example/PinLayoutExampleMacOS

Example/.swiftlint.yml

@@ -24,3 +24,4 @@ disabled_rules: # rule identifiers to exclude from running
 
 excluded: # paths to ignore during linting. overridden by `included`.
   - Pods
+  - PinLayoutExampleMacOS

Example/PinLayoutSample.xcodeproj/xcshareddata/xcschemes/PinLayoutSample.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0900"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

PinLayout.xcodeproj/project.pbxproj

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0900"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

PinLayout.xcodeproj/xcshareddata/xcschemes/PinLayout-iOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0930"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

PinLayout.xcodeproj/xcshareddata/xcschemes/PinLayout-macOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0900"
+   LastUpgradeVersion = "0940"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

PinLayout.xcodeproj/xcshareddata/xcschemes/PinLayout-tvOS.xcscheme

@@ -1,6 +1,6 @@
 PODS:
   - Nimble (7.0.3)
-  - PinLayout (1.7.3)
+  - PinLayout (1.7.4)
   - Quick (1.2.0)
   - Reveal-SDK (10)
   - SwiftLint (0.25.1)
@@ -25,7 +25,7 @@ EXTERNAL SOURCES:
 
 SPEC CHECKSUMS:
   Nimble: 7f5a9c447a33002645a071bddafbfb24ea70e0ac
-  PinLayout: 04488e8fc8d19b59760bdf99a16deff7bfac422d
+  PinLayout: e20545b1fd5110133e0b03bed61f196161af8b36
   Quick: 58d203b1c5e27fff7229c4c1ae445ad7069a7a08
   Reveal-SDK: 7869ddf1f902cabbb07a1f0dd06bd25861a126f7
   SwiftLint: ce933681be10c3266e82576dad676fa815a602e9

PinLayout.xcworkspace/contents.xcworkspacedata

@@ -37,6 +37,8 @@ Extremely Fast views layouting without auto layout. No magic, pure code, full co
 * Swift 3.2+ / Swift 4.0 / Objective-C
 
 ### Recent features
+* :star: Add `wrapContent()` methods that adjust view's width and height to wrap all its subviews. See [wrapContent](#wrapContent) for more information.
+
 * :star: PinLayout now support macOS. See [macOS Support](#macos_support) for more information.
 
 * :star: PinLayout expose the `safeAreaInsets` through [`UIView.pin.safeArea`](#safeAreaInsets), this property support not only iOS 11, but is also backward compatible for earlier iOS releases (7/8/9/10). See [safeAreaInsets support](#safeAreaInsets) for more information.
@@ -61,6 +63,7 @@ Extremely Fast views layouting without auto layout. No magic, pure code, full co
   * [Aspect Ratio](#aspect_ratio)
   * [Margins](#margins)
   * [safeAreaInsets support](#safeAreaInsets)
+  * [WrapContent](#wrapCcontent)
   * [justify, align](#justify_align)
   * [UIView's transforms](#uiview_transform)
   * [Warnings](#warnings)
@@ -1134,8 +1137,65 @@ This example runs perfectly on a iPhone X (iOS 11), but it also runs on any devi
 
 <br/>
 
+<a name="wrapContent"></a>
+## WrapContent
 
-<a name="aspect_ratio"></a>
+The following methods are useful to adjust view's width and/or height to wrap all its subviews. These methods also adjust subviews position to create a tight wrap.
+
+**Methods:**
+
+* **`wrapContent()`**  
+**`wrapContent(padding: CGFloat)`**  
+**`wrapContent(padding: UIEdgeInsets)`**   
+Adjust the view's width and height to wrap all its subviews. The method also adjusts subviews's position to create a tight wrap. It is also possible to specify an optional padding around all subviews. 
+* **`wrapContent(:WrapType)`**  
+**`wrapContent(:WrapType, padding: CGFloat)`**  **`wrapContent(:WrapType, padding: UIEdgeInsets)`**  
+Adjust the view's width AND/OR height to wrap all its subviews. Accept a WrapType parameter to define the wrapping type. It is also possible to specify an optional padding around all subviews.
+ 
+**Types:** 
+
+* **`WrapType`** values:
+	* `.horizontally`: Adjust the view's width and update subviews's horizontal position.
+	* `.vertically`: Adjust only the view's height and update subviews's vertical position.
+	* `.all`: Adjust the view's width AND height and update subviews position. This is the default WrapType parameter value `wrapContent()` methods.
+
+###### Usage examples:
+```swift
+	view.pin.wrapContent().center()   // wrap all subviews and centered the view inside its parent.
+	view.pin.wrapContent(padding: 20) // wrap all subviews with a padding of 20 pixels all around
+	view.pin.wrapContent(.horizontally)
+```
+
+###### Example:
+This example show the result of different `wrapContent()` method calls.  
+Here is the initial state:
+
+<img src="docs/images/wrapContent_before.png" width="200"/>
+
+| Source code     | Result | Description |
+|---------------------|----------|-------------------|
+| `view.pin.wrapContent()` | <img src="docs/images/wrapContent_all.png" width="200"/> | Adjust the view's height and width to tight fit its subviews. |
+| `view.pin.wrapContent(padding: 10)` | <img src="docs/images/wrapContent_padding.png" width="200"/> | Adjust the view's height and width and add a padding of 10 pixels around its subviews. |
+| `view.pin.wrapContent(.horizontally)` | <img src="docs/images/wrapContent_horizontally.png" width="200"/> | Adjust only the view's width. |
+| `view.pin.wrapContent(.vertically)` | <img src="docs/images/wrapContent_vertically.png" width="200"/> | Adjust only the view's height. |
+
+
+###### Example:
+This example shows how a view (`containerView`) with two subviews (`imageView` and `label`), can be adjusted to the size of its subviews and then centered inside its parent.
+
+<img src="docs/images/wrapContent_example_1.png" width="540"/>
+
+```swift
+   label.pin.below(of: imageView, aligned: .center).marginTop(4)
+   containerView.pin.wrapContent().center()
+```
+* Line 1: Position the label below the imageView aligned on its center with a top margin of 4 pixels. 
+* Line 2: Adjust the `containerView`'s size and position its subviews to create a tight wrap around them, and then it center the `containerView` inside its parent (superview).    
+
+<br/>
+
+
+<a name="justify_align"></a>
 ## justify() / align()
 
 **Methods:**