fiftyone-ipintelligence-translation 4.5.0__tar.gz

fiftyone_ipintelligence_translation-4.5.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include version.txt
+include readme.md
+recursive-include src/fiftyone_ipintelligence_translation/translations *.yml

fiftyone_ipintelligence_translation-4.5.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: fiftyone_ipintelligence_translation
+Version: 4.5.0
+Summary: Country translation engines for 51Degrees on-premise IP Intelligence. Turns the weighted ISO country codes returned by the IP Intelligence engine into localized country names and complete ordered country lists.
+Home-page: https://51degrees.com/?utm_source=pypi&utm_medium=package&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-setup.py&utm_term=url
+Author: 51Degrees Engineering
+Author-email: engineering@51degrees.com
+License: EUPL-1.2
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fiftyone_pipeline_core
+Requires-Dist: fiftyone_pipeline_translation
+Requires-Dist: PyYAML
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# IP Intelligence Country Translation
+
+![51Degrees](https://51degrees.com/img/logo.png?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-readme.md&utm_term=ip-intelligence-country-translation "Data rewards the curious") **Python IP Intelligence Country Translation**
+
+[Developer Documentation](https://51degrees.com/documentation/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-readme.md&utm_term=ip-intelligence-country-translation "Developer Documentation")
+
+## Introduction
+
+This package adds two flow elements that build on the on-premise 51Degrees IP
+Intelligence engine.
+
+On-premise IP Intelligence returns country information as weighted lists of ISO
+country codes. These engines turn those codes into localized country names and
+produce complete ordered lists, so an application can render a dropdown of
+countries with the most probable country at the top.
+
+* `CountryCodeTranslationEngine` translates the weighted country codes into
+  English country names.
+* `CountriesTranslationEngine` translates the English names into the browser
+  language (resolved from the request evidence) and builds complete ordered
+  "All" lists of every known country, most probable first.
+
+These properties are only produced for the on-premise path. The cloud service
+already returns them in their final form.
+
+## Requirements
+
+* Python 3.8+
+
+## This package fiftyone_ipintelligence_translation
+
+Built on top of:
+
+* [fiftyone_pipeline_core](https://pypi.org/project/fiftyone-pipeline-core/)
+* [fiftyone_pipeline_translation](https://pypi.org/project/fiftyone-pipeline-translation/)

fiftyone_ipintelligence_translation-4.5.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

fiftyone_ipintelligence_translation-4.5.0/readme.md

@@ -0,0 +1,35 @@
+# IP Intelligence Country Translation
+
+![51Degrees](https://51degrees.com/img/logo.png?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-readme.md&utm_term=ip-intelligence-country-translation "Data rewards the curious") **Python IP Intelligence Country Translation**
+
+[Developer Documentation](https://51degrees.com/documentation/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-readme.md&utm_term=ip-intelligence-country-translation "Developer Documentation")
+
+## Introduction
+
+This package adds two flow elements that build on the on-premise 51Degrees IP
+Intelligence engine.
+
+On-premise IP Intelligence returns country information as weighted lists of ISO
+country codes. These engines turn those codes into localized country names and
+produce complete ordered lists, so an application can render a dropdown of
+countries with the most probable country at the top.
+
+* `CountryCodeTranslationEngine` translates the weighted country codes into
+  English country names.
+* `CountriesTranslationEngine` translates the English names into the browser
+  language (resolved from the request evidence) and builds complete ordered
+  "All" lists of every known country, most probable first.
+
+These properties are only produced for the on-premise path. The cloud service
+already returns them in their final form.
+
+## Requirements
+
+* Python 3.8+
+
+## This package fiftyone_ipintelligence_translation
+
+Built on top of:
+
+* [fiftyone_pipeline_core](https://pypi.org/project/fiftyone-pipeline-core/)
+* [fiftyone_pipeline_translation](https://pypi.org/project/fiftyone-pipeline-translation/)

fiftyone_ipintelligence_translation-4.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fiftyone_ipintelligence_translation-4.5.0/setup.py

@@ -0,0 +1,110 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+import setuptools
+import io
+import os
+import shutil
+
+
+def read(file_name):
+
+    """Read a text file and return the content as a string."""
+    try:
+        with io.open(
+            os.path.join(os.path.dirname(__file__), file_name), encoding="utf-8"
+        ) as f:
+            return f.read().strip()
+    except Exception:
+        return "0.0.0"
+
+
+def stage_translations():
+
+    """Copy the translation YAML files shipped in the ip-intelligence-data
+    submodule into the package so they are included in the built distribution.
+    This mirrors how the .NET project embeds the same files as resources. If the
+    submodule is not present the package falls back to reading it at run time,
+    so any failure here is ignored."""
+
+    here = os.path.dirname(os.path.abspath(__file__))
+    source = os.path.join(here, "..", "ip-intelligence-data", "Translations")
+    dest = os.path.join(
+        here, "src", "fiftyone_ipintelligence_translation", "translations")
+    if not os.path.isdir(source):
+        return
+    os.makedirs(dest, exist_ok=True)
+
+    def copy_yaml(folder):
+        for name in os.listdir(folder):
+            full = os.path.join(folder, name)
+            if os.path.isfile(full) and name.endswith((".yml", ".yaml")):
+                shutil.copyfile(full, os.path.join(dest, name))
+
+    copy_yaml(source)
+    osm = os.path.join(source, "OSM")
+    if os.path.isdir(osm):
+        copy_yaml(osm)
+
+
+try:
+    stage_translations()
+except Exception:
+    pass
+
+
+setuptools.setup(
+    name="fiftyone_ipintelligence_translation",
+    version=read("version.txt"),
+    author="51Degrees Engineering",
+    author_email="engineering@51degrees.com",
+    url="https://51degrees.com/?utm_source=pypi&utm_medium=package&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence_translation-setup.py&utm_term=url",
+    description=("Country translation engines for 51Degrees on-premise IP Intelligence. Turns the weighted ISO country codes returned by the IP Intelligence engine into localized country names and complete ordered country lists."),
+    long_description=read("readme.md"),
+    long_description_content_type='text/markdown',
+    python_requires=">=3.10",
+    packages=["fiftyone_ipintelligence_translation"],
+    package_dir={"": "src"},
+    package_data={
+        "fiftyone_ipintelligence_translation": ["translations/*.yml"]
+    },
+    install_requires=[
+        "fiftyone_pipeline_core",
+        "fiftyone_pipeline_translation",
+        "PyYAML"
+    ],
+    license="EUPL-1.2",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
+        "License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)",
+        "Operating System :: OS Independent",
+        "Topic :: Software Development :: Libraries :: Python Modules"
+    ],
+    include_package_data=True
+)

fiftyone_ipintelligence_translation-4.5.0/src/fiftyone_ipintelligence_translation/comparer.py

@@ -0,0 +1,51 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+import unicodedata
+
+
+def make_comparer(culture=None):
+
+    """!
+    Return a sort key function for ordering country names.
+
+    Python has no stable, dependency-free, process-local culture aware string
+    comparer equivalent to .NET's CultureInfo / StringComparer, so a Unicode
+    normalized, case-insensitive key is used instead: names are accent folded
+    (NFKD, dropping combining marks) and case folded. This gives a deterministic
+    alphabetical ordering that is stable across platforms. The same key function
+    is used by the engine and its tests so the ordering is self-consistent.
+
+    The culture argument is accepted for parity with the resolved locale (it is
+    also surfaced as the SortingCultureUsed property) but does not change the
+    ordering.
+    """
+
+    def key(name):
+        if name is None:
+            return ""
+        decomposed = unicodedata.normalize("NFKD", str(name))
+        without_marks = "".join(
+            char for char in decomposed if not unicodedata.combining(char))
+        return without_marks.casefold()
+
+    return key

fiftyone_ipintelligence_translation-4.5.0/src/fiftyone_ipintelligence_translation/constants.py

@@ -0,0 +1,34 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+
+class Constants:
+
+    """!
+    Constants used by the country translation flow elements.
+    """
+
+    # Element data key used by CountryCodeTranslationEngine.
+    COUNTRY_NAMES_KEY = "countrynames"
+
+    # Element data key used by CountriesTranslationEngine.
+    COUNTRY_NAMES_TRANSLATED_KEY = "countrynamestranslated"

fiftyone_ipintelligence_translation-4.5.0/src/fiftyone_ipintelligence_translation/countries_translation_engine.py

@@ -0,0 +1,209 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+from fiftyone_pipeline_core.aspectproperty_value import AspectPropertyValue
+from fiftyone_pipeline_translation.translation_engine_base import (
+    TranslationEngineBase)
+from fiftyone_pipeline_translation.missing_translation_behavior import (
+    MissingTranslationBehavior)
+
+from .constants import Constants
+from .comparer import make_comparer
+from .resources import get_country_resources
+
+
+class CountriesTranslationEngine(TranslationEngineBase):
+
+    """!
+    Engine which takes the English country name properties from the
+    CountryCodeTranslationEngine and the weighted country code properties from
+    the IP Intelligence engine, translates the country names to the browser
+    language, and produces complete ordered lists of all countries combining the
+    weighted results with all known countries.
+
+    The base class handles the weighted translations
+    (CountryNamesGeographical / Population to their Translated variants). This
+    subclass adds the "All" list logic on top. Results are stored under the
+    Constants.COUNTRY_NAMES_TRANSLATED_KEY element data key.
+    """
+
+    # Output properties added by this engine on top of the base translations.
+    _EXTRA_PROPERTIES = [
+        "CountryNamesGeographicalAllTranslated",
+        "CountryNamesPopulationAllTranslated",
+        "CountryCodesGeographicalAll",
+        "CountryCodesPopulationAll",
+        "SortingCultureUsed",
+    ]
+
+    def __init__(self, all_countries):
+
+        """!
+        Constructor.
+
+        @type all_countries: list
+        @param all_countries: Ordered list of (code, English name) pairs for
+        every known country, as loaded from countrycodes.en_GB.yml.
+        """
+
+        super().__init__(
+            # Source is the output of the CountryCodeTranslationEngine.
+            Constants.COUNTRY_NAMES_KEY,
+            [
+                ("CountryNamesGeographical",
+                 "CountryNamesGeographicalTranslated"),
+                ("CountryNamesPopulation",
+                 "CountryNamesPopulationTranslated"),
+            ],
+            get_country_resources(),
+            None,
+            MissingTranslationBehavior.ORIGINAL)
+
+        self.datakey = Constants.COUNTRY_NAMES_TRANSLATED_KEY
+
+        if all_countries is None:
+            raise ValueError("all_countries must not be None.")
+        self._all_countries = list(all_countries)
+        # The set of real country codes, used to drop the IP engine's no-match
+        # sentinel (e.g. "Unknown") from the "All" lists.
+        self._valid_codes = {
+            code.lower() for code, _name in self._all_countries}
+
+        for name in self._EXTRA_PROPERTIES:
+            self.properties[name] = {"type": "object"}
+
+    def process_internal(self, flowdata):
+
+        # Let the base class produce the weighted translated names.
+        super().process_internal(flowdata)
+
+        element_data = flowdata.get(self.datakey)
+
+        # Resolve the translator and locale used for the "All" lists.
+        translator, locale = self._resolve_translator(flowdata)
+        culture_used = (
+            locale.replace("_", "-")
+            if translator is not None and locale else "")
+        element_data.contents["sortingcultureused"] = culture_used
+        comparer = make_comparer(culture_used or None)
+
+        # Weighted codes come directly from the IP Intelligence element data.
+        ip_data = self._get_ip_data(flowdata)
+        geo_codes = self._weighted_list(ip_data, "CountryCodesGeographical")
+        pop_codes = self._weighted_list(ip_data, "CountryCodesPopulation")
+
+        # Weighted translated names come from the base class output.
+        geo_names = self._weighted_list(
+            element_data, "CountryNamesGeographicalTranslated")
+        pop_names = self._weighted_list(
+            element_data, "CountryNamesPopulationTranslated")
+
+        self._build_and_store(
+            element_data, geo_names, geo_codes, translator, comparer,
+            "CountryNamesGeographicalAllTranslated",
+            "CountryCodesGeographicalAll")
+        self._build_and_store(
+            element_data, pop_names, pop_codes, translator, comparer,
+            "CountryNamesPopulationAllTranslated",
+            "CountryCodesPopulationAll")
+
+        return True
+
+    @staticmethod
+    def _get_ip_data(flowdata):
+        try:
+            return flowdata.get("ip")
+        except Exception:
+            return None
+
+    @staticmethod
+    def _weighted_list(data, property_name):
+
+        """Return the list of weighted {"value", "weighting"} dictionaries for
+        a property, or an empty list when it is missing or has no value."""
+
+        if data is None:
+            return []
+        try:
+            value = data.get(property_name)
+        except Exception:
+            return []
+        if value is None:
+            return []
+        if isinstance(value, AspectPropertyValue):
+            return value.value() if value.has_value() else []
+        return value
+
+    def _build_and_store(
+            self, element_data, translated_names, weighted_codes, translator,
+            comparer, names_property, codes_property):
+
+        """Build the complete "All" lists for one dimension and store them in
+        the element data."""
+
+        # The weighted countries, most probable first. Keep only real country
+        # codes so the IP engine's no-match sentinel never leads the list.
+        weighted_tuples = [
+            tuple_
+            for tuple_ in self._build_weighted_tuples(
+                translated_names, weighted_codes, comparer)
+            if tuple_[0].lower() in self._valid_codes]
+
+        used_codes = {code.lower() for code, _name in weighted_tuples}
+
+        # Every remaining known country, alphabetical by translated name.
+        remaining = [
+            (code, english)
+            for code, english in self._all_countries
+            if code.lower() not in used_codes]
+        if translator is not None:
+            remaining = [
+                (code, translator.translate(english) or english)
+                for code, english in remaining]
+        remaining.sort(key=lambda pair: comparer(pair[1]))
+
+        all_tuples = weighted_tuples + remaining
+
+        element_data.contents[codes_property.lower()] = AspectPropertyValue(
+            value=[code for code, _name in all_tuples])
+        element_data.contents[names_property.lower()] = AspectPropertyValue(
+            value=[name for _code, name in all_tuples])
+
+    @staticmethod
+    def _build_weighted_tuples(translated_names, codes, comparer):
+
+        """Zip the weighted translated names with the weighted codes by index,
+        ordered by weighting descending then translated name ascending."""
+
+        if not translated_names or not codes:
+            return []
+        count = min(len(translated_names), len(codes))
+        tuples = []
+        for index in range(count):
+            name_item = translated_names[index]
+            code_item = codes[index]
+            tuples.append((
+                code_item["value"],
+                name_item["value"],
+                name_item.get("weighting", 0)))
+        tuples.sort(key=lambda item: (-item[2], comparer(item[1])))
+        return [(code, name) for code, name, _weighting in tuples]

fiftyone_ipintelligence_translation-4.5.0/src/fiftyone_ipintelligence_translation/countries_translation_engine_builder.py

@@ -0,0 +1,54 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+from .countries_translation_engine import CountriesTranslationEngine
+from .resources import get_all_countries
+
+
+class CountriesTranslationEngineBuilder:
+
+    """!
+    Builder for the CountriesTranslationEngine element. Loads the country code
+    resource (countrycodes.en_GB.yml) which lists all known country codes and
+    their English names. The country name translation resources (countries.*)
+    are handled by the base translation engine.
+    """
+
+    def __init__(self, logger_factory=None):
+
+        """!
+        Constructor.
+
+        @param logger_factory: Accepted for parity with the other SDKs; the
+        Python pipeline performs logging through the pipeline the element is
+        added to, so it is not required here.
+        """
+
+        self._logger_factory = logger_factory
+
+    def build(self):
+
+        """!
+        Build a new instance of CountriesTranslationEngine.
+        """
+
+        return CountriesTranslationEngine(get_all_countries())

fiftyone_ipintelligence_translation-4.5.0/src/fiftyone_ipintelligence_translation/country_code_translation_engine.py

@@ -0,0 +1,61 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+from fiftyone_pipeline_translation.translation_engine_base import (
+    TranslationEngineBase)
+from fiftyone_pipeline_translation.missing_translation_behavior import (
+    MissingTranslationBehavior)
+
+from .constants import Constants
+from .resources import get_country_code_resources
+
+
+class CountryCodeTranslationEngine(TranslationEngineBase):
+
+    """!
+    Engine which takes the weighted country code properties from the IP
+    Intelligence engine and translates them to country names. The country names
+    are always in English (the fixed en_GB resource). Results are stored under
+    the Constants.COUNTRY_NAMES_KEY element data key.
+
+    All translation files are loaded as package resources, so no configuration
+    is required.
+    """
+
+    def __init__(self):
+
+        """!
+        Constructor.
+        """
+
+        super().__init__(
+            # Source element data key of the IP Intelligence engine.
+            "ip",
+            [
+                ("CountryCodesGeographical", "CountryNamesGeographical"),
+                ("CountryCodesPopulation", "CountryNamesPopulation"),
+            ],
+            get_country_code_resources(),
+            "en_GB",
+            MissingTranslationBehavior.ORIGINAL)
+
+        self.datakey = Constants.COUNTRY_NAMES_KEY