<commit_before>//
//  UIView+TATViewConstraints.h
//  TATLayout
//

@import UIKit;

/**
 This category in `UIView` provides support for constraining the receiver's layout attributes specifying the constraints with the equation format.
 */
@interface UIView (TATViewConstraints)

///-------------------------------------
/// @name Constraining Layout Attributes
///-------------------------------------

/**
 Constrain a layout attribute by creating a constraint specified with the equation format and installing it in the closest ancestor shared by the receiver and any view related.
 
 The first item is automatically set to be the receiver so the equation must start from the first attribute, example `width == superview.width` translates to `self.width == superview.width`. Also, if you need to set the second item to be the receiver you can do so by using the magic keyword `self`, example `width == self.height`.
 
 @param format The format specification for the constraint.
 @param metrics A dictionary of constants that appear in the equation format string. The keys must be the string values used in the equation format string, and the values must be `NSNumber` objects.
 @param views A dictionary of views that appear in the equation format string. The keys must be the string values used in the equation format string, and the values must be the view objects.
 @return The constraint created.
 @see NSLayoutConstraint(TATConstraintFactory) for a description of the language used in the equation format string.
 */
- (NSLayoutConstraint *)tat_constrainLayoutAttributeWithEquationFormat:(NSString *)format metrics:(NSDictionary *)metrics views:(NSDictionary *)views;

/**
 Convenience method to send tat_constrainLayoutAttributeWithEquationFormat:metrics:views: to the receiver with `nil` `metrics` and `views`.
 @param format The format specification for the constraint.
 @return The constraint created.
 @warning If there is any metric or view specified in the equation string an error will be thrown.
 */
- (NSLayoutConstraint *)tat_constrainLayoutAttributeWithEquationFormat:(NSString *)format;<commit_msg>Improve documentation<commit_after>//
//  UIView+TATViewConstraints.h
//  TATLayout
//

@import UIKit;

/**
 This category in `UIView` provides support for constraining the receiver's layout attributes specifying the constraints with the equation format.
 */
@interface UIView (TATViewConstraints)

///-------------------------------------
/// @name Constraining Layout Attributes
///-------------------------------------

/**
 Constrain a layout attribute by creating a constraint described with the equation format and installing it in the closest ancestor shared by the receiver and any view related.
 
 The first item is automatically set to be the receiver so the equation must start from the first attribute, example `width == superview.width` translates to `self.width == superview.width`. Also, if you need to set the second item to be the receiver you can do so by using the magic keyword `self`, example `width == self.height`.
 
 @param format The format specification for the constraint.
 @param metrics A dictionary of constants that appear in the equation format string. The keys must be the string values used in the equation format string, and the values must be `NSNumber` objects.
 @param views A dictionary of views that appear in the equation format string. The keys must be the string values used in the equation format string, and the values must be the view objects.
 @return The constraint created.
 @see NSLayoutConstraint(TATConstraintFactory) for a description of the language used in the equation format string.
 */
- (NSLayoutConstraint *)tat_constrainLayoutAttributeWithEquationFormat:(NSString *)format metrics:(NSDictionary *)metrics views:(NSDictionary *)views;

/**
 Convenience method to send tat_constrainLayoutAttributeWithEquationFormat:metrics:views: to the receiver with `nil` `metrics` and `views`.
 @param format The format specification for the constraint.
 @return The constraint created.
 @warning If there is any metric or view specified in the equation string an error will be thrown.
 */
- (NSLayoutConstraint *)tat_constrainLayoutAttributeWithEquationFormat:(NSString *)format;
{'fraction_non_alphanumeric': 0.09660697455230914, 'fraction_numerical': 0.0, 'mean_word_length': 4.06563245823389, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5984914', 'n_tokens_mistral': 984, 'n_tokens_neox': 931, 'n_words': 514}