lenskit.data.ItemListCollector
==============================

.. py:class:: lenskit.data.ItemListCollector
   :canonical: lenskit.data._collection.ItemListCollector

   Bases: :py:obj:`Protocol`


   Collect item lists with associated keys, as in :class:`ItemListCollection`.


   .. py:method:: add(list, *fields, **kwfields)
      :abstractmethod:


      Add a single item list to this list.

      :param list: The item list to add.
      :param fields: The key fields for this list.
      :param kwfields: The key fields for this list.



   .. py:method:: add_from(other, **fields)
      :abstractmethod:


      Add all collection from another collection to this collection.  If field
      values are supplied, they are used to supplement or overwrite the keys
      in ``other``; a common use case is to add results from multiple
      recommendation runs and save them a single field.

      :param other: The item list collection to incorporate into this one.
      :param fields: Additional key fields (must be specified by name).