Files
tryton/trytond/model/modelstorage.py
T
2021-10-03 01:14:08 +02:00

1910 lines
76 KiB
Python

# This file is part of Tryton. The COPYRIGHT file at the top level of
# this repository contains the full copyright notices and license terms.
import base64
import datetime
import time
import csv
import random
from decimal import Decimal
from itertools import islice, chain
from functools import lru_cache, wraps
from operator import itemgetter
from collections import defaultdict
from trytond.exceptions import UserError
from trytond.model import Model
from trytond.model import fields
from trytond.tools import reduce_domain, is_instance_method, grouped_slice
from trytond.tools.domain_inversion import (
domain_inversion, parse as domain_parse)
from trytond.pyson import PYSONEncoder, PYSONDecoder, PYSON
from trytond.const import OPERATORS
from trytond.config import config
from trytond.i18n import gettext, lazy_gettext
from trytond.transaction import Transaction, record_cache_size
from trytond.pool import Pool
from trytond.cache import Cache, LRUDictTransaction, freeze, unfreeze
from trytond.rpc import RPC
from .descriptors import dualmethod
__all__ = ['ModelStorage', 'EvalEnvironment']
_cache_field = config.getint('cache', 'field')
_cache_count_timeout = config.getint(
'cache', 'count_timeout', default=60 * 60 * 24)
_cache_count_clear = config.getint(
'cache', 'count_clear', default=1000)
def local_cache(Model, transaction=None):
if transaction is None:
transaction = Transaction()
return LRUDictTransaction(record_cache_size(transaction), Model._record)
class AccessError(UserError):
pass
class ImportDataError(UserError):
pass
class ValidationError(UserError):
pass
class DomainValidationError(ValidationError):
pass
class RequiredValidationError(ValidationError):
pass
class SizeValidationError(ValidationError):
pass
class DigitsValidationError(ValidationError):
pass
class ForbiddenCharValidationError(ValidationError):
pass
class SelectionValidationError(ValidationError):
pass
class TimeFormatValidationError(ValidationError):
pass
def without_check_access(func):
@wraps(func)
def wrapper(*args, **kwargs):
with Transaction().set_context(_check_access=False):
return func(*args, **kwargs)
return wrapper
def is_leaf(expression):
return (isinstance(expression, (list, tuple))
and len(expression) > 2
and isinstance(expression[1], str)
and expression[1] in OPERATORS) # TODO remove OPERATORS test
class ModelStorage(Model):
"""
Define a model with storage capability in Tryton.
"""
__slots__ = ('_transaction', '_user', '_context', '_ids',
'_transaction_cache', '_local_cache')
create_uid = fields.Many2One(
'res.user', lazy_gettext('ir.msg_created_by'), readonly=True)
create_date = fields.Timestamp(
lazy_gettext('ir.msg_created_at'), readonly=True)
write_uid = fields.Many2One(
'res.user', lazy_gettext('ir.msg_edited_by'), readonly=True)
write_date = fields.Timestamp(
lazy_gettext('ir.msg_edited_at'), readonly=True)
rec_name = fields.Function(
fields.Char(lazy_gettext('ir.msg_record_name')), 'get_rec_name',
searcher='search_rec_name')
_count_cache = Cache(
'modelstorage.count', duration=_cache_count_timeout, context=False)
@classmethod
def __setup__(cls):
from .modelview import ModelView
super(ModelStorage, cls).__setup__()
if issubclass(cls, ModelView):
cls.__rpc__.update({
'create': RPC(readonly=False,
result=lambda r: list(map(int, r))),
'read': RPC(),
'write': RPC(readonly=False,
instantiate=slice(0, None, 2)),
'delete': RPC(readonly=False, instantiate=0),
'copy': RPC(readonly=False, instantiate=0, unique=False,
result=lambda r: list(map(int, r))),
'search': RPC(result=lambda r: list(map(int, r))),
'search_count': RPC(),
'search_read': RPC(),
'resources': RPC(instantiate=0, unique=False),
'export_data_domain': RPC(),
'export_data': RPC(instantiate=0, unique=False),
'import_data': RPC(readonly=False),
})
@classmethod
def __post_setup__(cls):
super().__post_setup__()
cls._mptt_fields = set()
cls._path_fields = set()
for name, field in cls._fields.items():
if (isinstance(field, fields.Many2One)
and field.model_name == cls.__name__):
if field.path:
cls._path_fields.add(name)
if field.left and field.right:
cls._mptt_fields.add(name)
@staticmethod
def default_create_uid():
"Default value for uid field."
return int(Transaction().user)
@staticmethod
def default_create_date():
"Default value for create_date field."
return datetime.datetime.today()
@classmethod
def create(cls, vlist):
'''
Returns the list of created records.
'''
pool = Pool()
ModelAccess = pool.get('ir.model.access')
ModelFieldAccess = pool.get('ir.model.field.access')
ModelAccess.check(cls.__name__, 'create')
all_fields = list(set().union(*vlist))
ModelFieldAccess.check(cls.__name__, all_fields, 'write')
# Increase transaction counter
Transaction().counter += 1
count = cls._count_cache.get(cls.__name__)
if count is not None:
if random.random() < 1 / _cache_count_clear:
cls._count_cache.set(cls.__name__, None)
else:
cls._count_cache.set(cls.__name__, count + len(vlist))
@classmethod
@without_check_access
def trigger_create(cls, records):
'''
Trigger create actions
'''
Trigger = Pool().get('ir.trigger')
triggers = Trigger.get_triggers(cls.__name__, 'create')
if not triggers:
return
for trigger in triggers:
trigger.queue_trigger_action(records)
@classmethod
def read(cls, ids, fields_names):
'''
Read fields_names of record ids.
The order is not guaranteed.
'''
pool = Pool()
ModelAccess = pool.get('ir.model.access')
ModelFieldAccess = pool.get('ir.model.field.access')
ModelAccess.check(cls.__name__, 'read')
ModelFieldAccess.check(cls.__name__, fields_names, 'read')
return []
@classmethod
def write(cls, records, values, *args):
'''
Write values on records.
'''
pool = Pool()
ModelAccess = pool.get('ir.model.access')
ModelFieldAccess = pool.get('ir.model.field.access')
assert not len(args) % 2
actions = iter((records, values) + args)
all_records = []
all_fields = set()
for records, values in zip(actions, actions):
if not cls.check_xml_record(records, values):
raise AccessError(
gettext('ir.msg_write_xml_record'),
gettext('ir.msg_base_config_record'))
all_records += records
all_fields.update(values.keys())
ModelAccess.check(cls.__name__, 'write')
ModelFieldAccess.check(cls.__name__, all_fields, 'write')
# Increase transaction counter
Transaction().counter += 1
# Clean local cache
for record in all_records:
record._local_cache.pop(record.id, None)
# Clean transaction cache
for cache in Transaction().cache.values():
if cls.__name__ in cache:
cache_cls = cache[cls.__name__]
for record in all_records:
cache_cls.pop(record.id, None)
@classmethod
@without_check_access
def trigger_write_get_eligibles(cls, records):
'''
Return eligible records for write actions by triggers
'''
Trigger = Pool().get('ir.trigger')
triggers = Trigger.get_triggers(cls.__name__, 'write')
if not triggers:
return {}
eligibles = {}
for trigger in triggers:
eligibles[trigger] = []
for record in records:
if not Trigger.eval(trigger, record):
eligibles[trigger].append(record)
return eligibles
@classmethod
@without_check_access
def trigger_write(cls, eligibles):
'''
Trigger write actions.
eligibles is a dictionary of the lists of eligible records by triggers
'''
for trigger, records in eligibles.items():
trigger.queue_trigger_action(records)
@classmethod
def index_set_field(cls, name):
"Returns the index sort order of the field set calls."
return 0
@classmethod
def delete(cls, records):
'''
Delete records.
'''
pool = Pool()
ModelAccess = pool.get('ir.model.access')
ModelData = pool.get('ir.model.data')
ModelAccess.check(cls.__name__, 'delete')
if not cls.check_xml_record(records, None):
raise AccessError(
gettext('ir.msg_delete_xml_record'),
gettext('ir.msg_base_config_record'))
if ModelData.has_model(cls.__name__):
with Transaction().set_context(_check_access=False):
data = []
for sub_records in grouped_slice(records):
ids = [r.id for r in sub_records]
data += ModelData.search([
('model', '=', cls.__name__),
('db_id', 'in', ids),
('noupdate', '=', True),
])
ModelData.write(data, {'db_id': None})
# Increase transaction counter
Transaction().counter += 1
# Clean local cache
for record in records:
record._local_cache.pop(record.id, None)
# Clean transaction cache
for cache in Transaction().cache.values():
if cls.__name__ in cache:
cache_cls = cache[cls.__name__]
for record in records:
cache_cls.pop(record.id, None)
count = cls._count_cache.get(cls.__name__)
if count is not None:
if random.random() < 1 / _cache_count_clear:
cls._count_cache.set(cls.__name__, None)
else:
cls._count_cache.set(cls.__name__, count - len(records))
@classmethod
@without_check_access
def trigger_delete(cls, records):
'''
Trigger delete actions
'''
Trigger = Pool().get('ir.trigger')
triggers = Trigger.get_triggers(cls.__name__, 'delete')
if not triggers:
return
for trigger in triggers:
# Do not queue because records will be deleted
trigger.trigger_action(records)
@classmethod
def copy(cls, records, default=None):
'''
Duplicate the records and return a list of new records.
'''
pool = Pool()
Lang = pool.get('ir.lang')
if default is None:
default = {}
else:
default = default.copy()
def is_readonly(Model):
return (not issubclass(Model, ModelStorage)
or callable(getattr(Model, 'table_query', None)))
def get_default(name):
prefix = name + '.'
return {name[len(prefix):]: value
for name, value in default.items()
if name.startswith(prefix)}
def convert_data(field_defs, origin):
data = origin.copy()
for field_name in field_defs:
ftype = field_defs[field_name]['type']
field = cls._fields[field_name]
if field_name in (
'create_date',
'create_uid',
'write_date',
'write_uid',
):
del data[field_name]
if field_name in default:
if callable(default[field_name]):
data[field_name] = default[field_name](origin)
else:
data[field_name] = default[field_name]
if (isinstance(field, fields.Function)
and not isinstance(field, fields.MultiValue)):
del data[field_name]
elif ftype in ('many2one', 'one2one'):
try:
data[field_name] = data[field_name] and \
data[field_name][0]
except Exception:
pass
elif ftype in ('one2many',):
if is_readonly(field.get_target()):
del data[field_name]
elif data[field_name]:
data[field_name] = [(
'copy', data[field_name],
get_default(field_name))]
elif ftype == 'many2many':
if is_readonly(pool.get(field.relation_name)):
del data[field_name]
elif data[field_name]:
data[field_name] = [('add', data[field_name])]
elif ftype == 'binary':
# Copy only file_id
if field.file_id and origin.get(field.file_id):
del data[field_name]
if 'id' in data:
del data['id']
return data
# Reset MPTT field to the default value
mptt = set()
for field in cls._fields.values():
if (isinstance(field, fields.Many2One)
and field.model_name == cls.__name__
and field.left and field.right):
mptt.add(field.left)
mptt.add(field.right)
fields_names = [n for n, f in cls._fields.items()
if (not isinstance(f, fields.Function)
or isinstance(f, fields.MultiValue))
and n not in mptt]
ids = list(map(int, records))
values = {d['id']: d for d in cls.read(ids, fields_names=fields_names)}
field_defs = cls.fields_get(fields_names=fields_names)
to_create = []
for id_ in ids:
data = convert_data(field_defs, values[id_])
to_create.append(data)
new_records = cls.create(to_create)
fields_translate = {}
for field_name, field in field_defs.items():
if (field_name in cls._fields
and getattr(cls._fields[field_name], 'translate', False)):
fields_translate[field_name] = field
if fields_translate:
langs = Lang.search([
('translatable', '=', True),
])
if langs:
id2new_records = defaultdict(list)
for id_, new_record in zip(ids, new_records):
id2new_records[id_].append(new_record)
fields_names = list(fields_translate.keys()) + ['id']
for lang in langs:
# Prevent fuzzing translations when copying as the terms
# should be the same.
with Transaction().set_context(language=lang.code,
fuzzy_translation=False):
values = cls.read(ids, fields_names=fields_names)
to_write = []
for data in values:
to_write.append(id2new_records[data['id']])
to_write.append(
convert_data(fields_translate, data))
cls.write(*to_write)
return new_records
@classmethod
def search(cls, domain, offset=0, limit=None, order=None, count=False):
'''
Return a list of records that match the domain.
'''
pool = Pool()
transaction = Transaction()
ModelAccess = pool.get('ir.model.access')
ModelFieldAccess = pool.get('ir.model.field.access')
ModelAccess.check(cls.__name__, 'read')
def check_domain(domain, cls, to_check):
if is_leaf(domain):
local, relate = (domain[0].split('.', 1) + [None])[:2]
to_check[cls.__name__].add(local)
if relate:
if len(domain) >= 4:
target = pool.get(domain[3])
elif hasattr(cls._fields[local], 'get_target'):
target = cls._fields[local].get_target()
else:
return
target_domain = [(relate,) + tuple(domain[1:])]
check_domain(target_domain, target, to_check)
elif not domain:
return
else:
i = 1 if domain[0] in ['OR', 'AND'] else 0
for d in domain[i:]:
check_domain(d, cls, to_check)
def check_order(order, cls, to_check):
if not order:
return
for oexpr, otype in order:
local, _, relate = oexpr.partition('.')
to_check[cls.__name__].add(local)
if relate and hasattr(cls._fields[local], 'get_target'):
target = cls._fields[local].get_target()
target_order = [(relate, otype)]
check_order(target_order, target, to_check)
if transaction.user and transaction.context.get('_check_access'):
to_check = defaultdict(set)
check_domain(domain, cls, to_check)
check_order(order, cls, to_check)
for name, fields_names in to_check.items():
ModelAccess.check(name, 'read')
ModelFieldAccess.check(name, fields_names, 'read')
if count:
return 0
return []
@classmethod
def search_count(cls, domain):
'''
Return the number of records that match the domain.
'''
res = cls.search(domain, order=[], count=True)
if isinstance(res, list):
return len(res)
return res
@classmethod
def search_read(cls, domain, offset=0, limit=None, order=None,
fields_names=None):
'''
Call search and read functions at once.
Useful for the client to reduce the number of calls.
'''
records = cls.search(domain, offset=offset, limit=limit, order=order)
if fields_names is None:
fields_names = ['id']
if 'id' not in fields_names:
fields_names.append('id')
rows = cls.read(list(map(int, records)), fields_names)
index = {r.id: i for i, r in enumerate(records)}
rows.sort(key=lambda r: index[r['id']])
return rows
@classmethod
def _search_domain_active(cls, domain, active_test=True):
# reduce_domain return a new instance so we can safety modify domain
domain = reduce_domain(domain)
# if the object has a field named 'active', filter out all inactive
# records unless they were explicitely asked for
if not ('active' in cls._fields
and active_test
and Transaction().context.get('active_test', True)):
return domain
def process(domain):
i = 0
active_found = False
while i < len(domain):
arg = domain[i]
# add test for xmlrpc that doesn't handle tuple
if is_leaf(arg):
if arg[0] == 'active':
active_found = True
elif isinstance(arg, list):
domain[i] = process(domain[i])
i += 1
if not active_found:
if (domain and ((isinstance(domain[0], str)
and domain[0] == 'AND')
or (not isinstance(domain[0], str)))):
domain.append(('active', '=', True))
else:
domain = ['AND', domain, ('active', '=', True)]
return domain
return process(domain)
@classmethod
def count(cls):
"Returns the estimation of the number of records."
count = cls._count_cache.get(cls.__name__)
if count is None:
count = cls.search([], count=True)
cls._count_cache.set(cls.__name__, count)
return count
def resources(self):
pool = Pool()
Attachment = pool.get('ir.attachment')
Note = pool.get('ir.note')
return {
'attachment_count': Attachment.search_count([
('resource', '=', str(self)),
]),
'note_count': Note.search_count([
('resource', '=', str(self)),
]),
'note_unread': Note.search_count([
('resource', '=', str(self)),
('unread', '=', True),
]),
}
def get_rec_name(self, name):
'''
Return the rec_name of the instance.
It is used by the Function field rec_name.
'''
rec_name = self._rec_name
if rec_name not in self._fields:
rec_name = 'id'
return str(getattr(self, rec_name))
@classmethod
def search_rec_name(cls, name, clause):
'''
Return a list of arguments for search on rec_name.
'''
rec_name = cls._rec_name
if rec_name not in cls._fields:
return []
return [(rec_name,) + tuple(clause[1:])]
@classmethod
def search_global(cls, text):
'''
Yield tuples (record, name, icon) for text
'''
# TODO improve search clause
for record in cls.search([
('rec_name', 'ilike', '%%%s%%' % text),
]):
yield record, record.rec_name, None
@classmethod
def browse(cls, ids):
'''
Return a list of instance for the ids
'''
transaction = Transaction()
ids = list(map(int, ids))
_local_cache = local_cache(cls, transaction)
transaction_cache = transaction.get_cache()
return [cls(x, _ids=ids,
_local_cache=_local_cache,
_transaction_cache=transaction_cache,
_transaction=transaction) for x in ids]
@staticmethod
def __export_row(record, fields_names):
pool = Pool()
lines = []
data = ['' for x in range(len(fields_names))]
done = []
for fpos in range(len(fields_names)):
fields_tree = fields_names[fpos]
if not fields_tree:
continue
value = record
i = 0
while i < len(fields_tree):
if not isinstance(value, ModelStorage):
break
field_name = fields_tree[i]
descriptor = None
if '.' in field_name:
field_name, descriptor = field_name.split('.')
eModel = pool.get(value.__name__)
field = eModel._fields[field_name]
if field.states and 'invisible' in field.states:
invisible = _record_eval_pyson(
value, field.states['invisible'])
if invisible:
value = ''
break
if descriptor:
value = getattr(field, descriptor)().__get__(value, eModel)
else:
value = getattr(value, field_name)
if isinstance(value, (list, tuple)):
first = True
child_fields_names = [(x[:i + 1] == fields_tree[:i + 1]
and x[i + 1:]) or [] for x in fields_names]
if child_fields_names in done:
break
done.append(child_fields_names)
for child_record in value:
child_lines = ModelStorage.__export_row(child_record,
child_fields_names)
if first:
for child_fpos in range(len(fields_names)):
if child_lines and child_lines[0][child_fpos]:
data[child_fpos] = \
child_lines[0][child_fpos]
lines += child_lines[1:]
first = False
else:
lines += child_lines
break
i += 1
if i == len(fields_tree):
if value is None:
value = ''
elif isinstance(value, Model):
value = str(value)
data[fpos] = value
return [data] + lines
@classmethod
def export_data(cls, records, fields_names):
'''
Return list of list of values for each record.
The list of values follows fields_names.
Relational fields are defined with '/' at any depth.
'''
fields_names = [x.split('/') for x in fields_names]
data = []
for record in records:
data += cls.__export_row(record, fields_names)
return data
@classmethod
def export_data_domain(
cls, domain, fields_names, offset=0, limit=None, order=None):
records = cls.search(domain, limit=limit, offset=offset, order=order)
return cls.export_data(records, fields_names)
@classmethod
def import_data(cls, fields_names, data):
'''
Create records for all values in data.
The field names of values must be defined in fields_names.
'''
pool = Pool()
@lru_cache(maxsize=1000)
def get_many2one(relation, value):
if not value:
return None
Relation = pool.get(relation)
res = Relation.search([
('rec_name', '=', value),
], limit=2)
if len(res) < 1:
raise ImportDataError(gettext(
'ir.msg_relation_not_found',
value=value,
model=relation))
elif len(res) > 1:
raise ImportDataError(
gettext('ir.msg_too_many_relations_found',
value=value,
model=relation))
else:
res = res[0].id
return res
@lru_cache(maxsize=1000)
def get_many2many(relation, value):
if not value:
return None
res = []
Relation = pool.get(relation)
for word in next(csv.reader(value.splitlines(), delimiter=',',
quoting=csv.QUOTE_NONE, escapechar='\\')):
res2 = Relation.search([
('rec_name', '=', word),
], limit=2)
if len(res2) < 1:
raise ImportDataError(
gettext('ir.msg_relation_not_found',
value=word,
model=relation))
elif len(res2) > 1:
raise ImportDataError(
gettext('ir.msg_too_many_relations_found',
value=word,
model=relation))
else:
res.extend(res2)
if len(res):
res = [('add', [x.id for x in res])]
return res
def get_one2one(relation, value):
return ('add', get_many2one(relation, value))
@lru_cache(maxsize=1000)
def get_reference(value, field):
if not value:
return None
try:
relation, value = value.split(',', 1)
except Exception:
raise ImportDataError(
gettext('ir.msg_reference_syntax_error',
value=value,
field=field))
Relation = pool.get(relation)
res = Relation.search([
('rec_name', '=', value),
], limit=2)
if len(res) < 1:
raise ImportDataError(gettext(
'ir.msg_relation_not_found',
value=value,
model=relation))
elif len(res) > 1:
raise ImportDataError(
gettext('ir.msg_too_many_relations_found',
value=value,
model=relation))
else:
res = '%s,%s' % (relation, res[0].id)
return res
@lru_cache(maxsize=1000)
def get_by_id(value, field, ftype):
if not value:
return None
relation = None
if ftype == 'many2many':
value = next(csv.reader(value.splitlines(), delimiter=',',
quoting=csv.QUOTE_NONE, escapechar='\\'))
elif ftype == 'reference':
try:
relation, value = value.split(',', 1)
except Exception:
raise ImportDataError(
gettext('ir.msg_reference_syntax_error',
value=value,
field=field))
value = [value]
else:
value = [value]
res_ids = []
for word in value:
try:
module, xml_id = word.rsplit('.', 1)
except Exception:
raise ImportDataError(
gettext('ir.msg_xml_id_syntax_error',
value=word,
field=field))
db_id = ModelData.get_id(module, xml_id)
res_ids.append(db_id)
if ftype == 'many2many' and res_ids:
return [('add', res_ids)]
elif ftype == 'reference' and res_ids:
return '%s,%s' % (relation, str(res_ids[0]))
return res_ids and res_ids[0] or False
def dispatch(create, write, row, Relation=cls):
id_ = row.pop('id', None)
if id_:
write.append([Relation(id_)])
write.append(row)
else:
create.append(row)
return id_
def process_lines(data, prefix, fields_def, position=0, klass=cls):
line = data[position]
row = {}
translate = {}
todo = set()
prefix_len = len(prefix)
# Import normal fields_names
for i, field in enumerate(fields_names):
if i >= len(line):
raise Exception('ImportError',
'Please check that all your lines have %d cols.'
% len(fields_names))
is_prefix_len = (len(field) == (prefix_len + 1))
value = line[i]
if is_prefix_len and field[-1].endswith(':id'):
ftype = fields_def[field[-1][:-3]]['type']
row[field[0][:-3]] = get_by_id(
value, '/'.join(field), ftype)
elif is_prefix_len and ':lang=' in field[-1]:
field_name, lang = field[-1].split(':lang=')
translate.setdefault(lang, {})[field_name] = value or False
elif is_prefix_len and prefix == field[:-1]:
this_field_def = fields_def[field[-1]]
field_type = this_field_def['type']
res = None
if field[-1] == 'id':
try:
res = int(value)
except ValueError:
res = get_many2one(klass.__name__, value)
elif field_type == 'boolean':
if value.lower() == 'true':
res = True
elif value.lower() == 'false':
res = False
elif not value:
res = False
else:
res = bool(int(value))
elif field_type == 'integer':
if isinstance(value, int):
res = value
elif value:
res = int(value)
else:
res = None
elif field_type == 'float':
if isinstance(value, float):
res = value
elif value:
res = float(value)
else:
res = None
elif field_type == 'numeric':
if isinstance(value, Decimal):
res = value
elif value:
res = Decimal(value)
else:
res = None
elif field_type == 'date':
if isinstance(value, datetime.date):
res = value
elif value:
res = datetime.datetime.strptime(
value, '%Y-%m-%d').date()
else:
res = None
elif field_type == 'datetime':
if isinstance(value, datetime.datetime):
res = value
elif value:
res = datetime.datetime.strptime(
value, '%Y-%m-%d %H:%M:%S')
else:
res = None
elif field_type == 'timedelta':
if isinstance(value, datetime.timedelta):
res = value
elif value:
try:
res = float(value)
except ValueError:
hours, minutes, seconds = (
value.split(':') + ['00'])[:3]
res = datetime.timedelta(
hours=int(hours), minutes=int(minutes),
seconds=float(seconds))
else:
res = None
elif field_type == 'many2one':
res = get_many2one(this_field_def['relation'], value)
elif field_type == 'many2many':
res = get_many2many(this_field_def['relation'], value)
elif field_type == 'one2one':
res = get_one2one(this_field_def['relation'], value)
elif field_type == 'reference':
res = get_reference(value, '/'.join(field))
elif (field_type == 'binary'
and not isinstance(value, bytes)):
res = base64.b64decode(value)
else:
res = value or None
row[field[-1]] = res
elif prefix == field[0:prefix_len]:
todo.add(field[prefix_len])
# Import one2many fields
nbrmax = 1
for field in todo:
Relation = pool.get(fields_def[field]['relation'])
newfd = Relation.fields_get()
newrow, max2, _ = process_lines(
data, prefix + [field], newfd, position, klass=Relation)
nbrmax = max(nbrmax, max2)
create, write = [], []
dispatch(create, write, newrow, Relation)
i = max2
while (position + i) < len(data):
test = True
for j, field2 in enumerate(fields_names):
if (len(field2) <= (prefix_len + 1)
and data[position + i][j]):
test = False
break
if not test:
break
newrow, max2, _ = process_lines(
data, prefix + [field], newfd, position + i,
klass=Relation)
dispatch(create, write, newrow, Relation)
i += max2
nbrmax = max(nbrmax, i)
row[field] = []
if create:
row[field].append(('create', create))
if write:
row[field].append(('write',) + tuple(write))
if prefix_len == 0:
for i in range(max(nbrmax, 1)):
data.pop(0)
return (row, nbrmax, translate)
ModelData = pool.get('ir.model.data')
len_fields_names = len(fields_names)
assert all(len(x) == len_fields_names for x in data)
fields_names = [x.split('/') for x in fields_names]
fields_def = cls.fields_get()
to_create, to_create_translations = [], []
to_write, to_write_translations = [], []
languages = set()
while len(data):
(row, _, translate) = \
process_lines(data, [], fields_def)
if dispatch(to_create, to_write, row):
to_write_translations.append(translate)
else:
to_create_translations.append(translate)
languages.update(translate)
def translate(records, translations):
for language in languages:
translated = [t.get(language, {}) for t in translations]
with Transaction().set_context(language=language):
cls.write(*chain(*filter(itemgetter(1),
zip(([r] for r in records), translated))))
count = 0
if to_create:
records = cls.create(to_create)
translate(records, to_create_translations)
count += len(records)
if to_write:
cls.write(*to_write)
records = sum(to_write[0:None:2], [])
translate(records, to_write_translations)
count += len(records)
return count
@classmethod
def check_xml_record(cls, records, values):
"""
Check if a list of records and their corresponding fields are
originating from xml data. This is used by write and delete
functions: if the return value is True the records can be
written/deleted, False otherwise. The default behaviour is to
forbid any modification on records/fields originating from
xml. Values is the dictionary of written values. If values is
equal to None, no field by field check is performed, False is
returned as soon as one of the record comes from the xml.
"""
ModelData = Pool().get('ir.model.data')
# Allow root user to update/delete
if (Transaction().user == 0
or not ModelData.has_model(cls.__name__)):
return True
with Transaction().set_context(_check_access=False):
models_data = ModelData.search([
('model', '=', cls.__name__),
('db_id', 'in', list(map(int, records))),
])
if not models_data:
return True
for model_data in models_data:
if values is None:
if not model_data.noupdate:
return False
else:
if not model_data.values or model_data.noupdate:
continue
xml_values = ModelData.load_values(model_data.values)
for key, val in values.items():
if key in xml_values and val != xml_values[key]:
return False
return True
@classmethod
def validate(cls, records):
pass
@classmethod
@without_check_access
def _validate(cls, records, field_names=None):
pool = Pool()
# Ensure only records to validate are read,
# also convert iterator to list
records = cls.browse(records)
ctx_pref = {}
if Transaction().user:
try:
User = pool.get('res.user')
except KeyError:
pass
else:
ctx_pref = User.get_preferences(context_only=True)
def is_pyson(test):
if isinstance(test, PYSON):
return True
if isinstance(test, (list, tuple)):
for i in test:
if isinstance(i, PYSON):
return True
if isinstance(i, (list, tuple)):
if is_pyson(i):
return True
if isinstance(test, dict):
for key, value in list(test.items()):
if isinstance(value, PYSON):
return True
if isinstance(value, (list, tuple, dict)):
if is_pyson(value):
return True
return False
def validate_domain(field):
if not field.domain:
return
if field._type in ['dict', 'reference']:
return
if field._type in ('many2one', 'one2many'):
Relation = pool.get(field.model_name)
elif field._type in ('many2many', 'one2one'):
Relation = field.get_target()
else:
Relation = cls
domains = defaultdict(lambda: defaultdict(list))
if is_pyson(field.domain) or is_pyson(field.context):
encoder = PYSONEncoder()
pyson_domain = encoder.encode(field.domain)
pyson_context = encoder.encode(field.context)
for record in records:
domain = freeze(_record_eval_pyson(
record, pyson_domain, encoded=True))
context = freeze(_record_eval_pyson(
record, pyson_context, encoded=True))
domains[context][domain].append(record)
# Select strategy depending if it is closer to one domain per
# record or one domain for all records
# Do not use IN_MAX to let spaces for the pyson domain
in_max = Transaction().database.IN_MAX
count = in_max // 10
for context, ctx_domains in domains.items():
if len(ctx_domains) > len(records) * 0.5:
new_domains = {}
for sub_domains in grouped_slice(
list(ctx_domains.keys()), count):
grouped_domain = ['OR']
grouped_records = []
for d in sub_domains:
sub_records = ctx_domains[d]
grouped_records.extend(sub_records)
relations = relation_domain(field, sub_records)
if len(relations) > in_max:
break
grouped_domain.append(
[('id', 'in',
[r.id for r in relations]), d])
else:
new_domains[freeze(grouped_domain)] = \
grouped_records
continue
break
else:
domains[context] = new_domains
else:
domains[freeze(field.context)][freeze(field.domain)].extend(
records)
for context, ctx_domains in domains.items():
for domain, sub_records in ctx_domains.items():
with Transaction().set_context(unfreeze(context)):
validate_relation_domain(
field, sub_records, Relation, unfreeze(domain))
def relation_domain(field, records):
if field._type in ('many2one', 'one2many', 'many2many', 'one2one'):
relations = set()
for record in records:
if getattr(record, field.name):
if field._type in ('many2one', 'one2one'):
relations.add(getattr(record, field.name))
else:
relations.update(getattr(record, field.name))
else:
# Cache alignment is not a problem
relations = set(records)
return relations
def validate_relation_domain(field, records, Relation, domain):
relations = relation_domain(field, records)
if relations:
for sub_relations in grouped_slice(relations):
sub_relations = set(sub_relations)
# Use root user to skip access rules
with Transaction().set_user(0):
finds = Relation.search(['AND',
[('id', 'in', [r.id for r in sub_relations])],
domain,
])
invalid_records = sub_relations - set(finds)
if invalid_records:
invalid_record = invalid_records.pop()
domain = field.domain
if is_pyson(domain):
domain = _record_eval_pyson(records[0], domain)
msg = gettext(
'ir.msg_domain_validation_record',
**cls.__names__(field.name))
fields = set()
level = 0
if field not in Relation._fields.values():
expression = domain_parse(domain)
for variable in expression.variables:
parts = variable.split('.')
fields.add(parts[0])
level = max(level, len(parts))
else:
fields.add(field.name)
for field_name in sorted(fields):
invalid_domain = domain_inversion(
domain, field_name,
EvalEnvironment(invalid_record, Relation))
if isinstance(invalid_domain, bool):
continue
field_def = Relation.fields_get(
[field_name], level=level)
raise DomainValidationError(
msg, domain=(invalid_domain, field_def))
raise DomainValidationError(msg)
field_names = set(field_names or [])
function_fields = {name for name, field in cls._fields.items()
if isinstance(field, fields.Function)}
ctx_pref['active_test'] = False
with Transaction().set_context(ctx_pref):
for field_name, field in cls._fields.items():
depends = set(field.depends)
if (field_names
and field_name not in field_names
and not (depends & field_names)
and not (depends & function_fields)):
continue
if isinstance(field, fields.Function):
continue
validate_domain(field)
def required_test(value, field_name, field):
if ((
isinstance(value,
(type(None), bool, list, tuple, str, dict))
and not value)
or (field._type == 'reference'
and not isinstance(value, ModelStorage))):
raise RequiredValidationError(
gettext('ir.msg_required_validation_record',
**cls.__names__(field_name)))
# validate states required
if field.states and 'required' in field.states:
if is_pyson(field.states['required']):
pyson_required = PYSONEncoder().encode(
field.states['required'])
for record in records:
required = _record_eval_pyson(
record, pyson_required, encoded=True)
if required:
required_test(getattr(record, field_name),
field_name, field)
else:
if field.states['required']:
for record in records:
required_test(getattr(record, field_name),
field_name, field)
# validate required
if field.required:
for record in records:
required_test(
getattr(record, field_name), field_name, field)
# validate size
if hasattr(field, 'size') and field.size is not None:
for record in records:
if isinstance(field.size, PYSON):
field_size = _record_eval_pyson(record, field.size)
else:
field_size = field.size
size = len(getattr(record, field_name) or '')
if (size > field_size >= 0):
error_args = cls.__names__(field_name)
error_args['size'] = size
error_args['max_size'] = field_size
raise SizeValidationError(
gettext('ir.msg_size_validation_record',
**error_args))
def digits_test(record, digits, field_name):
def raise_error(value):
error_args = cls.__names__(field_name)
error_args['digits'] = digits[1]
error_args['value'] = repr(value)
raise DigitsValidationError(
gettext('ir.msg_digits_validation_record',
**error_args))
value = getattr(record, field_name)
if isinstance(digits, str):
digit_record = getattr(record, digits)
if digit_record:
digits = digit_record.get_digits()
else:
digits = None
if (value is None
or not digits
or any(d is None for d in digits)):
return
if isinstance(value, Decimal):
exp = Decimal('.'.join(['0', '0' * digits[1]]))
if value.quantize(exp) != value:
raise_error(value)
else:
if not (round(value, digits[1]) == float(value)):
raise_error(value)
# validate digits
if getattr(field, 'digits', None):
if is_pyson(field.digits):
pyson_digits = PYSONEncoder().encode(field.digits)
for record in records:
digits = _record_eval_pyson(
record, pyson_digits, encoded=True)
digits_test(record, digits, field_name)
else:
for record in records:
digits_test(record, field.digits, field_name)
if hasattr(field, 'forbidden_chars'):
for record in records:
value = getattr(record, field_name)
if value and any(
c in value for c in field.forbidden_chars):
error_args = cls.__names__(field_name)
error_args['value'] = value
error_args['chars'] = ','.join(
repr(c) for c in field.forbidden_chars
if c in value)
raise ForbiddenCharValidationError(gettext(
'ir.msg_forbidden_char_validation_record',
**error_args))
# validate selection
if hasattr(field, 'selection') and field.selection:
if isinstance(field.selection, (tuple, list)):
test = set(dict(field.selection).keys())
instance_sel_func = False
else:
sel_func = getattr(cls, field.selection)
instance_sel_func = is_instance_method(
cls, field.selection)
if not instance_sel_func:
test = set(dict(sel_func()))
for record in records:
value = getattr(record, field_name)
if field._type == 'reference':
if isinstance(value, ModelStorage):
value = value.__class__.__name__
elif value:
value, _ = value.split(',')
if instance_sel_func:
test = set(dict(sel_func(record)))
# None and '' are equivalent
if '' in test or None in test:
test.add('')
test.add(None)
if field._type != 'multiselection':
values = [value]
else:
values = value or []
for value in values:
if value not in test:
error_args = cls.__names__(field_name)
error_args['value'] = value
raise SelectionValidationError(gettext(
'ir.msg_selection_validation_record',
**error_args))
def format_test(value, format, field_name):
if not value:
return
if not isinstance(value, datetime.time):
value = value.time()
if value != datetime.datetime.strptime(
value.strftime(format), format).time():
error_args = cls.__names__(field_name)
error_args['value'] = value
raise TimeFormatValidationError(
gettext('ir.msg_time_format_validation_record',
**error_args))
# validate time format
if (field._type in ('datetime', 'time')
and field_name not in ('create_date', 'write_date')):
if is_pyson(field.format):
pyson_format = PYSONDecoder().encode(field.format)
for record in records:
env = EvalEnvironment(record, cls)
env.update(Transaction().context)
env['current_date'] = datetime.datetime.today()
env['time'] = time
env['context'] = Transaction().context
env['active_id'] = record.id
format = PYSONDecoder(env).decode(pyson_format)
format_test(getattr(record, field_name), format,
field_name)
else:
for record in records:
format_test(getattr(record, field_name),
field.format, field_name)
for record in records:
record.pre_validate()
cls.validate(records)
@classmethod
def _clean_defaults(cls, defaults):
pool = Pool()
vals = {}
for field in defaults.keys():
if '.' in field: # skip all related fields
continue
fld_def = cls._fields[field]
if fld_def._type in ('many2one', 'one2one'):
if isinstance(defaults[field], (list, tuple)):
vals[field] = defaults[field][0]
else:
vals[field] = defaults[field]
elif fld_def._type in ('one2many',):
obj = pool.get(fld_def.model_name)
vals[field] = []
for defaults2 in defaults[field]:
vals2 = obj._clean_defaults(defaults2)
vals[field].append(('create', [vals2]))
elif fld_def._type in ('many2many',):
vals[field] = [('add', defaults[field])]
elif fld_def._type in ('boolean',):
vals[field] = bool(defaults[field])
else:
vals[field] = defaults[field]
return vals
def __init__(self, id=None, **kwargs):
_ids = kwargs.pop('_ids', None)
_local_cache = kwargs.pop('_local_cache', None)
_transaction_cache = kwargs.pop('_transaction_cache', None)
transaction = kwargs.pop('_transaction', None)
if transaction is None:
transaction = Transaction()
self._transaction = transaction
self._user = transaction.user
self._context = transaction.context
if id is not None:
id = int(id)
if _ids is not None:
self._ids = _ids
assert id in _ids
else:
self._ids = [id]
if _transaction_cache is not None:
self._transaction_cache = _transaction_cache
else:
self._transaction_cache = transaction.get_cache()
if _local_cache is not None:
assert isinstance(_local_cache, LRUDictTransaction)
self._local_cache = _local_cache
else:
self._local_cache = local_cache(self.__class__, transaction)
super(ModelStorage, self).__init__(id, **kwargs)
@property
def _cache(self):
return self._transaction_cache[self.__name__]
def __getattr__(self, name):
try:
return super(ModelStorage, self).__getattr__(name)
except AttributeError:
if name.startswith('_') or self.id is None or self.id < 0:
raise
self._local_cache.refresh()
try:
return self._local_cache[self.id][name]
except KeyError:
pass
# fetch the definition of the field
try:
field = self._fields[name]
except KeyError:
raise AttributeError('"%s" has no attribute "%s"' % (self, name))
try:
if field._type not in ('many2one', 'reference'):
# fill local cache for quicker access later
value \
= self._local_cache[self.id][name] \
= self._cache[self.id][name]
return value
else:
skip_eager = name in self._cache[self.id]
except KeyError:
skip_eager = False
# build the list of fields we will fetch
ffields = {
name: field,
}
load_eager = field.loading == 'eager' and not skip_eager
multiple_getter = None
if (field.loading == 'lazy'
and isinstance(field, fields.Function)
and field.getter_multiple(
getattr(self.__class__, field.getter))):
multiple_getter = field.getter
if load_eager or multiple_getter:
FieldAccess = Pool().get('ir.model.field.access')
fread_accesses = {}
fread_accesses.update(FieldAccess.check(self.__name__,
list(self._fields.keys()), 'read', access=True))
to_remove = set(x for x, y in fread_accesses.items()
if not y and x != name)
def not_cached(item):
fname, field = item
return ((self.id not in self._cache
or fname not in self._cache[self.id])
and (self.id not in self._local_cache
or fname not in self._local_cache[self.id]))
def to_load(item):
fname, field = item
if fname in to_remove:
return False
if multiple_getter:
return getattr(field, 'getter', None) == multiple_getter
return field.loading == 'eager'
ifields = filter(to_load,
filter(not_cached,
iter(self._fields.items())))
ifields = islice(ifields, 0, _cache_field)
ffields.update(ifields)
require_context_field = False
# add datetime_field
for field in list(ffields.values()):
if hasattr(field, 'datetime_field') and field.datetime_field:
require_context_field = True
if field.datetime_field not in ffields:
datetime_field = self._fields[field.datetime_field]
ffields[field.datetime_field] = datetime_field
# add depends of field with context
for field in list(ffields.values()):
if field.context:
eval_fields = fields.get_eval_fields(field.context)
for context_field_name in eval_fields:
if context_field_name not in field.depends:
continue
require_context_field = True
if context_field_name not in ffields:
context_field = self._fields.get(context_field_name)
ffields[context_field_name] = context_field
delete_records = self._transaction.delete_records.get(
self.__name__, set())
def filter_(id_):
return (id_ == self.id # Ensure the value is read
or (id_ not in delete_records
and (
id_ not in self._cache
or name not in self._cache[id_])
and (id_ not in self._local_cache
or name not in self._local_cache[id_])))
def unique(ids):
s = set()
for id_ in ids:
if id_ not in s:
s.add(id_)
yield id_
index = self._ids.index(self.id)
ids = chain(islice(self._ids, index, None),
islice(self._ids, 0, max(index - 1, 0)))
ids = islice(unique(filter(filter_, ids)),
self._transaction.database.IN_MAX)
def instantiate(field, value, data):
if field._type in ('many2one', 'one2one', 'reference'):
if value is None or value is False:
return None
elif field._type in ('one2many', 'many2many'):
if not value:
return ()
try:
if field._type == 'reference':
model_name, record_id = value.split(',')
Model = Pool().get(model_name)
try:
record_id = int(record_id)
except ValueError:
return value
if record_id < 0:
return value
value = record_id
else:
Model = field.get_target()
except KeyError:
return value
transaction = Transaction()
ctx = {}
if field.context:
pyson_context = PYSONEncoder().encode(field.context)
ctx.update(PYSONDecoder(data).decode(pyson_context))
datetime_ = None
if getattr(field, 'datetime_field', None):
datetime_ = data.get(field.datetime_field)
ctx = {'_datetime': datetime_}
with transaction.set_context(**ctx):
kwargs = {}
key = (Model, freeze(ctx))
if key not in model2cache:
model2cache[key] = local_cache(Model, transaction)
kwargs['_local_cache'] = model2cache[key]
kwargs['_ids'] = ids = model2ids.setdefault(key, [])
kwargs['_transaction_cache'] = transaction.get_cache()
kwargs['_transaction'] = transaction
if field._type in ('many2one', 'one2one', 'reference'):
value = int(value)
ids.append(value)
return Model(value, **kwargs)
elif field._type in ('one2many', 'many2many'):
ids.extend(int(x) for x in value)
return tuple(Model(id, **kwargs) for id in value)
model2ids = {}
model2cache = {}
# Read the data
with Transaction().set_current_transaction(self._transaction), \
self._transaction.set_user(self._user), \
self._transaction.reset_context(), \
self._transaction.set_context(
self._context, _check_access=False):
if (self.id in self._cache and name in self._cache[self.id]
and not require_context_field):
# Use values from cache
ids = islice(chain(islice(self._ids, index, None),
islice(self._ids, 0, max(index - 1, 0))),
self._transaction.database.IN_MAX)
ffields = {name: ffields[name]}
read_data = [{'id': i, name: self._cache[i][name]}
for i in ids
if i in self._cache and name in self._cache[i]]
else:
# Order data read to update cache in the same order
index = {i: n for n, i in enumerate(ids)}
read_data = self.read(list(index.keys()), list(ffields.keys()))
read_data.sort(key=lambda r: index[r['id']])
# create browse records for 'remote' models
no_local_cache = {'one2one', 'one2many', 'many2many', 'binary'}
for data in read_data:
id_ = data['id']
to_delete = set()
for fname, field in ffields.items():
fvalue = data[fname]
if field._type in {
'many2one', 'one2one', 'one2many', 'many2many',
'reference'}:
if (fname != name
and not require_context_field
and field._type not in no_local_cache):
continue
fvalue = instantiate(field, data[fname], data)
if id_ == self.id and fname == name:
value = fvalue
if fname not in self._local_cache[id_]:
self._local_cache[id_][fname] = fvalue
if (field._type in no_local_cache
or field.context
or getattr(field, 'datetime_field', None)
or isinstance(field, fields.Function)):
to_delete.add(fname)
self._cache[id_]._update(
**{k: v for k, v in data.items() if k not in to_delete})
return value
@property
def _save_values(self):
values = {}
if not self._values:
return values
for fname, value in self._values._items():
field = self._fields[fname]
if isinstance(field, fields.Function) and not field.setter:
continue
if field._type in ('many2one', 'one2one', 'reference'):
if value:
if ((value.id is None or value.id < 0)
and field._type != 'reference'):
value.save()
if field._type == 'reference':
value = str(value)
else:
value = value.id
if field._type in ('one2many', 'many2many'):
targets = value
if self.id is not None and self.id >= 0:
_values, self._values = self._values, None
try:
previous = [t.id for t in getattr(self, fname)]
finally:
self._values = _values
else:
previous = []
to_add = []
to_create = []
to_write = []
for target in targets:
if (field._type == 'one2many'
and field.field
and target._values):
t_values = target._values._copy()
# Don't look at reverse field
target._values._pop(field.field, None)
else:
t_values = None
try:
if target.id is None or target.id < 0:
to_create.append(target._save_values)
else:
if target.id in previous:
previous.remove(target.id)
else:
to_add.append(target.id)
target_values = target._save_values
if target_values:
to_write.append(
('write', [target.id], target_values))
finally:
if t_values:
target._values = t_values
value = []
if previous:
to_delete, to_remove = [], []
deleted = removed = None
if self._deleted:
deleted = self._deleted[fname]
if self._removed:
removed = self._removed[fname]
for id_ in previous:
if deleted and id_ in deleted:
to_delete.append(id_)
elif removed and id_ in removed:
to_remove.append(id_)
elif field._type == 'one2many':
to_delete.append(id_)
else:
to_remove.append(id_)
if to_delete:
value.append(('delete', to_delete))
if to_remove:
value.append(('remove', to_remove))
if to_add:
value.append(('add', to_add))
if to_create:
value.append(('create', to_create))
if to_write:
value.extend(to_write)
values[fname] = value
return values
@dualmethod
def save(cls, records):
while records:
latter = []
values = {}
save_values = {}
to_create = []
to_write = []
first = next(iter(records))
transaction = first._transaction
user = first._user
context = first._context
for record in records:
if (record._transaction != transaction
or user != record._user
or context != record._context):
latter.append(record)
continue
save_values[record] = record._save_values
values[record] = record._values
record._values = None
if record.id is None or record.id < 0:
to_create.append(record)
elif save_values[record]:
to_write.append(record)
transaction = Transaction()
try:
with transaction.set_current_transaction(transaction), \
transaction.set_user(user), \
transaction.reset_context(), \
transaction.set_context(context, _check_access=False):
if to_create:
news = cls.create([save_values[r] for r in to_create])
for record, new in zip(to_create, news):
record._ids.remove(record.id)
record._id = new.id
record._ids.append(record.id)
if to_write:
cls.write(*sum(
(([r], save_values[r]) for r in to_write), ()))
except Exception:
for record in to_create + to_write:
record._values = values[record]
raise
for record in to_create + to_write:
record._init_values = None
record._deleted = None
record._removed = None
records = latter
class EvalEnvironment(dict):
__slots__ = ('_record', '_model')
def __init__(self, record, Model):
super(EvalEnvironment, self).__init__()
self._record = record
self._model = Model
def __getitem__(self, item):
if item.startswith('_parent_'):
field = item[8:]
model_name = self._model._fields[field].model_name
ParentModel = Pool().get(model_name)
return EvalEnvironment(getattr(self._record, field), ParentModel)
if item in self._model._fields:
value = getattr(self._record, item)
if isinstance(value, Model):
if self._model._fields[item]._type == 'reference':
return str(value)
return value.id
elif (isinstance(value, (list, tuple))
and value and isinstance(value[0], Model)):
return [r.id for r in value]
else:
return value
return super(EvalEnvironment, self).__getitem__(item)
def __getattr__(self, item):
try:
return self.__getitem__(item)
except KeyError as exception:
raise AttributeError(*exception.args)
def get(self, item, default=None):
try:
return self.__getitem__(item)
except Exception:
pass
return super(EvalEnvironment, self).get(item, default)
def __bool__(self):
return bool(self._record)
def _record_eval_pyson(record, source, encoded=False):
transaction = Transaction()
if not encoded:
pyson = _pyson_encoder.encode(source)
else:
pyson = source
env = EvalEnvironment(record, record.__class__)
env.update(transaction.context)
env['current_date'] = datetime.datetime.today()
env['time'] = time
env['context'] = transaction.context
env['active_id'] = record.id
return PYSONDecoder(env).decode(pyson)
_pyson_encoder = PYSONEncoder()