From 1d8b232dafcf291e069ec1f788430006e57faea5 Mon Sep 17 00:00:00 2001 From: Jiri Kyjovsky Date: Tue, 19 Sep 2023 15:42:38 +0200 Subject: [PATCH] frontend: unify naming convention for safe methods Originally, safe methods were considered as methods raising ObjectNotFound for API (mainly with session.one() method). Now methods which returns None or ignores the error completely are also considered as "safe". For the sake of consistency: - *_noop_safe -> methods that ignores error completely (they basically logs) - *_none_safe -> returns None if object was not found in the database - *_safe -> raises an exception (ObjectNotFound) if no object found --- ...d3_add_buildchroot_id_and_coprchroot_id.py | 1 + .../coprs/logic/builds_logic.py | 4 ++-- .../coprs/logic/complex_logic.py | 21 +++++++++++++++---- .../coprs_frontend/coprs/logic/coprs_logic.py | 14 ++++++------- .../views/apiv3_ns/apiv3_build_chroots.py | 8 +++---- .../coprs/views/apiv3_ns/apiv3_builds.py | 2 +- .../coprs/views/apiv3_ns/apiv3_monitor.py | 2 +- .../coprs/views/backend_ns/backend_general.py | 6 +++--- 8 files changed, 36 insertions(+), 22 deletions(-) diff --git a/frontend/coprs_frontend/alembic/versions/4d06318043d3_add_buildchroot_id_and_coprchroot_id.py b/frontend/coprs_frontend/alembic/versions/4d06318043d3_add_buildchroot_id_and_coprchroot_id.py index b90ea30cf..375b3b0a9 100644 --- a/frontend/coprs_frontend/alembic/versions/4d06318043d3_add_buildchroot_id_and_coprchroot_id.py +++ b/frontend/coprs_frontend/alembic/versions/4d06318043d3_add_buildchroot_id_and_coprchroot_id.py @@ -9,6 +9,7 @@ import time import sqlalchemy as sa +from sqlalchemy.ext import declarative from alembic import op revision = '4d06318043d3' diff --git a/frontend/coprs_frontend/coprs/logic/builds_logic.py b/frontend/coprs_frontend/coprs/logic/builds_logic.py index a051ade7d..b30ac66a6 100644 --- a/frontend/coprs_frontend/coprs/logic/builds_logic.py +++ b/frontend/coprs_frontend/coprs/logic/builds_logic.py @@ -381,7 +381,7 @@ def get_pending_build_tasks(cls, background=None, data_type=None): return query @classmethod - def get_build_task(cls, task_id): + def get_build_task_safe(cls, task_id): try: build_id, chroot_name = task_id.split("-", 1) except ValueError: @@ -411,7 +411,7 @@ def get_multiple_by_copr(cls, copr): def get_copr_builds_list(cls, copr, dirname=None): query = models.Build.query.filter(models.Build.copr_id==copr.id) if dirname: - copr_dir = coprs_logic.CoprDirsLogic.get_by_copr(copr, dirname) + copr_dir = coprs_logic.CoprDirsLogic.get_by_copr_safe(copr, dirname) query = query.filter(models.Build.copr_dir_id==copr_dir.id) query = query.options(selectinload('build_chroots'), selectinload('package')) return query diff --git a/frontend/coprs_frontend/coprs/logic/complex_logic.py b/frontend/coprs_frontend/coprs/logic/complex_logic.py index 4c1007298..c7501b30b 100644 --- a/frontend/coprs_frontend/coprs/logic/complex_logic.py +++ b/frontend/coprs_frontend/coprs/logic/complex_logic.py @@ -184,7 +184,7 @@ def get_group_copr_safe(group_name, copr_name, **kwargs): def get_copr_safe(user_name, copr_name, **kwargs): """ Get one project. - This always return personal project. For group projects see get_group_copr_safe(). + This always return personal project. For group projects see get_group_copr_raise_safe(). """ try: return CoprsLogic.get(user_name, copr_name, **kwargs).filter(Copr.group_id.is_(None)).one() @@ -201,6 +201,19 @@ def get_copr_by_owner_safe(owner_name, copr_name, **kwargs): @staticmethod def get_copr_by_repo_safe(repo_url): + """ + Safely get copr repo by repo url. + + Args: + repo_url: str + + Returns: + Copr repo or None in case of invalid url format or different url + scheme than copr. + + Raises: + ObjectNotFound if no such Copr (group) repo was found. + """ copr_repo = helpers.copr_repo_fullname(repo_url) if not copr_repo: return None @@ -212,7 +225,7 @@ def get_copr_by_repo_safe(repo_url): return ComplexLogic.get_copr_by_owner_safe(owner, copr) @staticmethod - def get_copr_dir_safe(ownername, copr_dirname, **kwargs): + def get_copr_dir_safe(ownername, copr_dirname): try: return CoprDirsLogic.get_by_ownername(ownername, copr_dirname).one() except sqlalchemy.orm.exc.NoResultFound: @@ -238,7 +251,7 @@ def get_build_safe(build_id): message="Build {} does not exist.".format(build_id)) @staticmethod - def get_build_chroot(build_id, chrootname): + def get_build_chroot_safe(build_id, chrootname): """ Return a `models.BuildChroot` instance based on build ID and name of the chroot. If there is no such chroot, `ObjectNotFound` execption is raised. @@ -281,7 +294,7 @@ def get_group_by_name_safe(group_name): @staticmethod def get_copr_chroot_safe(copr, chroot_name): try: - chroot = CoprChrootsLogic.get_by_name_safe(copr, chroot_name) + chroot = CoprChrootsLogic.get_by_name_none_safe(copr, chroot_name) except (ValueError, KeyError, RuntimeError) as e: raise ObjectNotFound(message=str(e)) diff --git a/frontend/coprs_frontend/coprs/logic/coprs_logic.py b/frontend/coprs_frontend/coprs/logic/coprs_logic.py index d3a41746c..c6c2e468d 100644 --- a/frontend/coprs_frontend/coprs/logic/coprs_logic.py +++ b/frontend/coprs_frontend/coprs/logic/coprs_logic.py @@ -185,7 +185,7 @@ def get_by_ownername(cls, ownername): return cls.filter_by_ownername(query, ownername) @classmethod - def get_by_ownername_coprname(cls, ownername, coprname): + def get_by_ownername_coprname_safe(cls, ownername, coprname): """ Return a Copr object owned by OWNERNAME (either '@groupname' or 'username') with a name COPRNAME. @@ -206,7 +206,7 @@ def get_by_ownername_and_dirname(cls, ownername, dirname): # Some of the calling methods (routes) strictly require us not to check # if the dirname exists. coprname = CoprDirsLogic.copr_name_from_dirname(dirname) - return cls.get_by_ownername_coprname(ownername, coprname) + return cls.get_by_ownername_coprname_safe(ownername, coprname) @classmethod def filter_without_ids(cls, query, ids): @@ -622,7 +622,7 @@ def request_permission(cls, copr, user, permission, req_bool): class CoprDirsLogic(object): @classmethod - def get_by_copr_safe(cls, copr, dirname): + def get_by_copr_none_safe(cls, copr, dirname): """ Return _query_ for getting CoprDir by Copr and dirname """ @@ -632,12 +632,12 @@ def get_by_copr_safe(cls, copr, dirname): .filter(models.CoprDir.name==dirname)).first() @classmethod - def get_by_copr(cls, copr, dirname): + def get_by_copr_safe(cls, copr, dirname): """ Return CoprDir instance per given Copr instance and dirname. Raise ObjectNotFound if it doesn't exist. """ - coprdir = cls.get_by_copr_safe(copr, dirname) + coprdir = cls.get_by_copr_none_safe(copr, dirname) if not coprdir: raise exceptions.ObjectNotFound( "Dirname '{}' doesn't exist in '{}' copr".format( @@ -669,7 +669,7 @@ def get_or_create(cls, copr, dirname, trusted_caller=False): submitted. We don't create the "main" CoprDirs here (those are created when a new project is created. """ - copr_dir = cls.get_by_copr_safe(copr, dirname) + copr_dir = cls.get_by_copr_none_safe(copr, dirname) if copr_dir: return copr_dir @@ -948,7 +948,7 @@ def get_by_name(cls, copr, chroot_name, active_only=True): return cls.get_by_mock_chroot_id(copr, mc.id) @classmethod - def get_by_name_safe(cls, copr, chroot_name): + def get_by_name_none_safe(cls, copr, chroot_name): """ :rtype: models.CoprChroot """ diff --git a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_build_chroots.py b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_build_chroots.py index dc5ec446c..4444d254f 100644 --- a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_build_chroots.py +++ b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_build_chroots.py @@ -19,7 +19,7 @@ def to_dict(build_chroot): def build_config(build_chroot): config = BuildConfigLogic.generate_build_config(build_chroot.build.copr, build_chroot.name) - copr_chroot = CoprChrootsLogic.get_by_name_safe(build_chroot.build.copr, build_chroot.name) + copr_chroot = CoprChrootsLogic.get_by_name_none_safe(build_chroot.build.copr, build_chroot.name) dict_data = { "repos": config.get("repos"), "additional_repos": BuildConfigLogic.generate_additional_repos(copr_chroot), @@ -40,7 +40,7 @@ def build_config(build_chroot): @apiv3_ns.route("/build-chroot//", methods=GET) # deprecated @query_params() def get_build_chroot(build_id, chrootname): - chroot = ComplexLogic.get_build_chroot(build_id, chrootname) + chroot = ComplexLogic.get_build_chroot_safe(build_id, chrootname) return flask.jsonify(to_dict(chroot)) @@ -62,7 +62,7 @@ def get_build_chroot_list(build_id, **kwargs): @apiv3_ns.route("/build-chroot/build-config//", methods=GET) # deprecated @query_params() def get_build_chroot_config(build_id, chrootname): - chroot = ComplexLogic.get_build_chroot(build_id, chrootname) + chroot = ComplexLogic.get_build_chroot_safe(build_id, chrootname) return flask.jsonify(build_config(chroot)) @@ -72,5 +72,5 @@ def get_build_chroot_built_packages(build_id, chrootname): """ Return built packages (NEVRA dicts) for a given build chroot """ - chroot = ComplexLogic.get_build_chroot(build_id, chrootname) + chroot = ComplexLogic.get_build_chroot_safe(build_id, chrootname) return flask.jsonify(chroot.results_dict) diff --git a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_builds.py b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_builds.py index 83a352ece..d8766db83 100644 --- a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_builds.py +++ b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_builds.py @@ -233,7 +233,7 @@ def check_before_build(): # Raises an exception if CoprDir doesn't exist if data["project_dirname"]: - CoprDirsLogic.get_by_copr(copr, data["project_dirname"]) + CoprDirsLogic.get_by_copr_safe(copr, data["project_dirname"]) # Permissions check if not flask.g.user.can_build_in(copr): diff --git a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_monitor.py b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_monitor.py index ed848a692..8a18a5f5f 100644 --- a/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_monitor.py +++ b/frontend/coprs_frontend/coprs/views/apiv3_ns/apiv3_monitor.py @@ -82,7 +82,7 @@ def package_monitor(ownername, projectname, project_dirname=None): additional_fields = set() if project_dirname: - copr_dir = CoprDirsLogic.get_by_copr(copr, project_dirname) + copr_dir = CoprDirsLogic.get_by_copr_safe(copr, project_dirname) else: copr_dir = copr.main_dir diff --git a/frontend/coprs_frontend/coprs/views/backend_ns/backend_general.py b/frontend/coprs_frontend/coprs/views/backend_ns/backend_general.py index 8a7b4c34a..b3f522486 100755 --- a/frontend/coprs_frontend/coprs/views/backend_ns/backend_general.py +++ b/frontend/coprs_frontend/coprs/views/backend_ns/backend_general.py @@ -171,7 +171,7 @@ def get_build_record(task, for_backend=False): "repo_priority": task.build.copr.repo_priority }) - copr_chroot = CoprChrootsLogic.get_by_name_safe(task.build.copr, task.mock_chroot.name) + copr_chroot = CoprChrootsLogic.get_by_name_none_safe(task.build.copr, task.mock_chroot.name) modules = copr_chroot.module_setup_commands if modules: build_record["modules"] = {'toggle': modules} @@ -275,7 +275,7 @@ def build_task_canceled(task_id): if not was_running: if '-' in task_id: try: - build_chroot = BuildsLogic.get_build_task(task_id) + build_chroot = BuildsLogic.get_build_task_safe(task_id) build_chroot.status = StatusEnum("canceled") except ObjectNotFound: pass @@ -369,7 +369,7 @@ def _stream(): @backend_ns.route("/get-build-task/") def get_build_task(task_id): try: - task = BuildsLogic.get_build_task(task_id) + task = BuildsLogic.get_build_task_safe(task_id) build_record = get_build_record(task) return flask.jsonify(build_record) except CoprHttpException as ex: