Module utils

Compute the smallest, integer aspect ratio.

Parameters:

• width - The width (float, int, Size, 2-tuple (width, height), str("w:h") or NSSize_t).
• height - The height (float or int).

Returns:

2-Tuple (width, height) as (int, int) or None.

>>> aspect_ratio(10, 15)
(2, 3)
>>> aspect_ratio(10.0, 15)
(2, 3)
>>> aspect_ratio(10, -15)
(-2, 3)
>>> aspect_ratio(-10, -15)
(2, 3)
>>> aspect_ratio(10.5, 15)
(7, 10)
>>> aspect_ratio(0, 15)
()

Clip a string to the given length limit.

Parameters:

• bytestr - String (bytes or str).
• limit - Length limit (int).

Returns:

Clipped bytes or str.

Calculate the Greatest Common Divisor of a and b.

Unless b==0, the result will have the same sign as b (so that when b is divided by it, the result comes out positive).

Convert an instance's attributes, maintaining the order.

Parameters:

• inst - Instance (any, incl. ctypes).
• strepr - Conversion (repr or str).
• attrs - Instance attribute names (all positional).

Returns:

Instance representation (str).

Check a Python instance' class.

Parameters:

• inst - The instance to check (any).
• classes - One or several classes (all positional).
• raiser_name - Optional instance name (str) to raise TypeError.

Returns:

The type{inst} if isinstance(inst, classes else None.

Raises:

• TypeError - If inst does not match any of the classes but only if keyword raiser is specified.

Is instance a list or tuple?

Parameters:

• inst - The object (any type).

Returns:

True if inst is a list or tuple, False otherwise.

Return the platform.machine string, distinguishing Intel from emulating Intel on Apple Silicon (on macOS).

Returns:

Machine 'arm64' for Apple Silicon, 'x86_64' for Intel, "arm64_x86_64" for Intel emulated, etc. (str with any commas replaced by underscore).

Return the macOS release as str.

Return the macOS release as 1-, 2- or 3-tuple of ints.

Convert a (selector) name to bytes and ObjC naming rules.

Parameters:

• name_ - Name to convert (str or bytes).

Returns:

Converted name (bytes).

Convert a (selector) name str and Python naming conventions.

Parameters:

• name_ - Name to convert (str or bytes).

Returns:

Converted name (str).

Convert a (selector) name to a valid Python callback method.

Parameters:

• name_ - Name to convert (str or bytes).

Returns:

Converted name (str).

Raises:

• ValueError - Invalid, non-alphanumeric name_.

Formatted print fmt % args with optional keywords.

Parameters:

• fmtxt - Print-like format or plain string (str).
• args - Optional arguments to format (all positional).
• file - Alternate file to write to (file-type), default sys.stdout.
• flush - Flush file after writing (bool), default False.
• nl - Number of leading blank lines (int).
• nt - Number of trailing blank lines (int, default 1).
• argv0 - Optional prefix (str).

Returns:

Number of bytes written (int).

All property names and values.

Parameters:

• inst - An instance (any).

Returns:

The properties (dict).

Set up a separate thread to terminate an NSApplication app by calling its .terminate_ method at the given timeout in seconds.

Returns:

Timeout in seconds (float) or None.

Represent a Python Type instance as str or repr.

Parameters:

• inst - Instance (any).
• strepr - Representation function (repr or str).
• kwds - Optional, additional name=value arguments.

Returns:

Instance representation (str).

Convert a size to string with 1_000's seperator.

Parameters:

• size - Value to convert (float or int).
• sep - 1_000's separator (str).

Returns:

"<1or2digits><sep><3digits>..." or "-" if size is negative (str).

Format a float and strip trailing zero decimals.

Parameters:

• flt - Value (float).
• prec - Number of decimals (int).

Returns:

Value (str).

Convert a size to string with SI-units suffix.

Parameters:

• size - Value to convert (float or int).
• B - The unit (str).
• K - 1024 or 1000 (int).

Returns:

"<Size> <SI>[i]<B>" (str).