howler-api 3.0.0.dev374__py3-none-any.whl

howler/common/classification.py

@@ -0,0 +1,979 @@
+import itertools
+import logging
+from copy import copy
+from typing import Any, Dict, KeysView, List, Optional, Set, Tuple, Union, cast
+
+from howler.common.exceptions import (
+    HowlerKeyError,
+    InvalidClassification,
+    InvalidDefinition,
+)
+from howler.common.loader import APP_NAME
+
+log = logging.getLogger(f"{APP_NAME}.classification")
+
+
+class Classification(object):
+    MIN_LVL = 1
+    MAX_LVL = 10000
+    NULL_LVL = 0
+    INVALID_LVL = 10001
+    NULL_CLASSIFICATION = "NULL"
+    INVALID_CLASSIFICATION = "INVALID"
+
+    def __init__(self, classification_definition: Dict):
+        """Returns the classification class instantiated with the classification_definition
+
+        Args:
+            classification_definition:  The classification definition dictionary,
+                                        see default classification.yml for an example.
+        """
+        banned_params_keys = [
+            "name",
+            "short_name",
+            "lvl",
+            "aliases",
+            "auto_select",
+            "css",
+            "description",
+        ]
+        self.original_definition = classification_definition
+        self.levels_map: dict[str, str] = {}
+        self.levels_map_stl = {}
+        self.levels_map_lts = {}
+        self.levels_styles_map = {}
+        self.levels_aliases = {}
+        self.access_req_map_lts = {}
+        self.access_req_map_stl = {}
+        self.access_req_aliases: dict[str, Any] = {}
+        self.groups_map_lts = {}
+        self.groups_map_stl = {}
+        self.groups_aliases: dict[str, Any] = {}
+        self.groups_auto_select = []
+        self.groups_auto_select_short = []
+        self.subgroups_map_lts = {}
+        self.subgroups_map_stl = {}
+        self.subgroups_aliases: dict[str, Any] = {}
+        self.subgroups_auto_select = []
+        self.subgroups_auto_select_short = []
+        self.params_map = {}
+        self.description = {}
+        self.invalid_mode = False
+        self._classification_cache = set()
+        self._classification_cache_short = set()
+
+        self.enforce = False
+        self.dynamic_groups = False
+
+        # Add Invalid classification
+        self.levels_map["INV"] = self.INVALID_LVL
+        self.levels_map[str(self.INVALID_LVL)] = "INV"
+        self.levels_map_stl["INV"] = self.INVALID_CLASSIFICATION
+        self.levels_map_lts[self.INVALID_CLASSIFICATION] = "INV"
+
+        # Add null classification
+        self.levels_map[self.NULL_CLASSIFICATION] = self.NULL_LVL
+        self.levels_map[str(self.NULL_LVL)] = self.NULL_CLASSIFICATION
+        self.levels_map_stl[self.NULL_CLASSIFICATION] = self.NULL_CLASSIFICATION
+        self.levels_map_lts[self.NULL_CLASSIFICATION] = self.NULL_CLASSIFICATION
+
+        log.debug("Beginning classification parsing")
+        try:
+            self.enforce = classification_definition.get("enforce", None)
+            if self.enforce is None:
+                raise HowlerKeyError("Enforce not set!")
+
+            self.dynamic_groups = classification_definition.get("dynamic_groups", None)
+            if self.enforce is None:
+                raise HowlerKeyError("Dynamic groups not set!")
+
+            if self.enforce:
+                self._classification_cache = self.list_all_classification_combinations()
+                self._classification_cache_short = self.list_all_classification_combinations(long_format=False)
+
+            if classification_definition.get("levels", None) is None:
+                raise HowlerKeyError("No classification levels provided!")
+
+            for x in classification_definition["levels"]:
+                short_name = x["short_name"]
+                name = x["name"]
+
+                if short_name in ["INV", "NULL"] or name in [
+                    self.INVALID_CLASSIFICATION,
+                    self.NULL_CLASSIFICATION,
+                ]:
+                    raise InvalidDefinition(
+                        "You cannot use reserved words NULL, INVALID or INV in your " "classification definition."
+                    )
+
+                lvl = int(x["lvl"])
+                if lvl > self.MAX_LVL:
+                    raise InvalidDefinition("Level over maximum classification level of %s." % self.MAX_LVL)
+                if lvl < self.MIN_LVL:
+                    raise InvalidDefinition("Level under minimum classification level of %s." % self.MIN_LVL)
+
+                self.levels_map[short_name] = lvl
+                self.levels_map[str(lvl)] = short_name
+                self.levels_map_stl[short_name] = name
+                self.levels_map_lts[name] = short_name
+                for a in x.get("aliases", []):
+                    self.levels_aliases[a] = short_name
+                self.params_map[short_name] = {k: v for k, v in x.items() if k not in banned_params_keys}
+                self.params_map[name] = self.params_map[short_name]
+                self.levels_styles_map[short_name] = x.get("css", {"color": "default"})
+                self.levels_styles_map[name] = self.levels_styles_map[short_name]
+                self.description[short_name] = x.get("description", "N/A")
+                self.description[name] = self.description[short_name]
+
+            if classification_definition.get("required", None) is None:
+                log.warning("No required tokens specified in classification definition!")
+
+            for x in classification_definition.get("required", []):
+                short_name = x["short_name"]
+                name = x["name"]
+                self.access_req_map_lts[name] = short_name
+                self.access_req_map_stl[short_name] = name
+                for a in x.get("aliases", []):
+                    self.access_req_aliases[a] = self.access_req_aliases.get(a, []) + [short_name]
+                self.params_map[short_name] = {k: v for k, v in x.items() if k not in banned_params_keys}
+                self.params_map[name] = self.params_map[short_name]
+                self.description[short_name] = x.get("description", "N/A")
+                self.description[name] = self.description[short_name]
+
+            if classification_definition.get("groups", None) is None:
+                log.debug("No groups specified in classification definition!")
+
+            for x in classification_definition.get("groups", []):
+                short_name = x["short_name"]
+                name = x["name"]
+                self.groups_map_lts[name] = short_name
+                self.groups_map_stl[short_name] = name
+                for a in x.get("aliases", []):
+                    self.groups_aliases[a] = list(set(self.groups_aliases.get(a, []) + [short_name]))
+                solitary_display_name = x.get("solitary_display_name", None)
+                if solitary_display_name:
+                    self.groups_aliases[solitary_display_name] = list(
+                        set(self.groups_aliases.get(solitary_display_name, []) + [short_name])
+                    )
+                if x.get("auto_select", False):
+                    self.groups_auto_select.append(name)
+                    self.groups_auto_select_short.append(short_name)
+                self.params_map[short_name] = {k: v for k, v in x.items() if k not in banned_params_keys}
+                self.params_map[name] = self.params_map[short_name]
+                self.description[short_name] = x.get("description", "N/A")
+                self.description[name] = self.description[short_name]
+
+            if classification_definition.get("subgroups", None) is None:
+                log.debug("No subgroups specified in classification definition!")
+
+            for x in classification_definition.get("subgroups", []):
+                short_name = x["short_name"]
+                name = x["name"]
+                self.subgroups_map_lts[name] = short_name
+                self.subgroups_map_stl[short_name] = name
+                for a in x.get("aliases", []):
+                    self.subgroups_aliases[a] = list(set(self.subgroups_aliases.get(a, []) + [short_name]))
+                solitary_display_name = x.get("solitary_display_name", None)
+                if solitary_display_name:
+                    self.subgroups_aliases[solitary_display_name] = list(
+                        set(self.subgroups_aliases.get(solitary_display_name, []) + [short_name])
+                    )
+                if x.get("auto_select", False):
+                    self.subgroups_auto_select.append(name)
+                    self.subgroups_auto_select_short.append(short_name)
+                self.params_map[short_name] = {k: v for k, v in x.items() if k not in banned_params_keys}
+                self.params_map[name] = self.params_map[short_name]
+                self.description[short_name] = x.get("description", "N/A")
+                self.description[name] = self.description[short_name]
+
+            if not self.is_valid(classification_definition["unrestricted"]):
+                raise InvalidDefinition("Classification definition's unrestricted classification is invalid.")
+
+            if not self.is_valid(classification_definition["restricted"]):
+                raise InvalidDefinition("Classification definition's restricted classification is invalid.")
+
+            self.UNRESTRICTED = classification_definition["unrestricted"]
+            self.RESTRICTED = classification_definition["restricted"]
+
+            self.UNRESTRICTED = self.normalize_classification(classification_definition["unrestricted"])
+            self.RESTRICTED = self.normalize_classification(classification_definition["restricted"])
+
+        except Exception as e:
+            self.UNRESTRICTED = self.NULL_CLASSIFICATION
+            self.RESTRICTED = self.INVALID_CLASSIFICATION
+
+            self.invalid_mode = True
+
+            log.warning(
+                "Invalid classification: %s. Setting classification mode to invalid",
+                str(e),
+            )
+
+    ############################
+    # Private functions
+    ############################
+    @staticmethod
+    def _build_combinations(items: Set, separator: str = "/", solitary_display: Optional[Dict] = None) -> Set:
+        if solitary_display is None:
+            solitary_display = {}
+
+        out = {""}
+        for i in items:
+            others = [x for x in items if x != i]
+            for x in range(len(others) + 1):
+                for c in itertools.combinations(others, x):
+                    value = separator.join(sorted([i] + list(c)))
+                    out.add(solitary_display.get(value, value))
+
+        return out
+
+    @staticmethod
+    def _list_items_and_aliases(data: List, long_format: bool = True) -> Set:
+        items = set()
+        for item in data:
+            if long_format:
+                items.add(item["name"])
+            else:
+                items.add(item["short_name"])
+
+        return items
+
+    def _get_c12n_level_index(self, c12n: str) -> str:
+        # Parse classifications in uppercase mode only
+        c12n = c12n.upper()
+
+        lvl = c12n.split("//")[0]
+        if lvl in self.levels_map:
+            return self.levels_map[lvl]
+        elif lvl in self.levels_map_lts:
+            return self.levels_map[self.levels_map_lts[lvl]]
+        elif lvl in self.levels_aliases:
+            return self.levels_map[self.levels_aliases[lvl]]
+        else:
+            raise InvalidClassification(
+                "Classification level '%s' was not found in " "your classification definition." % lvl
+            )
+
+    def _get_c12n_level_text(self, lvl_idx: int, long_format: bool = True) -> str:
+        text = self.levels_map.get(str(lvl_idx), None)
+        if not text:
+            raise InvalidClassification(
+                "Classification level number '%s' was not " "found in your classification definition." % lvl_idx
+            )
+        if long_format:
+            return self.levels_map_stl[text]
+        return text
+
+    def _get_c12n_required(self, c12n: str, long_format: bool = True) -> List:
+        # Parse classifications in uppercase mode only
+        c12n = c12n.upper()
+
+        return_set = set()
+        part_set = set(c12n.split("/"))
+
+        for p in part_set:
+            if p in self.access_req_map_lts:
+                return_set.add(self.access_req_map_lts[p])
+            elif p in self.access_req_map_stl:
+                return_set.add(p)
+            elif p in self.access_req_aliases:
+                for a in self.access_req_aliases[p]:
+                    return_set.add(a)
+
+        if long_format:
+            return sorted([self.access_req_map_stl[r] for r in return_set])
+        return sorted(list(return_set))
+
+    def _get_c12n_groups(self, c12n: str, long_format: bool = True) -> Tuple[List, List]:
+        # Parse classifications in uppercase mode only
+        c12n = c12n.upper()
+
+        g1_set = set()
+        g2_set = set()
+        others = set()
+
+        grp_part = c12n.split("//")
+        groups = []
+        for gp in grp_part:
+            gp = gp.replace("REL TO ", "")
+            gp = gp.replace("REL ", "")
+            temp_group = set([x.strip() for x in gp.split(",")])
+            for t in temp_group:
+                groups.extend(t.split("/"))
+
+        for g in groups:
+            if g in self.groups_map_lts:
+                g1_set.add(self.groups_map_lts[g])
+            elif g in self.groups_map_stl:
+                g1_set.add(g)
+            elif g in self.groups_aliases:
+                for a in self.groups_aliases[g]:
+                    g1_set.add(a)
+            elif g in self.subgroups_map_lts:
+                g2_set.add(self.subgroups_map_lts[g])
+            elif g in self.subgroups_map_stl:
+                g2_set.add(g)
+            elif g in self.subgroups_aliases:
+                for a in self.subgroups_aliases[g]:
+                    g2_set.add(a)
+            else:
+                others.add(g)
+
+        if self.dynamic_groups:
+            for o in others:
+                if (
+                    o not in self.access_req_map_lts
+                    and o not in self.access_req_map_stl
+                    and o not in self.access_req_aliases
+                    and o not in self.levels_map
+                    and o not in self.levels_map_lts
+                    and o not in self.levels_aliases
+                ):
+                    g1_set.add(o)
+
+        if long_format:
+            return sorted([self.groups_map_stl.get(r, r) for r in g1_set]), sorted(
+                [self.subgroups_map_stl[r] for r in g2_set]
+            )
+        return sorted(list(g1_set)), sorted(list(g2_set))
+
+    @staticmethod
+    def _can_see_required(user_req: List, req: List) -> bool:
+        return set(req).issubset(user_req)
+
+    @staticmethod
+    def _can_see_groups(user_groups: List, req: List) -> bool:
+        if len(req) == 0:
+            return True
+
+        for g in user_groups:
+            if g in req:
+                return True
+
+        return False
+
+    # noinspection PyTypeChecker
+    def _get_normalized_classification_text(
+        self,
+        lvl_idx: int,
+        req: List,
+        groups: List,
+        subgroups: List,
+        long_format: bool = True,
+        skip_auto_select: bool = False,
+    ) -> str:
+        # 1. Check for all required items if they need a specific classification lvl
+        required_lvl_idx = 0
+        for r in req:
+            required_lvl_idx = max(required_lvl_idx, self.params_map.get(r, {}).get("require_lvl", 0))
+        out = self._get_c12n_level_text(max(lvl_idx, required_lvl_idx), long_format=long_format)
+
+        # 2. Check for all required items if they should be shown inside the groups display part
+        req_grp = []
+        for r in req:
+            if self.params_map.get(r, {}).get("is_required_group"):
+                req_grp.append(r)
+        req = list(set(req).difference(set(req_grp)))
+
+        if req:
+            out += "//" + "/".join(req)
+        if req_grp:
+            out += "//" + "/".join(sorted(req_grp))
+
+        # 3. Add auto-selected subgroups
+        if long_format:
+            if len(subgroups) > 0 and len(self.subgroups_auto_select) > 0 and not skip_auto_select:
+                subgroups = sorted(list(set(subgroups).union(set(self.subgroups_auto_select))))
+        else:
+            if len(subgroups) > 0 and len(self.subgroups_auto_select_short) > 0 and not skip_auto_select:
+                subgroups = sorted(list(set(subgroups).union(set(self.subgroups_auto_select_short))))
+
+        # 4. For every subgroup, check if the subgroup requires or is limited to a specific group
+        temp_groups = []
+        for sg in subgroups:
+            required_group = self.params_map.get(sg, {}).get("require_group", None)
+            if required_group is not None:
+                temp_groups.append(required_group)
+
+            limited_to_group = self.params_map.get(sg, {}).get("limited_to_group", None)
+            if limited_to_group is not None:
+                if limited_to_group in temp_groups:
+                    temp_groups = [limited_to_group]
+                else:
+                    temp_groups = []
+
+        for g in temp_groups:
+            if long_format:
+                groups.append(self.groups_map_stl.get(g, g))
+            else:
+                groups.append(self.groups_map_lts.get(g, g))
+        groups = list(set(groups))
+
+        # 5. Add auto-selected groups
+        if long_format:
+            if len(groups) > 0 and len(self.groups_auto_select) > 0 and not skip_auto_select:
+                groups = sorted(list(set(groups).union(set(self.groups_auto_select))))
+        else:
+            if len(groups) > 0 and len(self.groups_auto_select_short) > 0 and not skip_auto_select:
+                groups = sorted(list(set(groups).union(set(self.groups_auto_select_short))))
+
+        if groups:
+            out += {True: "/", False: "//"}[len(req_grp) > 0]
+            if len(groups) == 1:
+                # 6. If only one group, check if it has a solitary display name.
+                grp = groups[0]
+                display_name = self.params_map.get(grp, {}).get("solitary_display_name", grp)
+                if display_name != grp:
+                    out += display_name
+                else:
+                    out += "REL TO " + grp
+            else:
+                if not long_format:
+                    # 7. In short format mode, check if there is an alias that can replace multiple groups
+                    for alias, values in self.groups_aliases.items():
+                        if len(values) > 1:
+                            if sorted(values) == groups:
+                                groups = [alias]
+                out += "REL TO " + ", ".join(sorted(groups))
+
+        if subgroups:
+            if len(groups) > 0 or len(req_grp) > 0:
+                out += "/"
+            else:
+                out += "//"
+            out += "/".join(sorted(subgroups))
+
+        return out
+
+    def _get_classification_parts(
+        self, c12n: str, long_format: bool = True
+    ) -> Tuple[Union[Union[int, str], Any], List, List, List]:
+        lvl_idx = self._get_c12n_level_index(c12n)
+        req = self._get_c12n_required(c12n, long_format=long_format)
+        groups, subgroups = self._get_c12n_groups(c12n, long_format=long_format)
+
+        return lvl_idx, req, groups, subgroups
+
+    @staticmethod
+    def _max_groups(groups_1: List, groups_2: List) -> List:
+        if len(groups_1) > 0 and len(groups_2) > 0:
+            groups = set(groups_1) & set(groups_2)
+        else:
+            groups = set(groups_1) | set(groups_2)
+
+        if len(groups_1) > 0 and len(groups_2) > 0 and len(groups) == 0:
+            # NOTE: Intersection generated nothing, we will raise an InvalidClassification exception
+            raise InvalidClassification(
+                "Could not find any intersection between the groups. %s & %s" % (groups_1, groups_2)
+            )
+
+        return list(groups)
+
+    # ++++++++++++++++++++++++
+    # Public functions
+    # ++++++++++++++++++++++++
+    # noinspection PyUnusedLocal
+    def list_all_classification_combinations(self, long_format: bool = True) -> Set:
+        combinations = set()
+
+        levels = self._list_items_and_aliases(self.original_definition["levels"], long_format=long_format)
+        reqs = self._list_items_and_aliases(self.original_definition["required"], long_format=long_format)
+        grps = self._list_items_and_aliases(self.original_definition["groups"], long_format=long_format)
+        sgrps = self._list_items_and_aliases(self.original_definition["subgroups"], long_format=long_format)
+
+        req_cbs = self._build_combinations(reqs)
+        if long_format:
+            grp_solitary_display = {
+                x["name"]: x["solitary_display_name"]
+                for x in self.original_definition["groups"]
+                if "solitary_display_name" in x
+            }
+        else:
+            grp_solitary_display = {
+                x["short_name"]: x["solitary_display_name"]
+                for x in self.original_definition["groups"]
+                if "solitary_display_name" in x
+            }
+        solitary_names = [
+            x["solitary_display_name"] for x in self.original_definition["groups"] if "solitary_display_name" in x
+        ]
+
+        grp_cbs = self._build_combinations(grps, separator=", ", solitary_display=grp_solitary_display)
+        sgrp_cbs = self._build_combinations(sgrps)
+
+        for p in itertools.product(levels, req_cbs):
+            cl = "//".join(p)
+            if cl.endswith("//"):
+                combinations.add(cl[:-2])
+            else:
+                combinations.add(cl)
+
+        temp_combinations = copy(combinations)
+        for p in itertools.product(temp_combinations, grp_cbs):
+            cl = "//REL TO ".join(p)
+            if cl.endswith("//REL TO "):
+                combinations.add(cl[:-9])
+            else:
+                combinations.add(cl)
+
+        for sol_name in solitary_names:
+            to_edit = []
+            to_find = "REL TO {sol_name}".format(sol_name=sol_name)
+            for c in combinations:
+                if to_find in c:
+                    to_edit.append(c)
+
+            for e in to_edit:
+                combinations.add(e.replace(to_find, sol_name))
+                combinations.remove(e)
+
+        temp_combinations = copy(combinations)
+        for p in itertools.product(temp_combinations, sgrp_cbs):
+            if "//REL TO " in p[0]:
+                cl = "/".join(p)
+
+                if cl.endswith("/"):
+                    combinations.add(cl[:-1])
+                else:
+                    combinations.add(cl)
+            else:
+                cl = "//REL TO ".join(p)
+
+                if cl.endswith("//REL TO "):
+                    combinations.add(cl[:-9])
+                else:
+                    combinations.add(cl)
+
+        return combinations
+
+    # noinspection PyUnusedLocal
+    def default_user_classification(self, user: Optional[str] = None, long_format: bool = True) -> str:
+        """You can overload this function to specify a way to get the default classification of a user.
+        By default, this function returns the UNRESTRICTED value of your classification definition.
+
+        Args:
+            user: Which user to get the classification for
+            long_format: Request a long classification format or not
+
+        Returns:
+            The classification in the specified format
+        """
+        return self.UNRESTRICTED
+
+    def get_parsed_classification_definition(self) -> Dict:
+        """Returns all dictionary of all the variables inside the classification object that will be used
+        to enforce classification throughout the system.
+        """
+        from copy import deepcopy
+
+        out = deepcopy(self.__dict__)
+        out["levels_map"].pop("INV", None)
+        out["levels_map"].pop(str(self.INVALID_LVL), None)
+        out["levels_map_stl"].pop("INV", None)
+        out["levels_map_lts"].pop("INVALID", None)
+        out["levels_map"].pop("NULL", None)
+        out["levels_map"].pop(str(self.NULL_LVL), None)
+        out["levels_map_stl"].pop("NULL", None)
+        out["levels_map_lts"].pop("NULL", None)
+        out.pop("_classification_cache", None)
+        out.pop("_classification_cache_short", None)
+        out.pop("original_definition", None)
+        return out
+
+    def get_access_control_parts(self, c12n: str, user_classification: bool = False) -> Dict:
+        """Returns a dictionary containing the different access parameters Lucene needs to build it's queries
+
+        Args:
+            c12n: The classification to get the parts from
+            user_classification: Is a user classification
+        """
+        if not self.enforce or self.invalid_mode:
+            c12n = self.UNRESTRICTED
+
+        try:
+            # Normalize the classification before gathering the parts
+            c12n = self.normalize_classification(c12n, skip_auto_select=user_classification)
+
+            access_lvl = self._get_c12n_level_index(c12n)
+            access_req = self._get_c12n_required(c12n, long_format=False)
+            access_grp1, access_grp2 = self._get_c12n_groups(c12n, long_format=False)
+
+            return {
+                "__access_lvl__": access_lvl,
+                "__access_req__": access_req,
+                "__access_grp1__": access_grp1 or ["__EMPTY__"],
+                "__access_grp2__": access_grp2 or ["__EMPTY__"],
+            }
+        except InvalidClassification:
+            if not self.enforce or self.invalid_mode:
+                return {
+                    "__access_lvl__": self.NULL_LVL,
+                    "__access_req__": [],
+                    "__access_grp1__": ["__EMPTY__"],
+                    "__access_grp2__": ["__EMPTY__"],
+                }
+            else:
+                raise
+
+    def get_access_control_req(self) -> Union[KeysView, List]:
+        """Returns a list of the different possible REQUIRED parts"""
+        if not self.enforce or self.invalid_mode:
+            return []
+
+        return self.access_req_map_stl.keys()
+
+    def get_access_control_groups(self) -> Union[KeysView, List]:
+        """Returns a list of the different possible GROUPS"""
+        if not self.enforce or self.invalid_mode:
+            return []
+
+        return self.groups_map_stl.keys()
+
+    def get_access_control_subgroups(self) -> Union[KeysView, List]:
+        """Returns a list of the different possible SUBGROUPS"""
+        if not self.enforce or self.invalid_mode:
+            return []
+
+        return self.subgroups_map_stl.keys()
+
+    def intersect_user_classification(self, user_c12n_1: str, user_c12n_2: str, long_format: bool = True) -> str:
+        """This function intersects two user classification to return the maximum classification
+        that both user could see.
+
+        Args:
+            user_c12n_1: First user classification
+            user_c12n_2: Second user classification
+            long_format: True/False in long format
+
+        Returns:
+            Intersected classification in the desired format
+        """
+        if not self.enforce or self.invalid_mode:
+            return self.UNRESTRICTED
+
+        # Normalize classifications before comparing them
+        if user_c12n_1 is not None:
+            user_c12n_1 = self.normalize_classification(user_c12n_1, skip_auto_select=True)
+        if user_c12n_2 is not None:
+            user_c12n_2 = self.normalize_classification(user_c12n_2, skip_auto_select=True)
+
+        if user_c12n_1 is None:
+            return user_c12n_2
+        if user_c12n_2 is None:
+            return user_c12n_1
+
+        lvl_idx_1, req_1, groups_1, subgroups_1 = self._get_classification_parts(user_c12n_1, long_format=long_format)
+        lvl_idx_2, req_2, groups_2, subgroups_2 = self._get_classification_parts(user_c12n_2, long_format=long_format)
+
+        req = list(set(req_1) & set(req_2))
+        groups = list(set(groups_1) & set(groups_2))
+        subgroups = list(set(subgroups_1) & set(subgroups_2))
+
+        return self._get_normalized_classification_text(
+            min(lvl_idx_1, lvl_idx_2),  # type: ignore
+            req,
+            groups,
+            subgroups,
+            long_format=long_format,
+            skip_auto_select=True,
+        )
+
+    def is_accessible(self, user_c12n: str, c12n: str, ignore_invalid: bool = False) -> bool:
+        """Given a user classification, check if a user is allow to see a certain classification
+
+        Args:
+            user_c12n: Maximum classification for the user
+            c12n: Classification the user which to see
+
+        Returns:
+            True is the user can see the classification
+        """
+        if self.invalid_mode:
+            return False
+
+        if not self.enforce:
+            return True
+
+        if c12n is None:
+            return True
+
+        try:
+            # Normalize classifications before comparing them
+            user_c12n = self.normalize_classification(user_c12n, skip_auto_select=True)
+            c12n = self.normalize_classification(c12n, skip_auto_select=True)
+
+            user_req = self._get_c12n_required(user_c12n)
+            user_groups, user_subgroups = self._get_c12n_groups(user_c12n)
+            req = self._get_c12n_required(c12n)
+            groups, subgroups = self._get_c12n_groups(c12n)
+
+            if self._get_c12n_level_index(user_c12n) >= self._get_c12n_level_index(c12n):
+                if not self._can_see_required(user_req, req):
+                    return False
+                if not self._can_see_groups(user_groups, groups):
+                    return False
+                if not self._can_see_groups(user_subgroups, subgroups):
+                    return False
+                return True
+            return False
+        except InvalidClassification:
+            if ignore_invalid:
+                return False
+            else:
+                raise
+
+    def is_valid(self, c12n: str, skip_auto_select: bool = False) -> bool:
+        """Performs a series of checks againts a classification to make sure it is valid in it's current form
+
+        Args:
+            c12n: The classification we want to validate
+            skip_auto_select: skip the auto selection phase
+
+        Returns:
+            True if the classification is valid
+        """
+        if not self.enforce:
+            return True
+
+        try:
+            # Classification normalization test
+            n_c12n = self.normalize_classification(c12n, skip_auto_select=skip_auto_select)
+            n_lvl_idx, n_req, n_groups, n_subgroups = self._get_classification_parts(n_c12n)
+            lvl_idx, req, groups, subgroups = self._get_classification_parts(c12n)
+        except InvalidClassification:
+            return False
+
+        if lvl_idx != n_lvl_idx:
+            return False
+
+        if sorted(req) != sorted(n_req):
+            return False
+
+        if sorted(groups) != sorted(n_groups):
+            return False
+
+        if sorted(subgroups) != sorted(n_subgroups):
+            return False
+
+        c12n = c12n.replace("REL TO ", "")
+        c12n = c12n.replace("REL ", "")
+        parts = c12n.split("//")
+
+        # There is a maximum of 3 parts
+        if len(parts) > 3:
+            return False
+
+        cur_part = parts.pop(0)
+        # First parts as to be a classification level part
+        if (
+            cur_part not in self.levels_aliases.keys()
+            and cur_part not in self.levels_map_lts.keys()
+            and cur_part not in self.levels_map_stl.keys()
+        ):
+            return False
+
+        check_groups = False
+        while len(parts) > 0:
+            # Can't be two groups sections.
+            if check_groups:
+                return False
+
+            cur_part = parts.pop(0)
+            items = cur_part.split("/")
+            comma_idx = None
+            for idx, i in enumerate(items):
+                if "," in i:
+                    comma_idx = idx
+
+            if comma_idx is not None:
+                items += [x.strip() for x in items.pop(comma_idx).split(",")]
+
+            for i in items:
+                if not check_groups:
+                    # If current item not found in access req, we might already be dealing with groups
+                    if (
+                        i not in self.access_req_aliases.keys()
+                        and i not in self.access_req_map_stl.keys()
+                        and i not in self.access_req_map_lts.keys()
+                    ):
+                        check_groups = True
+
+                if check_groups and not self.dynamic_groups:
+                    # If not groups. That stuff does not exists...
+                    if (
+                        i not in self.groups_aliases.keys()
+                        and i not in self.groups_map_stl.keys()
+                        and i not in self.groups_map_lts.keys()
+                        and i not in self.subgroups_aliases.keys()
+                        and i not in self.subgroups_map_stl.keys()
+                        and i not in self.subgroups_map_lts.keys()
+                    ):
+                        return False
+
+        return True
+
+    def max_classification(self, c12n_1: str, c12n_2: str, long_format: bool = True) -> str:
+        """Mixes to classification and returns to most restrictive form for them
+
+        Args:
+            c12n_1: First classification
+            c12n_2: Second classification
+            long_format: True/False in long format
+
+        Returns:
+            The most restrictive classification that we could create out of the two
+        """
+        if not self.enforce or self.invalid_mode:
+            return self.UNRESTRICTED
+
+        # Normalize classifications before comparing them
+        if c12n_1 is not None:
+            c12n_1 = self.normalize_classification(c12n_1)
+        if c12n_2 is not None:
+            c12n_2 = self.normalize_classification(c12n_2)
+
+        if c12n_1 is None:
+            return c12n_2
+        if c12n_2 is None:
+            return c12n_1
+
+        lvl_idx_1, req_1, groups_1, subgroups_1 = self._get_classification_parts(c12n_1, long_format=long_format)
+        lvl_idx_2, req_2, groups_2, subgroups_2 = self._get_classification_parts(c12n_2, long_format=long_format)
+
+        req = list(set(req_1) | set(req_2))
+        groups = self._max_groups(groups_1, groups_2)
+        subgroups = self._max_groups(subgroups_1, subgroups_2)
+
+        return self._get_normalized_classification_text(
+            cast(int, max(lvl_idx_1, lvl_idx_2)),
+            req,
+            groups,
+            subgroups,
+            long_format=long_format,  # type: ignore
+        )
+
+    def min_classification(self, c12n_1: str, c12n_2: str, long_format: bool = True) -> str:
+        """Mixes to classification and returns to least restrictive form for them
+
+        Args:
+            c12n_1: First classification
+            c12n_2: Second classification
+            long_format: True/False in long format
+
+        Returns:
+            The least restrictive classification that we could create out of the two
+        """
+        if not self.enforce or self.invalid_mode:
+            return self.UNRESTRICTED
+
+        # Normalize classifications before comparing them
+        if c12n_1 is not None:
+            c12n_1 = self.normalize_classification(c12n_1)
+        if c12n_2 is not None:
+            c12n_2 = self.normalize_classification(c12n_2)
+
+        if c12n_1 is None:
+            return c12n_2
+        if c12n_2 is None:
+            return c12n_1
+
+        lvl_idx_1, req_1, groups_1, subgroups_1 = self._get_classification_parts(c12n_1, long_format=long_format)
+        lvl_idx_2, req_2, groups_2, subgroups_2 = self._get_classification_parts(c12n_2, long_format=long_format)
+
+        req = list(set(req_1) & set(req_2))
+        if len(groups_1) > 0 and len(groups_2) > 0:
+            groups = list(set(groups_1) | set(groups_2))
+        else:
+            groups = []
+
+        if len(subgroups_1) > 0 and len(subgroups_2) > 0:
+            subgroups = list(set(subgroups_1) | set(subgroups_2))
+        else:
+            subgroups = []
+
+        return self._get_normalized_classification_text(
+            cast(int, min(lvl_idx_1, lvl_idx_2)),
+            req,
+            groups,
+            subgroups,
+            long_format=long_format,  # type: ignore
+        )
+
+    def normalize_classification(self, c12n: str, long_format: bool = True, skip_auto_select: bool = False) -> str:
+        """Normalize a given classification by applying the rules defined in the classification definition.
+        This function will remove any invalid parts and add missing parts to the classification.
+        It will also ensure that the display of the classification is always done the same way
+
+        Args:
+            c12n: Classification to normalize
+            long_format: True/False in long format
+            skip_auto_select: True/False skip group auto adding, use True when dealing with user's classifications
+
+        Returns:
+            A normalized version of the original classification
+        """
+        if not self.enforce or self.invalid_mode:
+            return self.UNRESTRICTED
+
+        # Has the classification has already been normalized before?
+        if long_format and c12n in self._classification_cache:
+            return c12n
+        if not long_format and c12n in self._classification_cache_short:
+            return c12n
+
+        lvl_idx, req, groups, subgroups = self._get_classification_parts(c12n, long_format=long_format)
+        new_c12n = self._get_normalized_classification_text(
+            lvl_idx,  # type: ignore
+            req,
+            groups,
+            subgroups,
+            long_format=long_format,
+            skip_auto_select=skip_auto_select,
+        )
+        if long_format:
+            self._classification_cache.add(new_c12n)
+        else:
+            self._classification_cache_short.add(new_c12n)
+
+        return new_c12n
+
+    def build_user_classification(self, c12n_1: str, c12n_2: str, long_format: bool = True) -> str:
+        """Mixes to classification and return the classification marking that would give access to the most data
+
+        Args:
+            c12n_1: First classification
+            c12n_2: Second classification
+            long_format: True/False in long format
+
+        Returns:
+            The classification that would give access to the most data
+        """
+        if not self.enforce or self.invalid_mode:
+            return self.UNRESTRICTED
+
+        # Normalize classifications before comparing them
+        if c12n_1 is not None:
+            c12n_1 = self.normalize_classification(c12n_1, skip_auto_select=True)
+        if c12n_2 is not None:
+            c12n_2 = self.normalize_classification(c12n_2, skip_auto_select=True)
+
+        if c12n_1 is None:
+            return c12n_2
+        if c12n_2 is None:
+            return c12n_1
+
+        lvl_idx_1, req_1, groups_1, subgroups_1 = self._get_classification_parts(c12n_1, long_format=long_format)
+        lvl_idx_2, req_2, groups_2, subgroups_2 = self._get_classification_parts(c12n_2, long_format=long_format)
+
+        req = list(set(req_1) | set(req_2))
+        groups = list(set(groups_1) | set(groups_2))
+        subgroups = list(set(subgroups_1) | set(subgroups_2))
+
+        return self._get_normalized_classification_text(
+            max(lvl_idx_1, lvl_idx_2),  # type: ignore
+            req,
+            groups,
+            subgroups,
+            long_format=long_format,
+            skip_auto_select=True,
+        )