fleche._attrs
=============

.. py:module:: fleche._attrs

.. autoapi-nested-parse::

   Internal helpers for hashing and destructuring ``attrs``-decorated classes.

   The ``attrs`` package is an optional dependency; importing this module is always safe.
   Helpers gracefully degrade (``is_attrs_instance`` returns ``False``, ``field_items``
   asserts) when ``attr`` cannot be imported.



Attributes
----------

.. autoapisummary::

   fleche._attrs._attr


Functions
---------

.. autoapisummary::

   fleche._attrs.is_attrs_instance
   fleche._attrs.field_items


Module Contents
---------------

.. py:data:: _attr
   :type:  types.ModuleType | None

.. py:function:: is_attrs_instance(value: Any) -> bool

   Return True iff *value* is an instance of an ``attrs``-decorated class.

   Returns False (rather than raising) when ``attrs`` is not installed.


.. py:function:: field_items(value: Any) -> list[tuple[str, Any]]

   Return ``[(name, value), ...]`` for every attribute of an attrs instance.