.. _jgdv.structs.strang.formatter:
   
    
=============================
jgdv.structs.strang.formatter
=============================
  

   
.. py:module:: jgdv.structs.strang.formatter

       
 

   
 

 

 
   
        

           

 
 

           
   
             
  
           
 
  
 
 
  

   
Classes
-------
  


.. autoapisummary::

    jgdv.structs.strang.formatter.StrangFormatter
           
 
      
 
Module Contents
===============

 
 

.. _jgdv.structs.strang.formatter.StrangFormatter:
   
.. py:class:: StrangFormatter
   
   Bases: :py:obj:`string.Formatter` 
     
   An Expander/Formatter to extend string formatting with options useful for dkey's
   and doot specs/state.


   
      
   .. py:method:: convert_field(value, conversion) -> <Unknown>
      


      
   .. py:method:: expanded_str(value, *, stop = None) -> <Unknown>
      :abstractmethod:
      

      Create a str with generative marks replaced with generated values

      eg: a.b.c.<gen-uuid> -> a.b.c.<UUID:......>



      
   .. py:method:: format(key, /, *args, **kwargs) -> <Unknown>
      

      format keys as strings



      
   .. py:method:: format_subval(value, val, *, no_expansion = False) -> <Unknown>
      


      
   .. py:method:: get_value(key, args, kwargs) -> <Unknown>
      

      lowest level handling of keys being expanded