summer_course_2024/hub/persistence/db_control.py

250 lines
9.1 KiB
Python
Raw Normal View History

"""
DBFactory performs read related operations
SPDX - License - Identifier: LGPL - 3.0 - or -later
Copyright © 2022 Concordia CERC group
Project CoderPeter Yefi peteryefi@gmail.com
"""
import json
2023-05-19 13:15:40 -04:00
from typing import Dict
2023-05-19 13:15:40 -04:00
from hub.persistence.repositories.application import Application
from hub.persistence.repositories.city import City
2023-05-19 13:15:40 -04:00
from hub.persistence.repositories.city_object import CityObject
from hub.persistence.repositories.simulation_results import SimulationResults
from hub.persistence.repositories.user import User
from hub.persistence.repositories.user import UserRoles
2023-05-17 12:30:11 -04:00
class DBControl:
"""
DBFactory class
"""
2022-12-07 19:06:17 -05:00
def __init__(self, db_name, app_env, dotenv_path):
self._city = City(db_name=db_name, dotenv_path=dotenv_path, app_env=app_env)
self._application = Application(db_name=db_name, app_env=app_env, dotenv_path=dotenv_path)
self._user = User(db_name=db_name, app_env=app_env, dotenv_path=dotenv_path)
self._city_object = CityObject(db_name=db_name, app_env=app_env, dotenv_path=dotenv_path)
2023-03-03 17:19:36 -05:00
self._simulation_results = SimulationResults(db_name=db_name, dotenv_path=dotenv_path, app_env=app_env)
2023-05-19 13:15:40 -04:00
def application_info(self, application_uuid) -> Application:
2023-03-03 17:19:36 -05:00
"""
Retrieve the application info for the given uuid from the database
:param application_uuid: the uuid for the application
2023-05-19 13:15:40 -04:00
:return: Application
2023-03-03 17:19:36 -05:00
"""
return self._application.get_by_uuid(application_uuid)
2022-11-22 20:20:12 -05:00
2023-05-19 13:15:40 -04:00
def user_info(self, name, password, application_id) -> User:
"""
Retrieve the user info for the given name and password and application_id from the database
:param name: the username
:param password: the user password
:param application_id: the application id
2023-05-19 13:15:40 -04:00
:return: User
"""
return self._user.get_by_name_application_id_and_password(name, password, application_id)
2023-05-19 13:15:40 -04:00
def user_login(self, name, password, application_uuid) -> User:
"""
Retrieve the user info from the database
:param name: the username
:param password: the user password
:param application_uuid: the application uuid
2023-05-19 13:15:40 -04:00
:return: User
"""
return self._user.get_by_name_application_uuid_and_password(name, password, application_uuid)
def cities_by_user_and_application(self, user_id, application_id) -> [City]:
2023-03-13 14:41:25 -04:00
"""
Retrieve the cities belonging to the user and the application from the database
2023-03-13 14:41:25 -04:00
:param user_id: User id
:param application_id: Application id
:return: [City]
"""
return self._city.get_by_user_id_and_application_id(user_id, application_id)
def building(self, name, user_id, application_id, scenario) -> CityObject:
"""
Retrieve the building from the database
:param name: Building name
:param user_id: User id
:param application_id: Application id
:param scenario: Scenario
:
"""
cities = self._city.get_by_user_id_application_id_and_scenario(user_id, application_id, scenario)
for city in cities:
result = self.building_info(name, city[0].id)
if result is not None:
return result
return None
2023-05-19 13:15:40 -04:00
def building_info(self, name, city_id) -> CityObject:
2023-03-13 14:41:25 -04:00
"""
Retrieve the building info from the database
2023-03-13 14:41:25 -04:00
:param name: Building name
2023-05-17 17:10:30 -04:00
:param city_id: City ID
2023-05-19 13:15:40 -04:00
:return: CityObject
2023-03-13 14:41:25 -04:00
"""
2023-07-26 15:03:31 -04:00
return self._city_object.get_by_name_or_alias_and_city(name, city_id)
2023-03-13 14:41:25 -04:00
def buildings_info(self, request_values, city_id) -> [CityObject]:
"""
Retrieve the buildings info from the database
:param request_values: Building names
:param city_id: City ID
:return: [CityObject]
"""
buildings = []
for name in request_values['names']:
buildings.append(self.building_info(name, city_id))
return buildings
def results(self, user_id, application_id, request_values, result_names=None) -> Dict:
"""
Retrieve the simulation results for the given cities from the database
:param user_id: the user id owning the results
:param application_id: the application id owning the results
:param request_values: dictionary containing the scenario and building names to grab the results
:param result_names: if given, filter the results to the selected names
"""
2023-03-13 14:41:25 -04:00
if result_names is None:
result_names = []
results = {}
for scenario in request_values['scenarios']:
for scenario_name in scenario.keys():
result_sets = self._city.get_by_user_id_application_id_and_scenario(
user_id,
application_id,
scenario_name
)
if result_sets is None:
continue
for result_set in result_sets:
city_id = result_set[0].id
results[scenario_name] = []
for building_name in scenario[scenario_name]:
_building = self._city_object.get_by_name_or_alias_and_city(building_name, city_id)
if _building is None:
continue
city_object_id = _building.id
_ = self._simulation_results.get_simulation_results_by_city_id_city_object_id_and_names(
city_id,
city_object_id,
result_names)
for value in _:
values = json.loads(value.values)
values["building"] = building_name
results[scenario_name].append(values)
return results
2023-05-17 12:30:11 -04:00
2023-07-26 15:03:31 -04:00
def persist_city(self, city: City, pickle_path, scenario, application_id: int, user_id: int):
2023-05-17 12:30:11 -04:00
"""
Creates a city into the database
2023-05-17 12:30:11 -04:00
:param city: City to be stored
:param pickle_path: Path to save the pickle file
2023-07-26 15:03:31 -04:00
:param scenario: Simulation scenario name
2023-05-17 12:30:11 -04:00
:param application_id: Application id owning this city
:param user_id: User who create the city
2023-05-19 13:15:40 -04:00
return identity_id
2023-05-17 12:30:11 -04:00
"""
return self._city.insert(city, pickle_path, scenario, application_id, user_id)
2023-05-17 12:30:11 -04:00
def update_city(self, city_id, city):
"""
Update an existing city in the database
2023-05-17 12:30:11 -04:00
:param city_id: the id of the city to update
:param city: the updated city object
"""
return self._city.update(city_id, city)
2023-05-17 12:30:11 -04:00
def persist_application(self, name: str, description: str, application_uuid: str):
"""
Creates information for an application in the database
2023-05-17 12:30:11 -04:00
:param name: name of application
:param description: the description of the application
:param application_uuid: the uuid of the application to be created
"""
return self._application.insert(name, description, application_uuid)
def update_application(self, name: str, description: str, application_uuid: str):
"""
Update the application information stored in the database
2023-05-17 12:30:11 -04:00
:param name: name of application
:param description: the description of the application
:param application_uuid: the uuid of the application to be created
"""
return self._application.update(application_uuid, name, description)
def add_simulation_results(self, name, values, city_id=None, city_object_id=None):
"""
Add simulation results to the city or to the city_object to the database
2023-05-17 12:30:11 -04:00
:param name: simulation and simulation engine name
:param values: simulation values in json format
:param city_id: city id or None
:param city_object_id: city object id or None
"""
return self._simulation_results.insert(name, values, city_id, city_object_id)
2023-05-17 12:30:11 -04:00
def create_user(self, name: str, application_id: int, password: str, role: UserRoles):
"""
Creates a new user in the database
2023-05-17 12:30:11 -04:00
:param name: the name of the user
:param application_id: the application id of the user
:param password: the password of the user
:param role: the role of the user
"""
return self._user.insert(name, password, role, application_id)
def update_user(self, user_id: int, name: str, password: str, role: UserRoles):
"""
Updates a user in the database
2023-05-17 12:30:11 -04:00
:param user_id: the id of the user
:param name: the name of the user
:param password: the password of the user
:param role: the role of the user
"""
return self._user.update(user_id, name, password, role)
def get_by_name_and_application(self, name: str, application: int):
"""
Retrieve a single user from the database
:param name: username
:param application: application accessing hub
"""
return self._user.get_by_name_and_application(name, application)
2023-05-17 12:30:11 -04:00
def delete_user(self, user_id):
"""
Delete a single user from the database
2023-05-17 12:30:11 -04:00
:param user_id: the id of the user to delete
"""
self._user.delete(user_id)
2023-05-17 12:30:11 -04:00
def delete_city(self, city_id):
2023-05-17 17:10:30 -04:00
"""
Deletes a single city from the database
:param city_id: the id of the city to get
2023-05-17 17:10:30 -04:00
"""
self._city.delete(city_id)
def delete_results_by_name(self, name, city_id=None, city_object_id=None):
"""
Deletes city object simulation results from the database
:param name: simulation name
:param city_id: if given, delete delete the results for the city with id city_id
:param city_object_id: if given, delete delete the results for the city object with id city_object_id
"""
self._simulation_results.delete(name, city_id=city_id, city_object_id=city_object_id)
def delete_application(self, application_uuid):
"""
Deletes a single application from the database
:param application_uuid: the id of the application to get
"""
self._application.delete(application_uuid)