python.observation.fields

  1# -*- coding: utf-8 -*-
  2"""
  3Created on Sun May 28 19:34:03 2023
  4
  5@author: a lab in the Air
  6"""
  7from observation.field import Field
  8from json_ntv import Ntv, NtvSingle, NtvJsonEncoder
  9import json
 10    
 11class Nfield(Field):
 12    ''' Nfield is a child class of NtvField where values are NTV objects
 13
 14    The methods defined in this class are conversion methods:
 15    
 16    *converting external value to internal value:*
 17    
 18    - `Nfield.l_to_i`
 19    - `Nfield.s_to_i`
 20
 21    *converting internal value to external value:*
 22    
 23    - `Nfield.l_to_e`
 24    - `Nfield.s_to_e`
 25
 26    *converting internal value / NTV value:*
 27    
 28    - `Nfield.i_to_n`
 29    - `Nfield.n_to_i`
 30
 31    *extract the name of the value:*
 32
 33    - `Nfield.i_to_name`
 34    '''
 35    def __init__(self, codec=None, name=None, keys=None,
 36                 lendefault=0, reindex=False, fast=False):
 37        super().__init__(codec=codec, name=name, keys=keys,
 38                     lendefault=lendefault, reindex=reindex, fast=fast)
 39
 40    def __str__(self):
 41        '''return json string format'''
 42        return str(self.to_ntv(modecodec='full'))
 43        #return '    ' + self.to_obj(encoded=True, modecodec='full', untyped=False) + '\n'
 44        
 45    @staticmethod
 46    def l_to_i(lis, fast=False):
 47        ''' converting a list of external values to a list of internal values
 48        
 49        *Parameters*
 50
 51        - **fast**: boolean (default False) - list is created with a list of json values 
 52        without control'''
 53        if fast:
 54            return [NtvSingle(val, fast=True) for val in lis]
 55        return [Ntv.from_obj(val) for val in lis]
 56
 57    @staticmethod
 58    def s_to_i(val, fast=False):
 59        '''converting an external value to an internal value
 60
 61        *Parameters*
 62
 63        - **fast**: boolean (default False) - list is created with a list of json values 
 64        without control'''
 65        if fast:
 66            return NtvSingle(val, fast=True)        
 67        return Ntv.from_obj(val)
 68
 69    @staticmethod
 70    def n_to_i(ntv, fast=False):
 71        ''' converting a NTV value to an internal value'''
 72        return ntv
 73
 74    @staticmethod
 75    def l_to_e(lis, fast=False):
 76        ''' converting a list of internal values to a list of external values'''
 77        return [ntv.to_obj() for ntv in lis]    
 78
 79    @staticmethod
 80    def s_to_e(val, fast=False):
 81        '''converting an internal value to an external value'''
 82        return val.to_obj()
 83
 84    @staticmethod
 85    def i_to_n(val):
 86        ''' converting an internal value to a NTV value'''
 87        return val
 88
 89    @staticmethod
 90    def i_to_name(val):
 91        ''' return the name of the internal value'''
 92        return val.name   
 93    
 94class Sfield(Field):
 95    ''' Sfield is a child class of NtvField where inner and outer values are same
 96
 97    The methods defined in this class are conversion methods:
 98    
 99    *converting external value to internal value:*
100    
101    - `Nfield.l_to_i`
102    - `Nfield.s_to_i`
103
104    *converting internal value to external value:*
105    
106    - `Nfield.l_to_e`
107    - `Nfield.s_to_e`
108
109    *converting internal value / NTV value:*
110    
111    - `Nfield.i_to_n`
112    - `Nfield.n_to_i`
113
114    *extract the name of the value:*
115
116    - `Nfield.i_to_name`
117    '''    
118    def __init__(self, codec=None, name=None, keys=None,
119                 lendefault=0, reindex=False, fast=False):
120        super().__init__(codec=codec, name=name, keys=keys,
121                     lendefault=lendefault, reindex=reindex, fast=fast)
122
123    def __str__(self):
124        '''return json string format'''
125        return str({self.name: self.l_to_e(self.values)})
126        #return '    ' + self.to_obj(encoded=True, modecodec='full', untyped=False) + '\n'
127        
128    @staticmethod
129    def l_to_i(lis, fast=False):
130        ''' converting a list of external values to a list of internal values'''
131        if fast:
132            return lis
133        return [Sfield.s_to_i(val, fast) for val in lis]
134    
135    @staticmethod
136    def s_to_i(val, fast=False):
137        '''converting an external value to an internal value'''
138        if fast:
139            return val
140        if val is None or isinstance(val, bool):
141            return json.dumps(val)
142        #if val in ('null', 'false' 'true'):
143        #    return json.loads(val)
144        if isinstance(val, list):
145            return Sfield._tupled(val)
146        if isinstance(val, dict):
147            return json.dumps(val, cls=NtvJsonEncoder)
148        return val    
149    
150    @staticmethod
151    def n_to_i(ntv_lis, fast=False):
152        ''' converting a NtvList value to an internal value'''
153        if isinstance(ntv_lis, list) and len(ntv_lis) == 0:
154            return []
155        if isinstance(ntv_lis, list) and ntv_lis[0].__class__.__name__ in ('NtvSingle', 'NtvList'):
156            #return [Sfield.n_to_i(ntv.val, fast) for ntv in ntv_lis]
157            return [Sfield.n_to_i(ntv.to_obj(), fast) for ntv in ntv_lis]
158        return  Sfield.s_to_i(ntv_lis, fast)
159    
160    @staticmethod
161    def l_to_e(lis, fast=False):
162        ''' converting a list of internal values to a list of external values'''
163        if fast:
164            return lis
165        return [Sfield.s_to_e(val) for val in lis]
166    
167    @staticmethod
168    def s_to_e(val, fast=False):
169        '''converting an internal value to an external value'''
170        if fast:
171            return val
172        if val in ('null', 'false', 'true'):
173            return json.loads(val)
174        #if val is None or isinstance(val, bool):
175        #    return json.dumps(val)
176        if isinstance(val, tuple):
177            return Sfield._listed(val)
178        if isinstance(val, str) and len(val) > 0 and val[0] == '{':
179            return json.loads(val)
180        return val
181    
182    @staticmethod
183    def i_to_n(val):
184        ''' converting an internal value to a NTV value'''
185        return Ntv.obj(Sfield.s_to_e(val))
186
187    @staticmethod
188    def i_to_name(val):
189        ''' return the name of the internal value'''
190        return ''
191    
192    @staticmethod
193    def _tupled(lis):
194        '''transform a list of list in a tuple of tuple'''
195        return tuple([val if not isinstance(val, list) else Sfield._tupled(val) for val in lis])
196
197    @staticmethod
198    def _listed(lis):
199        '''transform a tuple of tuple in a list of list'''
200        return [val if not isinstance(val, tuple) else Sfield._listed(val) for val in lis]