hio.help.hicting
================

.. py:module:: hio.help.hicting

.. autoapi-nested-parse::

   hio.help.hicting module





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

.. py:class:: Hict(arg: multidict._abc.MDArg[_V] = None, /, **kwargs: _V)

   Bases: :py:obj:`multidict.CIMultiDict`


   Hict is a Case Insensitive Keyed Multiple valued dictionary like class that
   extends CIMultiDict and is used for HTTP headers which have case insentive
   labels.
   Insertion order of keys preserved.
   Associated with each key is a valuelist i.e. a list of values for that key.

   https://multidict.readthedocs.io/en/stable/
   CIMultiDict keys must be subclass of str no ints allowed
   In CIMultiDict::

       .add(key, value) appends value to the valuelist at key
       m["key"] = value replaces the valuelist at key with [value]
       m["key"] returns the first added element of the valuelist at key

   MultiDict methods access values in FIFO order
   Hict adds method to access values in LIFO order

   Extended methods in Hict but not in CIMultiDict:
       - nabone(key [,default]): get last value at key else default or KeyError
       - nab(key [,default]): get last value at key else default or None
       - naball(key [,default]): get all values inverse order else default or KeyError
       - firsts(): get all items where item value is first inserted value at key
       - lasts(): get all items where item value is last inserted value at key


   .. py:method:: nabone(key, *pa, **kwa)

      Usage:
          .nabone(key [, default])

      returns last value at key if key in dict else default
      raises KeyError if key not in dict and default not provided.



   .. py:method:: nab(key, *pa, **kwa)

      Usage:
          .nab(key [, default])

      returns last value at key if key in dict else default
      returns None if key not in dict and default not provided.



   .. py:method:: naball(key, *pa, **kwa)

      Usage:
          .nabone(key [, default])

      returns list of values at key if key in dict else default
      raises KeyError if key not in dict and default not provided.



   .. py:method:: firsts()

      Returns list of (key, value) pair where each value is first value at key
      but with no duplicate keys. MultiDict .keys() returns a key for each
      duplicate value



   .. py:method:: lasts()

      Returns list of (key, value) pairs where each value is last value at key
      but with no duplicate keys. MultiDict .keys() returns a key for each
      duplicate value



.. py:class:: Mict(arg: multidict._abc.MDArg[_V] = None, /, **kwargs: _V)

   Bases: :py:obj:`multidict.MultiDict`


   Mict is a multiple valued dictionary like class that extends  MultiDict.
   Insertion order of keys preserved.
   Associated with each key is a valuelist i.e. a list of values for that key.

   https://multidict.readthedocs.io/en/stable/
   MultiDict keys must be subclass of str no ints allowed
   In MultiDict::

       .add(key, value) appends value to the valuelist at key
       m["key"] = value replaces the valuelist at key with [value]
       m["key"] returns the first added element of the valuelist at key

   MultiDict methods access values in FIFO order
   Mict adds methods to access values in LIFO order

   Extended methods in Mict but not in MultiDict:
       - nabone(key [,default]): get last value at key else default or KeyError
       - nab(key [,default]): get last value at key else default or None
       - naball(key [,default]): get all values inverse order else default or KeyError



   .. py:method:: nabone(key, *pa, **kwa)

      Usage:
          .nabone(key [, default])

      returns last value at key if key in dict else default
      raises KeyError if key not in dict and default not provided.



   .. py:method:: nab(key, *pa, **kwa)

      Usage:
          .nab(key [, default])

      returns last value at key if key in dict else default
      returns None if key not in dict and default not provided.



   .. py:method:: naball(key, *pa, **kwa)

      Usage:
          .nabone(key [, default])

      returns list of values at key if key in dict else default
      raises KeyError if key not in dict and default not provided.



   .. py:method:: firsts()

      Returns list of (key, value) pair where each value is first value at key
      No duplicate keys



   .. py:method:: lasts()

      Returns list of (key, value) pairs where each value is last value at key
      No duplicate keys