Add `pin.readableMargins` and `pin.layoutmargins` properties

Add properties:

• pin.readableMargins: UIEdgeInset:
  PinLayout's UIView.pin.readableMargins property expose UIKit UIView.readableContentGuide as an UIEdgeInsets. This is really useful since UIKit only expose the readableContent area to Auto Layout using UILayoutGuide.

• pin.layoutmargins: UIEdgeInset
  PinLayout's UIView.pin.layoutMargins property expose directly the value of UIKit UIView.layoutMargins. The property exists only to be consistent with the other areas: pin.safeArea, pin.readableMargins and pin.layoutmargins. So its usage is not necessary.

Add examples using these properties:

• Added by Luc Dion in Pull Request #170

PinLayout Swift 3 support

PinLayout supports Swift 3 and Swift 4

• Added by Luc Dion in Pull Request #169

Deprecated method `fitSize()` has been removed

BREAKING CHANGE: fitSize() has been removed after being deprecated for 10 months. sizeToFit(:FitType) should now be used instead. See Adjusting size.

Plus:

• Refactor relative positioning methods source code (above(...), after(...), ...) using a default parameter value for the alignment parameter.

• Fix unit test screen density.

• Update few examples source code.

• Added by Luc Dion in Pull Request #167

Add Animations documentation and examples + 'private' declarations

• Add documentation that explains how PinLayout can handle view's animations.

  • Show few strategies that can be used to animate views.

• Add animation examples using PinLayout

• Convert fileprivate to private declarations

• Add an new "Examples" markdown page showing all PinLayout's examples.

• Added by Luc Dion in Pull Request #165

Method that position multiple edges now accept an `offset` parameter

Method that position multiple edges now accept an offset parameter that specifies the distance from their superview's corresponding edges in pixels.

New methods:

• topLeft(_ offset: CGFloat)

• topCenter(_ topOffset: CGFloat)

• topRight(_ offset: CGFloat)

• centerLeft(_ leftOffset: CGFloat)

• center(_ offset: CGFloat)

• centerRight(_ rightOffset offset: CGFloat)

• bottomLeft(_ offset: CGFloat)

• bottomCenter(_ bottomOffset: CGFloat)

• bottomRight(_ offset: CGFloat)

For example, to position a view at the top left corner with a top and left margin of 10 pixels:

   view.pin.topLeft(10)

Other change

Cleanup the interface by using default value parameters.

• Added by Luc Dion in Pull Request #163

Add `sizeToFit()` method

Add sizeToFit() method

The method adjust the view's size based on the result of the method UIView.sizeToFit(). Particularly useful for controls/views that have an intrinsic size (label, button, ...).

Fix a regression

The recent changes to PinLayout that enable the layout of CALayer has impacted the layout of UIViews.

• Added by Luc Dion in Pull Request #152

Add support for CALayer layout

PinLayout can now layouts CALayer's. All PinLayout's properties and methods are available, with the following exceptions:

• sizeToFit(:FitType) is not supported. Support for sizeToFit(:FitType) can be added to your custom CALayer subclasses, just make those layers conform to the SizeCalculable protocol and implement the two required functions.
• CALayer.pin.safeArea property is not available.
• aspectRatio() with no parameters

See CALayer Support documentation for more information

• Added by Antoine Lamy in Pull Request #151

Refactoring using generics

Refactoring to avoid having to deal directly with view types, making it easier to extend layouting to other APIs (e.g: CALayer)

• Added by Antoine Lamy in Pull Request #148

PinLayout has moved to the "layoutBox" organization and ...

PinLayout has moved to the layoutBox organization

PinLayout is now part of the same organization as other open source projects related to layout using Swift.

Refactor source code that handle size adjustment.

• Added by Luc Dion in Pull Request #143

Add an example using wrapContent() methods

• Added by Luc Dion in Pull Request #145

Refactor views frame/bounds access

• Added by Luc Dion in Pull Request #147