except Exception as e: # TODO refine
raise DbException(str(e))
- def _update(self, db_item, update_dict, unset=None, pull=None, push=None):
+ def _update(self, db_item, update_dict, unset=None, pull=None, push=None, push_list=None, pull_list=None):
"""
Modifies an entry at database
:param db_item: entry of the table to update
ignored. If not exist, it is ignored
:param pull: Plain dictionary with the content to be removed from an array. It is a dot separated keys and value
if exist in the array is removed. If not exist, it is ignored
+ :param pull_list: Same as pull but values are arrays where each item is removed from the array
:param push: Plain dictionary with the content to be appended to an array. It is a dot separated keys and value
is appended to the end of the array
+ :param push_list: Same as push but values are arrays where each item is and appended instead of appending the
+ whole array
:return: True if database has been changed, False if not; Exception on error
"""
def _iterate_keys(k, db_nested, populate=True):
k_list = k.split(".")
k_item_prev = k_list[0]
populated = False
+ if k_item_prev not in db_nested and populate:
+ populated = True
+ db_nested[k_item_prev] = None
for k_item in k_list[1:]:
if isinstance(db_nested[k_item_prev], dict):
if k_item not in db_nested[k_item_prev]:
while v in dict_to_update[key_to_update]:
dict_to_update[key_to_update].remove(v)
updated = True
+ if pull_list:
+ for dot_k, v in pull_list.items():
+ if not isinstance(v, list):
+ raise DbException("Invalid content at pull_list, '{}' must be an array".format(dot_k),
+ http_code=HTTPStatus.BAD_REQUEST)
+ try:
+ dict_to_update, key_to_update, _ = _iterate_keys(dot_k, db_item, populate=False)
+ except Exception:
+ continue
+ if key_to_update not in dict_to_update:
+ continue
+ if not isinstance(dict_to_update[key_to_update], list):
+ raise DbException("Cannot pull_list '{}'. Target is not a list".format(dot_k))
+ for single_v in v:
+ while single_v in dict_to_update[key_to_update]:
+ dict_to_update[key_to_update].remove(single_v)
+ updated = True
if push:
for dot_k, v in push.items():
dict_to_update, key_to_update, populated = _iterate_keys(dot_k, db_item)
else:
dict_to_update[key_to_update].append(v)
updated = True
+ if push_list:
+ for dot_k, v in push_list.items():
+ if not isinstance(v, list):
+ raise DbException("Invalid content at push_list, '{}' must be an array".format(dot_k),
+ http_code=HTTPStatus.BAD_REQUEST)
+ dict_to_update, key_to_update, populated = _iterate_keys(dot_k, db_item)
+ if isinstance(dict_to_update, dict) and key_to_update not in dict_to_update:
+ dict_to_update[key_to_update] = v.copy()
+ updated = True
+ elif populated and dict_to_update[key_to_update] is None:
+ dict_to_update[key_to_update] = v.copy()
+ updated = True
+ elif not isinstance(dict_to_update[key_to_update], list):
+ raise DbException("Cannot push '{}'. Target is not a list".format(dot_k),
+ http_code=HTTPStatus.CONFLICT)
+ else:
+ dict_to_update[key_to_update] += v
+ updated = True
return updated
except DbException:
except Exception as e: # TODO refine
raise DbException(str(e))
- def set_one(self, table, q_filter, update_dict, fail_on_empty=True, unset=None, pull=None, push=None):
+ def set_one(self, table, q_filter, update_dict, fail_on_empty=True, unset=None, pull=None, push=None,
+ push_list=None, pull_list=None):
"""
Modifies an entry at database
:param table: collection or table
ignored. If not exist, it is ignored
:param pull: Plain dictionary with the content to be removed from an array. It is a dot separated keys and value
if exist in the array is removed. If not exist, it is ignored
+ :param pull_list: Same as pull but values are arrays where each item is removed from the array
:param push: Plain dictionary with the content to be appended to an array. It is a dot separated keys and value
is appended to the end of the array
+ :param push_list: Same as push but values are arrays where each item is and appended instead of appending the
+ whole array
:return: Dict with the number of entries modified. None if no matching is found.
"""
with self.lock:
for i, db_item in self._find(table, self._format_filter(q_filter)):
- updated = self._update(db_item, update_dict, unset=unset, pull=pull, push=push)
+ updated = self._update(db_item, update_dict, unset=unset, pull=pull, push=push, push_list=push_list,
+ pull_list=pull_list)
return {"updated": 1 if updated else 0}
else:
if fail_on_empty:
raise DbException("Not found entry with _id='{}'".format(q_filter), HTTPStatus.NOT_FOUND)
return None
- def set_list(self, table, q_filter, update_dict, fail_on_empty=True, unset=None, pull=None, push=None):
+ def set_list(self, table, q_filter, update_dict, unset=None, pull=None, push=None, push_list=None, pull_list=None):
+ """Modifies al matching entries at database. Same as push. Do not fail if nothing matches"""
with self.lock:
updated = 0
- for i, db_item in self._find(table, self._format_filter(q_filter)):
- if self._update(db_item, update_dict, unset=unset, pull=pull, push=push):
+ found = 0
+ for _, db_item in self._find(table, self._format_filter(q_filter)):
+ found += 1
+ if self._update(db_item, update_dict, unset=unset, pull=pull, push=push, push_list=push_list,
+ pull_list=pull_list):
updated += 1
- if i == 0 and fail_on_empty:
- raise DbException("Not found entry with _id='{}'".format(q_filter), HTTPStatus.NOT_FOUND)
- return {"updated": updated} if i else None
+ # if not found and fail_on_empty:
+ # raise DbException("Not found entry with '{}'".format(q_filter), HTTPStatus.NOT_FOUND)
+ return {"updated": updated} if found else None
def replace(self, table, _id, indata, fail_on_empty=True):
"""
Add a new entry at database
:param table: collection or table
:param indata: content to be added
- :return: database id of the inserted element. Raises a DbException on error
+ :return: database '_id' of the inserted element. Raises a DbException on error
"""
try:
id = indata.get("_id")
Add a new entry at database
:param table: collection or table
:param indata_list: list content to be added
- :return: database ids of the inserted element. Raises a DbException on error
+ :return: list of inserted 'id's. Raises a DbException on error
"""
try:
_ids = []