Utils Module

Utility functions and helpers

Modules

• Docs
• Formatting
• Grad Utils
• Max Interop
• Shape Utils
• Testing
• Types

Module Overview

Utility functions and decorators for Nabla.

nabla.utils.nodoc(obj)

Decorator to mark functions, methods, or classes as non-documentable.

This decorator adds a special attribute to the decorated object that can be checked by documentation generation tools to exclude it from generated docs.

Parameters:

obj (F | C) – The function, method, or class to mark as non-documentable.

Returns:

The original object with the _nabla_nodoc attribute set to True.

Return type:

F | C

Examples

>>> @nodoc
... def internal_helper():
...     '''This function won't appear in generated docs.'''
...     pass

>>> @nodoc
... class InternalClass:
...     '''This class won't appear in generated docs.'''
...     pass

nabla.utils.is_documentable(obj)

Check if an object should be included in documentation.

Parameters:

obj (Any) – The object to check.

Returns:

False if the object is marked with @nodoc, True otherwise.

Return type:

bool

nabla.utils.should_document(obj, name)

Determine if an object should be documented based on various criteria.

This function checks: 1. If the object is marked with @nodoc decorator 2. If the name starts with underscore (private/internal) 3. Other standard exclusion criteria

Parameters:

• obj (Any) – The object to check.

• name (str) – The name of the object.

Returns:

True if the object should be documented, False otherwise.

Return type:

bool